c0cb3a28750d10ddc293ec114225caf83fc5dc40
[notmuch] / NEWS
1 Notmuch 0.13 (2012-xx-xx)
2 =========================
3
4 Command-Line Interface
5 ----------------------
6
7 Reply to sender
8
9   "notmuch reply" has gained the ability to create a reply template
10   for replying just to the sender of the message, in addition to reply
11   to all. The feature is available through the new command line option
12   --reply-to=(all|sender).
13
14 JSON reply format
15
16   "notmuch reply" can now produce JSON output that contains the headers
17   for a reply message and full information about the original message
18   begin replied to. This allows MUAs to create replies intelligtently.
19   For example, an MUA that can parse HTML might quote HTML parts.
20
21   Calling notmuch reply with --format=json imposes the restriction that
22   only a single message is returned by the search, as replying to
23   multiple messages does not have a well-defined behavior. The default
24   retains its current behavior for multiple message replies.
25
26 Tag exclusion
27
28   Tags can be automatically excluded from search results by adding them
29   to the new 'search.exclude_tags' option in the Notmuch config file.
30
31   This behaviour can be overridden by explicitly including an excluded
32   tag in your query, for example:
33
34     notmuch search $your_query and tag:$excluded_tag
35
36   Existing users will probably want to run "notmuch setup" again to add
37   the new well-commented [search] section to the configuration file.
38
39   For new configurations, accepting the default setting will cause the
40   tags "deleted" and "spam" to be excluded, equivalent to running:
41
42     notmuch config set search.exclude_tags deleted spam
43
44 Raw show format changes
45
46   The output of show --format=raw has changed for multipart and
47   message parts.  Previously, the output was a mash of somewhat-parsed
48   headers and transfer-decoded bodies.  Now, such parts are reproduced
49   faithfully from the original source.  Message parts (which includes
50   part 0) output the full message, including the message headers (but
51   not the transfer headers).  Multipart parts output the part as
52   encoded in the original message, including the part's headers.  Leaf
53   parts, as before, output the part's transfer-decoded body.
54
55 Listing configuration items
56
57   The new "config list" command prints out all configuration items and
58   their values.
59
60 Emacs Interface
61 ---------------
62
63 Reply improvement using the JSON format
64
65   Emacs now uses the JSON reply format to create replies. It obeys
66   the customization variables message-citation-line-format and
67   message-citation-line-function when creating the first line of the
68   reply body, and it will quote HTML parts if no text/plain parts are
69   available.
70
71 New add-on tool: notmuch-mutt
72 -----------------------------
73
74 The new contrib/ tool "notmuch-mutt" provides Notmuch integration for
75 the Mutt mail user agent. Using it, Mutt users can perform mail
76 search, thread reconstruction, and mail tagging/untagging without
77 leaving Mutt.  notmuch-mutt, formerly distributed under the name
78 "mutt-notmuch" by Stefano Zacchiroli, will be maintained as a notmuch
79 contrib/ from now on.
80
81 Library changes
82 ---------------
83
84 The function notmuch_database_close has been split into
85 notmuch_database_close and notmuch_database_destroy
86
87   This makes it possible for long running programs to close the xapian
88   database and thus release the lock associated with it without
89   destroying the data structures obtained from it.
90
91 notmuch_database_open and notmuch_database_create now return errors
92
93   The type signatures of notmuch_database_open and
94   notmuch_database_create have changed so that the functions now
95   return a notmuch_status_t and take an out-argument for returning the
96   new database object.
97
98 Notmuch 0.12 (2012-03-20)
99 =========================
100
101 Command-Line Interface
102 ----------------------
103
104 Reply to sender
105
106   `notmuch reply` has gained the ability to create a reply template
107   for replying just to the sender of the message, in addition to reply
108   to all. The feature is available through the new command line option
109   `--reply-to=(all|sender)`.
110
111 Mail store folder/file ignore
112
113   A new configuration option, `new.ignore`, lets users specify a
114   ;-separated list of file and directory names that will not be
115   searched for messages by `notmuch new`.
116
117   NOTE: *Every* file/directory that goes by one of those names will
118   be ignored, independent of its depth/location in the mail store.
119
120 Unified help and manual pages
121
122   The notmuch help command now runs man for the appropriate page.  If
123   you install notmuch somewhere "unusual", you may need to update
124   MANPATH.
125
126 Manual page for notmuch configuration options
127
128   The notmuch CLI configuration file options are now documented in the
129   notmuch-config(1) manual page in addition to the configuration file
130   itself.
131
132 Emacs Interface
133 ---------------
134
135 Reply to sender
136
137   The Emacs interface has, with the new CLI support, gained the
138   ability to reply to sender in addition to reply to all. In both show
139   and search modes, 'r' has been bound to reply to sender, replacing
140   reply to all, which now has key binding 'R'.
141
142 More flexible and consistent tagging operations
143
144   All tagging operations ('+', '-', '*') now accept multiple tags with
145   '+' or '-' prefix, like '*' operation in notmuch-search view before.
146
147   '*' operation (`notmuch-show-tag-all`) is now available in
148   notmuch-show view.
149
150   `notmuch-show-{add,remove}-tag` functions no longer accept tag
151   argument, `notmuch-show-tag-message` should be used instead.  Custom
152   bindings using these functions should be updated, e.g.:
153
154         (notmuch-show-remove-tag "unread")
155
156   should be changed to:
157
158         (notmuch-show-tag-message "-unread")
159
160 Refreshing the show view ('=' by default) no longer opens or closes messages
161
162   To get the old behavior of putting messages back in their initial
163   opened/closed state, use a prefix argument, e.g., 'C-u ='.
164
165 Attachment buttons can be used to view or save attachments.
166
167   When the cursor is on an attachment button the key 's' can be used
168   to save the attachment, the key 'v' to view the attachment in the
169   default mailcap application, and the key 'o' prompts the user for an
170   application to use to open the attachment. By default Enter or mouse
171   button 1 saves the attachment but this is customisable (option
172   Notmuch Show Part Button Default Action).
173
174 New functions
175
176   `notmuch-show-stash-mlarchive-link{,-and-go}` allow stashing and
177   optionally visiting a URI to the current message at one of a number
178   of Mailing List Archives.
179
180 Fix MML tag quoting in replies
181
182   The MML tag quoting fix of 0.11.1 unintentionally quoted tags
183   inserted in `message-setup-hook`. Quoting is now limited to the
184   cited message.
185
186 Show view archiving key binding changes
187
188   The show view archiving key bindings 'a' and 'x' now remove the
189   "inbox" tag from the current message only (instead of thread), and
190   move to the next message. At the last message, 'a' proceeds to the
191   next thread in search results, and 'x' returns to search
192   results. The thread archiving functions are now available in 'A' and
193   'X'.
194
195 Support text/calendar MIME type
196
197   The text/calendar MIME type is now supported in addition to
198   text/x-vcalendar.
199
200 Generate inline patch fake attachment file names from message subject
201
202   Use the message subject to generate file names for the inline patch
203   fake attachments. The names are now similar to the ones generated by
204   'git format-patch' instead of just "inline patch". See "Notmuch Show
205   Insert Text/Plain Hook" in the notmuch customize interface.
206
207 Enable `notmuch-search-line-faces` by default
208
209   Make the `notmuch-search-line-faces` functionality more discoverable
210   for new users by showing "unread" messages bold and "flagged"
211   messages blue by default in the search view.
212
213 Printing Support
214
215   notmuch-show mode now has simple printing support, bound to '#' by
216   default. You can customize the variable notmuch-print-mechanism.
217
218 Library changes
219 ---------------
220
221 New functions
222
223   `notmuch_query_add_tag_exclude` supports the new tag exclusion
224   feature.
225
226 Python bindings changes
227 -----------------------
228
229 Python 3.2 compatibility
230
231   The python bindings are now compatible with both python 2.5+ and 3.2.
232
233 Added missing unicode conversions
234
235   Python strings have to be encoded to and decoded from utf-8 when
236   calling libnotmuch functions. Porting the bindings to python 3.2
237   revealed a few function calls that were missing these conversions.
238
239 Build fixes
240 -----------
241
242 Compatibility with GMime 2.6
243
244   It is now possible to build notmuch against both GMime 2.4 and 2.6.
245   However, a bug in GMime 2.6 before 2.6.5 causes notmuch not to
246   report signatures where the signer key is unavailable (GNOME bug
247   668085).  For compatibility with GMime 2.4's tolerance of "From "
248   headers we require GMime 2.6 >= 2.6.7.
249
250 Notmuch 0.11.1 (2012-02-03)
251 ===========================
252
253 Bug-fix release
254 ---------------
255
256 Fix error handling in python bindings
257
258   The python bindings in 0.11 failed to detect NULL pointers being
259   returned from libnotmuch functions and thus failed to raise
260   exceptions to indicate the error condition. Any subsequent calls
261   into libnotmuch caused segmentation faults.
262
263 Quote MML tags in replies
264
265   MML tags are text codes that Emacs uses to indicate attachments
266   (among other things) in messages being composed.  The Emacs
267   interface did not quote MML tags in the quoted text of a reply.
268   User could be tricked into replying to a maliciously formatted
269   message and not editing out the MML tags from the quoted text.  This
270   could lead to files from the user's machine being attached to the
271   outgoing message.  The Emacs interface now quotes these tags in
272   reply text, so that they do not effect outgoing messages.
273
274 Notmuch 0.11 (2012-01-13)
275 =========================
276
277 Command-Line Interface
278 ----------------------
279
280 Hooks
281
282   Hooks have been introduced to notmuch. Hooks are scripts that notmuch
283   invokes before and after certain actions. Initially, `notmuch new`
284   supports `pre-new` and `post-new` hooks that are run before and after
285   importing new messages into the database.
286
287 `notmuch reply --decrypt bugfix`
288
289   The `notmuch reply` command with `--decrypt` argument had a rarely
290   occurring bug that caused an encrypted message not to be decrypted
291   sometimes. This is now fixed.
292
293 Performance
294 -----------
295
296 Automatic tag query optimization
297
298   `notmuch tag` now automatically optimizes the user's query to
299   exclude messages whose tags won't change.  In the past, we've
300   suggested that people do this by hand; this is no longer necessary.
301
302 Don't sort messages when creating a dump file
303
304   This speeds up tag dumps considerably, without any loss of
305   information. To replicate the old behavior of sorted output (for
306   example to compare two dump files), one can use e.g. `sort(1)`.
307
308 Memory Management
309 -----------------
310
311 Reduction of memory leaks
312
313   Two memory leaks when searching and showing messages were identified
314   and fixed in this release.
315
316 Emacs Interface
317 ---------------
318
319 Bug fixes
320
321   notmuch-show-advance (bound to the spacebar in notmuch-show-mode) had
322   a bug that caused it to always jump to the next message, even if it
323   should have scrolled down to show more of the current message instead.
324   This is now fixed.
325
326 Support `notmuch new` as a notmuch-poll-script
327
328   It's now possible to use `notmuch new` as a notmuch-poll-script
329   directly. This is also the new default. This allows taking better
330   advantage of the `notmuch new` hooks from emacs without intermediate
331   scripts.
332
333 Improvements in saved search management
334
335   New saved searches are now appended to the list of saved searches,
336   not inserted in front. It's also possible to define a sort function
337   for displaying saved searches; alphabetical sort is provided.
338
339 Hooks for notmuch-hello
340
341   Two new hooks have been added: "notmuch-hello-mode-hook" (called after
342   entering notmuch-hello-mode) and "notmuch-hello-refresh-hook" (called
343   after updating a notmuch-hello buffer).
344
345 New face for crypto parts headers
346
347   Crypto parts used to be displayed with a hardcoded color. A new face
348   has been introduced to fix this: notmuch-crypto-part-header. It
349   defaults to the same value as before, but can be customized to match
350   other color themes.
351
352 Use space as default thousands separator
353
354   Large numbers in notmuch-hello are now displayed using a space as
355   thousands separator (e.g. "123 456" instead of "123,456"). This can be
356   changed by customizing "notmuch-hello-thousands-separator".
357
358 Call notmuch-show instead of notmuch-search when clicking on
359 buttonized id: links
360
361 New function notmuch-show-advance
362
363   This new function advances through just the current thread, and is
364   less invasive than notmuch-show-advance-and-archive.  It can easily
365   be bound to SPC with:
366
367         (define-key notmuch-show-mode-map " " 'notmuch-show-advance)
368
369 Various performance improvements
370
371 New add-on tool
372 ---------------
373
374 The tool `contrib/notmuch-deliver` helps with initial delivery and
375 tagging of mail (replacing running `notmuch new`).
376
377
378 Notmuch 0.10.2 (2011-12-04)
379 ===========================
380
381 Bug-fix release
382 ---------------
383
384 Fix crash in python bindings
385
386   The python bindings did not call `g_type_init`, which caused crashes
387   for some, but not all users.
388
389 Notmuch 0.10.1 (2011-11-25)
390 ===========================
391
392 Bug-fix release
393 ---------------
394
395 Fix `--help` argument
396
397   Argument processing changes in 0.10 introduced a bug where
398   `notmuch --help` crashed while `notmuch help` worked fine.
399   This is fixed in 0.10.1.
400
401 Notmuch 0.10 (2011-11-23)
402 =========================
403
404 New build and testing features
405 ------------------------------
406
407 Emacs tests are now done in `dtach`. This means that dtach is now
408 needed to run the notmuch test suite, at least until the checking for
409 prerequisites is improved.
410
411 Full test coverage of the stashing feature in Emacs.
412
413 New command-line features
414 -------------------------
415
416 Add `notmuch restore --accumulate` option
417
418   The `--accumulate` switch causes the union of the existing and new tags to
419   be applied, instead of replacing each message's tags as they are read in
420   from the dump file.
421
422 Add search terms to `notmuch dump`
423
424   The dump command now takes an optional search term much like notmuch
425   search/show/tag. The output file argument of dump is deprecated in
426   favour of using stdout.
427
428 Add `notmuch search` `--offset` and `--limit` options
429
430   The search command now takes options `--offset=[-]N` and `--limit=N` to
431   limit the number of results shown.
432
433 Add `notmuch count --output` option
434
435   The count command is now capable of counting threads in addition to
436   messages. This is selected using the new `--output=(threads|messages)`
437   option.
438
439 New emacs UI features
440 ---------------------
441
442 Add tab-completion for `notmuch-search` and `notmuch-search-filter`
443
444   These functions now support completion tags for query parts
445   starting with "tag:".
446
447 Turn "id:MSG-ID" links into buttons associated with notmuch searches
448
449   Text of the form "id:MSG-ID" in mails is now a clickable button that
450   opens a notmuch search for the given message id.
451
452 Add keybinding ('c I') for stashing Message-ID's without an id: prefix
453
454   Reduces manual labour when stashing them for use outside notmuch.
455
456 Do not query on `notmuch-search` exit
457
458   It is harmless to kill the external notmuch process, so the user
459   is no longer interrogated when they interrupt a search.
460
461 Performance
462 -----------
463
464 Emacs now constructs large search buffers more efficiently
465
466 Search avoids opening and parsing message files
467
468   We now store more information in the database so search no longer
469   has to open every message file to get basic headers.  This can
470   improve search speed by as much as 10X, but taking advantage of this
471   requires a database rebuild:
472
473         notmuch dump > notmuch.dump
474         # Backup, then remove notmuch database ($MAIL/.notmuch)
475         notmuch new
476         notmuch restore notmuch.dump
477
478 New collection of add-on tools
479 ------------------------------
480
481 The source directory "contrib" contains tools built on notmuch.  These
482 tools are not part of notmuch, and you should check their individual
483 licenses.  Feel free to report problems with them to the notmuch
484 mailing list.
485
486 nmbug - share tags with a given prefix
487
488   nmbug helps maintain a git repo containing all tags with a given
489   prefix (by default "notmuch::"). Tags can be shared by commiting
490   them to git in one location and restoring in another.
491
492 Notmuch 0.9 (2011-10-01)
493 ========================
494
495 New, general features
496 ---------------------
497
498 Correct handling of interruptions during `notmuch new`
499
500   `notmuch new` now operates as a series of small, self-consistent
501   transactions, so it can correctly resume after an interruption or
502   crash.  Previously, interruption could lose existing tags, fail to
503   detect messages on resume, or leave the database in a state
504   temporarily or permanently inconsistent with the mail store.
505
506 Library changes
507 ---------------
508
509 New functions
510
511   `notmuch_database_begin_atomic` and `notmuch_database_end_atomic`
512   allow multiple database operations to be performed atomically.
513
514   `notmuch_database_find_message_by_filename` does exactly what it says.
515
516 API changes
517
518   `notmuch_database_find_message` (and `n_d_f_m_by_filename`) now return
519   a status indicator and uses an output parameter for the
520   message. This change required changing the SONAME of libnotmuch to
521   libnotmuch.so.2
522
523 Python bindings changes
524 -----------------------
525
526   - Re-encode python unicode objects to utf-8 before passing back to
527     libnotmuch.
528   - Support `Database().begin_atomic()/end_atomic()`
529   - Support `Database().find_message_by_filename()`
530     NB! This needs a db opened in READ-WRITE mode currently, or it will crash
531     the python process. The is a limitation (=bug) of the underlying libnotmuch.
532   - Fixes where we would not throw NotmuchErrors when we should (Justus Winter)
533   - Update for `n_d_find_message*` API changes (see above).
534
535 Ruby bindings changes
536 ---------------------
537
538   - Wrap new library functions `notmuch_database_{begin,end}_atomic.`
539   - Add new exception `Notmuch::UnbalancedAtomicError.`
540   - Rename destroy to destroy! according to Ruby naming conventions.
541   - Update for `n_d_find_message*` API changes (see above).
542
543 Emacs improvements
544 ------------------
545
546   * Add gpg callback to crypto sigstatus buttons to retrieve/refresh
547     signing key.
548   * Add `notmuch-show-refresh-view` function (and corresponding binding)
549     to refresh the view of a notmuch-show buffer.
550
551 Reply formatting cleanup
552 ------------------------
553
554   `notmuch reply` no longer includes notification that non-leafnode
555   MIME parts are being suppressed.
556
557 Notmuch 0.8 (2011-09-10)
558 ========================
559
560 Improved handling of message/rfc822 parts
561
562   Both in the CLI and the emacs interface.  Output of rfc822 parts now
563   includes the primary headers, as well as the body and all subparts.
564   Output of the completely raw rfc822-formatted message, including all
565   headers, is unfortunately not yet supported (but hopefully will be
566   soon).
567
568 Improved Build system portability
569
570   Certain parts of the shell script generating notmuch.sym were
571   specific to the GNU versions of sed and nm. The new version should
572   be more portable to e.g. OpenBSD.
573
574 Documentation update for Ruby bindings
575
576   Added documentation, typo fixes, and improved support for rdoc.
577
578 Unicode, iterator, PEP8 changes for python bindings
579
580   - PEP8 (code formatting) changes for python files.
581   - Remove `Tags.__len__` ; see 0.6 release notes for motivation.
582   - Decode headers as UTF8, encode (unicode) database paths as UTF8.
583
584 Notmuch 0.7 (2011-08-01)
585 ========================
586
587 Vim interface improvements
588 --------------------------
589
590 Jason Woofenden provided a number of bug fixes for the Vim interface
591
592   * fix citation/signature fold lengths
593   * fix cig/cit parsing within multipart/*
594   * fix on-screen instructions for show-signature
595   * fix from list reformatting in search view
596   * fix space key: now archives (did opposite)
597
598 Uwe Kleine-König contributed
599
600   * use full path for sendmail/doc fix
601   * fix compose temp file name
602
603 Python Bindings changes
604 -----------------------
605
606 Sebastian Spaeth contributed two changes related to unicode and UTF8:
607
608   * message tags are now explicitly unicode
609   * query string is encoded as a UTF8 byte string
610
611 Build-System improvements
612 -------------------------
613
614 Generate notmuch.sym after the relevant object files
615
616   This fixes a bug in parallel building. Thanks to Thomas Jost for the
617   patch.
618
619 Notmuch 0.6.1 (2011-07-17)
620 ==========================
621
622 Bug-fix release
623 ---------------
624
625 Re-export Xapian exception typeinfo symbols
626
627   It turned out our aggressive symbol hiding caused problems for
628   people running gcc 4.4.5.
629
630 Notmuch 0.6 (2011-07-01)
631 =======================
632
633 New, general features
634 ---------------------
635
636 Folder-based searching
637
638   Notmuch queries can now include a search term to match the
639   directories in which mail files are stored (within the mail
640   storage). The syntax is as follows:
641
642         folder:<path>
643
644   For example, one might use things such as:
645
646         folder:spam
647         folder:2011-*
648         folder:work/todo
649
650   to match any path containing a directory "spam", "work/todo", or
651   containing a directory starting with "2011-", respectively.
652
653   This feature is particularly useful for users of delivery-agent
654   software (such as procmail or maildrop) that is filtering mail and
655   delivering it to particular folders, or users of systems such as
656   Gmail that use filesystem directories to indicate message tags.
657
658   NOTE: Only messages that are newly indexed with this version of
659   notmuch will be searchable with folder: terms. In order to enable
660   this feature for all mail, the entire notmuch index will need to be
661   rebuilt as follows:
662
663         notmuch dump > notmuch.dump
664         # Backup, then remove notmuch database ($MAIL/.notmuch)
665         notmuch new
666         notmuch restore notmuch.dump
667
668 Support for PGP/MIME
669
670   Both the command-line interface and the emacs-interface have new
671   support for PGP/MIME, detailed below. Thanks to Daniel Kahn Gillmor
672   and Jameson Graef Rollins for making this happen.
673
674 New, automatic tags: "signed" and "encrypted"
675
676   These tags will automatically be applied to messages containing
677   multipart/signed and multipart/encrypted parts.
678
679   NOTE: Only messages that are newly indexed with this version of
680   notmuch will receive these tags.
681
682 New command-line features
683 -------------------------
684
685 Add new "notmuch show --verify" option for signature verification
686
687   This option instruct notmuch to verify the signature of
688   PGP/MIME-signed parts.
689
690 Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options
691
692   This option instructs notmuch to decrypt PGP/MIME-encrypted parts.
693   Note that this feature currently requires gpg-agent and a passphrase entry
694   tool (e.g. pinentry-gtk or pinentry-curses).
695
696 Proper nesting of multipart parts in "notmuch show" output
697
698   MIME parts are now display with proper nesting to reflect original
699   MIME hierarchy of a message. This allows clients to correctly
700   analyze the MIME structure, (such as, for example, determining to
701   which parts a signature part applies).
702
703 Add new "notmuch show --part" option
704
705   This is a replacement for the older "notmuch part" command, (which
706   is now deprecated—it should still work as always, but is no longer
707   documented). Putting part output under "notmuch show" allows for all
708   of the "notmuch show" options to be applied when extracting a single
709   part, (such as --format=json for extracting a message part with JSON
710   formatting).
711
712 Deprecate "notmuch search-tags" (in favor of "notmuch search --output=tags *")
713
714   The "notmuch search-tags" sub-command has been redundant since the
715   addition of the --output=tags option to "notmuch search". We now
716   make that more clear by deprecating "notmuch search-tags", (dropping
717   it from the documentation). We do continue to support the old syntax
718   by translating it internally to the new call.
719
720 Performance improvements
721 ------------------------
722
723 Faster searches (by doing fewer searches to construct threads)
724
725   Whenever a user asks for search results as threads, notmuch first
726   performs a search for messages matching the query, then performs
727   additional searches to find other messages in the resulting threads.
728
729   Removing inefficiencies and redundancies in these secondary searches
730   results in a measured speedups of 1.5x for a typical search.
731
732 Faster searches (by doing fewer passes to gather message data)
733
734   Optimizing Xapian data access patterns (using a single pass to get
735   all message-document data rather than a pass for each data type)
736   results in a measured speedup of 1.7x for a typical search.
737
738   The benefits of this optimization combine with the preceding
739   optimization. With both in place, Austin Clements measured a speedup
740   of 2.5x for a search of all messages in his inbox (was 4.5s, now
741   1.8s). Thanks, Austin!
742
743 Faster initial indexing
744
745   More efficient indexing of new messages results in a measured
746   speedup of 1.4x for the initial indexing of 3 GB of mail (1h 14m
747   rather than 1h 46m). Thanks to Austin Clements and Michal Sojka.
748
749 Make "notmuch new" faster for unchanged directories
750
751   Optimizing to not do any further examinations of sub-directories
752   when the filesystem indicates that a directory is unchanged from the
753   last "notmuch new" results in measured speedups of 8.5 for the "No
754   new mail" case, (was 0.77s, now 0.09s). Thanks to Karel Zak.
755
756 New emacs-interface features
757 ----------------------------
758
759 Support for PGP/MIME (GnuPG)
760
761   Automatically indicate validity of signatures for multipart/signed
762   messages.  Automatically display decrypted content for
763   multipart/encrypted messages.  See the emacs variable
764   notmuch-crypto-process-mime for more information. Note that this
765   needs gpg-agent and a pinentry tool just as the command-line tools.
766   Also note there is no support SMIME yet.
767
768 Output of pipe command is now displayed if pipe command fails
769
770   This is extremely useful in the common use case of piping a patch to
771   "git am". If git fails to cleanly merge the patch the error messages
772   from the failed merge are now clearly displayed to the user, (where
773   previously they were silently hidden from the user).
774
775 User-selectable From address
776
777   A user can choose which configured email addresses should be used as
778   the From address whenever composing a new message. To do so, simply
779   press C-u before the command which will open a new message. Emacs
780   will prompt for the from address to use.
781
782   The user can customize the "Notmuch Identities" setting in the
783   notmuch customize group in order to use addresses other than those in
784   the notmuch configuration file if desired.
785
786   The user can also choose to always be prompted for the from address
787   when composing a new message (without having to use C-u) by setting
788   the "Notmuch Always Prompt For Sender" option in the notmuch
789   customize group.
790
791 Hiding of repeated subjects in collapsed thread view
792
793   In notmuch-show mode, if a collapsed message has the same subject as
794   its parent, the subject is not shown.
795
796 Automatic detection and hiding of original message in top-posted message
797
798   When a message contains a line looking something like:
799
800         ----- Original Message -----
801
802   emacs hides this and all subsequent lines as an "original message",
803   (allowing the user to click or press enter on the "original message"
804   button to display it again). This makes the handling of top-posted
805   citations work much like conventional citations.
806
807 New hooks for running code when tags are modified
808
809   Some users want to perform additional actions whenever a particular
810   tag is added/removed from a message. This could be used to, for
811   example, interface with some external spam-recognition training
812   tool. To facilitate this, two new hooks are added which can be
813   modified in the following settings of the notmuch customize group:
814
815         Notmuch Before Tag Hook
816         Notmuch After Tag Hook
817
818 New optional support for hiding some multipart/alternative parts
819
820   Many emails are sent with redundant content within a
821   multipart/alternative group (such as a text/plain part as well as a
822   text/html part). Users can configure the setting:
823
824         Notmuch Show All Multipart/Alternative Parts
825
826   to "off" in the notmuch customize group to have the interface
827   automatically hide some part alternatives (such as text/html
828   parts). This new part hiding is not configured by default yet
829   because there's not yet a simple way to re-display such a hidden
830   part if it is not actually redundant with a displayed part.
831
832 Better rendering of text/x-vcalendar parts
833
834   These parts are now displayed in a format suitable for use with the
835   emacs diary.
836
837 Avoid getting confused by Subject and Author fields with newline characters
838
839   Replacing all characters with ASCII code less than 32 with a question mark.
840
841 Cleaner display of From line in email messages
842
843   Remove double quotes, and drop "name" if it's actually just a repeat of
844   the email address.
845
846 Vim interface improvements
847 --------------------------
848
849 Felipe Contreras provided a number of updates for the vim interface:
850
851   * Using sendmail directly rather than mailx,
852   * Implementing archive in show view
853   * Add support to mark as read in show and search views
854   * Add delete commands
855   * Various cleanups.
856
857 Bindings improvements
858 ---------------------
859
860 Ruby bindings are now much more complete
861
862   Including `QUERY.sort`, `QUERY.to_s`, `MESSAGE.maildir_flags_to_tags`,
863   `MESSAGE.tags_to_maildir_flags`, and `MESSAGE.get_filenames`
864
865 Python bindings have been updated and extended
866
867   (docs online at http://packages.python.org/notmuch/)
868
869   New bindings:
870
871   - `Message().get_filenames()`, `Message().tags_to_maildir_flags()`,
872     `Message().maildir_flags_to_tags()`, `list(Threads())` and
873     `list(Messages)` works now
874   - `Message().__cmp__()` and `__hash__()`
875
876   These allow, for example:
877
878         if msg1 == msg2: ...
879
880   As well as set arithmetic on `Messages()`:
881
882         s1, s2 = set(msgs1), set(msgs2)
883         s1.union(s2)
884         s2 -= s1
885
886   Removed:
887
888   - `len(Messages())` as it exhausted the iterator
889
890   Use `len(list(Messages()))` or `Query.count_messages()`
891   to get the length.
892
893 Added initial Go bindings in bindings/go
894
895 New build-system features
896 -------------------------
897
898 Added support for building in a directory other than the source directory
899
900   This can be used with the widely-supported idiom of simply running
901   the configure script from some other directory:
902
903         mkdir build
904         cd build
905         ../configure
906         make
907
908 Fix to save configure options for future, implicit runs of configure
909
910   When a user updates the source (such as with "git pull") calling
911   "make" may cause an automatic re-run of the configure script. When
912   this happens, the configure script will automatically be called with
913   the same options the user originally passed in the most-recent
914   manual invocation of configure.
915
916 New test-suite feature
917 ----------------------
918
919 Binary for bash for running test suite now located via PATH
920
921   The notmuch test suite requires a fairly recent version of bash (>=
922   bash 4). As some systems supply an older version of bash at
923   /bin/bash, the test suite is now updated to search $PATH to locate
924   the bash binary. This allows users of systems with old /bin/bash to
925   simply install bash >= 4 somewhere on $PATH before /bin and then use
926   the test suite.
927
928 Support for testing output with a trailing newline
929
930   Previously, some tests would fail to notice a difference in the
931   presence/absence of a trailing newline in a program output, (which
932   has led to bugs in the past). Now, carefully-written tests (using
933   `test_expect_equal_file` rather than `test_expect_equal`) will detect
934   any change in the presence/absence of a trailing newline. Many tests
935   are updated to take advantage of this.
936
937 Avoiding accessing user's $HOME while running test suite
938
939   The test suite now carefully creates its own HOME directory. This
940   allows the test suite to be run with no existing HOME directory, (as
941   some build systems apparently do), and avoids test-suite differences
942   due to configuration files in the users HOME directory.
943
944
945 General bug fixes
946 -----------------
947
948 Output *all* files for "notmuch search --output=files"
949
950   For the cases where multiple files have the same Message ID,
951   previous versions of notmuch would output only one such file. This
952   command is now fixed to correctly output all files.
953
954 Fixed spurious search results from "overlapped" indexing of addresses
955
956   This fixed a bug where a search for:
957
958         to:user@elsewhere.com
959
960   would incorrectly match a message sent:
961
962         To: user@example,com, someone@elsewhere.com
963
964 Fix --output=json when search has no results
965
966   A bug present since notmuch 0.4 had caused searches with no results
967   to produce an invalid json object. This is now fixed to cleanly
968   return a valid json object representing an empty array "[]" as
969   expected.
970
971 Fix the automatic detection of the From address for "notmuch reply"
972 from the Received headers in some cases
973
974 Fix core dump on DragonFlyBSD due to -1 return value from
975 `sysconf(_SC_GETPW_R_SIZE_MAX)`
976
977 Cleaned up several memory leaks
978
979 Eliminated a few, rare segmentation faults and a double-free
980
981 Fix libnotmuch library to only export notmuch API functions
982
983   Previous release of the notmuch library also exported some Xapian
984   C++ exception type symbols. These were never part of the library
985   interface and were never intended to be exported.
986
987 Emacs-interface bug fixes
988 -------------------------
989
990 Display any unexpected output or errors from "notmuch search" invocations
991
992   Previously any misformatted output or trailing error messages were
993   silently ignored. This output is now clearly displayed. This fix was
994   very helpful in identifying and fixing the bug described below.
995
996 Fix bug where some threads would be missing from large search results
997
998   When a search returned a "large" number of results, the emacs
999   interface was incorrectly dropping one thread every time the output
1000   of the "notmuch search" process spanned the emacs read-buffer. This
1001   is now fixed.
1002
1003 Avoid re-compression of .gz files (and similar) when saving attachment
1004
1005   Emacs was being too clever for its own good and trying to
1006   re-compress pre-compressed .gz files when saving such attachments
1007   (potentially corrupting the attachment). The emacs interface is
1008   fixed to avoid this bug.
1009
1010 Fix hiding of a message when a previously-hidden citation is visible
1011
1012   Previously the citation would remain visible in this case. This is
1013   fixed so that hiding a message hides all parts.
1014
1015 Notmuch 0.5 (2010-11-11)
1016 ========================
1017
1018 New, general features
1019 ---------------------
1020
1021 Maildir-flag synchronization
1022
1023   Notmuch now knows how to synchronize flags in maildir filenames with
1024   tags in the notmuch database. The following flag/tag mappings are
1025   supported:
1026
1027         Flag <-> Tag
1028         ----     -----
1029         'D'      draft
1030         'F'      flagged
1031         'P'      passed
1032         'R'      replied
1033         'S'      unread (added when 'S' flag is not present)
1034
1035   The synchronization occurs in both directions, (for example, adding
1036   the 'S' flag to a file will cause the "unread" tag to be added, and
1037   adding the "replied" tag to a message will cause the file to be
1038   renamed with an 'R' flag).
1039
1040   This synchronization is enabled by default for users of the
1041   command-line interface, (though only files in directories named
1042   "cur" or "new" will be renamed). It can be disabled by setting the
1043   new `maildir.synchronize_flags` option in the configuration file. For
1044   example:
1045
1046         notmuch config set maildir.synchronize_flags false
1047
1048   Users upgrading may also want to run "notmuch setup" once (just
1049   accept the existing configuration) to get a new, nicely-commented
1050   [maildir] section added to the configuration file.
1051
1052   For users of the notmuch library, the new synchronization
1053   functionality is available with the following two new functions:
1054
1055         notmuch_message_maildir_flags_to_tags
1056         notmuch_message_tags_to_maildir_flags
1057
1058   It is anticipated that future improvements to this support will
1059   allow for safe synchronization of the 'T' flag with the "deleted"
1060   tag, as well as support for custom flag/tag mappings.
1061
1062 New library features
1063 --------------------
1064
1065 Support for querying multiple filenames for a single message
1066
1067   It is common for the mailstore to contain multiple files with the
1068   same message ID. Previously, notmuch would always hide these
1069   duplicate files, (returning a single, arbitrary filename with
1070   `notmuch_message_get_filename`).
1071
1072   With this release, library users can access all filenames for a
1073   message with the new function:
1074
1075         notmuch_message_get_filenames
1076
1077   Together with `notmuch_filenames_valid`, `notmuch_filenames_get`,
1078   and `notmuch_filenames_move_to_next` it is now possible to iterate
1079   over all available filenames for a given message.
1080
1081 New command-line features
1082 -------------------------
1083
1084 New "notmuch show --format=raw" for getting at original email contents
1085
1086   This new feature allows for a fully-functional email client to be
1087   built on top of the notmuch command-line without needing any direct
1088   access to the mail store itself.
1089
1090   For example, it's now possible to run "emacs -f notmuch" on a local
1091   machine with only ssh access to the mail store/notmuch database. To
1092   do this, simply set the notmuch-command variable in emacs to the
1093   name of a script containing:
1094
1095         ssh user@host notmuch "$@"
1096
1097   If the ssh client has enabled connection sharing (ControlMaster
1098   option in OpenSSH), the emacs interface can be quite responsive this
1099   way.
1100
1101 General bug fixes
1102 -----------------
1103
1104 Fix "notmuch search" to print nothing when nothing matches
1105
1106   The 0.4 release had a bug in which:
1107
1108         notmuch search <expression-with-no-matches>
1109
1110   would produce a single blank line of output, (where previous
1111   versions would produce no output. This fix also causes a change in
1112   the --format=json output, (which would previously produce "[]" and
1113   now produces nothing).
1114
1115 Emacs interface improvements
1116 ----------------------------
1117
1118 Fix to allow pipe ('|') command to work when using notmuch over ssh
1119
1120 Fix count of lines in hidden signatures
1121
1122 Omit repeated subject lines in (collapsed) thread display
1123
1124 Display current thread subject in a header line
1125
1126 Provide a "c i" binding to copy a thread ID from the search view
1127
1128 Allow for notmuch-fcc-dirs to have a value of nil
1129
1130   Also, the more complex form of notmuch-fcc-dirs now has a slightly
1131   different format. It no longer has a special first-element, fallback
1132   string. Instead it's now a list of cons cells where the car of each
1133   cell is a regular expression to be matched against the sender
1134   address, and the cdr is the name of a folder to use for an FCC. So
1135   the old fallback behavior can be achieved by including a final cell
1136   of (".*" . "default-fcc-folder").
1137
1138 Vim interface improvements
1139 --------------------------
1140
1141 Felipe Contreras provided a number of updates for the vim interface
1142
1143   These include optimizations, support for newer versions of vim, fixed
1144   support for sending mail on modern systems, new commands, and
1145   various cleanups.
1146
1147 New bindings
1148 ------------
1149
1150 Added initial ruby bindings in bindings/ruby
1151
1152 Notmuch 0.4 (2010-11-01)
1153 ========================
1154
1155 New command-line features
1156 -------------------------
1157
1158 `notmuch search --output=(summary|threads|messages|tags|files)`
1159
1160   This new option allows for particular items to be returned from
1161   notmuch searches. The "summary" option is the default and behaves
1162   just as "notmuch search" has historically behaved.
1163
1164   The new option values allow for thread IDs, message IDs, lists of
1165   tags, and lists of filenames to be returned from searches. It is
1166   expected that this new option will be very useful in shell
1167   scripts. For example:
1168
1169         for file in $(notmuch search --output=files <search-terms>); do
1170                 <operations-on> "$file"
1171         done
1172
1173 `notmuch show --format=mbox <search-specification>`
1174
1175   This new option allows for the messages matching a search
1176   specification to be presented as an mbox. Specifically the "mboxrd"
1177   format is used which allows for reversible quoting of lines
1178   beginning with "From ". A reader should remove a single '>' from the
1179   beginning of all lines beginning with one or more '>' characters
1180   followed by the 5 characters "From ".
1181
1182 `notmuch config [get|set] <section>.<item> [value ...]`
1183
1184   The new top-level "config" command allows for any value in the
1185   notmuch configuration file to be queried or set to a new value. Both
1186   single-valued and multi-valued items are supported, as our any
1187   custom items stored in the configuration file.
1188
1189 Avoid setting Bcc header in "notmuch reply"
1190
1191   We decided that this was a bit heavy-handed as the actual mail
1192   user-agent should be responsible for setting any Bcc option. Also,
1193   see below for the notmuch/emacs user-agent now setting an Fcc by
1194   default rather than Bcc.
1195
1196 New library features
1197 --------------------
1198
1199 Add `notmuch_query_get_query_string` and `notmuch_query_get_sort`
1200
1201   These are simply functions for querying properties of a
1202   `notmuch_query_t` object.
1203
1204 New emacs features
1205 ------------------
1206
1207 Enable Fcc of all sent messages by default (to "sent" directory)
1208
1209   All messages sent from the emacs interface will now be saved to the
1210   notmuch mail store where they will be incorporated to the database
1211   by the next "notmuch new". By default, messages are saved to the
1212   "sent" directory at the top-level of the mail store. This directory
1213   can be customized by means of the "Notmuch Fcc Dirs" option in the
1214   notmuch customize interface.
1215
1216 Ability to all open messages in a thread to a pipe
1217
1218   Historically, the '|' keybinding allows for piping a single message
1219   to an external command. Now, by prefixing this key with a prefix
1220   argument, (for example, by pressing "Control-U |"), all open
1221   messages in the current thread will be sent to the external command.
1222
1223 Optional support for detecting inline patches
1224
1225   This hook is disabled by default but can be enabled with a checkbox
1226   under "Notmuch Show Insert Text/Plain Hook" in the notmuch customize
1227   interface. It allows for inline patches to be detected and treated
1228   as if they were attachments, (with context-sensitive highlighting).
1229
1230 Automatically tag messages as "replied" when sending a reply
1231
1232   Messages replied to within the emacs interface will now be tagged as
1233   "replied". This feature can easily be customized to add or remove
1234   other tags as well. For example, a user might use a tag of
1235   "needs-reply" and can configure this feature to automatically remove
1236   that tag when replying. See "Notmuch Message Mark Replied" in the
1237   notmuch customize interface.
1238
1239 Allow search-result color specifications to overlay each other
1240
1241   For example, one tag can specify the background color of matching
1242   lines, while another can specify the foreground. With this change,
1243   both settings will now be visible simultaneously, (which was not the
1244   case in previous releases). See "Notmuch Search Line Faces" in the
1245   notmuch customize interface.
1246
1247 Make hidden author names still available for incremental search
1248
1249   When there is insufficient space to display all authors of a thread
1250   in search results, the names of hidden authors are now still made
1251   available to emacs' incremental search commands. As the user
1252   searches, matching lines will temporarily expand to show the hidden
1253   names.
1254
1255 New binding of Control-TAB (works like TAB in reverse)
1256
1257   Many notmuch nodes already use TAB to navigate forward through
1258   various items allowing actions, (message headers, email attachments,
1259   etc.). The new Control-TAB binding operates similarly but in the
1260   opposite direction.
1261
1262 New build-system features
1263 -------------------------
1264
1265 Various portability fixes have been applied
1266
1267   These include fixes for build failures on at least Solaris, FreeBSD,
1268   and Fedora systems. We're hopeful that the notmuch code base is now
1269   more portable than ever before.
1270
1271 Arrange for libnotmuch to be found automatically after make install
1272
1273   The notmuch build system is now careful to help the user avoid
1274   errors of the form "libnotmuch.so could not be found" immediately
1275   after installing. This support takes two forms:
1276
1277   1. If the library is installed to a system directory,
1278      (configured in /etc/ld.so.conf), then "make install" will
1279      automatically run ldconfig.
1280
1281   2. If the library is installed to a non-system directory, the
1282      build system adds a `DR_RUNPATH` entry to the final binary
1283      pointing to the directory to which the library is installed.
1284
1285   When this support works, the user should be able to run notmuch
1286   immediately after "make install", without any errors trying to find
1287   the notmuch library, and without having to manually set environment
1288   variables such as `LD_LIBRARY_PATH`.
1289
1290 Check compiler/linker options before using them
1291
1292   The configure script now carefully checks that any desired
1293   compilation options, (whether for enabling compiler warnings, or for
1294   embedding rpath, etc.), are supported. Only supported options are
1295   used in the resulting Makefile.
1296
1297 New test-suite features
1298 -----------------------
1299
1300 New modularization of test suite
1301
1302   Thanks to a gracious relicensing of the test-suite infrastructure
1303   from the git project, notmuch now has a modular test suite. This
1304   provides the ability to run individual sections of the test suite
1305   rather than the whole things. It also provides better summary of
1306   test results, with support for tests that are expected to fail
1307   (BROKEN and FIXED) in addition to PASS and FAIL. Finally, it makes
1308   it easy to run the test suite within valgrind (pass --valgrind to
1309   notmuch-test or to any sub-script) which has been very useful.
1310
1311 New testing of emacs interface
1312
1313   The test suite has been augmented to allow automated testing of the
1314   emacs interfaces. So far, this includes basic searches, display of
1315   threads, and tag manipulation. This also includes a test that a new
1316   message can successfully be sent out through a (dummy) SMTP server
1317   and that said message is successfully integrated into the notmuch
1318   database via the FCC setting.
1319
1320 General bug fixes
1321 -----------------
1322
1323 Fix potential corruption of database when "notmuch new" is interrupted
1324
1325   Previously, an interruption of "notmuch new" would (rarely) result
1326   in a corrupt database. The corruption would manifest itself by a
1327   persistent error of the form:
1328
1329         document ID of 1234 has no thread ID
1330
1331   The message-adding code has been carefully audited and reworked to
1332   avoid this sort of corruption regardless of when it is interrupted.
1333
1334 Fix failure with extremely long message ID headers
1335
1336   Previously, a message with an extremely long message ID, (say, more
1337   than 300 characters), would fail to be added to notmuch, (triggering
1338   Xapian exceptions). This has now been fixed.
1339
1340 Fix for messages with "charset=unknown-8bit"
1341
1342   Previously, messages with this charset would cause notmuch to emit a
1343   GMime warning, (which would then trip up emacs or other interfaces
1344   parsing the notmuch results).
1345
1346 Fix `notmuch_query_search_threads` function to return NULL on any exception
1347
1348 Fix "notmuch search" to return non-zero if `notmuch_query_search_threads`
1349 fails
1350
1351   Previously, this command could confusingly report a Xapian
1352   exception, yet still return an error code of 0. It now correctly
1353   returns a failing error code of 1 in this case.
1354
1355 Emacs bug fixes
1356 ---------------
1357
1358 Fix to handle a message with a subject containing, for example "[1234]"
1359
1360   Previously, a message subject containing a sequence of digits within
1361   square brackets would cause the emacs interface to mis-parse the
1362   output of "notmuch search". This would result in the message being
1363   mis-displayed and prevent the user from manipulating the message in
1364   the emacs interface.
1365
1366 Fix to correctly handle message IDs containing ".."
1367
1368   The emacs interface now properly quotes message IDs to avoid a
1369   Xapian bug in which the ".." within a message ID would be
1370   misinterpreted as a numeric range specification.
1371
1372 Python-binding fixes
1373 --------------------
1374
1375 The python bindings for notmuch have been updated to work with python3.
1376
1377 Debian-specific fixes
1378 ---------------------
1379
1380 Fix emacs initialization so "M-x notmuch" works for users by default
1381
1382   Now, a new Debian user can immediately run "emacs -f notmuch" after
1383   "apt-get install notmuch". Previously, the user would have had to
1384   edit the ~/.emacs file to add "(require 'notmuch)" before this would
1385   work.
1386
1387 Notmuch 0.3.1 (2010-04-27)
1388 ==========================
1389
1390 General bug fixes
1391 -----------------
1392
1393 Fix an infinite loop in "notmuch reply"
1394
1395   This bug could be triggered by replying to a message where the
1396   user's primary email address did not appear in the To: header and
1397   the user had not configured any secondary email addresses. The bug
1398   was a simple re-use of the same iterator variable in nested loops.
1399
1400 Fix a potential SEGV in "notmuch search"
1401
1402   This bug could be triggered by an author name ending in a ','.
1403   Admittedly - that's almost certainly a spam email, but we never
1404   want notmuch to crash.
1405
1406 Emacs bug fixes
1407 ---------------
1408
1409 Fix calculations for line wrapping in the primary "notmuch" view
1410
1411 Fix Fcc support to prompt to create a directory if the specified Fcc
1412 directory does not exist
1413
1414 Build fix
1415 ---------
1416
1417 Fix build on OpenSolaris (at least) due to missing 'extern "C"' block
1418
1419   Without this, the C++ sources could not find strcasestr and the
1420   final linking of notmuch would fail.
1421
1422 Notmuch 0.3 (2010-04-27)
1423 ========================
1424
1425 New command-line features
1426 -------------------------
1427
1428 User-configurable tags for new messages
1429
1430   A new "new.tags" option is available in the configuration file to
1431   determine which tags are applied to new messages. Run "notmuch
1432   setup" to generate new documentation within ~/.notmuch-config on how
1433   to specify this value.
1434
1435 Threads search results named based on subjects that match search
1436
1437   This means that when new mails arrived to a thread you've previously
1438   read, and the new mails have a new subject, you will see that
1439   subject in the search results rather than the old subject.
1440
1441 Faster operation of "notmuch tag" (avoid unneeded sorting)
1442
1443   Since the user just wants to tag all matching messages, we can make
1444   things perform a bit faster by avoiding the sort.
1445
1446 Even Better guessing of From: header for "notmuch reply"
1447
1448   Notmuch now looks at a number of headers when trying to figure out
1449   the best From: header to use in a reply. This is helpful if you have
1450   several configured email addresses, and you also subscribe to various
1451   mailing lists with different addresses, (so that mails you are
1452   replying to won't always include your subscribed address in the To:
1453   header).
1454
1455 Indication of author names that match a search
1456
1457   When notmuch displays threads as the result of a search, it now
1458   lists the authors that match the search before listing the other
1459   authors in the thread. It inserts a pipe '|' symbol between the last
1460   matching and first non-matching author. This is especially useful in
1461   a search that includes tag:unread. Now the authors of the unread
1462   messages in the thread are listed first.
1463
1464 New: Python bindings
1465 --------------------
1466
1467 Sebastian Spaeth has contributed his python bindings for the notmuch
1468 library to the central repository. These bindings were previously
1469 known as "cnotmuch" within python but have now been renamed to be
1470 accessible with a simple, and more official-looking "import notmuch".
1471
1472 The bindings have already proven very useful as people proficient in
1473 python have been able to easily develop programs to do notmuch-based
1474 searches for email-address completion, maildir-flag synchronization,
1475 and other tasks.
1476
1477 These bindings are available within the bindings/python directory, but
1478 are not yet integrated into the top-level Makefiles, nor the top-level
1479 package-building scripts. Improvements are welcome.
1480
1481 Emacs interface improvements
1482 ----------------------------
1483
1484 An entirely new initial view for notmuch, (friendly yet powerful)
1485
1486   Some of us call the new view "notmuch hello" but you can get at it
1487   by simply calling "emacs -f notmuch". The new view provides a search
1488   bar where new searches can be performed. It also displays a list of
1489   recent searches, along with a button to save any of these, giving it
1490   a new name as a "saved search". Many people find these "saved
1491   searches" one of the most convenient ways of organizing their mail,
1492   (providing all of the features of "folders" in other mail clients,
1493   but without any of the disadvantages).
1494
1495   Finally, this view can also optionally display all of the tags that
1496   exist in the database, along with a count for each tag, and a custom
1497   search of messages with that tag that's simply a click (or keypress)
1498   away.
1499
1500   NOTE: For users that liked the original mode of "emacs -f notmuch"
1501   immediately displaying a particular search result, we recommend
1502   instead running something like:
1503
1504         emacs --eval '(notmuch search "tag:inbox" t)'
1505
1506   The "t" means to sort the messages in an "oldest first" order,
1507   (as notmuch would do previously by default). You can also
1508   leave that off to have your search results in "newest first"
1509   order.
1510
1511 Full-featured "customize" support for configuring notmuch
1512
1513   Notmuch now plugs in well to the emacs "customize" mode to make it
1514   much simpler to find things about the notmuch interface that can be
1515   tweaked by the user.
1516
1517   You can get to this mode by starting at the main "Customize" menu in
1518   emacs, then browsing through "Applications", "Mail", and
1519   "Notmuch". Or you can go straight to "M-x customize-group"
1520   "notmuch".
1521
1522   Once you're at the customize screen, you'll see a list of documented
1523   options that can be manipulated along with checkboxes, drop-down
1524   selectors, and text-entry boxes for configuring the various
1525   settings.
1526
1527 Support for doing tab-completion of email addresses
1528
1529   This support currently relies on an external program,
1530   (notmuch-addresses), that is not yet shipped with notmuch
1531   itself. But multiple, suitable implementations of this program have
1532   already been written that generate address completions by doing
1533   notmuch searches of your email collection. For example, providing
1534   first those addresses that you have composed messages to in the
1535   past, etc.
1536
1537   One such program (implemented in python with the python bindings to
1538   notmuch) is available via:
1539
1540         git clone  http://jkr.acm.jhu.edu/git/notmuch_addresses.git
1541
1542   Install that program as notmuch-addresses on your PATH, and then
1543   hitting TAB on a partial email address or name within the To: or Cc:
1544   line of an email message will provide matching completions.
1545
1546 Support for file-based (Fcc) delivery of sent messages to mail store
1547
1548   This isn't yet enabled by default. To enable this, one will have to
1549   set the "Notmuch Fcc Dirs" setting within the notmuch customize
1550   screen, (see its documentation there for details). We anticipate
1551   making this automatic in a future release.
1552
1553 New 'G' key binding to trigger mail refresh (G == "Get new mail")
1554
1555   The 'G' key works wherever '=' works. Before refreshing the screen
1556   it calls an external program that can be used to poll email servers,
1557   run notmuch new and setup specific tags for the new emails. The
1558   script to be called should be configured with the "Notmuch Poll
1559   Script" setting in the customize interface. This script will
1560   typically invoke "notmuch new" and then perhaps several "notmuch
1561   tag" commands.
1562
1563 Implement emacs message display with the JSON output from notmuch
1564
1565   This is much more robust than the previous implementation, (where
1566   some HTML mails and mail quoting the notmuch code with the delimiter
1567   characters in it would cause the parser to fall over).
1568
1569 Better handling of HTML messages and MIME attachments (inline images!)
1570
1571   Allow for any MIME parts that emacs can display to be displayed
1572   inline. This includes inline viewing of image attachments, (provided
1573   the window is large enough to fit the image at its natural size).
1574
1575   Much more robust handling of HTML messages. Currently both text/plain
1576   and text/html alternates will be rendered next to each other. In a
1577   future release, users will be able to decide to see only one or the
1578   other representation.
1579
1580   Each attachment now has its own button so that attachments can be
1581   saved individually (the 'w' key is still available to save all
1582   attachments).
1583
1584 Customizable support for tidying of text/plain message content
1585
1586   Many new functions are available for tidying up message
1587   content. These include options such as wrapping long lines,
1588   compressing duplicate blank lines, etc.
1589
1590   Most of these are disabled by default, but can easily be enabled by
1591   clicking the available check boxes under the "Notmuch Show Insert
1592   Text/Plain Hook" within the notmuch customize screen.
1593
1594 New support for searchable citations (even when hidden)
1595
1596   When portions of overly-long citations are hidden, the contents of
1597   these citations will still be available for emacs' standard
1598   "incremental search" functions. When the search matches any portion
1599   of a hidden citation, the citation will become visible temporarily
1600   to display the search result.
1601
1602 More flexible handling of header visibility
1603
1604   As an answer to complaints from many users, the To, Cc, and Date
1605   headers of messages are no longer hidden by default. For those users
1606   that liked that these were hidden, a new "Notmuch Messages Headers
1607   Visible" option in the customize interface can be set to nil. The
1608   visibility of headers can still be toggled on a per-message basis
1609   with the 'h' keybinding.
1610
1611   For users that don't want to see some subset of those headers, the
1612   new "Notmuch Message Headers" variable can be customized to list
1613   only those headers that should be present in the display of a message.
1614
1615 The Return key now toggles message visibility anywhere
1616
1617   Previously this worked only on the first summary-line of a message.
1618
1619 Customizable formatting of search results
1620
1621   The user can easily customize the order, width, and formatting of
1622   the various fields in a "notmuch search" buffer. See the "Notmuch
1623   Search Result Format" section of the customize interface.
1624
1625 Generate nicer names for search buffers when using a saved search
1626
1627 Add a notmuch User-Agent header when sending mail from notmuch/emacs
1628
1629 New keybinding (M-Ret) to open all collapsed messages in a thread
1630
1631 New library feature
1632 -------------------
1633
1634 Provide a new `NOTMUCH_SORT_UNSORTED` value for queries
1635
1636   This can be somewhat faster when sorting simply isn't desired. For
1637   example when collecting a set of messages that will all be
1638   manipulated identically, (adding a tag, removing a tag, deleting the
1639   messages), then there's no advantage to sorting the messages by
1640   date.
1641
1642 Build fixes
1643 -----------
1644
1645 Fix to compile against GMime 2.6
1646
1647   Previously notmuch insisted on being able to find GMime 2.4, (even
1648   though GMime 2.6 would have worked all along).
1649
1650 Fix configure script to accept (and ignore) various standard options
1651
1652   For example, those that the Gentoo build scripts expect configure to
1653   accept are now all accepted.
1654
1655 Test suite
1656 ----------
1657
1658 A large number of new tests for the many new features
1659
1660 Better display of output from failed tests
1661
1662   Now shows failures with diff rather than forcing the user to gaze at
1663   complete actual and expected output looking for deviation.
1664
1665 Notmuch 0.2 (2010-04-16)
1666 ========================
1667
1668 This is the second release of the notmuch mail system, with actual
1669 detailed release notes this time!
1670
1671 This release consists of a number of minor new features that make
1672 notmuch more pleasant to use, and a few fairly major bug fixes.
1673
1674 We didn't quite hit our release target of "about a week" from the 0.1
1675 release, (0.2 is happening 11 days after 0.1), but we hope to do
1676 better for next week. Look forward to some major features coming to
1677 notmuch in subsequent releases.
1678
1679 -Carl
1680
1681 General features
1682 ----------------
1683
1684 Better guessing of From: header
1685
1686   Notmuch now tries harder to guess which configured address should be
1687   used as the From: line in a "notmuch reply". It will examine the
1688   Received: headers if it fails to find any configured address in To:
1689   or Cc:. This allows it to often choose the correct address even when
1690   replying to a message sent to a mailing list, and not directly to a
1691   configured address.
1692
1693 Make "notmuch count" with no arguments count all messages
1694
1695   Previously, it was hard to construct a search term that was
1696   guaranteed to match all messages.
1697
1698 Provide a new special-case search term of "*" to match all messages
1699
1700   This can be used in any command accepting a search term, such as
1701   "notmuch search '*'". Note that you'll want to take care that the
1702   shell doesn't expand * against the current files. And note that the
1703   support for "*" is a special case. It's only meaningful as a single
1704   search term and loses its special meaning when combined with any
1705   other search terms.
1706
1707 Automatically detect thread connections even when a parent message is
1708 missing
1709
1710   Previously, if two or more message were received with a common
1711   parent, but that parent was not received, then these messages would
1712   not be recognized as belonging to the same thread. This is now fixed
1713   so that such messages are properly connected in a thread.
1714
1715 General bug fixes
1716 -----------------
1717
1718 Fix potential data loss in "notmuch new" with SIGINT
1719
1720   One code path in "notmuch new" was not properly handling
1721   SIGINT. Previously, this could lead to messages being removed from
1722   the database (and their tags being lost) if the user pressed
1723   Control-C while "notmuch new" was working.
1724
1725 Fix segfault when a message includes a MIME part that is empty
1726
1727 Fix handling of non-ASCII characters with --format=json
1728
1729   Previously, characters outside the range of 7-bit ASCII were
1730   silently dropped from the JSON output. This led to corrupted display
1731   of utf-8 content in the upcoming notmuch web-based frontends.
1732
1733 Fix headers to be properly decoded in "notmuch reply"
1734
1735   Previously, the user might see:
1736
1737         Subject: Re: =?iso-8859-2?q?Rozlu=E8ka?=
1738
1739   rather than:
1740
1741         Subject: Re: Rozlučka
1742
1743   The former text is properly encoded to be RFC-compliant SMTP, will
1744   be sent correctly, and will be properly decoded by the
1745   recipient. But the user trying to edit the reply would likely be
1746   unable to read or edit that field in its encoded form.
1747
1748 Emacs client features
1749 ---------------------
1750
1751 Show the last few lines of citations as well as the first few lines
1752
1753   It's often the case that the last sentence of a citation is what is
1754   being replied to directly, so the last few lines are often much more
1755   important. The number of lines shown at the beginning and end of any
1756   citation can be configured, (notmuch-show-citation-lines-prefix and
1757   notmuch-show-citation-lines-suffix).
1758
1759 The '+' and '-' commands in the search view can now add and remove
1760 tags by region
1761
1762   Selective bulk tagging is now possible by selecting a region of
1763   threads and then using either the '+' or '-' keybindings. Bulk
1764   tagging is still available for all threads matching the current
1765   search with the '*' binding.
1766
1767 More meaningful buffer names for thread-view buffers
1768
1769   Notmuch now uses the Subject of the thread as the buffer
1770   name. Previously it was using the thread ID, which is a meaningless
1771   number to the user.
1772
1773 Provide for customized colors of threads in search view based on tags
1774
1775   See the documentation of notmuch-search-line-faces, (or us "M-x
1776   customize" and browse to the "notmuch" group within "Applications"
1777   and "Mail"), for details on how to configure this colorization.
1778
1779 Build-system features
1780 ---------------------
1781
1782 Add support to properly build libnotmuch on Darwin systems (OS X)
1783
1784 Add support to configure for many standard options
1785
1786   We include actual support for:
1787
1788         --includedir --mandir --sysconfdir
1789
1790   And accept and silently ignore several more:
1791
1792         --build --infodir --libexecdir --localstatedir
1793         --disable-maintainer-mode --disable-dependency-tracking
1794
1795 Install emacs client in "make install" rather than requiring a
1796 separate "make install-emacs"
1797
1798 Automatically compute versions numbers between releases
1799
1800   This support uses the git-describe notation, so a version such as
1801   0.1-144-g43cbbfc indicates a version that is 144 commits since the
1802   0.1 release and is available as git commit "43cbbfc".
1803
1804 Add a new "make test" target to run the test suite and actually
1805 verify its results
1806
1807 Notmuch 0.1 (2010-04-05)
1808 ========================
1809
1810 This is the first release of the notmuch mail system.
1811
1812 It includes the libnotmuch library, the notmuch command-line
1813 interface, and an emacs-based interface to notmuch.
1814
1815 Note: Notmuch will work best with Xapian 1.0.18 (or later) or Xapian
1816 1.1.4 (or later). Previous versions of Xapian (whether 1.0 or 1.1) had
1817 a performance bug that made notmuch very slow when modifying
1818 tags. This would cause distracting pauses when reading mail while
1819 notmuch would wait for Xapian when removing the "inbox" and "unread"
1820 tags from messages in a thread.
1821
1822
1823 <!--
1824  Local variables:
1825  mode: text
1826  tab-width: 8
1827  indent-tabs-mode: nil
1828  End:
1829  vi: sw=8 ts=8 et
1830 -->