8 years agoemacs: add support for custom tag changes on message/thread archive
Jani Nikula [Thu, 6 Sep 2012 15:32:40 +0000 (18:32 +0300)]
emacs: add support for custom tag changes on message/thread archive

Add support for customization of the tag changes that are applied when
a message or a thread is archived. Instead of hard-coded removal of
the "inbox" tag, the user can now specify a list of tag changes to

8 years agoemacs: use new tag change helper to mark messages as replied
Jani Nikula [Thu, 6 Sep 2012 15:32:39 +0000 (18:32 +0300)]
emacs: use new tag change helper to mark messages as replied

Clarify documentation while at it.

8 years agoemacs: fix notmuch-message-replied-tags defcustom type
Jani Nikula [Thu, 6 Sep 2012 15:32:38 +0000 (18:32 +0300)]
emacs: fix notmuch-message-replied-tags defcustom type

8 years agoemacs: add helper for tag change list manipulation
Jani Nikula [Thu, 6 Sep 2012 15:32:37 +0000 (18:32 +0300)]
emacs: add helper for tag change list manipulation

Add a helper to create (and optionally reverse) a list of tag changes.

8 years ago{., man}/Makefile.local: edit/remove related targets
Tomi Ollila [Tue, 4 Sep 2012 14:49:13 +0000 (17:49 +0300)]
{., man}/Makefile.local: edit/remove related targets

Use new target release-checks in place of verify-version-debian,
verify-version-python verify-version-manpage. This target executes
devel/ which does all the verifications the three
dropped targets did, and some more.

8 years agodevel: add
Tomi Ollila [Tue, 4 Sep 2012 14:49:12 +0000 (17:49 +0300)]
devel: add

Currently Makefile.local contains some machine executable release
checking functionality. This is unnecessarily complex way to do it:

Multiline script functionality is hard to embed -- from Makefile point
of view there is just one line split using backslashes and every line
ends with ';'. It is hard to maintain such "script" when it gets longer.

The embedded script does not fail as robust as separate script; set -eu
could be added to get same level of robustness -- but the provided
Bourne Again Shell (bash) script exceeds this with 'set -o pipefail',
making the script to fail when any of the commands in pipeline fails
(and not just the last one).

Checking for release is done very seldom compared to all other use;
The whole Makefile.local gets simpler and easier to grasp when most
release checking targets are removed.

When release checking is done, the steps are executed sequentially;
nothing is allowed to be skipped due to some satisfied dependency.

8 years agotest/atomicity: use a more portable 'cp' form
Mike Kelly [Wed, 30 May 2012 07:02:03 +0000 (03:02 -0400)]
test/atomicity: use a more portable 'cp' form

-a already implies -r/-R, so no need for both.

FreeBSD's cp complains:

  cp: the -R and -r options may not be specified together

8 years agotest/basic: use portable args for find
Mike Kelly [Wed, 30 May 2012 07:02:01 +0000 (03:02 -0400)]
test/basic: use portable args for find

`-executable` isn't available in FreeBSD's version of find, so use a
more portable version, `-perm +111`.

8 years agotests: Test against source man pages.
Mike Kelly [Wed, 30 May 2012 07:02:00 +0000 (03:02 -0400)]
tests: Test against source man pages.

Without this, help-test tests against the installed man pages, rather
than the default ones.

8 years agotest/smtp-dummy.c: fix compilation on FreeBSD
Mike Kelly [Wed, 30 May 2012 07:01:59 +0000 (03:01 -0400)]
test/smtp-dummy.c: fix compilation on FreeBSD

Use the more portable netint/in.h, instead of netint/ip.h, to include
htons(3), etc.

8 years agotest/Makefile.local: Use $(XAPIAN_LDFLAGS) for symbol-test
Mike Kelly [Wed, 30 May 2012 07:01:57 +0000 (03:01 -0400)]
test/Makefile.local: Use $(XAPIAN_LDFLAGS) for symbol-test

On FreeBSD, and probably anywhere else someone installed xapian to
some other prefix, we need to use XAPIAN_LDFLAGS to make the linker can
actually find libxapian.

8 years agoconfigure: Add support for FreeBSD.
Mike Kelly [Wed, 30 May 2012 07:01:56 +0000 (03:01 -0400)]
configure: Add support for FreeBSD.

This makes FreeBSD a recognized platform. Follow up patches make it
work properly.

8 years agotest: make test_expect_equal_file() arguments flexible
Dmitry Kurochkin [Wed, 1 Feb 2012 07:19:54 +0000 (11:19 +0400)]
test: make test_expect_equal_file() arguments flexible

Before the change, test_expect_equal_file() function treated the first
argument as "actual output file" and the second argument as "expected
output file".  When the test fails, the files are copied for later
inspection.  The first files was copied to "$testname.output" and the
second file to "$testname.expected".  The argument order for
test_expect_equal_file() is often wrong which results in confusing
diff output and incorrectly named files.

The patch solves the issue by changing test_expect_equal_file() to
treat arguments just as two files, without any special properties
(like "actual" and "expected").  The file names for copying is now
based on the given file name: "$testname.$file1" and
"$testname.$file2".  E.g. if test_expect_equal_file() is called with
"OUTPUT" and "EXPECTED", the copied files can be named
"emacs.1.OUTPUT" and "emacs.1.EXPECTED".

The down side of this approach is that diff argument order depends on
test_expect_equal_file() argument order.  So sometimes we get diff
from expected to actual results, and sometimes the other way around.
But the files are always named correctly.

8 years agoemacs: correct `notmuch-search-mode's docstring wrt `notmuch-search-tag-all'
Pieter Praet [Wed, 22 Feb 2012 20:09:14 +0000 (21:09 +0100)]
emacs: correct `notmuch-search-mode's docstring wrt `notmuch-search-tag-all'

* emacs/notmuch.el (notmuch-search-mode):
  `notmuch-search-tag-all' currently uses the current query string
  instead of `notmuch-search-find-thread-id-region-search', which
  might cause a race condition.

8 years agocli: make the command line parser's errors more informative.
Mark Walters [Tue, 5 Jun 2012 14:36:36 +0000 (15:36 +0100)]
cli: make the command line parser's errors more informative.

Previously, the cli parser was a little erratic in what errors it
reported and would fail silently in many cases (for example, when no
argument was passed to an integer option). This was particularly
annoying as the user could not (easily) tell whether the command
failed or just there were no search results.

This patch tries to make the handling consistent and return a helpful
error message in all cases.

8 years agolib: fix NULL checks for filenames iterators
Sascha Silbe [Sun, 24 Jun 2012 16:29:24 +0000 (18:29 +0200)]
lib: fix NULL checks for filenames iterators

The API documentation (notmuch.h) states that the parameter may be NULL,
but the implementation only checked the current element, potentially
dereferencing a NULL pointer in the process.

Signed-off-by: Sascha Silbe <>
8 years agoemacs: make notmuch-show return its buffer
Mark Walters [Tue, 24 Jul 2012 21:21:48 +0000 (22:21 +0100)]
emacs: make notmuch-show return its buffer

notmuch-pick uses the returned buffer to try and make sure it does not
close the wrong buffer.

8 years agocontrib/nmbug/nmbug-status: if realname empty, use part of mailaddr
Tomi Ollila [Fri, 24 Aug 2012 17:29:21 +0000 (20:29 +0300)]
contrib/nmbug/nmbug-status: if realname empty, use part of mailaddr

When the From: field in patch email does not contain 'realname'
field, the patch listing does not show anything as patch sender.
In this case use the part before '@' in mail address as the sender
identification in patch listing.

8 years agotest: use (format "%S") to print nil in emacs test.
David Bremner [Fri, 31 Aug 2012 01:05:51 +0000 (22:05 -0300)]
test: use (format "%S") to print nil in emacs test.

The behaviour of "emacsclient --eval nil" changed from emacs23 to
emacs24, and in emacs24 it prints 'nil' rather than an empty string.

(format "%S" foo) produces a sexpr form of foo, and is consistent
between the two versions.

8 years agotest: canonicalize content-type in "Sending a message via (fake) SMTP"
David Bremner [Thu, 30 Aug 2012 01:09:54 +0000 (22:09 -0300)]
test: canonicalize content-type in "Sending a message via (fake) SMTP"

The version of message.el in emacs24 omits the charset=us-ascii,
causing the current version of this test to fail. With this patch, we
accept either option.  According to RFC 2046, they are semantically

8 years agotest: emacs: run list-processes after accept-process-output in emacs 23.1
Tomi Ollila [Sun, 5 Aug 2012 11:13:02 +0000 (14:13 +0300)]
test: emacs: run list-processes after accept-process-output in emacs 23.1

When running emacs tests using emacs 23.1.1 the tests block (until timeout)
when emacs function (notmuch-test-wait) is called.

There is an emacs bug #2930 titled:
23.0.92; `accept-process-output' and `sleep-for' do not run sentinel

It seems this is present in emacs 23.1.

Calling list-processes after accept-process-output seems work around
this problem; in case Emacs version is 23.1 a defadvice is activated
to do just that.

8 years agotest: emacs: call accept-process-output in notmuch-test-wait
Tomi Ollila [Sun, 5 Aug 2012 11:13:01 +0000 (14:13 +0300)]
test: emacs: call accept-process-output in notmuch-test-wait

notmuch-test-wait called sleep-for in a loop to wait unconditionally 0.1
seconds while waiting for process to exit.
accept-process-output returns as soon as there is any data available
from process, so using it avoids unnecessary fixed delays.
Both of these functions run process sentinels.

8 years agonotmuch-show: add notmuch-show-mark-read-tags option
Michal Nazarewicz [Tue, 21 Aug 2012 13:13:36 +0000 (15:13 +0200)]
notmuch-show: add notmuch-show-mark-read-tags option

The `notmuch-show-mark-read-tags' lists tags that are to be applied when
message is read.  By default, the only value is "-unread" which will remove
the unread tag.  Among other uses, this variable can be used to stop
notmuch-show from modifying tags when message is shown (by setting the
variable to an empty list).

8 years agoNEWS: 2 minor consistency changes in sections 0.13.1 and 0.13.2
Tomi Ollila [Fri, 24 Aug 2012 08:19:41 +0000 (11:19 +0300)]
NEWS: 2 minor consistency changes in sections 0.13.1 and 0.13.2

0.13.2: `contrib/notmuch-deliver` is in backticks elsewhere in
NEWS file. Commands are generally written in backticks in latest
NEWS entries.

0.13.1: Dropped period at the end of Title
'Fix compilation of ruby bindings',
as all other titles do not end with a period.

8 years agodebian: mention some upstream news in changelog 0.14 debian/0.14-1
David Bremner [Tue, 21 Aug 2012 08:41:39 +0000 (10:41 +0200)]
debian: mention some upstream news in changelog

8 years agodebian: set distribution to experimental
David Bremner [Tue, 21 Aug 2012 08:39:58 +0000 (10:39 +0200)]
debian: set distribution to experimental

This is to simplify potential bugfix uploads during Debian freeze.

8 years agoversion: propagate version changes
David Bremner [Mon, 20 Aug 2012 12:48:00 +0000 (14:48 +0200)]
version: propagate version changes

These are the result of running "make update-versions"

8 years agodebian: set date for changelog.
David Bremner [Mon, 20 Aug 2012 12:46:31 +0000 (14:46 +0200)]
debian: set date for changelog.

Make d/changelog match NEWS

8 years agoNEWS: set date for release.
David Bremner [Mon, 20 Aug 2012 12:46:15 +0000 (14:46 +0200)]
NEWS: set date for release.

8 years agoversion: bump primary version
David Bremner [Mon, 20 Aug 2012 11:53:50 +0000 (13:53 +0200)]
version: bump primary version

The date for man pages is taken from the last commit, so in this case
it makes sense to do this in two commits.

8 years agoNews for new 'previous' behavior
Austin Clements [Mon, 13 Aug 2012 15:27:19 +0000 (11:27 -0400)]
News for new 'previous' behavior

8 years agoemacs: Make moving to the previous message move to the previous boundary
Austin Clements [Sat, 14 Jul 2012 03:47:48 +0000 (23:47 -0400)]
emacs: Make moving to the previous message move to the previous boundary

Previously, notmuch-show-previous-message would move to the beginning
of the message before the message containing point.  This patch makes
it instead move to the previous message *boundary*.  That is, if point
isn't already at the beginning of the message, it moves to the
beginning of the current message.  This is consistent with
notmuch-show-next-message, which can be thought of as moving to the
next message boundary.  Several people have expressed a preference for

8 years agoreply: Convert JSON format to use sprinter
Austin Clements [Tue, 7 Aug 2012 12:57:10 +0000 (08:57 -0400)]
reply: Convert JSON format to use sprinter

Almost all of reply was already being formatted using the sprinter.
This patch converts the top-level dictionary to use the sprinter

8 years agocli: Remove now-unused json.c
Austin Clements [Tue, 7 Aug 2012 13:04:27 +0000 (09:04 -0400)]
cli: Remove now-unused json.c

The string buffer quoting functions in json.c have been superseded by
the new sprinter interface and are no longer used.  Remove them.

8 years agoemacs: notmuch search bugfix
Mark Walters [Tue, 7 Aug 2012 16:32:18 +0000 (17:32 +0100)]
emacs: notmuch search bugfix

The recent change to use json for notmuch-search.el introduced a bug
in the code for keeping position on refresh. The problem is a
comparison between (plist-get result :thread) and a thread-id returned
by notmuch-search-find-thread-id: the latter is prefixed with

We fix this by adding an option to notmuch-search-find-thread-id to
return the bare thread-id. It appears that notmuch-search-refresh-view
is the only caller of notmuch-search that supplies a thread-id so this
change should be safe (but could theoretically break users .emacs

8 years agosprinters: bugfix when NULL passed for a string.
Mark Walters [Wed, 8 Aug 2012 21:23:33 +0000 (22:23 +0100)]
sprinters: bugfix when NULL passed for a string.

The string function in a sprinter may be called with a NULL string
pointer (eg if a header is absent). This causes a segfault. We fix
this by checking for a null pointer in the string functions and update
the sprinter documentation.

At the moment some output when format=text is done directly rather than
via an sprinter: in that case a null pointer is passed to printf or
similar and a "(null)" appears in the output. That behaviour is not
changed in this patch.

8 years agotest: Add test for messages with missing headers
Austin Clements [Wed, 8 Aug 2012 01:28:33 +0000 (21:28 -0400)]
test: Add test for messages with missing headers

Currently the JSON tests for search and show are broken because
notmuch attempts to dereference a NULL pointer.

8 years agoemacs: Fix "not defined at runtime" warning
Austin Clements [Wed, 8 Aug 2012 21:40:10 +0000 (17:40 -0400)]
emacs: Fix "not defined at runtime" warning

Previously, the Emacs byte compiler produced the warning

    the function `remove-if-not' might not be defined at runtime.

because we only required cl at compile-time (not runtime).  This fixes
this warning by requiring cl at runtime, ensuring that the definition
of remove-if-not is available.

8 years agoNEWS: discuss changes for dump and restore syntax.
David Bremner [Sun, 5 Aug 2012 15:05:10 +0000 (12:05 -0300)]
NEWS: discuss changes for dump and restore syntax.

The duplication in NEWS.Debian is so that Debian users will be warned
during upgrade.

8 years agonotmuch-restore: replace positional argument for input with option
David Bremner [Sat, 4 Aug 2012 12:55:45 +0000 (09:55 -0300)]
notmuch-restore: replace positional argument for input with option

Since notmuch dump doesn't use positional arguments anymore, it seems
better to be consistent.

8 years agonotmuch-dump: remove deprecated positional argument for output file
David Bremner [Sat, 4 Aug 2012 02:23:11 +0000 (23:23 -0300)]
notmuch-dump: remove deprecated positional argument for output file

The syntax --output=filename is a smaller change than deleting the
output argument completely, and conceivably useful e.g. when running
notmuch under a debugger.

8 years agodebian: alternately depend on emacs24 for notmuch-emacs, build
David Bremner [Fri, 3 Aug 2012 00:56:26 +0000 (21:56 -0300)]
debian: alternately depend on emacs24 for notmuch-emacs, build

This should allow users to install notmuch-emacs with only emacs24
installed on their system. For good measure, allow building with
emacs24 as a 4th choice.

8 years agoshow: Remove now unused fields from notmuch_show_format
Austin Clements [Fri, 3 Aug 2012 01:14:59 +0000 (21:14 -0400)]
show: Remove now unused fields from notmuch_show_format

The message_set_{begin,sep,end} and null_message fields are no longer
used because we now use the structure printer provided by the format.

8 years agoshow: Convert do_show to use sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:58 +0000 (21:14 -0400)]
show: Convert do_show to use sprinter

8 years agoshow: Convert show_message to use sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:57 +0000 (21:14 -0400)]
show: Convert show_message to use sprinter

Unlike the previous patches, this function is used for all formats.
However, for formats other than the JSON format, the sprinter methods
used by show_message are all no-ops, so this code continues to
function correctly for all of the formats.

Converting show_message eliminates show_null_message in the process,
since this maps directly to an sprinter method.

8 years agoshow: Convert envelope format_part_json to use sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:56 +0000 (21:14 -0400)]
show: Convert envelope format_part_json to use sprinter

8 years agoshow: Convert non-envelope format_part_json to use sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:55 +0000 (21:14 -0400)]
show: Convert non-envelope format_part_json to use sprinter

8 years agoshow: Convert format_part_sigstatus_json to use sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:54 +0000 (21:14 -0400)]
show: Convert format_part_sigstatus_json to use sprinter

8 years agoshow: Convert format_headers_json to use sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:53 +0000 (21:14 -0400)]
show: Convert format_headers_json to use sprinter

This no longer requires a talloc context (not that it really did
before since it didn't return anything), so we remove its context

8 years agoshow: Feed the sprinter down to part formatters
Austin Clements [Fri, 3 Aug 2012 01:14:52 +0000 (21:14 -0400)]
show: Feed the sprinter down to part formatters

There are several levels of function calls between where we create the
sprinter and the call to the part formatter in show_message. This
feeds the sprinter through all of them and into the part formatters.

8 years agoreply: Create a JSON sprinter
Austin Clements [Fri, 3 Aug 2012 01:14:51 +0000 (21:14 -0400)]
reply: Create a JSON sprinter

8 years agoshow: Associate an sprinter with each format
Austin Clements [Fri, 3 Aug 2012 01:14:50 +0000 (21:14 -0400)]
show: Associate an sprinter with each format

This associates an sprinter constructor with each show format and uses
this to construct the appropriate sprinter.  Currently nothing is done
with this sprinter, but the following patches will weave it through
the layers of notmuch show.

8 years agosprinter: Add a string_len method
Austin Clements [Fri, 3 Aug 2012 01:14:49 +0000 (21:14 -0400)]
sprinter: Add a string_len method

This method allows callers to output strings with specific lengths.
It's useful both for strings with embedded NULs (which JSON can
represent, though parser support is apparently spotty), and
non-terminated strings.

8 years agotest: Remove unnecessary JSON canonicalization
Austin Clements [Fri, 3 Aug 2012 01:14:48 +0000 (21:14 -0400)]
test: Remove unnecessary JSON canonicalization

Format canonicalization of JSON output is no longer necessary, so
remove it.  Value canonicalization (e.g., normalizing thread IDs) is
still necessary, so all of the sanitization functions remain.

8 years agotest: Uniformly canonicalize actual and expected JSON
Austin Clements [Fri, 3 Aug 2012 01:14:47 +0000 (21:14 -0400)]
test: Uniformly canonicalize actual and expected JSON

Previously, we used a variety of ad-hoc canonicalizations for JSON
output in the test suite, but were ultimately very sensitive to JSON
irrelevancies such as whitespace.  This introduces a new test
comparison function, test_expect_equal_json, that first pretty-prints
*both* the actual and expected JSON and the compares the result.

The current implementation of this simply uses Python's json.tool to
perform pretty-printing (with a fallback to the identity function if
parsing fails).  However, since the interface it introduces is
semantically high-level, we could swap in other mechanisms in the
future, such as another pretty-printer or something that does not
re-order object keys (if we decide that we care about that).

In general, this patch does not remove the existing ad-hoc
canonicalization because it does no harm.  We do have to remove the
newline-after-comma rule from notmuch_json_show_sanitize and
filter_show_json because it results in invalid JSON that cannot be

Most of this patch simply replaces test_expect_equal and
test_expect_equal_file with test_expect_equal_json.  It changes the
expected JSON in a few places where sanitizers had placed newlines
after commas inside strings.

8 years agodebian: close notmuch-mutt bug in changelog
David Bremner [Fri, 3 Aug 2012 00:37:18 +0000 (21:37 -0300)]
debian: close notmuch-mutt bug in changelog

Apparently Stefano and I forgot to finish that discussion about how to
patch the changelog.

8 years agoemacs: show: exclude bug fix
Mark Walters [Sat, 28 Jul 2012 11:56:34 +0000 (12:56 +0100)]
emacs: show: exclude bug fix

The pipe message function (when used with a prefix) uses a search of
the form "id:<id1> or id:<id2>" etc. Since the user says precisely
which messages are wanted by opening them it should not use excludes.

8 years agodebian packaging: new depends for duplicate removals in mutt contrib
Stefano Zacchiroli [Wed, 1 Aug 2012 08:09:42 +0000 (10:09 +0200)]
debian packaging: new depends for duplicate removals in mutt contrib

both new hard dependency for File::Which and soft dependency on fdupes

8 years agoAdd duplicate message removal for notmuch-mutt.
Kevin McCarthy [Wed, 1 Aug 2012 08:09:41 +0000 (10:09 +0200)]
Add duplicate message removal for notmuch-mutt.

Add a --remove-dups flag which removes duplicate files from search and
thread results.  Uses fdupes if installed.  Otherwise it runs a size and
Digest::SHA scan on each file to detect duplicates.

Signed-off-by: Stefano Zacchiroli <>
8 years agoemacs: fix a bug introduced by the recent search cleanups.
Mark Walters [Thu, 2 Aug 2012 07:19:37 +0000 (08:19 +0100)]
emacs: fix a bug introduced by the recent search cleanups.

In commit 5d0883e the function notmuch-search-next-thread was changed.
In particular it only goes to the next message if there is a next
message. This breaks notmuch-show-archive-thread-then-next. Fix this
by going to the "next" message whenever we are on a current message.

8 years agodebian: update changelog for cleaning changes
David Bremner [Thu, 2 Aug 2012 12:36:24 +0000 (09:36 -0300)]
debian: update changelog for cleaning changes

8 years agobuild system: remove configure output in Make distclean.
David Bremner [Thu, 2 Aug 2012 12:30:31 +0000 (09:30 -0300)]
build system: remove configure output in Make distclean.

Create a variable DISTCLEAN which contains a list of things to
clean in the distclean target (in addition to running the clean

The deleted comment seems to be false these days, since we do
create files during configuration.

Use "rm -rf" here as well in case we want to add directories to

8 years agobuild system: remove directories created by tests in "make clean"
David Bremner [Thu, 2 Aug 2012 12:27:26 +0000 (09:27 -0300)]
build system: remove directories created by tests in "make clean"

These extra directories cause problems for building on Debian
twice in a row.

In order to remove directories, we need to us "rm -rf" instead of
"rm -f". So now we should be extra careful what we add to the
variable CLEAN.

8 years agoconfigure: check whether shell is capable of parameter substring processing
Tomi Ollila [Thu, 3 May 2012 18:59:58 +0000 (21:59 +0300)]
configure: check whether shell is capable of parameter substring processing

'configure' script uses parameter substring extensively. It is Posix shell
feature. Original Bourne shell does not have such features. Some systems
still ships such shells as /bin/sh (for compatibility reasons -- shell
scripts written on those platforms are expected to work on 1990's systems).

Just testing whether parameter substring processing works will make the
shell exit due to syntax error if it is not compatible. Therefore the test
is executed in a subshell -- subshell exits with nonzero value when the
operation in question fails.

As 'if ! ...' does not work in Bourne shell, Short-circuiting construct
'||' is used to print information message and exit when expected.

8 years agoman: show: update man page for entire-thread and json.
Mark Walters [Tue, 24 Jul 2012 18:57:57 +0000 (19:57 +0100)]
man: show: update man page for entire-thread and json.

Previously in notmuch show --format=json implied --entire-thread. This
is still the default but it is now possible to disable this. Update
the manpage to reflect this.

8 years agoschemata: update for --body=true|false option
Mark Walters [Tue, 24 Jul 2012 18:23:30 +0000 (19:23 +0100)]
schemata: update for --body=true|false option

Previously body: was a compulsory field in a message. The new
--body=false option causes notmuch show to omit this field so update
schemata to reflect this.

8 years agoman: update man page for the new --body=true|false option
Mark Walters [Tue, 24 Jul 2012 18:23:29 +0000 (19:23 +0100)]
man: update man page for the new --body=true|false option

8 years agotest: add tests for the new --body=true|false option
Mark Walters [Tue, 24 Jul 2012 18:23:28 +0000 (19:23 +0100)]
test: add tests for the new --body=true|false option

8 years agocli: add --body=true|false option to notmuch-show.c
Mark Walters [Tue, 24 Jul 2012 18:23:27 +0000 (19:23 +0100)]
cli: add --body=true|false option to notmuch-show.c

This option allows the caller to suppress the output of the bodies of
the messages. Currently this is only implemented for format=json.

This is used by notmuch-pick.el (although not needed) because it gives
a speed-up of at least a factor of a two (and in some cases a speed up
of more than a factor of 8); moreover it reduces the memory usage in
emacs hugely.

8 years agoUse the structured formatters in notmuch-search.c. [Mon, 23 Jul 2012 10:39:46 +0000 (12:39 +0200)]
Use the structured formatters in notmuch-search.c.

This patch switches from the current ad-hoc printer to the structured
formatters in sprinter.h, sprinter-text.c and sprinter-json.c.

The JSON tests are changed slightly in order to make them PASS for the
new structured output formatter.

The text tests pass without adaptation.

8 years agoAdd structured output formatter for JSON and plain text (but don't use them yet). [Mon, 23 Jul 2012 10:39:45 +0000 (12:39 +0200)]
Add structured output formatter for JSON and plain text (but don't use them yet).

Using the new structured printer support in sprinter.h, implement
sprinter_json_create, which returns a new JSON structured output
formatter. The formatter prints output similar to the existing JSON, but
with differences in whitespace (mostly newlines, --output=summary prints
the entire message summary on one line, not split across multiple lines).

Also implement a "structured" formatter for plain text that prints
prefixed strings, to be used with notmuch-search.c plain text output.

8 years agoAdd support for structured output formatters. [Mon, 23 Jul 2012 10:39:44 +0000 (12:39 +0200)]
Add support for structured output formatters.

This patch adds a new struct type sprinter_t, which is used for
structured formatting, e.g. JSON or S-Expressions. The structure printer
is heavily based on code from Austin Clements

It includes the following functions:

    /* Start a new map/dictionary structure. This should be followed by
     * a sequence of alternating calls to map_key and one of the
     * value-printing functions until the map is ended by end.
    void (*begin_map) (struct sprinter *);

    /* Start a new list/array structure.
    void (*begin_list) (struct sprinter *);

    /* End the last opened list or map structure.
    void (*end) (struct sprinter *);

    /* Print one string/integer/boolean/null element (possibly inside a
     * list or map, followed or preceded by separators).
     * For string, the char * must be UTF-8 encoded.
    void (*string) (struct sprinter *, const char *);
    void (*integer) (struct sprinter *, int);
    void (*boolean) (struct sprinter *, notmuch_bool_t);
    void (*null) (struct sprinter *);

    /* Print the key of a map's key/value pair. The char * must be UTF-8
     * encoded.
    void (*map_key) (struct sprinter *, const char *);

    /* Insert a separator (usually extra whitespace) for improved
     * readability without affecting the abstract syntax of the
     * structure being printed.
     * For JSON, this could simply be a line break.
    void (*separator) (struct sprinter *);

    /* Set the current string prefix. This only affects the text
     * printer, which will print this string, followed by a colon,
     * before any string. For other printers, this does nothing.
    void (*set_prefix) (struct sprinter *, const char *);

To support the plain text format properly, the following additional
function must also be implemented:

    /* Set the current string prefix. This only affects the text
     * printer, which will print this string, followed by a colon,
     * before any string. For other printers, this does nothing.
    void (*set_prefix) (struct sprinter *, const char *);

The structure also contains a flag that should be set to FALSE in all
custom printers and to TRUE in the plain text formatter.

    /* True if this is the special-cased plain text printer.
    notmuch_bool_t is_text_printer;

The printer can (and should) use internal state to insert delimiters
and syntax at the correct places.


format->map_key(format, "foo");
format->integer(format, 1);
format->integer(format, 2);
format->integer(format, 3);
format->map_key(format, "bar");
format->map_key(format, "baaz");
format->string(format, "hello world");

would output JSON as follows:

{"foo": [1, 2, 3], "bar": { "baaz": "hello world"}}

8 years agoNews for search cleanups
Austin Clements [Sat, 21 Jul 2012 17:37:12 +0000 (13:37 -0400)]
News for search cleanups

8 years agoemacs: Fix navigation of multi-line search result formats
Austin Clements [Sat, 21 Jul 2012 17:37:11 +0000 (13:37 -0400)]
emacs: Fix navigation of multi-line search result formats

At this point, the only remaining functions that don't support
multi-line search result formats are the thread navigation functions.
This patch fixes that by rewriting them in terms of

This changes the behavior of notmuch-search-previous-thread slightly
so that if point isn't at the beginning of a result, it first moves
point to the beginning of the result.

8 years agoemacs: Allow custom tags formatting
Austin Clements [Sat, 21 Jul 2012 17:37:10 +0000 (13:37 -0400)]
emacs: Allow custom tags formatting

Previously we ignored any notmuch-search-result-format customizations
for tag formatting because we needed to be able to parse back in the
result line and update the tags in place.  We no longer do either of
these things, so we can allow customization of this format.

(Coincidentally, previously we still allowed too much customization of
the tags format, since moving it earlier on the line or removing it
from the line would interfere with the tagging mechanism.  There is
now no problem with doing such things.)

8 years agoemacs: Replace other search text properties with result property
Austin Clements [Sat, 21 Jul 2012 17:37:09 +0000 (13:37 -0400)]
emacs: Replace other search text properties with result property

Since the result object contains everything that the other text
properties recorded, we can remove the other text properties and
simply look in the plist of the appropriate result object.

8 years agoemacs: Use result text properties for search result iteration
Austin Clements [Sat, 21 Jul 2012 17:37:08 +0000 (13:37 -0400)]
emacs: Use result text properties for search result iteration

This simplifies the traversal of regions of results and eliminates the
need for save-excursions (which tend to get in the way of maintaining
point when we make changes to the buffer).  It also fixes some strange
corner cases in the old line-based code where results that bordered
the region but were not included in it could be affected by region
commands.  Coincidentally, this also essentially enables multi-line
search result formats; the only remaining non-multi-line-capable
functions are notmuch-search-{next,previous}-thread, which are only
used for interactive navigation.

8 years agoemacs: Update tags by rewriting the search result line in place
Austin Clements [Sat, 21 Jul 2012 17:37:07 +0000 (13:37 -0400)]
emacs: Update tags by rewriting the search result line in place

Now that we keep the full thread result object, we can refresh a
result after any changes by simply deleting and reconstructing the
result line from scratch.

A convenient side-effect of this wholesale replacement is that search
now re-applies notmuch-search-line-faces when tags change.

8 years agoemacs: Use text properties instead of overlays for tag coloring
Austin Clements [Sat, 21 Jul 2012 17:37:06 +0000 (13:37 -0400)]
emacs: Use text properties instead of overlays for tag coloring

Previously, tag-based search result highlighting was done by creating
an overlay over each search result.  However, overlays have annoying
front- and rear-advancement semantics that make it difficult to
manipulate text at their boundaries, which the next patch will do.
They also have performance problems (creating an overlay is linear in
the number of overlays between point and the new overlay, making
highlighting a search buffer quadratic in the number of results).

Text properties have neither problem.  However, text properties make
it more difficult to apply multiple faces since, unlike with overlays,
a given character can only have a single 'face text property.  Hence,
we introduce a utility function that combines faces into any existing
'face text properties.

Using this utility function, it's straightforward to apply all of the
appropriate tag faces in notmuch-search-color-line.

8 years agoemacs: Record thread search result object in a text property
Austin Clements [Sat, 21 Jul 2012 17:37:05 +0000 (13:37 -0400)]
emacs: Record thread search result object in a text property

This also provides utility functions for working with this text
property that get its value, find its start, and find its end.

8 years agoemacs: Fix notmuch-message-mark-replied.
Ingo Lohmar [Sun, 3 Jun 2012 18:23:57 +0000 (21:23 +0300)]
emacs: Fix notmuch-message-mark-replied.

notmuch-message-mark-replied used "apply" to change message tags
according to notmuch-message-replied-tags after sending a reply.  This
works if the latter is a single-element list.  But with the recently
changed format of tag changes, it breaks for multiple-element lists.
Use "funcall" to properly pass the list of tag changes as a single

8 years agodebian: finalize changelog
David Bremner [Thu, 12 Jul 2012 23:49:09 +0000 (17:49 -0600)]
debian: finalize changelog

It turns out the "debian-snapshot" target needs a valid changelog.

8 years agoNews for JSON-based search
Austin Clements [Mon, 9 Jul 2012 21:42:42 +0000 (17:42 -0400)]
News for JSON-based search

8 years agoemacs: Switch from text to JSON format for search results
Austin Clements [Mon, 9 Jul 2012 21:42:41 +0000 (17:42 -0400)]
emacs: Switch from text to JSON format for search results

The JSON format eliminates the complex escaping issues that have
plagued the text search format.  This uses the incremental JSON parser
so that, like the text parser, it can output search results

This slows down the parser by about ~4X, but puts us in a good
position to optimize either by improving the JSON parser (evidence
suggests this can reduce the overhead to ~40% over the text format) or
by switching to S-expressions (evidence suggests this will more than
double performance over the text parser).  [1]

This also fixes the incremental search parsing test.

This has one minor side-effect on search result formatting.
Previously, the date field was always padded to a fixed width of 12
characters because of how the text parser's regexp was written.  The
JSON format doesn't do this.  We could pad it out in Emacs before
formatting it, but, since all of the other fields are variable width,
we instead fix notmuch-search-result-format to take the variable-width
field and pad it out.  For users who have customized this variable,
we'll mention in the NEWS how to fix this slight format change.

[1] id:""

8 years agoemacs: Implement an incremental JSON parser
Austin Clements [Mon, 9 Jul 2012 21:42:40 +0000 (17:42 -0400)]
emacs: Implement an incremental JSON parser

This parser is designed to read streaming JSON whose structure is
known to the caller.  Like a typical JSON parsing interface, it
provides a function to read a complete JSON value from the input.
However, it extends this with an additional function that
requires the next value in the input to be a compound value and
descends into it, allowing its elements to be read one at a time
or further descended into.  Both functions can return 'retry to
indicate that not enough input is available.

The parser supports efficient partial parsing, so there's no need to
frame the input for correctness or performance.

The bulk of the parsing is still done by Emacs' json.el, so any
improvements or optimizations to that will benefit the incremental
parser as well.

Currently only descending into JSON lists is supported because that's
all we need, but support for descending into JSON objects can be added
in the future.

8 years agotest: New test for incremental search output parsing
Austin Clements [Mon, 9 Jul 2012 21:42:39 +0000 (17:42 -0400)]
test: New test for incremental search output parsing

This advises the search process filter to make it process one
character at a time in order to test the pessimal case for incremental
search output parsing.

The text parser fails this test because it gets tricked into thinking
a parenthetical remark in a subject is the tag list.

8 years agoemacs: Pass plist to `notmuch-search-show-result'
Austin Clements [Mon, 9 Jul 2012 21:42:38 +0000 (17:42 -0400)]
emacs: Pass plist to `notmuch-search-show-result'

Rather than passing lots of arguments and then further passing those
to `notmuch-search-insert-field', pass a plist containing all of the
search result information.  This plist is compatible with the JSON
format search results.

8 years agoemacs: Move search-target logic to `notmuch-search-show-result'
Austin Clements [Mon, 9 Jul 2012 21:42:37 +0000 (17:42 -0400)]
emacs: Move search-target logic to `notmuch-search-show-result'

This is a simpler place to do this, since we can avoid any point
motion and hence any save-excursions in
`notmuch-search-process-filter', which in turn lets us put all of the
search-target logic outside of any save-excursions.

`notmuch-search-show-{result,error}' are now responsible for their own
point motion.

`notmuch-search-process-filter' could use some reindentation after
this, but we're about to rewrite it entirely, so we won't bother.

8 years agoemacs: Helper for reporting search parsing errors
Austin Clements [Mon, 9 Jul 2012 21:42:36 +0000 (17:42 -0400)]
emacs: Helper for reporting search parsing errors

This removes the last bit of direct output from the parsing function.
With the parser now responsible solely for parsing, we can swap it out
for another parser.

8 years agoemacs: Separate search line parsing and display
Austin Clements [Mon, 9 Jul 2012 21:42:35 +0000 (17:42 -0400)]
emacs: Separate search line parsing and display

Previously, much of the display of search lines was done in the same
function that parsed the CLI's output.  Now the parsing function only
parses, and notmuch-search-show-result fully inserts the search result
in the search buffer.

8 years agoemacs: Clean up notmuch-search-show-result
Austin Clements [Mon, 9 Jul 2012 21:42:34 +0000 (17:42 -0400)]
emacs: Clean up notmuch-search-show-result

This simplifies the code and makes it no longer cubic in the number of
result fields.

8 years agocontib/nmbug/nmbug-status: leftover whitespaces, indentation & quoting
Tomi Ollila [Wed, 11 Jul 2012 09:10:05 +0000 (12:10 +0300)]
contib/nmbug/nmbug-status: leftover whitespaces, indentation & quoting

The initial nmbug-status was pretty consistent in it's whitespacing
but a few lines had some leftover slips. Those are now "corrected".

Also, most of the code used ' as quoting char. As in Python one can
use ' and " interchangeably some code used " instead of '. However
the usage of those were inconsistent. Now all quotes that python
parses are ':s (only quoted content uses ":s).

No functional changes.

8 years agocontrib/nmbug/ nmbug-status: restored out['subject']... block level
Tomi Ollila [Wed, 11 Jul 2012 09:10:04 +0000 (12:10 +0300)]
contrib/nmbug/ nmbug-status: restored out['subject']... block level

In reformatting the line 111 accidentally indented to one indentation
level too much (happens easily when interactively indenting python
code using emacs). The line now has 4 spacess less indentation, thus
restoring it to the block level it belongs.

8 years agocontrib/nmbug: add nmbug-status script
David Bremner [Sat, 7 Jul 2012 19:29:38 +0000 (13:29 -0600)]
contrib/nmbug: add nmbug-status script

This is (almost) the same script as has been used for for a while now. The only change is
that the configuration is not hardcoded anymore. By default the config
is fetched from a special branch in the nmbug repo that contains only
config info. The idea is that push access to this branch can be
restricted a bit more than the tags, since it will change the
appearence of the web pages.

8 years agocontrib/nmbug: make nmbug a subdirectory
David Bremner [Sat, 7 Jul 2012 18:56:06 +0000 (12:56 -0600)]
contrib/nmbug: make nmbug a subdirectory

I want to ship the status tool here as well, along with a sample
config file.

8 years agoAdd missing "tags" field to search schema
Austin Clements [Tue, 3 Jul 2012 05:47:38 +0000 (01:47 -0400)]
Add missing "tags" field to search schema

This field is output by search, but it didn't make it into the

8 years agomanpages: consistent "format" for NAME section
Tomi Ollila [Sun, 24 Jun 2012 21:53:27 +0000 (00:53 +0300)]
manpages: consistent "format" for NAME section

The NAME section in manpages generally doesn't start with capital
letter (unless the word is 'proper noun') and doesn't end with
period. Notmuch manual pages now matches that "format".

8 years agotest: add basic show, search --format=text tests
Peter Wang [Sun, 24 Jun 2012 03:27:48 +0000 (13:27 +1000)]
test: add basic show, search --format=text tests

There didn't seem to be these basic tests for --format=text,
as there are for --format=json.  These are just the tests from
the `json' script, with adjusted expected outputs.

8 years agodebian: document tag action invocation fix in changelog
Stefano Zacchiroli [Tue, 3 Jul 2012 21:30:48 +0000 (15:30 -0600)]
debian: document tag action invocation fix in changelog

8 years agonotmuch-mutt: fix helper invocation for the tag action
Stefano Zacchiroli [Tue, 3 Jul 2012 21:30:47 +0000 (15:30 -0600)]
notmuch-mutt: fix helper invocation for the tag action

As it was before, "-inbox" was interpreted as a getopt option, rather
than as a tag manipulation request. Making the action unusable.