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