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