647cd07858f1faf48784e3c4261f37bf69448609
[notmuch] / NEWS
1 Notmuch 0.21 (UNRELEASED)
2 =========================
3
4 General
5 -------
6
7 Notmuch now requires gmime >= 2.6.7. The gmime 2.4 series is no longer
8 supported.
9
10 Database revision tracking: `lastmod:` queries
11
12   Each message now has a metadata revision number that increases with
13   every tagging operation. See the discussion of `lastmod:` in
14   `notmuch-search-terms(7)` for more information.
15
16 Date queries now support `date:<expr>..!` shorthand for
17 `date:<expr>..<expr>`
18
19   You can use, for example, `date:yesterday..!` to match from the
20   beginning of yesterday to the end of yesterday. For further details,
21   please refer to the `notmuch-search-terms` manual page.
22
23 Notmuch database upgrade to support `lastmod:` queries
24
25   The above mentioned `lastmod:` prefix. This will be done
26   automatically, without prompting on the next time `notmuch new` is
27   run after the upgrade. The upgrade is not reversible, and the
28   upgraded database will not be readable by older versions of
29   Notmuch. As a safeguard, a database dump will be created in the
30   `.notmuch` directory before upgrading.
31
32 Build System
33 ------------
34
35 The ruby bindings are now built as part of the main notmuch build
36 process. This can be disabled with the `--without-ruby` option to
37 configure.
38
39 Building the documentation can be disabled with the `--without-docs`
40 option to configure.
41
42 Skipped individual tests are no longer considered as failures.
43
44 Command Line Interface
45 ----------------------
46
47 Database revision tracking
48
49   Two new options were added to support revision tracking. A global
50   option "--uuid" (`notmuch(1)`) was added for to detect counter
51   rollover and reinitialization, and `notmuch-count(1)` gained a
52   `--lastmod` option to query database revision tracking data.
53
54 Emacs Interface
55 ---------------
56
57 `notmuch-emacs-version` is used in `User-Agent` header
58
59   The value of recently introduced variable `notmuch-emacs-version` is
60   now used as a part of `User-Agent` header when sending emails.
61
62 Removed `notmuch-version` function by renaming it to `notmuch-cli-version`
63
64   With existing variable `notmuch-emacs-version` the accompanied
65   function which retrieves the version of `notmuch-command` is
66   better named as `notmuch-cli-version`.
67
68 Query input now supports completion for "is:<tag>".
69
70 New message composition mode: `notmuch-compose-mode`
71
72   This is mainly to fix fcc handling, but may be useful for user
73   customization as well.
74
75 Library
76 -------
77
78 The use of absolute paths is now enforced when calling
79 `notmuch_database_{open, create}`.
80
81 Database revision tracking
82
83   Revision tracking is supported via a new prefix "lastmod:" in the
84   query parser and the new function
85   `notmuch_database_get_revision`. For the latter, see `notmuch(3)`.
86
87 New status code returning API for n_query_count_{messages,threads}.
88
89 Deprecated functions
90
91   `notmuch_query_search_threads`, `notmuch_query_search_messages`,
92   `notmuch_query_count_messages`, and `notmuch_query_count_threads`
93   are all deprecated as of this release.  Clients are encouraged to
94   transition to the `_st` variants supporting better error reporting.
95
96 nmbug-status
97 ------------
98
99 nmbug-status now supports specifying the sort order for each view
100
101 Notmuch 0.20.2 (2015-06-27)
102 ===========================
103
104 Emacs Interface
105 ---------------
106
107 Bug fix for marking messages read in `notmuch-tree` mode.
108
109 Notmuch 0.20.1 (2015-06-01)
110 ===========================
111
112 Test Suite
113 ----------
114
115 Work around apparent gdb bug on arm64.
116
117 Notmuch 0.20 (2015-05-31)
118 =========================
119
120 Command-Line Interface
121 ----------------------
122
123 There is a new `mimetype:` search prefix
124
125   The new `mimetype:` search prefix allows searching for the
126   content-type of attachments, which is now indexed. See the
127   `notmuch-search-terms` manual page for details.
128
129 Path to gpg is now configurable
130
131   On systems with multiple versions of gpg, you can tell
132   notmuch which one to use by setting `crypto.gpg_path`
133
134 Emacs
135 -----
136
137 Avoid rendering large text attachements.
138
139 Improved rendering of CID references in HTML.
140
141 Vim
142 ---
143
144 Vim client now respects excluded tags.
145
146 Notmuch-Mutt
147 ------------
148
149 Support messages without Message-IDs.
150
151 Library
152 -------
153
154 Undeprecate single message mboxes
155
156   It seems more trouble to remove this feature than expected, so
157   `notmuch new` will no longer nag about mboxes with a single message.
158
159 New error logging facility
160
161   Clients should call `notmuch_database_status_string` to retrieve
162   output formerly printed to stderr.
163
164 Several bug fixes related to stale iterators
165
166 New status code returning API for n_query_search_{messages,thread}
167
168 Fix for library `install_name` on Mac OS X
169
170 Fix for rounding of seconds
171
172 Documentation
173 -------------
174
175 Sphinx is now mandatory to build docs
176
177   Support for using rst2man in place of sphinx to build the
178   docmumentation has been removed.
179
180 Improved notmuch-search-terms.7
181
182   The man page `notmuch-search-terms(7)` has been extended, merging
183   some material from the relicensed wiki.
184
185 Contrib
186 -------
187
188 `notmuch-deliver` is removed. As far as we know, all functionality
189 previously provided by `notmuch-deliver` should now be provided by
190 `notmuch insert`, provided by the main notmuch binary.
191
192 nmbug-status
193 ------------
194
195 `nmbug-status` now only matches local branches when reading
196 `status-config.json` from the `config` branch of the `NMBGIT`
197 repository.  To help new users running `nmbug-status`, `nmbug clone`
198 now creates a local `config` branch tracking `origin/config`.  Folks
199 who use `nmbug-status` with an in-Git config (i.e. you don't use the
200 `--config` option) who already have `NMBGIT` set up are encouraged to
201 run:
202
203     git checkout config origin/config
204
205 in their `NMBGIT` repository (usually `~/.nmbug`).
206
207 Notmuch 0.19 (2014-11-14)
208 =========================
209
210 Overview
211 --------
212
213 This release improves the reliability of `notmuch dump` and the error
214 handling for `notmuch insert`. The new `notmuch address` command is
215 intended to make searching for email addresses more convenient. At the
216 library level the revised handling of missing messages fixes at least
217 one bug in threading. The release also includes several interface
218 improvements to the emacs interface, most notably the ability to bind
219 keyboard shortcuts to saved searches.
220
221 Command-Line Interface
222 ----------------------
223
224 Stopped `notmuch dump` failing if someone writes to the database
225
226   The dump command now takes the write lock when running. This
227   prevents other processes from writing to the database during the
228   dump which would cause the dump to fail. Note, if another notmuch
229   process already has the write lock the dump will not start, so
230   script callers should still check the return value.
231
232 `notmuch insert` requires succesful message indexing for success status
233
234   Previously the `notmuch insert` subcommand indicated success even if
235   the message indexing failed, as long as the message was delivered to
236   file system. This could have lead to delivered messages missing
237   tags, etc. `notmuch insert` is now more strict, also requiring
238   succesful indexing for success status. Use the new `--keep` option
239   to revert to the old behaviour (keeping the delivered message file
240   and returning success even if indexing fails).
241
242 `notmuch insert` has gained support for `post-insert` hook
243
244   The new `post-insert` hook is run after message delivery, similar to
245   `post-new`. There's also a new option `notmuch insert --no-hooks` to
246   skip the hook. See the notmuch-hooks(1) man page for details.
247
248 `notmuch deliver` is deprecated
249
250   With this release we believe that `notmuch insert` has reached
251   parity with `notmuch deliver`. We recommend that all users of
252   `notmuch deliver` switch to `notmuch insert` as the former is
253   currently unmaintained.
254
255 `notmuch search` now supports `--duplicate=N` option with `--output=messages`
256
257   Complementing the `notmuch search --duplicate=N --output=files`
258   options, the new `--duplicate=N --output=messages` combination
259   limits output of message IDs to messages matching search terms that
260   have at least `N` files associated with them.
261
262 Added `notmuch address` subcommand
263
264   This new subcommand searches for messages matching the given search
265   terms, and prints the addresses from them. Duplicate addresses are
266   filtered out. The `--output` option controls which of the following
267   information is printed: sender addresses, recipient addresses and
268   count of duplicate addresses.
269
270 Emacs Interface
271 ---------------
272
273 Use the `j` key to access saved searches from anywhere in notmuch
274
275   `j` is now globally bound to `notmuch-jump`, which provides fast,
276   interactive keyboard shortcuts to saved searches.  For example,
277   with the default saved searches `j i` from anywhere in notmuch will
278   bring up the inbox.
279
280 Improved handling of the unread tag
281
282   Notmuch now marks an open message read (i.e., removes the unread
283   tag) if point enters the message at any time in a show buffer
284   regardless of how point got there (mouse click, cursor command, page
285   up/down, notmuch commands such as n,N etc). This fixes various
286   anomalies or bugs in the previous handling. Additionally it is
287   possible to customize the mark read handling by setting
288   `notmuch-show-mark-read-function` to a custom function.
289
290 Expanded default saved search settings
291
292   The default saved searches now include several more common searches,
293   as well as shortcut keys for `notmuch-jump`.
294
295 Improved `q` binding in notmuch buffers
296
297   `q` will now bury rather than kill a notmuch search, show or tree
298   buffer if there are multiple windows showing the buffer. If only a
299   single window is showing the buffer, it is killed.
300
301 `notmuch-show-stash-mlarchive-link-alist` now supports functions
302
303   Some list archives may use a more complicated scheme for referring
304   to messages than just concatenated URL and message ID. For example,
305   patchwork requires a query to translate message ID to a patchwork
306   patch ID. `notmuch-show-stash-mlarchive-link-alist` now supports
307   functions to better cover such cases. See the help documentation for
308   the variable for details.
309
310 Library changes
311 ---------------
312
313 Introduced database version 3 with support for "database features."
314
315   Features are independent aspects of the database schema.
316   Representing these independently of the database version number will
317   let us evolve the database format faster and more incrementally,
318   while maintaining better forwards and backwards compatibility.
319
320 Library users are no longer required to call `notmuch_database_upgrade`
321
322   Previously, library users were required to call
323   `notmuch_database_needs_upgrade` and `notmuch_database_upgrade`
324   before using a writable database.  Even the CLI didn't get this
325   right, and it is no longer required.  Now, individual APIs may
326   return `NOTMUCH_STATUS_UPGRADE_REQUIRED` if the database format is
327   too out of date for that API.
328
329 Library users can now abort an atomic section by closing the database
330
331   Previously there was no supported way to abort an atomic section.
332   Callers can now simply close the database, and any outstanding
333   atomic section will be aborted.
334
335 Add return status to `notmuch_database_close` and
336 `notmuch_database_destroy`
337
338 Bug fixes and performance improvements for thread linking
339
340   The database now represents missing-but-referenced messages ("ghost
341   messages") similarly to how it represents regular messages.  This
342   enables an improved thread linking algorithm that performs better
343   and fixes a bug that sometimes prevented notmuch from linking
344   messages into the same thread.
345
346 nmbug
347 -----
348
349 The Perl script has been translated to Python; you'll need Python 2.7
350 or anything from the 3.x line.  Most of the user-facing interface is
351 the same, but `nmbug help` is now `nmbug --help`, and the following nmbug
352 commands have slightly different interfaces: `archive`, `commit`,
353 `fetch`, `log`, `pull`, `push`, and `status`.  For details on the
354 new interface for a given command, run `nmbug COMMAND --help`.
355
356 nmbug-status
357 ------------
358
359 `nmbug-status` can now optionally load header and footer templates
360 from the config file.  Use something like:
361
362     {
363       "meta": {
364         "header": "<!DOCTYPE html>\n<html lang="en">\n...",
365         "footer": "</body></html>",
366          ...
367       },
368       ...
369     },
370
371 Python Bindings
372 ---------------
373
374 Add support for `notmuch_query_add_tag_exclude`
375
376 Build System
377 ------------
378
379 The notmuch binaries and libraries are now build with debugging symbols
380 by default.  Users concerned with disk space should change the
381 defaults when configuring or use the strip(1) command.
382
383 Notmuch 0.18.2 (2014-10-25)
384 ===========================
385
386 Test Suite
387 ----------
388
389 Translate T380-atomicity to use gdb/python
390
391   The new version is compatible with gdb 7.8
392
393 Emacs 24.4 related bug fixes
394
395   The Messages buffer became read-only, and the generated mime
396   structure for signatures changed slightly.
397
398 Simplify T360-symbol-hiding
399
400    Replace the use of `objdump` on the object files with `nm` on the
401    resulting lib.
402
403 Notmuch 0.18.1 (2014-06-25)
404 ===========================
405
406 This is a bug fix and portability release.
407
408 Build System
409 ------------
410
411 Add a workaround for systems without zlib.pc
412
413 Make emacs install robust against the non-existence of emacs
414
415 Put notmuch lib directory first in RPATH
416
417 Fix handling of `html_static_path` in sphinx
418
419   Both the python bindings and the main docs had spurious settings of
420   this variable.
421
422 Test Suite
423 ----------
424
425 Use --quick when starting emacs
426
427   This avoids a hang in the T160-json tests.
428
429 Allow pending break points in atomicity script
430
431   This allows the atomicity tests to run on several more architectures/OSes.
432
433 Command-Line Interface
434 ----------------------
435
436 To improve portability use fsync instead of fdatasync in
437 `notmuch-dump`. There should be no functional difference.
438
439 Library changes
440 ---------------
441
442 Resurrect support for single-message mbox files
443
444   The removal introduced a bug with previously indexed single-message
445   mboxes.  This support remains deprecated.
446
447 Fix for phrase indexing
448
449   There were several bugs where words intermingled from different
450   headers and MIME parts could match a single phrase query.  This fix
451   will affect only newly indexed messages.
452
453 Emacs Interface
454 ---------------
455
456 Make sure tagging on an empty query is harmless
457
458   Previously tagging an empty query could lead to tags being
459   unintentionally removed.
460
461 Notmuch 0.18 (2014-05-06)
462 =========================
463
464 Overview
465 --------
466
467 This new release includes some enhancements to searching for messages
468 by filesystem location (`folder:` and `path:` prefixes under *General*
469 below).  Saved searches in *Emacs* have also been enhanced to allow
470 distinct search orders for each one.  Another enhancement to the
471 *Emacs* interface is that replies to encrypted messages are now
472 encrypted, reducing the risk of unintentional information disclosure.
473 The default dump output format has changed to the more robust
474 `batch-tag` format. The previously deprecated parsing of single
475 message mboxes has been removed. For detailed release notes, see
476 below.
477
478 General
479 -------
480
481 The `folder:` search prefix now requires an exact match
482
483   The `folder:` prefix has been changed to search for email messages
484   by the exact, case sensitive maildir or MH folder name. Wildcard
485   matching (`folder:foo*`) is no longer supported. The new behaviour
486   allows for more accurate mail folder based searches, makes it
487   possible to search for messages in the top-level folder, and should
488   lead to less surprising results than the old behaviour. Users are
489   advised to see the `notmuch-search-terms` manual page for details,
490   and review how the change affects their existing `folder:` searches.
491
492 There is a new `path:` search prefix
493
494   The new `path:` search prefix complements the `folder:` prefix. The
495   `path:` prefix searches for email messages that are in particular
496   directories within the mail store, optionally recursively using a
497   special syntax. See the `notmuch-search-terms` manual page for
498   details.
499
500 Notmuch database upgrade due to `folder:` and `path:` changes
501
502   The above mentioned changes to the `folder:` prefix and the addition
503   of `path:` prefix require a Notmuch database upgrade. This will be
504   done automatically, without prompting on the next time `notmuch new`
505   is run after the upgrade. The upgrade is not reversible, and the
506   upgraded database will not be readable by older versions of
507   Notmuch. As a safeguard, a database dump will be created in the
508   `.notmuch` directory before upgrading.
509
510 Library changes
511 ---------------
512
513 Notmuch database upgrade
514
515   The libnotmuch consumers are reminded to handle database upgrades
516   properly, either by relying on running `notmuch new`, or checking
517   `notmuch_database_needs_upgrade()` and calling
518   `notmuch_database_upgrade()` as necessary. This has always been the
519   case, but in practise there have been no database upgrades in any
520   released version of Notmuch before now.
521
522 Support for indexing mbox files has been dropped
523
524   There has never been proper support for mbox files containing
525   multiple messages, and the support for single-message mbox files has
526   been deprecated since Notmuch 0.15. The support has now been
527   dropped, and all mbox files will be rejected during indexing.
528
529 Message header parsing changes
530
531   Notmuch previously had an internal parser for message headers. The
532   parser has now been dropped in favour of letting GMime parse both
533   the headers and the message MIME structure at the same pass. This is
534   mostly an internal change, but the GMime parser is stricter in its
535   interpretation of the headers. This may result in messages with
536   slightly malformed message headers being now rejected.
537
538 Command-Line Interface
539 ----------------------
540
541 `notmuch dump` now defaults to `batch-tag` format
542
543   The old format is still available with `--format=sup`.
544
545 `notmuch new` has a --quiet option
546
547   This option suppresses the progress and summary reports.
548
549 `notmuch insert` respects maildir.synchronize_flags config option
550
551   Do not synchronize tags to maildir flags in `notmuch insert` if the
552   user does not want it.
553
554 The commands set consistent exit status codes on failures
555
556   The cli commands now consistently set exit status of 1 on failures,
557   except where explicitly otherwise noted. The notable expections are
558   the status codes for format version mismatches for commands that
559   support formatted output.
560
561 Bug fix for checking configured new.tags for invalid tags
562
563   `notmuch new` and `notmuch insert` now check the user configured
564   new.tags for invalid tags, and refuse to apply them, similar to
565   `notmuch tag`. Invalid tags are currently the empty string and tags
566   starting with `-`.
567
568 Emacs Interface
569 ---------------
570
571 Init file
572
573   If the file pointed by new variable `notmuch-init-file` (typically
574   `~/.emacs.d/notmuch-config.el`) exists, it is loaded at the end of
575   `notmuch.el`. Users can put their personal notmuch emacs lisp based
576   configuration/customization items there instead of filling
577   `~/.emacs` with these.
578
579 Changed format for saved searches
580
581   The format for `notmuch-saved-searches` has changed, but old style
582   saved searches are still supported. The new style means that a saved
583   search can store the desired sort order for the search, and it can
584   store a separate query to use for generating the count notmuch
585   shows.
586
587   The variable is fully customizable and any configuration done
588   through customize should *just work*, with the additional options
589   mentioned above. For manual customization see the documentation for
590   `notmuch-saved-searches`.
591
592   IMPORTANT: a new style notmuch-saved-searches variable will break
593   previous versions of notmuch-emacs (even search will not work); to
594   fix remove the customization for notmuch-saved-searches.
595
596   If you have a custom saved search sort function (not unsorted or
597   alphabetical) then the sort function will need to be
598   modified. Replacing (car saved-search) by (notmuch-saved-search-get
599   saved-search :name) and (cdr saved-search) by
600   (notmuch-saved-search-get saved-search :query) should be sufficient.
601
602 The keys of `notmuch-tag-formats` are now regexps
603
604   Previously, the keys were literal strings.  Customized settings of
605   `notmuch-tag-formats` will continue to work as before unless tags
606   contain regexp special characters like `.` or `*`.
607
608 Changed tags are now shown in the buffer
609
610   Previously tag changes made in a buffer were shown immediately. In
611   some cases (particularly automatic tag changes like marking read)
612   this made it hard to see what had happened (e.g., whether the
613   message had been unread).
614
615   The changes are now shown explicitly in the buffer: by default
616   deleted tags are displayed with red strike-through and added tags
617   are displayed underlined in green (inverse video is used for deleted
618   tags if the terminal does not support strike-through).
619
620   The variables `notmuch-tag-deleted-formats` and
621   `notmuch-tag-added-formats`, which have the same syntax as
622   `notmuch-tag-formats`, allow this to be customized.
623
624   Setting `notmuch-tag-deleted-formats` to `'((".*" nil))` and
625   `notmuch-tag-added-formats` to `'((".*" tag))` will give the old
626   behavior of hiding deleted tags and showing added tags identically
627   to tags already present.
628
629 Version variable
630
631   The new, build-time generated variable `notmuch-emacs-version` is used
632   to distinguish between notmuch cli and notmuch emacs versions.
633   The function `notmuch-hello-versions` (bound to 'v' in notmuch-hello
634   window) prints both notmuch cli and notmuch emacs versions in case
635   these differ from each other.
636   This is especially useful when using notmuch remotely.
637
638 Ido-completing-read initialization in Emacs 23
639
640   `ido-completing-read` in Emacs 23 versions 1 through 3 freezes unless
641   it is initialized. Defadvice-based *Ido* initialization is defined
642   for these Emacs versions.
643
644 Bug fix for saved searches with newlines in them
645
646   Split lines confuse `notmuch count --batch`, so we remove embedded
647   newlines before calling notmuch count.
648
649 Bug fixes for sender identities
650
651   Previously, Emacs would rewrite some sender identities in unexpected
652   and undesirable ways.  Now it will use identities exactly as
653   configured in `notmuch-identities`.
654
655 Replies to encrypted messages will be encrypted by default
656
657   In the interest of maintaining confidentiality of communications,
658   the Notmuch Emacs interface now automatically adds the mml tag to
659   encrypt replies to encrypted messages. This should make it less
660   likely to accidentally reply to encrypted messages in plain text.
661
662 Reply pushes mark before signature
663
664   We push mark and set point on reply so that the user can easily cut
665   the quoted text. The mark is now pushed before the signature, if
666   any, instead of end of buffer so the signature is preserved.
667
668 Message piping uses the originating buffer's working directory
669
670   `notmuch-show-pipe-message` now uses the originating buffer's
671   current default directory instead of that of the `*notmuch-pipe*`
672   buffer's.
673
674 nmbug
675 -----
676
677 nmbug adds a `clone` command for setting up the initial repository and
678 uses `@{upstream}` instead of `FETCH_HEAD` to track upstream changes.
679
680   The `@{upstream}` change reduces ambiguity when fetching multiple
681   branches, but requires existing users update their `NMBGIT`
682   repository (usually `~/.nmbug`) to distinguish between local and
683   remote-tracking branches.  The easiest way to do this is:
684
685   1. If you have any purely local commits (i.e. they aren't in the
686      nmbug repository on nmbug.tethera.net), push them to a remote
687      repository.  We'll restore them from the backup in step 4.
688   2. Remove your `NMBGIT` repository (e.g. `mv .nmbug .nmbug.bak`).
689   3. Use the new `clone` command to create a fresh clone:
690
691         nmbug clone http://nmbug.tethera.net/git/nmbug-tags.git
692
693   4. If you had local commits in step 1, add a remote for that
694      repository and fetch them into the new repository.
695
696 Notmuch 0.17 (2013-12-30)
697 =========================
698
699 Incompatible change in SHA1 computation
700 ---------------------------------------
701
702 Previously on big endian architectures like sparc and powerpc the
703 computation of SHA1 hashes was incorrect. This meant that messages
704 with overlong or missing message-ids were given different computed
705 message-ids than on more common little endian architectures like i386
706 and amd64.  If you use notmuch on a big endian architecture, you are
707 strongly advised to make a backup of your tags using `notmuch dump`
708 before this upgrade. You can locate the affected files using something
709 like:
710
711     notmuch dump | \
712       awk '/^notmuch-sha1-[0-9a-f]{40} / \
713         {system("notmuch search --exclude=false --output=files id:" $1)}'
714
715 Command-Line Interface
716 ----------------------
717
718 New options to better support handling duplicate messages
719
720   If more than one message file is associated with a message-id,
721   `notmuch search --output=files` will print all of them. A new
722   `--duplicate=N` option can be used to specify which duplicate to
723   print for each message.
724
725   `notmuch count` now supports `--output=files` option to output the
726   number of files associated with matching messages. This may be
727   bigger than the number of matching messages due to duplicates
728   (i.e. multiple files having the same message-id).
729
730 Improved `notmuch new` performance for unchanged folders
731
732   `notmuch new` now skips over unchanged folders more efficiently,
733   which can substantially improve the performance of checking for new
734   mail in some situations (like NFS-mounted Maildirs).
735
736 `notmuch reply --format=text` RFC 2047-encodes headers
737
738   Previously, this used a mix of standard MIME encoding for the reply
739   body and UTF-8 for the headers.  Now, the text format reply template
740   RFC 2047-encodes the headers, making the output a valid RFC 2822
741   message.  The JSON/sexp format is unchanged.
742
743 `notmuch compact` command
744
745   The new `compact` command exposes Xapian's compaction
746   functionality through a more convenient interface than
747   `xapian-compact`. `notmuch compact` will compact the database to a
748   temporary location, optionally backup the original database, and
749   move the compacted database into place.
750
751 Emacs Interface
752 ---------------
753
754 `notmuch-tree` (formerly `notmuch-pick`) has been added to mainline
755
756   `notmuch-tree` is a threaded message view for the emacs
757   interface. Each message is one line in the results and the thread
758   structure is shown using UTF-8 box drawing characters (similar to
759   Mutt's threaded view). It comes between search and show in terms of
760   amount of output and can be useful for viewing both single threads
761   and multiple threads.
762
763   Using `notmuch-tree`
764
765   The main key entries to notmuch tree are
766
767   'z' enter a query to view using notmuch tree (works in hello,
768       search, show and tree mode itself)
769
770   'Z' view the current query in tree notmuch tree (works from search
771       and show)
772
773   Once in tree mode, keybindings are mostly in line with the rest of
774   notmuch and are all viewable with '?' as usual.
775
776   Customising `notmuch-tree`
777
778   `notmuch-tree` has several customisation variables. The most
779   significant is the first notmuch-tree-show-out which determines the
780   behaviour when selecting a message (with RET) in tree view. By
781   default tree view uses a split window showing the single message in
782   the bottom pane. However, if this option is set then it views the
783   whole thread in the complete window jumping to the selected message
784   in the thread. In either case command-prefix selects the other option.
785
786 Tagging threads in search is now race-free
787
788   Previously, adding or removing a tag from a thread in a search
789   buffer would affect messages that had arrived after the search was
790   performed, resulting in, for example, archiving messages that were
791   never seen.  Tagging now affects only the messages that were in the
792   thread when the search was performed.
793
794 `notmuch-hello` refreshes when switching to the buffer
795
796   The hello buffer now refreshes whenever you switch to the buffer,
797   regardless of how you get there.  You can disable automatic
798   refreshing by customizing `notmuch-hello-auto-refresh`.
799
800 Specific mini-buffer prompts for tagging operations
801
802   When entering tags to add or remove, the mini-buffer prompt now
803   indicates what operation will be performed (e.g., "Tag thread", "Tag
804   message", etc).
805
806 Built-in help improvements
807
808   Documentation for many commands has been improved, as displayed by
809   `notmuch-help` (usually bound to "?").  The bindings listed by
810   `notmuch-help` also now include descriptions of prefixed commands.
811
812 Quote replies as they are displayed in show view
813
814   We now render the parts for reply quoting the same way they are
815   rendered for show. At this time, the notable change is that replies
816   to text/calendar are now pretty instead of raw vcalendar.
817
818 Fixed inconsistent use of configured search order
819
820   All ways of interactively invoking search now honor the value of
821   `notmuch-search-oldest-first`.
822
823 Common keymap for notmuch-wide bindings
824
825   Several key bindings have been moved from mode-specific keymaps to
826   the single `notmuch-common-keymap`, which is inherited by each
827   notmuch mode.  If you've customized your key bindings, you may want
828   to move some of them to the common keymap.
829
830 The `notmuch-tag` function now requires a list of tag changes
831
832   For users who have scripted the Emacs interface: the `notmuch-tag`
833   API has changed.  Previously, it accepted either a list of tag
834   changes or a space-separated string of tag changes.  The latter is
835   no longer supported and the function now returns nothing.
836
837 Fixed `notmuch-reply` putting reply in primary selection
838
839   On emacs 24 notmuch-reply used to put the cited text into the
840   primary selection (which could lead to inadvertently pasting this
841   cited text elsewhere). Now the primary-selection is not changed.
842
843 Fixed `notmuch-show` invisible part handling
844
845   In some obscure cases part buttons and invisibility had strange
846   interactions: in particular, the default action for some parts gave
847   the wrong action. This has been fixed.
848
849 Fixed `notmuch-show` attachment viewers and stderr
850
851   In emacs 24.3+ viewing an attachment could cause spurious text to
852   appear in the show buffer (any stderr or stdout the viewer
853   produced). By default this output is now discarded. For debugging,
854   setting `notmuch-show-attachment-debug` causes notmuch to keep the
855   viewer's stderr and stdout in a separate buffer.
856
857 Fixed `notmuch-mua-reply` point placement when signature involved
858
859   By restricting cursor movement to body section for cursor placement
860   after signature is inserted, the cursor cannot "leak" to header
861   section anymore. Now inserted citation content will definitely go to
862   the body part of the message.
863
864 Vim Interface
865 -------------
866
867   It is now possible to compose new messages in the Vim interface, as
868   opposed reply to existing messages.  There is also support for
869   going straight to a search (bypassing the folders view).
870
871 Notmuch 0.16 (2013-08-03)
872 =========================
873
874 Command-Line Interface
875 ----------------------
876
877 Support for delivering messages to Maildir
878
879   There is a new command `insert` that adds a message to a Maildir
880   folder and notmuch index.
881
882 `notmuch count --batch` option
883
884   `notmuch count` now supports batch operations similar to `notmuch
885   tag`. This is mostly an optimization for remote notmuch usage.
886
887 `notmuch tag` option to remove all tags from matching messages
888
889   `notmuch tag --remove-all` option has been added to remove all tags
890   from matching messages. This can be combined with adding new tags,
891   resulting in setting (rather than modifying) the tags of the
892   messages.
893
894 Decrypting commands explicitly expect a gpg-agent
895
896   Decryption in `notmuch show` and `notmuch reply` has only ever
897   worked with a functioning gpg-agent. This is now made explicit in
898   code and documentation. The functional change is that it's now
899   possible to have gpg-agent running, but gpg "use-agent"
900   configuration option disabled, not forcing the user to use the agent
901   everywhere.
902
903 Configuration file saves follow symbolic links
904
905   The notmuch commands that save the configuration file now follow
906   symbolic links instead of overwrite them.
907
908 Top level option to specify configuration file
909
910   It's now possible to specify the configuration file to use on the
911   command line using the `notmuch --config=FILE` option.
912
913 Bash command-line completion
914
915   The notmuch command-line completion support for the bash shell has
916   been rewritten. Supported completions include all the notmuch
917   commands, command-line arguments, values for keyword arguments,
918   search prefixes (such as "subject:" or "from:") in all commands that
919   use search terms, tags after + and - in `notmuch tag`, tags after
920   "tag:" prefix, user's email addresses after "from:" and "to:"
921   prefixes, and config options (and some config option values) in
922   `notmuch config`. The new completion support depends on the
923   bash-completion package.
924
925 Deprecated commands "part" and "search-tags" are removed.
926
927 Emacs Interface
928 ---------------
929
930 New keymap to view/save parts; removed s/v/o/| part button bindings
931
932   The commands to view, save, and open MIME parts are now prefixed
933   with "." (". s" to save, ". v" to view, etc) and can be invoked with
934   point anywhere in a part, unlike the old commands, which were
935   restricted to part buttons.  The old "s"/"v"/"o"/"|" commands on
936   part buttons have been removed since they clashed with other
937   bindings (notably "s" for search!) and could not be invoked when
938   there was no part button.  The new, prefixed bindings appear in
939   show's help, so you no longer have to memorize them.
940
941 Default part save directory is now `mm-default-directory`
942
943   Previously, notmuch offered to save parts and attachments to a mix
944   of `mm-default-directory`, `mailcap-download-directory`, and `~/`.
945   This has been standardized on `mm-default-directory`.
946
947 Key bindings for next/previous thread
948
949   Show view has new key bindings M-n and M-p to move to the next and
950   previous thread in the search results.
951
952 Better handling of errors in search buffers
953
954   Instead of interleaving errors in search result buffers, search mode
955   now reports errors in the minibuffer.
956
957 Faster search and show
958
959   Communication between Emacs and the notmuch CLI is now more
960   efficient because it uses the CLI's S-expression support.  As a
961   result, search mode should now fill search buffers faster and
962   threads should show faster.
963
964 No Emacs 22 support
965
966   The Emacs 22 support added late 2010 was sufficient only for a short
967   period of time. After being incomplete for roughly 2 years the code
968   in question was now removed from this release.
969
970 Vim Front-End
971 -------------
972
973 The vim based front-end has been replaced with a new one that uses the Ruby
974 bindings. The old font-end is available in the contrib subfolder.
975
976 Python Bindings
977 ---------------
978
979 Fix loading of libnotmuch shared library on OS X (Darwin) systems.
980
981 Notmuch 0.15.2 (2013-02-17)
982 ===========================
983
984 Build fixes
985 -----------
986
987 Update dependencies to avoid problems when building in parallel.
988
989 Internal test framework changes
990 -------------------------------
991
992 Adjust Emacs test watchdog mechanism to cope with `process-attributes`
993 being unimplemented.
994
995 Notmuch 0.15.1 (2013-01-24)
996 ===========================
997
998 Internal test framework changes
999 -------------------------------
1000
1001 Set a default value for TERM when running tests. This fixes certain
1002 build failures in non-interactive environments.
1003
1004 Notmuch 0.15 (2013-01-18)
1005 =========================
1006
1007 General
1008 -------
1009
1010 Date range search support
1011
1012   The `date:` prefix can now be used in queries to restrict the results
1013   to only messages within a particular time range (based on the Date:
1014   header) with a range syntax of `date:<since>..<until>`. Notmuch
1015   supports a wide variety of expressions in `<since>` and
1016   `<until>`. Please refer to the `notmuch-search-terms(7)` manual page
1017   for details.
1018
1019 Empty tag names and tags beginning with "-" are deprecated
1020
1021   Such tags have been a frequent source of confusion and cause
1022   (sometimes unresolvable) conflicts with other syntax.  notmuch tag
1023   no longer allows such tags to be added to messages.  Removing such
1024   tags continues to be supported to allow cleanup of existing tags,
1025   but may be removed in a future release.
1026
1027 Command-Line Interface
1028 ----------------------
1029
1030 `notmuch new` no longer chokes on mboxes
1031
1032   `notmuch new` now rejects mbox files containing more than one
1033   message, rather than treating the file as one giant message.
1034
1035 Support for single message mboxes is deprecated
1036
1037   For historical reasons, `notmuch new` will index mbox files
1038   containing a single message; however, this behavior is now
1039   officially deprecated.
1040
1041 Fixed `notmuch new` to skip ignored broken symlinks
1042
1043   `notmuch new` now correctly skips symlinks if they are in the
1044   ignored files list.  Previously, it would abort when encountering
1045   broken symlink, even if it was ignored.
1046
1047 New dump/restore format and tagging interface
1048
1049   There is a new `batch-tag` format for dump and restore that is more
1050   robust, particularly with respect to tags and message-ids containing
1051   whitespace.
1052
1053   `notmuch tag` now supports the ability to read tag operations and
1054   queries from an input stream, in a format compatible with the new
1055   dump/restore format.
1056
1057 Bcc and Reply-To headers are now available in notmuch show json output
1058
1059   The `notmuch show --format=json` now includes "Bcc" and "Reply-To" headers.
1060   For example notmuch Emacs client can now have these headers visible
1061   when the headers are added to the `notmuch-message-headers` variable.
1062
1063 CLI callers can now request a specific output format version
1064
1065   `notmuch` subcommands that support structured output now support a
1066   `--format-version` argument for requesting a specific version of the
1067   structured output, enabling better compatibility and error handling.
1068
1069 `notmuch search` has gained a null character separated text output format
1070
1071   The new --format=text0 output format for `notmuch search` prints
1072   output separated by null characters rather than newline
1073   characters. This is similar to the find(1) -print0 option, and works
1074   together with the xargs(1) -0 option.
1075
1076 Emacs Interface
1077 ---------------
1078
1079 Removal of the deprecated `notmuch-folders` variable
1080
1081   `notmuch-folders` has been deprecated since the introduction of saved
1082   searches and the notmuch hello view in notmuch 0.3. `notmuch-folders`
1083   has now been removed. Any remaining users should migrate to
1084   `notmuch-saved-searches`.
1085
1086 Visibility of MIME parts can be toggled
1087
1088   Each part of a multi-part MIME email can now be shown or hidden
1089   using the button at the top of each part (by pressing RET on it or
1090   by clicking).  For emails with multiple alternative formats (e.g.,
1091   plain text and HTML), only the preferred format is shown initially,
1092   but other formats can be shown using their part buttons.  To control
1093   the behavior of this, see
1094   `notmuch-multipart/alternative-discouraged` and
1095   `notmuch-show-all-multipart/alternative-parts`.
1096
1097   Note notmuch-show-print-message (bound to '#' by default) will print
1098   all parts of multipart/alternative message regardless of whether
1099   they are currently hidden or shown in the buffer.
1100
1101 Emacs now buttonizes mid: links
1102
1103   mid: links are a standardized way to link to messages by message ID
1104   (see RFC 2392).  Emacs now hyperlinks mid: links to the appropriate
1105   notmuch search.
1106
1107 Handle errors from bodypart insertions
1108
1109   If displaying the text of a message in show mode causes an error (in
1110   the `notmuch-show-insert-part-*` functions), notmuch no longer cuts
1111   off thread display at the offending message.  The error is now
1112   simply displayed in place of the message.
1113
1114 Emacs now detects version mismatches with the notmuch CLI
1115
1116   Emacs now detects and reports when the Emacs interface version and
1117   the notmuch CLI version are incompatible.
1118
1119 Improved text/calendar content handling
1120
1121   Carriage returns in embedded text/calendar content caused insertion
1122   of the calendar content fail. Now CRs are removed before calling icalendar
1123   to extract icalendar data. In case icalendar extraction fails an error
1124   is thrown for the bodypart insertion function to deal with.
1125
1126 Disabled coding conversions when reading in `with-current-notmuch-show-message`
1127
1128   Depending on the user's locale, saving attachments containing 8-bit
1129   data may have performed an unintentional encoding conversion,
1130   corrupting the saved attachment.  This has been fixed by making
1131   `with-current-notmuch-show-message` disable coding conversion.
1132
1133 Fixed errors with HTML email containing images in Emacs 24
1134
1135   Emacs 24 ships with a new HTML renderer that produces better output,
1136   but is slightly buggy.  We work around a bug that caused it to fail
1137   for HTML email containing images.
1138
1139 Fixed handling of tags with unusual characters in them
1140
1141   Emacs now handles tags containing spaces, quotes, and parenthesis.
1142
1143 Fixed buttonization of id: links without quote characters
1144
1145   Emacs now correctly buttonizes id: links where the message ID is not
1146   quoted.
1147
1148 `notmuch-hello` refresh point placement improvements
1149
1150   Refreshing the `notmuch-hello` buffer does a better job of keeping
1151   the point where it was.
1152
1153 Automatic tag changes are now unified and customizable
1154
1155   All the automatic tag changes that the Emacs interface makes when
1156   reading, archiving, or replying to messages, can now be
1157   customized. Any number of tag additions and removals is supported
1158   through the `notmuch-show-mark-read`, `notmuch-archive-tags`, and
1159   `notmuch-message-replied-tags` customization variables.
1160
1161 Support for stashing the thread id in show view
1162
1163   Invoking `notmuch-show-stash-message-id` with a prefix argument
1164   stashes the (local and database specific) thread id of the current
1165   thread instead of the message id.
1166
1167 New add-on tool: notmuch-pick
1168 -----------------------------
1169
1170 The new contrib/ tool `notmuch-pick` is an experimental threaded message
1171 view for the emacs interface. Each message is one line in the results
1172 and the thread structure is shown using UTF-8 box drawing characters
1173 (similar to Mutt's threaded view). It comes between search and show in
1174 terms of amount of output and can be useful for viewing both single
1175 threads and multiple threads. See the notmuch-pick README file for
1176 further details and installation.
1177
1178 Portability
1179 -----------
1180
1181 notmuch now builds on OpenBSD.
1182
1183 Internal test framework changes
1184 -------------------------------
1185
1186 The emacsclient binary is now user-configurable
1187
1188   The test framework now accepts `TEST_EMACSCLIENT` in addition to
1189   `TEST_EMACS` for configuring the emacsclient to use.  This is
1190   necessary to avoid using an old emacsclient with a new emacs, which
1191   can result in buggy behavior.
1192
1193 Notmuch 0.14 (2012-08-20)
1194 =========================
1195
1196 General bug fixes
1197 -----------------
1198
1199 Maildir tag synchronization
1200
1201   Maildir flag-to-tag synchronization now applies only to messages in
1202   maildir-like directory structures.  Previously, it applied to any
1203   message that had a maildir "info" part, which meant it could
1204   incorrectly synchronize tags for non-maildir messages, while at the
1205   same time failing to synchronize tags for newly received maildir
1206   messages (typically causing new messages to not receive the "unread"
1207   tag).
1208
1209 Command-Line Interface
1210 ----------------------
1211
1212   The deprecated positional output file argument to `notmuch dump` has
1213   been replaced with an `--output` option. The input file positional
1214   argument to `notmuch restore` has been replaced with an `--input`
1215   option for consistency with dump.  These changes simplify the syntax
1216   of dump/restore options and make them more consistent with other
1217   notmuch commands.
1218
1219 Emacs Interface
1220 ---------------
1221
1222 Search results now get re-colored when tags are updated
1223
1224 The formatting of tags in search results can now be customized
1225
1226   Previously, attempting to change the format of tags in
1227   `notmuch-search-result-format` would usually break tagging from
1228   search-mode.  We no longer make assumptions about the format.
1229
1230 Experimental support for multi-line search result formats
1231
1232   It is now possible to embed newlines in
1233   `notmuch-search-result-format` to make individual search results
1234   span multiple lines.
1235
1236 Next/previous in search and show now move by boundaries
1237
1238   All "next" and "previous" commands in the search and show modes now
1239   move to the next/previous result or message boundary.  This doesn't
1240   change the behavior of "next", but "previous" commands will first
1241   move to the beginning of the current result or message if point is
1242   inside the result or message.
1243
1244 Search now uses the JSON format internally
1245
1246   This should address problems with unusual characters in authors and
1247   subject lines that could confuse the old text-based search parser.
1248
1249 The date shown in search results is no longer padded before applying
1250 user-specified formatting
1251
1252   Previously, the date in the search results was padded to fixed width
1253   before being formatted with `notmuch-search-result-format`.  It is
1254   no longer padded.  The default format has been updated, but if
1255   you've customized this variable, you may have to change your date
1256   format from `"%s "` to `"%12s "`.
1257
1258 The thread-id for the `target-thread` argument for `notmuch-search` should
1259 now be supplied without the "thread:" prefix.
1260
1261 Notmuch 0.13.2 (2012-06-02)
1262 ===========================
1263
1264 Bug-fix release
1265 ---------------
1266
1267 Update `contrib/notmuch-deliver` for API changes in 0.13. This fixes a
1268 compilation error for this contrib package.
1269
1270 Notmuch 0.13.1 (2012-05-29)
1271 ===========================
1272
1273 Bug-fix release
1274 ---------------
1275
1276 Fix inserting of UTF-8 characters from *text/plain* parts in reply
1277
1278   While notmuch gained ability to insert content from other than *text/plain*
1279   parts of email whenever *text/plain* parts are not available (notably
1280   HTML-only emails), replying to mails that do have *text/plain* the
1281   non-ASCII characters were incorrectly decoded. This is now fixed.
1282
1283 `notmuch_database_get_directory` and
1284 `notmuch_database_find_message_by_filename` now work on read-only
1285 databases
1286
1287   Previously, these functions attempted to create directory documents
1288   that didn't exist and would return an error or abort when given a
1289   read-only database.  Now they no longer create directory documents
1290   and simply return a `NULL` object if the directory does not exist,
1291   as documented.
1292
1293 Fix compilation of ruby bindings
1294
1295   Revert to dynamic linking, since the statically linked bindings did
1296   not work well.
1297
1298 Notmuch 0.13 (2012-05-15)
1299 =========================
1300
1301 Command-Line Interface
1302 ----------------------
1303
1304 JSON reply format
1305
1306   `notmuch reply` can now produce JSON output that contains the headers
1307   for a reply message and full information about the original message
1308   begin replied to. This allows MUAs to create replies intelligently.
1309   For example, an MUA that can parse HTML might quote HTML parts.
1310
1311   Calling notmuch reply with `--format=json` imposes the restriction that
1312   only a single message is returned by the search, as replying to
1313   multiple messages does not have a well-defined behavior. The default
1314   retains its current behavior for multiple message replies.
1315
1316 Tag exclusion
1317
1318   Tags can be automatically excluded from search results by adding them
1319   to the new `search.exclude_tags` option in the Notmuch config file.
1320
1321   This behaviour can be overridden by explicitly including an excluded
1322   tag in your query, for example:
1323
1324         notmuch search $your_query and tag:$excluded_tag
1325
1326   Existing users will probably want to run `notmuch setup` again to add
1327   the new well-commented [search] section to the configuration file.
1328
1329   For new configurations, accepting the default setting will cause the
1330   tags "deleted" and "spam" to be excluded, equivalent to running:
1331
1332         notmuch config set search.exclude_tags deleted spam
1333
1334 Raw show format changes
1335
1336   The output of show `--format=raw` has changed for multipart and
1337   message parts.  Previously, the output was a mash of somewhat-parsed
1338   headers and transfer-decoded bodies.  Now, such parts are reproduced
1339   faithfully from the original source.  Message parts (which includes
1340   part 0) output the full message, including the message headers (but
1341   not the transfer headers).  Multipart parts output the part as
1342   encoded in the original message, including the part's headers.  Leaf
1343   parts, as before, output the part's transfer-decoded body.
1344
1345 Listing configuration items
1346
1347   The new `config list` command prints out all configuration items and
1348   their values.
1349
1350 Emacs Interface
1351 ---------------
1352
1353 Changes to tagging interface
1354
1355   The user-facing tagging functions in the Emacs interface have been
1356   normalized across all notmuch modes.  The tagging functions are now
1357   notmuch-search-tag in search-mode, and notmuch-show-tag in
1358   show-mode.  They accept a string representing a single tag change,
1359   or a list of tag changes.  See 'M-x describe-function notmuch-tag'
1360   for more information.
1361
1362   NOTE: This breaks compatibility with old tagging functions, so user
1363   may need to update in custom configurations.
1364
1365 Reply improvement using the JSON format
1366
1367   Emacs now uses the JSON reply format to create replies. It obeys
1368   the customization variables message-citation-line-format and
1369   message-citation-line-function when creating the first line of the
1370   reply body, and it will quote HTML parts if no text/plain parts are
1371   available.
1372
1373 New add-on tool: notmuch-mutt
1374 -----------------------------
1375
1376 The new contrib/ tool `notmuch-mutt` provides Notmuch integration for
1377 the Mutt mail user agent. Using it, Mutt users can perform mail
1378 search, thread reconstruction, and mail tagging/untagging without
1379 leaving Mutt.  notmuch-mutt, formerly distributed under the name
1380 `mutt-notmuch` by Stefano Zacchiroli, will be maintained as a notmuch
1381 contrib/ from now on.
1382
1383 Library changes
1384 ---------------
1385
1386 The API changes detailed below break binary and source compatibility,
1387 so libnotmuch has been bumped to version 3.0.0.
1388
1389 The function `notmuch_database_close` has been split into
1390 `notmuch_database_close` and `notmuch_database_destroy`
1391
1392   This makes it possible for long running programs to close the xapian
1393   database and thus release the lock associated with it without
1394   destroying the data structures obtained from it.
1395
1396 `notmuch_database_open`, `notmuch_database_create`, and
1397 `notmuch_database_get_directory` now return errors
1398
1399   The type signatures of these functions have changed so that the
1400   functions now return a `notmuch_status_t` and take an out-argument for
1401   returning the new database object or directory object.
1402
1403 Go bindings changes
1404 -------------------
1405
1406 Go 1 compatibility
1407
1408   The go bindings and the `notmuch-addrlookup` utility are now
1409   compatible with go 1.
1410
1411 Notmuch 0.12 (2012-03-20)
1412 =========================
1413
1414 Command-Line Interface
1415 ----------------------
1416
1417 Reply to sender
1418
1419   `notmuch reply` has gained the ability to create a reply template
1420   for replying just to the sender of the message, in addition to reply
1421   to all. The feature is available through the new command line option
1422   `--reply-to=(all|sender)`.
1423
1424 Mail store folder/file ignore
1425
1426   A new configuration option, `new.ignore`, lets users specify a
1427   ;-separated list of file and directory names that will not be
1428   searched for messages by `notmuch new`.
1429
1430   NOTE: *Every* file/directory that goes by one of those names will
1431   be ignored, independent of its depth/location in the mail store.
1432
1433 Unified help and manual pages
1434
1435   The notmuch help command now runs man for the appropriate page.  If
1436   you install notmuch somewhere "unusual", you may need to update
1437   MANPATH.
1438
1439 Manual page for notmuch configuration options
1440
1441   The notmuch CLI configuration file options are now documented in the
1442   notmuch-config(1) manual page in addition to the configuration file
1443   itself.
1444
1445 Emacs Interface
1446 ---------------
1447
1448 Reply to sender
1449
1450   The Emacs interface has, with the new CLI support, gained the
1451   ability to reply to sender in addition to reply to all. In both show
1452   and search modes, 'r' has been bound to reply to sender, replacing
1453   reply to all, which now has key binding 'R'.
1454
1455 More flexible and consistent tagging operations
1456
1457   All tagging operations ('+', '-', '*') now accept multiple tags with
1458   '+' or '-' prefix, like '*' operation in notmuch-search view before.
1459
1460   '*' operation (`notmuch-show-tag-all`) is now available in
1461   notmuch-show view.
1462
1463   `notmuch-show-{add,remove}-tag` functions no longer accept tag
1464   argument, `notmuch-show-tag-message` should be used instead.  Custom
1465   bindings using these functions should be updated, e.g.:
1466
1467         (notmuch-show-remove-tag "unread")
1468
1469   should be changed to:
1470
1471         (notmuch-show-tag-message "-unread")
1472
1473 Refreshing the show view ('=' by default) no longer opens or closes messages
1474
1475   To get the old behavior of putting messages back in their initial
1476   opened/closed state, use a prefix argument, e.g., 'C-u ='.
1477
1478 Attachment buttons can be used to view or save attachments.
1479
1480   When the cursor is on an attachment button the key 's' can be used
1481   to save the attachment, the key 'v' to view the attachment in the
1482   default mailcap application, and the key 'o' prompts the user for an
1483   application to use to open the attachment. By default Enter or mouse
1484   button 1 saves the attachment but this is customisable (option
1485   Notmuch Show Part Button Default Action).
1486
1487 New functions
1488
1489   `notmuch-show-stash-mlarchive-link{,-and-go}` allow stashing and
1490   optionally visiting a URI to the current message at one of a number
1491   of Mailing List Archives.
1492
1493 Fix MML tag quoting in replies
1494
1495   The MML tag quoting fix of 0.11.1 unintentionally quoted tags
1496   inserted in `message-setup-hook`. Quoting is now limited to the
1497   cited message.
1498
1499 Show view archiving key binding changes
1500
1501   The show view archiving key bindings 'a' and 'x' now remove the
1502   "inbox" tag from the current message only (instead of thread), and
1503   move to the next message. At the last message, 'a' proceeds to the
1504   next thread in search results, and 'x' returns to search
1505   results. The thread archiving functions are now available in 'A' and
1506   'X'.
1507
1508 Support text/calendar MIME type
1509
1510   The text/calendar MIME type is now supported in addition to
1511   text/x-vcalendar.
1512
1513 Generate inline patch fake attachment file names from message subject
1514
1515   Use the message subject to generate file names for the inline patch
1516   fake attachments. The names are now similar to the ones generated by
1517   'git format-patch' instead of just "inline patch". See "Notmuch Show
1518   Insert Text/Plain Hook" in the notmuch customize interface.
1519
1520 Enable `notmuch-search-line-faces` by default
1521
1522   Make the `notmuch-search-line-faces` functionality more discoverable
1523   for new users by showing "unread" messages bold and "flagged"
1524   messages blue by default in the search view.
1525
1526 Printing Support
1527
1528   notmuch-show mode now has simple printing support, bound to '#' by
1529   default. You can customize the variable notmuch-print-mechanism.
1530
1531 Library changes
1532 ---------------
1533
1534 New functions
1535
1536   `notmuch_query_add_tag_exclude` supports the new tag exclusion
1537   feature.
1538
1539 Python bindings changes
1540 -----------------------
1541
1542 Python 3.2 compatibility
1543
1544   The python bindings are now compatible with both python 2.5+ and 3.2.
1545
1546 Added missing unicode conversions
1547
1548   Python strings have to be encoded to and decoded from utf-8 when
1549   calling libnotmuch functions. Porting the bindings to python 3.2
1550   revealed a few function calls that were missing these conversions.
1551
1552 Build fixes
1553 -----------
1554
1555 Compatibility with GMime 2.6
1556
1557   It is now possible to build notmuch against both GMime 2.4 and 2.6.
1558   However, a bug in GMime 2.6 before 2.6.5 causes notmuch not to
1559   report signatures where the signer key is unavailable (GNOME bug
1560   668085).  For compatibility with GMime 2.4's tolerance of "From "
1561   headers we require GMime 2.6 >= 2.6.7.
1562
1563 Notmuch 0.11.1 (2012-02-03)
1564 ===========================
1565
1566 Bug-fix release
1567 ---------------
1568
1569 Fix error handling in python bindings
1570
1571   The python bindings in 0.11 failed to detect NULL pointers being
1572   returned from libnotmuch functions and thus failed to raise
1573   exceptions to indicate the error condition. Any subsequent calls
1574   into libnotmuch caused segmentation faults.
1575
1576 Quote MML tags in replies
1577
1578   MML tags are text codes that Emacs uses to indicate attachments
1579   (among other things) in messages being composed.  The Emacs
1580   interface did not quote MML tags in the quoted text of a reply.
1581   User could be tricked into replying to a maliciously formatted
1582   message and not editing out the MML tags from the quoted text.  This
1583   could lead to files from the user's machine being attached to the
1584   outgoing message.  The Emacs interface now quotes these tags in
1585   reply text, so that they do not effect outgoing messages.
1586
1587 Notmuch 0.11 (2012-01-13)
1588 =========================
1589
1590 Command-Line Interface
1591 ----------------------
1592
1593 Hooks
1594
1595   Hooks have been introduced to notmuch. Hooks are scripts that notmuch
1596   invokes before and after certain actions. Initially, `notmuch new`
1597   supports `pre-new` and `post-new` hooks that are run before and after
1598   importing new messages into the database.
1599
1600 `notmuch reply --decrypt bugfix`
1601
1602   The `notmuch reply` command with `--decrypt` argument had a rarely
1603   occurring bug that caused an encrypted message not to be decrypted
1604   sometimes. This is now fixed.
1605
1606 Performance
1607 -----------
1608
1609 Automatic tag query optimization
1610
1611   `notmuch tag` now automatically optimizes the user's query to
1612   exclude messages whose tags won't change.  In the past, we've
1613   suggested that people do this by hand; this is no longer necessary.
1614
1615 Don't sort messages when creating a dump file
1616
1617   This speeds up tag dumps considerably, without any loss of
1618   information. To replicate the old behavior of sorted output (for
1619   example to compare two dump files), one can use e.g. `sort(1)`.
1620
1621 Memory Management
1622 -----------------
1623
1624 Reduction of memory leaks
1625
1626   Two memory leaks when searching and showing messages were identified
1627   and fixed in this release.
1628
1629 Emacs Interface
1630 ---------------
1631
1632 Bug fixes
1633
1634   notmuch-show-advance (bound to the spacebar in notmuch-show-mode) had
1635   a bug that caused it to always jump to the next message, even if it
1636   should have scrolled down to show more of the current message instead.
1637   This is now fixed.
1638
1639 Support `notmuch new` as a notmuch-poll-script
1640
1641   It's now possible to use `notmuch new` as a notmuch-poll-script
1642   directly. This is also the new default. This allows taking better
1643   advantage of the `notmuch new` hooks from emacs without intermediate
1644   scripts.
1645
1646 Improvements in saved search management
1647
1648   New saved searches are now appended to the list of saved searches,
1649   not inserted in front. It's also possible to define a sort function
1650   for displaying saved searches; alphabetical sort is provided.
1651
1652 Hooks for notmuch-hello
1653
1654   Two new hooks have been added: "notmuch-hello-mode-hook" (called after
1655   entering notmuch-hello-mode) and "notmuch-hello-refresh-hook" (called
1656   after updating a notmuch-hello buffer).
1657
1658 New face for crypto parts headers
1659
1660   Crypto parts used to be displayed with a hardcoded color. A new face
1661   has been introduced to fix this: notmuch-crypto-part-header. It
1662   defaults to the same value as before, but can be customized to match
1663   other color themes.
1664
1665 Use space as default thousands separator
1666
1667   Large numbers in notmuch-hello are now displayed using a space as
1668   thousands separator (e.g. "123 456" instead of "123,456"). This can be
1669   changed by customizing "notmuch-hello-thousands-separator".
1670
1671 Call notmuch-show instead of notmuch-search when clicking on
1672 buttonized id: links
1673
1674 New function notmuch-show-advance
1675
1676   This new function advances through just the current thread, and is
1677   less invasive than notmuch-show-advance-and-archive.  It can easily
1678   be bound to SPC with:
1679
1680         (define-key notmuch-show-mode-map " " 'notmuch-show-advance)
1681
1682 Various performance improvements
1683
1684 New add-on tool
1685 ---------------
1686
1687 The tool `contrib/notmuch-deliver` helps with initial delivery and
1688 tagging of mail (replacing running `notmuch new`).
1689
1690
1691 Notmuch 0.10.2 (2011-12-04)
1692 ===========================
1693
1694 Bug-fix release
1695 ---------------
1696
1697 Fix crash in python bindings
1698
1699   The python bindings did not call `g_type_init`, which caused crashes
1700   for some, but not all users.
1701
1702 Notmuch 0.10.1 (2011-11-25)
1703 ===========================
1704
1705 Bug-fix release
1706 ---------------
1707
1708 Fix `--help` argument
1709
1710   Argument processing changes in 0.10 introduced a bug where
1711   `notmuch --help` crashed while `notmuch help` worked fine.
1712   This is fixed in 0.10.1.
1713
1714 Notmuch 0.10 (2011-11-23)
1715 =========================
1716
1717 New build and testing features
1718 ------------------------------
1719
1720 Emacs tests are now done in `dtach`. This means that dtach is now
1721 needed to run the notmuch test suite, at least until the checking for
1722 prerequisites is improved.
1723
1724 Full test coverage of the stashing feature in Emacs.
1725
1726 New command-line features
1727 -------------------------
1728
1729 Add `notmuch restore --accumulate` option
1730
1731   The `--accumulate` switch causes the union of the existing and new tags to
1732   be applied, instead of replacing each message's tags as they are read in
1733   from the dump file.
1734
1735 Add search terms to `notmuch dump`
1736
1737   The dump command now takes an optional search term much like notmuch
1738   search/show/tag. The output file argument of dump is deprecated in
1739   favour of using stdout.
1740
1741 Add `notmuch search` `--offset` and `--limit` options
1742
1743   The search command now takes options `--offset=[-]N` and `--limit=N` to
1744   limit the number of results shown.
1745
1746 Add `notmuch count --output` option
1747
1748   The count command is now capable of counting threads in addition to
1749   messages. This is selected using the new `--output=(threads|messages)`
1750   option.
1751
1752 New emacs UI features
1753 ---------------------
1754
1755 Add tab-completion for `notmuch-search` and `notmuch-search-filter`
1756
1757   These functions now support completion tags for query parts
1758   starting with "tag:".
1759
1760 Turn "id:MSG-ID" links into buttons associated with notmuch searches
1761
1762   Text of the form "id:MSG-ID" in mails is now a clickable button that
1763   opens a notmuch search for the given message id.
1764
1765 Add keybinding ('c I') for stashing Message-ID's without an id: prefix
1766
1767   Reduces manual labour when stashing them for use outside notmuch.
1768
1769 Do not query on `notmuch-search` exit
1770
1771   It is harmless to kill the external notmuch process, so the user
1772   is no longer interrogated when they interrupt a search.
1773
1774 Performance
1775 -----------
1776
1777 Emacs now constructs large search buffers more efficiently
1778
1779 Search avoids opening and parsing message files
1780
1781   We now store more information in the database so search no longer
1782   has to open every message file to get basic headers.  This can
1783   improve search speed by as much as 10X, but taking advantage of this
1784   requires a database rebuild:
1785
1786         notmuch dump > notmuch.dump
1787         # Backup, then remove notmuch database ($MAIL/.notmuch)
1788         notmuch new
1789         notmuch restore notmuch.dump
1790
1791 New collection of add-on tools
1792 ------------------------------
1793
1794 The source directory "contrib" contains tools built on notmuch.  These
1795 tools are not part of notmuch, and you should check their individual
1796 licenses.  Feel free to report problems with them to the notmuch
1797 mailing list.
1798
1799 nmbug - share tags with a given prefix
1800
1801   nmbug helps maintain a git repo containing all tags with a given
1802   prefix (by default "notmuch::"). Tags can be shared by commiting
1803   them to git in one location and restoring in another.
1804
1805 Notmuch 0.9 (2011-10-01)
1806 ========================
1807
1808 New, general features
1809 ---------------------
1810
1811 Correct handling of interruptions during `notmuch new`
1812
1813   `notmuch new` now operates as a series of small, self-consistent
1814   transactions, so it can correctly resume after an interruption or
1815   crash.  Previously, interruption could lose existing tags, fail to
1816   detect messages on resume, or leave the database in a state
1817   temporarily or permanently inconsistent with the mail store.
1818
1819 Library changes
1820 ---------------
1821
1822 New functions
1823
1824   `notmuch_database_begin_atomic` and `notmuch_database_end_atomic`
1825   allow multiple database operations to be performed atomically.
1826
1827   `notmuch_database_find_message_by_filename` does exactly what it says.
1828
1829 API changes
1830
1831   `notmuch_database_find_message` (and `n_d_f_m_by_filename`) now return
1832   a status indicator and uses an output parameter for the
1833   message. This change required changing the SONAME of libnotmuch to
1834   libnotmuch.so.2
1835
1836 Python bindings changes
1837 -----------------------
1838
1839   - Re-encode python unicode objects to utf-8 before passing back to
1840     libnotmuch.
1841   - Support `Database().begin_atomic()/end_atomic()`
1842   - Support `Database().find_message_by_filename()`
1843     NB! This needs a db opened in READ-WRITE mode currently, or it will crash
1844     the python process. The is a limitation (=bug) of the underlying libnotmuch.
1845   - Fixes where we would not throw NotmuchErrors when we should (Justus Winter)
1846   - Update for `n_d_find_message*` API changes (see above).
1847
1848 Ruby bindings changes
1849 ---------------------
1850
1851   - Wrap new library functions `notmuch_database_{begin,end}_atomic.`
1852   - Add new exception `Notmuch::UnbalancedAtomicError.`
1853   - Rename destroy to destroy! according to Ruby naming conventions.
1854   - Update for `n_d_find_message*` API changes (see above).
1855
1856 Emacs improvements
1857 ------------------
1858
1859   * Add gpg callback to crypto sigstatus buttons to retrieve/refresh
1860     signing key.
1861   * Add `notmuch-show-refresh-view` function (and corresponding binding)
1862     to refresh the view of a notmuch-show buffer.
1863
1864 Reply formatting cleanup
1865 ------------------------
1866
1867   `notmuch reply` no longer includes notification that non-leafnode
1868   MIME parts are being suppressed.
1869
1870 Notmuch 0.8 (2011-09-10)
1871 ========================
1872
1873 Improved handling of message/rfc822 parts
1874
1875   Both in the CLI and the emacs interface.  Output of rfc822 parts now
1876   includes the primary headers, as well as the body and all subparts.
1877   Output of the completely raw rfc822-formatted message, including all
1878   headers, is unfortunately not yet supported (but hopefully will be
1879   soon).
1880
1881 Improved Build system portability
1882
1883   Certain parts of the shell script generating notmuch.sym were
1884   specific to the GNU versions of sed and nm. The new version should
1885   be more portable to e.g. OpenBSD.
1886
1887 Documentation update for Ruby bindings
1888
1889   Added documentation, typo fixes, and improved support for rdoc.
1890
1891 Unicode, iterator, PEP8 changes for python bindings
1892
1893   - PEP8 (code formatting) changes for python files.
1894   - Remove `Tags.__len__` ; see 0.6 release notes for motivation.
1895   - Decode headers as UTF8, encode (unicode) database paths as UTF8.
1896
1897 Notmuch 0.7 (2011-08-01)
1898 ========================
1899
1900 Vim interface improvements
1901 --------------------------
1902
1903 Jason Woofenden provided a number of bug fixes for the Vim interface
1904
1905   * fix citation/signature fold lengths
1906   * fix cig/cit parsing within multipart/*
1907   * fix on-screen instructions for show-signature
1908   * fix from list reformatting in search view
1909   * fix space key: now archives (did opposite)
1910
1911 Uwe Kleine-König contributed
1912
1913   * use full path for sendmail/doc fix
1914   * fix compose temp file name
1915
1916 Python Bindings changes
1917 -----------------------
1918
1919 Sebastian Spaeth contributed two changes related to unicode and UTF8:
1920
1921   * message tags are now explicitly unicode
1922   * query string is encoded as a UTF8 byte string
1923
1924 Build-System improvements
1925 -------------------------
1926
1927 Generate notmuch.sym after the relevant object files
1928
1929   This fixes a bug in parallel building. Thanks to Thomas Jost for the
1930   patch.
1931
1932 Notmuch 0.6.1 (2011-07-17)
1933 ==========================
1934
1935 Bug-fix release
1936 ---------------
1937
1938 Re-export Xapian exception typeinfo symbols
1939
1940   It turned out our aggressive symbol hiding caused problems for
1941   people running gcc 4.4.5.
1942
1943 Notmuch 0.6 (2011-07-01)
1944 =======================
1945
1946 New, general features
1947 ---------------------
1948
1949 Folder-based searching
1950
1951   Notmuch queries can now include a search term to match the
1952   directories in which mail files are stored (within the mail
1953   storage). The syntax is as follows:
1954
1955         folder:<path>
1956
1957   For example, one might use things such as:
1958
1959         folder:spam
1960         folder:2011-*
1961         folder:work/todo
1962
1963   to match any path containing a directory "spam", "work/todo", or
1964   containing a directory starting with "2011-", respectively.
1965
1966   This feature is particularly useful for users of delivery-agent
1967   software (such as procmail or maildrop) that is filtering mail and
1968   delivering it to particular folders, or users of systems such as
1969   Gmail that use filesystem directories to indicate message tags.
1970
1971   NOTE: Only messages that are newly indexed with this version of
1972   notmuch will be searchable with folder: terms. In order to enable
1973   this feature for all mail, the entire notmuch index will need to be
1974   rebuilt as follows:
1975
1976         notmuch dump > notmuch.dump
1977         # Backup, then remove notmuch database ($MAIL/.notmuch)
1978         notmuch new
1979         notmuch restore notmuch.dump
1980
1981 Support for PGP/MIME
1982
1983   Both the command-line interface and the emacs-interface have new
1984   support for PGP/MIME, detailed below. Thanks to Daniel Kahn Gillmor
1985   and Jameson Graef Rollins for making this happen.
1986
1987 New, automatic tags: "signed" and "encrypted"
1988
1989   These tags will automatically be applied to messages containing
1990   multipart/signed and multipart/encrypted parts.
1991
1992   NOTE: Only messages that are newly indexed with this version of
1993   notmuch will receive these tags.
1994
1995 New command-line features
1996 -------------------------
1997
1998 Add new "notmuch show --verify" option for signature verification
1999
2000   This option instruct notmuch to verify the signature of
2001   PGP/MIME-signed parts.
2002
2003 Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options
2004
2005   This option instructs notmuch to decrypt PGP/MIME-encrypted parts.
2006   Note that this feature currently requires gpg-agent and a passphrase entry
2007   tool (e.g. pinentry-gtk or pinentry-curses).
2008
2009 Proper nesting of multipart parts in "notmuch show" output
2010
2011   MIME parts are now display with proper nesting to reflect original
2012   MIME hierarchy of a message. This allows clients to correctly
2013   analyze the MIME structure, (such as, for example, determining to
2014   which parts a signature part applies).
2015
2016 Add new "notmuch show --part" option
2017
2018   This is a replacement for the older "notmuch part" command, (which
2019   is now deprecated—it should still work as always, but is no longer
2020   documented). Putting part output under "notmuch show" allows for all
2021   of the "notmuch show" options to be applied when extracting a single
2022   part, (such as --format=json for extracting a message part with JSON
2023   formatting).
2024
2025 Deprecate "notmuch search-tags" (in favor of "notmuch search --output=tags *")
2026
2027   The "notmuch search-tags" sub-command has been redundant since the
2028   addition of the --output=tags option to "notmuch search". We now
2029   make that more clear by deprecating "notmuch search-tags", (dropping
2030   it from the documentation). We do continue to support the old syntax
2031   by translating it internally to the new call.
2032
2033 Performance improvements
2034 ------------------------
2035
2036 Faster searches (by doing fewer searches to construct threads)
2037
2038   Whenever a user asks for search results as threads, notmuch first
2039   performs a search for messages matching the query, then performs
2040   additional searches to find other messages in the resulting threads.
2041
2042   Removing inefficiencies and redundancies in these secondary searches
2043   results in a measured speedups of 1.5x for a typical search.
2044
2045 Faster searches (by doing fewer passes to gather message data)
2046
2047   Optimizing Xapian data access patterns (using a single pass to get
2048   all message-document data rather than a pass for each data type)
2049   results in a measured speedup of 1.7x for a typical search.
2050
2051   The benefits of this optimization combine with the preceding
2052   optimization. With both in place, Austin Clements measured a speedup
2053   of 2.5x for a search of all messages in his inbox (was 4.5s, now
2054   1.8s). Thanks, Austin!
2055
2056 Faster initial indexing
2057
2058   More efficient indexing of new messages results in a measured
2059   speedup of 1.4x for the initial indexing of 3 GB of mail (1h 14m
2060   rather than 1h 46m). Thanks to Austin Clements and Michal Sojka.
2061
2062 Make "notmuch new" faster for unchanged directories
2063
2064   Optimizing to not do any further examinations of sub-directories
2065   when the filesystem indicates that a directory is unchanged from the
2066   last "notmuch new" results in measured speedups of 8.5 for the "No
2067   new mail" case, (was 0.77s, now 0.09s). Thanks to Karel Zak.
2068
2069 New emacs-interface features
2070 ----------------------------
2071
2072 Support for PGP/MIME (GnuPG)
2073
2074   Automatically indicate validity of signatures for multipart/signed
2075   messages.  Automatically display decrypted content for
2076   multipart/encrypted messages.  See the emacs variable
2077   notmuch-crypto-process-mime for more information. Note that this
2078   needs gpg-agent and a pinentry tool just as the command-line tools.
2079   Also note there is no support SMIME yet.
2080
2081 Output of pipe command is now displayed if pipe command fails
2082
2083   This is extremely useful in the common use case of piping a patch to
2084   "git am". If git fails to cleanly merge the patch the error messages
2085   from the failed merge are now clearly displayed to the user, (where
2086   previously they were silently hidden from the user).
2087
2088 User-selectable From address
2089
2090   A user can choose which configured email addresses should be used as
2091   the From address whenever composing a new message. To do so, simply
2092   press C-u before the command which will open a new message. Emacs
2093   will prompt for the from address to use.
2094
2095   The user can customize the "Notmuch Identities" setting in the
2096   notmuch customize group in order to use addresses other than those in
2097   the notmuch configuration file if desired.
2098
2099   The user can also choose to always be prompted for the from address
2100   when composing a new message (without having to use C-u) by setting
2101   the "Notmuch Always Prompt For Sender" option in the notmuch
2102   customize group.
2103
2104 Hiding of repeated subjects in collapsed thread view
2105
2106   In notmuch-show mode, if a collapsed message has the same subject as
2107   its parent, the subject is not shown.
2108
2109 Automatic detection and hiding of original message in top-posted message
2110
2111   When a message contains a line looking something like:
2112
2113         ----- Original Message -----
2114
2115   emacs hides this and all subsequent lines as an "original message",
2116   (allowing the user to click or press enter on the "original message"
2117   button to display it again). This makes the handling of top-posted
2118   citations work much like conventional citations.
2119
2120 New hooks for running code when tags are modified
2121
2122   Some users want to perform additional actions whenever a particular
2123   tag is added/removed from a message. This could be used to, for
2124   example, interface with some external spam-recognition training
2125   tool. To facilitate this, two new hooks are added which can be
2126   modified in the following settings of the notmuch customize group:
2127
2128         Notmuch Before Tag Hook
2129         Notmuch After Tag Hook
2130
2131 New optional support for hiding some multipart/alternative parts
2132
2133   Many emails are sent with redundant content within a
2134   multipart/alternative group (such as a text/plain part as well as a
2135   text/html part). Users can configure the setting:
2136
2137         Notmuch Show All Multipart/Alternative Parts
2138
2139   to "off" in the notmuch customize group to have the interface
2140   automatically hide some part alternatives (such as text/html
2141   parts). This new part hiding is not configured by default yet
2142   because there's not yet a simple way to re-display such a hidden
2143   part if it is not actually redundant with a displayed part.
2144
2145 Better rendering of text/x-vcalendar parts
2146
2147   These parts are now displayed in a format suitable for use with the
2148   emacs diary.
2149
2150 Avoid getting confused by Subject and Author fields with newline characters
2151
2152   Replacing all characters with ASCII code less than 32 with a question mark.
2153
2154 Cleaner display of From line in email messages
2155
2156   Remove double quotes, and drop "name" if it's actually just a repeat of
2157   the email address.
2158
2159 Vim interface improvements
2160 --------------------------
2161
2162 Felipe Contreras provided a number of updates for the vim interface:
2163
2164   * Using sendmail directly rather than mailx,
2165   * Implementing archive in show view
2166   * Add support to mark as read in show and search views
2167   * Add delete commands
2168   * Various cleanups.
2169
2170 Bindings improvements
2171 ---------------------
2172
2173 Ruby bindings are now much more complete
2174
2175   Including `QUERY.sort`, `QUERY.to_s`, `MESSAGE.maildir_flags_to_tags`,
2176   `MESSAGE.tags_to_maildir_flags`, and `MESSAGE.get_filenames`
2177
2178 Python bindings have been updated and extended
2179
2180   (docs online at http://packages.python.org/notmuch/)
2181
2182   New bindings:
2183
2184   - `Message().get_filenames()`, `Message().tags_to_maildir_flags()`,
2185     `Message().maildir_flags_to_tags()`, `list(Threads())` and
2186     `list(Messages)` works now
2187   - `Message().__cmp__()` and `__hash__()`
2188
2189   These allow, for example:
2190
2191         if msg1 == msg2: ...
2192
2193   As well as set arithmetic on `Messages()`:
2194
2195         s1, s2 = set(msgs1), set(msgs2)
2196         s1.union(s2)
2197         s2 -= s1
2198
2199   Removed:
2200
2201   - `len(Messages())` as it exhausted the iterator
2202
2203   Use `len(list(Messages()))` or `Query.count_messages()`
2204   to get the length.
2205
2206 Added initial Go bindings in bindings/go
2207
2208 New build-system features
2209 -------------------------
2210
2211 Added support for building in a directory other than the source directory
2212
2213   This can be used with the widely-supported idiom of simply running
2214   the configure script from some other directory:
2215
2216         mkdir build
2217         cd build
2218         ../configure
2219         make
2220
2221 Fix to save configure options for future, implicit runs of configure
2222
2223   When a user updates the source (such as with "git pull") calling
2224   "make" may cause an automatic re-run of the configure script. When
2225   this happens, the configure script will automatically be called with
2226   the same options the user originally passed in the most-recent
2227   manual invocation of configure.
2228
2229 New test-suite feature
2230 ----------------------
2231
2232 Binary for bash for running test suite now located via PATH
2233
2234   The notmuch test suite requires a fairly recent version of bash (>=
2235   bash 4). As some systems supply an older version of bash at
2236   /bin/bash, the test suite is now updated to search $PATH to locate
2237   the bash binary. This allows users of systems with old /bin/bash to
2238   simply install bash >= 4 somewhere on $PATH before /bin and then use
2239   the test suite.
2240
2241 Support for testing output with a trailing newline
2242
2243   Previously, some tests would fail to notice a difference in the
2244   presence/absence of a trailing newline in a program output, (which
2245   has led to bugs in the past). Now, carefully-written tests (using
2246   `test_expect_equal_file` rather than `test_expect_equal`) will detect
2247   any change in the presence/absence of a trailing newline. Many tests
2248   are updated to take advantage of this.
2249
2250 Avoiding accessing user's $HOME while running test suite
2251
2252   The test suite now carefully creates its own HOME directory. This
2253   allows the test suite to be run with no existing HOME directory, (as
2254   some build systems apparently do), and avoids test-suite differences
2255   due to configuration files in the users HOME directory.
2256
2257
2258 General bug fixes
2259 -----------------
2260
2261 Output *all* files for "notmuch search --output=files"
2262
2263   For the cases where multiple files have the same Message ID,
2264   previous versions of notmuch would output only one such file. This
2265   command is now fixed to correctly output all files.
2266
2267 Fixed spurious search results from "overlapped" indexing of addresses
2268
2269   This fixed a bug where a search for:
2270
2271         to:user@elsewhere.com
2272
2273   would incorrectly match a message sent:
2274
2275         To: user@example,com, someone@elsewhere.com
2276
2277 Fix --output=json when search has no results
2278
2279   A bug present since notmuch 0.4 had caused searches with no results
2280   to produce an invalid json object. This is now fixed to cleanly
2281   return a valid json object representing an empty array "[]" as
2282   expected.
2283
2284 Fix the automatic detection of the From address for "notmuch reply"
2285 from the Received headers in some cases
2286
2287 Fix core dump on DragonFlyBSD due to -1 return value from
2288 `sysconf(_SC_GETPW_R_SIZE_MAX)`
2289
2290 Cleaned up several memory leaks
2291
2292 Eliminated a few, rare segmentation faults and a double-free
2293
2294 Fix libnotmuch library to only export notmuch API functions
2295
2296   Previous release of the notmuch library also exported some Xapian
2297   C++ exception type symbols. These were never part of the library
2298   interface and were never intended to be exported.
2299
2300 Emacs-interface bug fixes
2301 -------------------------
2302
2303 Display any unexpected output or errors from "notmuch search" invocations
2304
2305   Previously any misformatted output or trailing error messages were
2306   silently ignored. This output is now clearly displayed. This fix was
2307   very helpful in identifying and fixing the bug described below.
2308
2309 Fix bug where some threads would be missing from large search results
2310
2311   When a search returned a "large" number of results, the emacs
2312   interface was incorrectly dropping one thread every time the output
2313   of the "notmuch search" process spanned the emacs read-buffer. This
2314   is now fixed.
2315
2316 Avoid re-compression of .gz files (and similar) when saving attachment
2317
2318   Emacs was being too clever for its own good and trying to
2319   re-compress pre-compressed .gz files when saving such attachments
2320   (potentially corrupting the attachment). The emacs interface is
2321   fixed to avoid this bug.
2322
2323 Fix hiding of a message when a previously-hidden citation is visible
2324
2325   Previously the citation would remain visible in this case. This is
2326   fixed so that hiding a message hides all parts.
2327
2328 Notmuch 0.5 (2010-11-11)
2329 ========================
2330
2331 New, general features
2332 ---------------------
2333
2334 Maildir-flag synchronization
2335
2336   Notmuch now knows how to synchronize flags in maildir filenames with
2337   tags in the notmuch database. The following flag/tag mappings are
2338   supported:
2339
2340         Flag <-> Tag
2341         ----     -----
2342         'D'      draft
2343         'F'      flagged
2344         'P'      passed
2345         'R'      replied
2346         'S'      unread (added when 'S' flag is not present)
2347
2348   The synchronization occurs in both directions, (for example, adding
2349   the 'S' flag to a file will cause the "unread" tag to be added, and
2350   adding the "replied" tag to a message will cause the file to be
2351   renamed with an 'R' flag).
2352
2353   This synchronization is enabled by default for users of the
2354   command-line interface, (though only files in directories named
2355   "cur" or "new" will be renamed). It can be disabled by setting the
2356   new `maildir.synchronize_flags` option in the configuration file. For
2357   example:
2358
2359         notmuch config set maildir.synchronize_flags false
2360
2361   Users upgrading may also want to run "notmuch setup" once (just
2362   accept the existing configuration) to get a new, nicely-commented
2363   [maildir] section added to the configuration file.
2364
2365   For users of the notmuch library, the new synchronization
2366   functionality is available with the following two new functions:
2367
2368         notmuch_message_maildir_flags_to_tags
2369         notmuch_message_tags_to_maildir_flags
2370
2371   It is anticipated that future improvements to this support will
2372   allow for safe synchronization of the 'T' flag with the "deleted"
2373   tag, as well as support for custom flag/tag mappings.
2374
2375 New library features
2376 --------------------
2377
2378 Support for querying multiple filenames for a single message
2379
2380   It is common for the mailstore to contain multiple files with the
2381   same message ID. Previously, notmuch would always hide these
2382   duplicate files, (returning a single, arbitrary filename with
2383   `notmuch_message_get_filename`).
2384
2385   With this release, library users can access all filenames for a
2386   message with the new function:
2387
2388         notmuch_message_get_filenames
2389
2390   Together with `notmuch_filenames_valid`, `notmuch_filenames_get`,
2391   and `notmuch_filenames_move_to_next` it is now possible to iterate
2392   over all available filenames for a given message.
2393
2394 New command-line features
2395 -------------------------
2396
2397 New "notmuch show --format=raw" for getting at original email contents
2398
2399   This new feature allows for a fully-functional email client to be
2400   built on top of the notmuch command-line without needing any direct
2401   access to the mail store itself.
2402
2403   For example, it's now possible to run "emacs -f notmuch" on a local
2404   machine with only ssh access to the mail store/notmuch database. To
2405   do this, simply set the notmuch-command variable in emacs to the
2406   name of a script containing:
2407
2408         ssh user@host notmuch "$@"
2409
2410   If the ssh client has enabled connection sharing (ControlMaster
2411   option in OpenSSH), the emacs interface can be quite responsive this
2412   way.
2413
2414 General bug fixes
2415 -----------------
2416
2417 Fix "notmuch search" to print nothing when nothing matches
2418
2419   The 0.4 release had a bug in which:
2420
2421         notmuch search <expression-with-no-matches>
2422
2423   would produce a single blank line of output, (where previous
2424   versions would produce no output. This fix also causes a change in
2425   the --format=json output, (which would previously produce "[]" and
2426   now produces nothing).
2427
2428 Emacs interface improvements
2429 ----------------------------
2430
2431 Fix to allow pipe ('|') command to work when using notmuch over ssh
2432
2433 Fix count of lines in hidden signatures
2434
2435 Omit repeated subject lines in (collapsed) thread display
2436
2437 Display current thread subject in a header line
2438
2439 Provide a "c i" binding to copy a thread ID from the search view
2440
2441 Allow for notmuch-fcc-dirs to have a value of nil
2442
2443   Also, the more complex form of notmuch-fcc-dirs now has a slightly
2444   different format. It no longer has a special first-element, fallback
2445   string. Instead it's now a list of cons cells where the car of each
2446   cell is a regular expression to be matched against the sender
2447   address, and the cdr is the name of a folder to use for an FCC. So
2448   the old fallback behavior can be achieved by including a final cell
2449   of (".*" . "default-fcc-folder").
2450
2451 Vim interface improvements
2452 --------------------------
2453
2454 Felipe Contreras provided a number of updates for the vim interface
2455
2456   These include optimizations, support for newer versions of vim, fixed
2457   support for sending mail on modern systems, new commands, and
2458   various cleanups.
2459
2460 New bindings
2461 ------------
2462
2463 Added initial ruby bindings in bindings/ruby
2464
2465 Notmuch 0.4 (2010-11-01)
2466 ========================
2467
2468 New command-line features
2469 -------------------------
2470
2471 `notmuch search --output=(summary|threads|messages|tags|files)`
2472
2473   This new option allows for particular items to be returned from
2474   notmuch searches. The "summary" option is the default and behaves
2475   just as "notmuch search" has historically behaved.
2476
2477   The new option values allow for thread IDs, message IDs, lists of
2478   tags, and lists of filenames to be returned from searches. It is
2479   expected that this new option will be very useful in shell
2480   scripts. For example:
2481
2482         for file in $(notmuch search --output=files <search-terms>); do
2483                 <operations-on> "$file"
2484         done
2485
2486 `notmuch show --format=mbox <search-specification>`
2487
2488   This new option allows for the messages matching a search
2489   specification to be presented as an mbox. Specifically the "mboxrd"
2490   format is used which allows for reversible quoting of lines
2491   beginning with "From ". A reader should remove a single '>' from the
2492   beginning of all lines beginning with one or more '>' characters
2493   followed by the 5 characters "From ".
2494
2495 `notmuch config [get|set] <section>.<item> [value ...]`
2496
2497   The new top-level "config" command allows for any value in the
2498   notmuch configuration file to be queried or set to a new value. Both
2499   single-valued and multi-valued items are supported, as our any
2500   custom items stored in the configuration file.
2501
2502 Avoid setting Bcc header in "notmuch reply"
2503
2504   We decided that this was a bit heavy-handed as the actual mail
2505   user-agent should be responsible for setting any Bcc option. Also,
2506   see below for the notmuch/emacs user-agent now setting an Fcc by
2507   default rather than Bcc.
2508
2509 New library features
2510 --------------------
2511
2512 Add `notmuch_query_get_query_string` and `notmuch_query_get_sort`
2513
2514   These are simply functions for querying properties of a
2515   `notmuch_query_t` object.
2516
2517 New emacs features
2518 ------------------
2519
2520 Enable Fcc of all sent messages by default (to "sent" directory)
2521
2522   All messages sent from the emacs interface will now be saved to the
2523   notmuch mail store where they will be incorporated to the database
2524   by the next "notmuch new". By default, messages are saved to the
2525   "sent" directory at the top-level of the mail store. This directory
2526   can be customized by means of the "Notmuch Fcc Dirs" option in the
2527   notmuch customize interface.
2528
2529 Ability to all open messages in a thread to a pipe
2530
2531   Historically, the '|' keybinding allows for piping a single message
2532   to an external command. Now, by prefixing this key with a prefix
2533   argument, (for example, by pressing "Control-U |"), all open
2534   messages in the current thread will be sent to the external command.
2535
2536 Optional support for detecting inline patches
2537
2538   This hook is disabled by default but can be enabled with a checkbox
2539   under "Notmuch Show Insert Text/Plain Hook" in the notmuch customize
2540   interface. It allows for inline patches to be detected and treated
2541   as if they were attachments, (with context-sensitive highlighting).
2542
2543 Automatically tag messages as "replied" when sending a reply
2544
2545   Messages replied to within the emacs interface will now be tagged as
2546   "replied". This feature can easily be customized to add or remove
2547   other tags as well. For example, a user might use a tag of
2548   "needs-reply" and can configure this feature to automatically remove
2549   that tag when replying. See "Notmuch Message Mark Replied" in the
2550   notmuch customize interface.
2551
2552 Allow search-result color specifications to overlay each other
2553
2554   For example, one tag can specify the background color of matching
2555   lines, while another can specify the foreground. With this change,
2556   both settings will now be visible simultaneously, (which was not the
2557   case in previous releases). See "Notmuch Search Line Faces" in the
2558   notmuch customize interface.
2559
2560 Make hidden author names still available for incremental search
2561
2562   When there is insufficient space to display all authors of a thread
2563   in search results, the names of hidden authors are now still made
2564   available to emacs' incremental search commands. As the user
2565   searches, matching lines will temporarily expand to show the hidden
2566   names.
2567
2568 New binding of Control-TAB (works like TAB in reverse)
2569
2570   Many notmuch nodes already use TAB to navigate forward through
2571   various items allowing actions, (message headers, email attachments,
2572   etc.). The new Control-TAB binding operates similarly but in the
2573   opposite direction.
2574
2575 New build-system features
2576 -------------------------
2577
2578 Various portability fixes have been applied
2579
2580   These include fixes for build failures on at least Solaris, FreeBSD,
2581   and Fedora systems. We're hopeful that the notmuch code base is now
2582   more portable than ever before.
2583
2584 Arrange for libnotmuch to be found automatically after make install
2585
2586   The notmuch build system is now careful to help the user avoid
2587   errors of the form "libnotmuch.so could not be found" immediately
2588   after installing. This support takes two forms:
2589
2590   1. If the library is installed to a system directory,
2591      (configured in /etc/ld.so.conf), then "make install" will
2592      automatically run ldconfig.
2593
2594   2. If the library is installed to a non-system directory, the
2595      build system adds a `DR_RUNPATH` entry to the final binary
2596      pointing to the directory to which the library is installed.
2597
2598   When this support works, the user should be able to run notmuch
2599   immediately after "make install", without any errors trying to find
2600   the notmuch library, and without having to manually set environment
2601   variables such as `LD_LIBRARY_PATH`.
2602
2603 Check compiler/linker options before using them
2604
2605   The configure script now carefully checks that any desired
2606   compilation options, (whether for enabling compiler warnings, or for
2607   embedding rpath, etc.), are supported. Only supported options are
2608   used in the resulting Makefile.
2609
2610 New test-suite features
2611 -----------------------
2612
2613 New modularization of test suite
2614
2615   Thanks to a gracious relicensing of the test-suite infrastructure
2616   from the git project, notmuch now has a modular test suite. This
2617   provides the ability to run individual sections of the test suite
2618   rather than the whole things. It also provides better summary of
2619   test results, with support for tests that are expected to fail
2620   (BROKEN and FIXED) in addition to PASS and FAIL. Finally, it makes
2621   it easy to run the test suite within valgrind (pass --valgrind to
2622   notmuch-test or to any sub-script) which has been very useful.
2623
2624 New testing of emacs interface
2625
2626   The test suite has been augmented to allow automated testing of the
2627   emacs interfaces. So far, this includes basic searches, display of
2628   threads, and tag manipulation. This also includes a test that a new
2629   message can successfully be sent out through a (dummy) SMTP server
2630   and that said message is successfully integrated into the notmuch
2631   database via the FCC setting.
2632
2633 General bug fixes
2634 -----------------
2635
2636 Fix potential corruption of database when "notmuch new" is interrupted
2637
2638   Previously, an interruption of "notmuch new" would (rarely) result
2639   in a corrupt database. The corruption would manifest itself by a
2640   persistent error of the form:
2641
2642         document ID of 1234 has no thread ID
2643
2644   The message-adding code has been carefully audited and reworked to
2645   avoid this sort of corruption regardless of when it is interrupted.
2646
2647 Fix failure with extremely long message ID headers
2648
2649   Previously, a message with an extremely long message ID, (say, more
2650   than 300 characters), would fail to be added to notmuch, (triggering
2651   Xapian exceptions). This has now been fixed.
2652
2653 Fix for messages with "charset=unknown-8bit"
2654
2655   Previously, messages with this charset would cause notmuch to emit a
2656   GMime warning, (which would then trip up emacs or other interfaces
2657   parsing the notmuch results).
2658
2659 Fix `notmuch_query_search_threads` function to return NULL on any exception
2660
2661 Fix "notmuch search" to return non-zero if `notmuch_query_search_threads`
2662 fails
2663
2664   Previously, this command could confusingly report a Xapian
2665   exception, yet still return an error code of 0. It now correctly
2666   returns a failing error code of 1 in this case.
2667
2668 Emacs bug fixes
2669 ---------------
2670
2671 Fix to handle a message with a subject containing, for example "[1234]"
2672
2673   Previously, a message subject containing a sequence of digits within
2674   square brackets would cause the emacs interface to mis-parse the
2675   output of "notmuch search". This would result in the message being
2676   mis-displayed and prevent the user from manipulating the message in
2677   the emacs interface.
2678
2679 Fix to correctly handle message IDs containing ".."
2680
2681   The emacs interface now properly quotes message IDs to avoid a
2682   Xapian bug in which the ".." within a message ID would be
2683   misinterpreted as a numeric range specification.
2684
2685 Python-binding fixes
2686 --------------------
2687
2688 The python bindings for notmuch have been updated to work with python3.
2689
2690 Debian-specific fixes
2691 ---------------------
2692
2693 Fix emacs initialization so "M-x notmuch" works for users by default
2694
2695   Now, a new Debian user can immediately run "emacs -f notmuch" after
2696   "apt-get install notmuch". Previously, the user would have had to
2697   edit the ~/.emacs file to add "(require 'notmuch)" before this would
2698   work.
2699
2700 Notmuch 0.3.1 (2010-04-27)
2701 ==========================
2702
2703 General bug fixes
2704 -----------------
2705
2706 Fix an infinite loop in "notmuch reply"
2707
2708   This bug could be triggered by replying to a message where the
2709   user's primary email address did not appear in the To: header and
2710   the user had not configured any secondary email addresses. The bug
2711   was a simple re-use of the same iterator variable in nested loops.
2712
2713 Fix a potential SEGV in "notmuch search"
2714
2715   This bug could be triggered by an author name ending in a ','.
2716   Admittedly - that's almost certainly a spam email, but we never
2717   want notmuch to crash.
2718
2719 Emacs bug fixes
2720 ---------------
2721
2722 Fix calculations for line wrapping in the primary "notmuch" view
2723
2724 Fix Fcc support to prompt to create a directory if the specified Fcc
2725 directory does not exist
2726
2727 Build fix
2728 ---------
2729
2730 Fix build on OpenSolaris (at least) due to missing 'extern "C"' block
2731
2732   Without this, the C++ sources could not find strcasestr and the
2733   final linking of notmuch would fail.
2734
2735 Notmuch 0.3 (2010-04-27)
2736 ========================
2737
2738 New command-line features
2739 -------------------------
2740
2741 User-configurable tags for new messages
2742
2743   A new "new.tags" option is available in the configuration file to
2744   determine which tags are applied to new messages. Run "notmuch
2745   setup" to generate new documentation within ~/.notmuch-config on how
2746   to specify this value.
2747
2748 Threads search results named based on subjects that match search
2749
2750   This means that when new mails arrived to a thread you've previously
2751   read, and the new mails have a new subject, you will see that
2752   subject in the search results rather than the old subject.
2753
2754 Faster operation of "notmuch tag" (avoid unneeded sorting)
2755
2756   Since the user just wants to tag all matching messages, we can make
2757   things perform a bit faster by avoiding the sort.
2758
2759 Even Better guessing of From: header for "notmuch reply"
2760
2761   Notmuch now looks at a number of headers when trying to figure out
2762   the best From: header to use in a reply. This is helpful if you have
2763   several configured email addresses, and you also subscribe to various
2764   mailing lists with different addresses, (so that mails you are
2765   replying to won't always include your subscribed address in the To:
2766   header).
2767
2768 Indication of author names that match a search
2769
2770   When notmuch displays threads as the result of a search, it now
2771   lists the authors that match the search before listing the other
2772   authors in the thread. It inserts a pipe '|' symbol between the last
2773   matching and first non-matching author. This is especially useful in
2774   a search that includes tag:unread. Now the authors of the unread
2775   messages in the thread are listed first.
2776
2777 New: Python bindings
2778 --------------------
2779
2780 Sebastian Spaeth has contributed his python bindings for the notmuch
2781 library to the central repository. These bindings were previously
2782 known as "cnotmuch" within python but have now been renamed to be
2783 accessible with a simple, and more official-looking "import notmuch".
2784
2785 The bindings have already proven very useful as people proficient in
2786 python have been able to easily develop programs to do notmuch-based
2787 searches for email-address completion, maildir-flag synchronization,
2788 and other tasks.
2789
2790 These bindings are available within the bindings/python directory, but
2791 are not yet integrated into the top-level Makefiles, nor the top-level
2792 package-building scripts. Improvements are welcome.
2793
2794 Emacs interface improvements
2795 ----------------------------
2796
2797 An entirely new initial view for notmuch, (friendly yet powerful)
2798
2799   Some of us call the new view "notmuch hello" but you can get at it
2800   by simply calling "emacs -f notmuch". The new view provides a search
2801   bar where new searches can be performed. It also displays a list of
2802   recent searches, along with a button to save any of these, giving it
2803   a new name as a "saved search". Many people find these "saved
2804   searches" one of the most convenient ways of organizing their mail,
2805   (providing all of the features of "folders" in other mail clients,
2806   but without any of the disadvantages).
2807
2808   Finally, this view can also optionally display all of the tags that
2809   exist in the database, along with a count for each tag, and a custom
2810   search of messages with that tag that's simply a click (or keypress)
2811   away.
2812
2813   NOTE: For users that liked the original mode of "emacs -f notmuch"
2814   immediately displaying a particular search result, we recommend
2815   instead running something like:
2816
2817         emacs --eval '(notmuch search "tag:inbox" t)'
2818
2819   The "t" means to sort the messages in an "oldest first" order,
2820   (as notmuch would do previously by default). You can also
2821   leave that off to have your search results in "newest first"
2822   order.
2823
2824 Full-featured "customize" support for configuring notmuch
2825
2826   Notmuch now plugs in well to the emacs "customize" mode to make it
2827   much simpler to find things about the notmuch interface that can be
2828   tweaked by the user.
2829
2830   You can get to this mode by starting at the main "Customize" menu in
2831   emacs, then browsing through "Applications", "Mail", and
2832   "Notmuch". Or you can go straight to "M-x customize-group"
2833   "notmuch".
2834
2835   Once you're at the customize screen, you'll see a list of documented
2836   options that can be manipulated along with checkboxes, drop-down
2837   selectors, and text-entry boxes for configuring the various
2838   settings.
2839
2840 Support for doing tab-completion of email addresses
2841
2842   This support currently relies on an external program,
2843   (notmuch-addresses), that is not yet shipped with notmuch
2844   itself. But multiple, suitable implementations of this program have
2845   already been written that generate address completions by doing
2846   notmuch searches of your email collection. For example, providing
2847   first those addresses that you have composed messages to in the
2848   past, etc.
2849
2850   One such program (implemented in python with the python bindings to
2851   notmuch) is available via:
2852
2853         git clone  http://jkr.acm.jhu.edu/git/notmuch_addresses.git
2854
2855   Install that program as notmuch-addresses on your PATH, and then
2856   hitting TAB on a partial email address or name within the To: or Cc:
2857   line of an email message will provide matching completions.
2858
2859 Support for file-based (Fcc) delivery of sent messages to mail store
2860
2861   This isn't yet enabled by default. To enable this, one will have to
2862   set the "Notmuch Fcc Dirs" setting within the notmuch customize
2863   screen, (see its documentation there for details). We anticipate
2864   making this automatic in a future release.
2865
2866 New 'G' key binding to trigger mail refresh (G == "Get new mail")
2867
2868   The 'G' key works wherever '=' works. Before refreshing the screen
2869   it calls an external program that can be used to poll email servers,
2870   run notmuch new and set up specific tags for the new emails. The
2871   script to be called should be configured with the "Notmuch Poll
2872   Script" setting in the customize interface. This script will
2873   typically invoke "notmuch new" and then perhaps several "notmuch
2874   tag" commands.
2875
2876 Implement emacs message display with the JSON output from notmuch
2877
2878   This is much more robust than the previous implementation, (where
2879   some HTML mails and mail quoting the notmuch code with the delimiter
2880   characters in it would cause the parser to fall over).
2881
2882 Better handling of HTML messages and MIME attachments (inline images!)
2883
2884   Allow for any MIME parts that emacs can display to be displayed
2885   inline. This includes inline viewing of image attachments, (provided
2886   the window is large enough to fit the image at its natural size).
2887
2888   Much more robust handling of HTML messages. Currently both text/plain
2889   and text/html alternates will be rendered next to each other. In a
2890   future release, users will be able to decide to see only one or the
2891   other representation.
2892
2893   Each attachment now has its own button so that attachments can be
2894   saved individually (the 'w' key is still available to save all
2895   attachments).
2896
2897 Customizable support for tidying of text/plain message content
2898
2899   Many new functions are available for tidying up message
2900   content. These include options such as wrapping long lines,
2901   compressing duplicate blank lines, etc.
2902
2903   Most of these are disabled by default, but can easily be enabled by
2904   clicking the available check boxes under the "Notmuch Show Insert
2905   Text/Plain Hook" within the notmuch customize screen.
2906
2907 New support for searchable citations (even when hidden)
2908
2909   When portions of overly-long citations are hidden, the contents of
2910   these citations will still be available for emacs' standard
2911   "incremental search" functions. When the search matches any portion
2912   of a hidden citation, the citation will become visible temporarily
2913   to display the search result.
2914
2915 More flexible handling of header visibility
2916
2917   As an answer to complaints from many users, the To, Cc, and Date
2918   headers of messages are no longer hidden by default. For those users
2919   that liked that these were hidden, a new "Notmuch Messages Headers
2920   Visible" option in the customize interface can be set to nil. The
2921   visibility of headers can still be toggled on a per-message basis
2922   with the 'h' keybinding.
2923
2924   For users that don't want to see some subset of those headers, the
2925   new "Notmuch Message Headers" variable can be customized to list
2926   only those headers that should be present in the display of a message.
2927
2928 The Return key now toggles message visibility anywhere
2929
2930   Previously this worked only on the first summary-line of a message.
2931
2932 Customizable formatting of search results
2933
2934   The user can easily customize the order, width, and formatting of
2935   the various fields in a "notmuch search" buffer. See the "Notmuch
2936   Search Result Format" section of the customize interface.
2937
2938 Generate nicer names for search buffers when using a saved search
2939
2940 Add a notmuch User-Agent header when sending mail from notmuch/emacs
2941
2942 New keybinding (M-Ret) to open all collapsed messages in a thread
2943
2944 New library feature
2945 -------------------
2946
2947 Provide a new `NOTMUCH_SORT_UNSORTED` value for queries
2948
2949   This can be somewhat faster when sorting simply isn't desired. For
2950   example when collecting a set of messages that will all be
2951   manipulated identically, (adding a tag, removing a tag, deleting the
2952   messages), then there's no advantage to sorting the messages by
2953   date.
2954
2955 Build fixes
2956 -----------
2957
2958 Fix to compile against GMime 2.6
2959
2960   Previously notmuch insisted on being able to find GMime 2.4, (even
2961   though GMime 2.6 would have worked all along).
2962
2963 Fix configure script to accept (and ignore) various standard options
2964
2965   For example, those that the Gentoo build scripts expect configure to
2966   accept are now all accepted.
2967
2968 Test suite
2969 ----------
2970
2971 A large number of new tests for the many new features
2972
2973 Better display of output from failed tests
2974
2975   Now shows failures with diff rather than forcing the user to gaze at
2976   complete actual and expected output looking for deviation.
2977
2978 Notmuch 0.2 (2010-04-16)
2979 ========================
2980
2981 This is the second release of the notmuch mail system, with actual
2982 detailed release notes this time!
2983
2984 This release consists of a number of minor new features that make
2985 notmuch more pleasant to use, and a few fairly major bug fixes.
2986
2987 We didn't quite hit our release target of "about a week" from the 0.1
2988 release, (0.2 is happening 11 days after 0.1), but we hope to do
2989 better for next week. Look forward to some major features coming to
2990 notmuch in subsequent releases.
2991
2992 -Carl
2993
2994 General features
2995 ----------------
2996
2997 Better guessing of From: header
2998
2999   Notmuch now tries harder to guess which configured address should be
3000   used as the From: line in a "notmuch reply". It will examine the
3001   Received: headers if it fails to find any configured address in To:
3002   or Cc:. This allows it to often choose the correct address even when
3003   replying to a message sent to a mailing list, and not directly to a
3004   configured address.
3005
3006 Make "notmuch count" with no arguments count all messages
3007
3008   Previously, it was hard to construct a search term that was
3009   guaranteed to match all messages.
3010
3011 Provide a new special-case search term of "*" to match all messages
3012
3013   This can be used in any command accepting a search term, such as
3014   "notmuch search '*'". Note that you'll want to take care that the
3015   shell doesn't expand * against the current files. And note that the
3016   support for "*" is a special case. It's only meaningful as a single
3017   search term and loses its special meaning when combined with any
3018   other search terms.
3019
3020 Automatically detect thread connections even when a parent message is
3021 missing
3022
3023   Previously, if two or more message were received with a common
3024   parent, but that parent was not received, then these messages would
3025   not be recognized as belonging to the same thread. This is now fixed
3026   so that such messages are properly connected in a thread.
3027
3028 General bug fixes
3029 -----------------
3030
3031 Fix potential data loss in "notmuch new" with SIGINT
3032
3033   One code path in "notmuch new" was not properly handling
3034   SIGINT. Previously, this could lead to messages being removed from
3035   the database (and their tags being lost) if the user pressed
3036   Control-C while "notmuch new" was working.
3037
3038 Fix segfault when a message includes a MIME part that is empty
3039
3040 Fix handling of non-ASCII characters with --format=json
3041
3042   Previously, characters outside the range of 7-bit ASCII were
3043   silently dropped from the JSON output. This led to corrupted display
3044   of utf-8 content in the upcoming notmuch web-based frontends.
3045
3046 Fix headers to be properly decoded in "notmuch reply"
3047
3048   Previously, the user might see:
3049
3050         Subject: Re: =?iso-8859-2?q?Rozlu=E8ka?=
3051
3052   rather than:
3053
3054         Subject: Re: Rozlučka
3055
3056   The former text is properly encoded to be RFC-compliant SMTP, will
3057   be sent correctly, and will be properly decoded by the
3058   recipient. But the user trying to edit the reply would likely be
3059   unable to read or edit that field in its encoded form.
3060
3061 Emacs client features
3062 ---------------------
3063
3064 Show the last few lines of citations as well as the first few lines
3065
3066   It's often the case that the last sentence of a citation is what is
3067   being replied to directly, so the last few lines are often much more
3068   important. The number of lines shown at the beginning and end of any
3069   citation can be configured, (notmuch-show-citation-lines-prefix and
3070   notmuch-show-citation-lines-suffix).
3071
3072 The '+' and '-' commands in the search view can now add and remove
3073 tags by region
3074
3075   Selective bulk tagging is now possible by selecting a region of
3076   threads and then using either the '+' or '-' keybindings. Bulk
3077   tagging is still available for all threads matching the current
3078   search with the '*' binding.
3079
3080 More meaningful buffer names for thread-view buffers
3081
3082   Notmuch now uses the Subject of the thread as the buffer
3083   name. Previously it was using the thread ID, which is a meaningless
3084   number to the user.
3085
3086 Provide for customized colors of threads in search view based on tags
3087
3088   See the documentation of notmuch-search-line-faces, (or us "M-x
3089   customize" and browse to the "notmuch" group within "Applications"
3090   and "Mail"), for details on how to configure this colorization.
3091
3092 Build-system features
3093 ---------------------
3094
3095 Add support to properly build libnotmuch on Darwin systems (OS X)
3096
3097 Add support to configure for many standard options
3098
3099   We include actual support for:
3100
3101         --includedir --mandir --sysconfdir
3102
3103   And accept and silently ignore several more:
3104
3105         --build --infodir --libexecdir --localstatedir
3106         --disable-maintainer-mode --disable-dependency-tracking
3107
3108 Install emacs client in "make install" rather than requiring a
3109 separate "make install-emacs"
3110
3111 Automatically compute versions numbers between releases
3112
3113   This support uses the git-describe notation, so a version such as
3114   0.1-144-g43cbbfc indicates a version that is 144 commits since the
3115   0.1 release and is available as git commit "43cbbfc".
3116
3117 Add a new "make test" target to run the test suite and actually
3118 verify its results
3119
3120 Notmuch 0.1 (2010-04-05)
3121 ========================
3122
3123 This is the first release of the notmuch mail system.
3124
3125 It includes the libnotmuch library, the notmuch command-line
3126 interface, and an emacs-based interface to notmuch.
3127
3128 Note: Notmuch will work best with Xapian 1.0.18 (or later) or Xapian
3129 1.1.4 (or later). Previous versions of Xapian (whether 1.0 or 1.1) had
3130 a performance bug that made notmuch very slow when modifying
3131 tags. This would cause distracting pauses when reading mail while
3132 notmuch would wait for Xapian when removing the "inbox" and "unread"
3133 tags from messages in a thread.
3134
3135
3136 <!--
3137  Local variables:
3138  mode: text
3139  tab-width: 8
3140  indent-tabs-mode: nil
3141  End:
3142  vi: sw=8 ts=8 et
3143 -->