1 Notmuch 0.9 (2011-10-01)
2 ========================
7 Correct handling of interruptions during "notmuch new"
9 "notmuch new" now operates as a series of small, self-consistent
10 transactions, so it can correctly resume after an interruption or
11 crash. Previously, interruption could lose existing tags, fail to
12 detect messages on resume, or leave the database in a state
13 temporarily or permanently inconsistent with the mail store.
20 notmuch_database_begin_atomic and notmuch_database_end_atomic allow
21 multiple database operations to be performed atomically.
23 notmuch_database_find_message_by_filename does exactly what it says.
27 notmuch_database_find_message (and n_d_f_m_by_filename) now return
28 a status indicator and uses an output parameter for the
29 message. This change required changing the SONAME of libnotmuch to
32 Python bindings changes
33 -----------------------
35 - Re-encode python unicode objects to utf-8 before passing back to
37 - Support Database().begin_atomic()/end_atomic()
38 - Support Database().find_message_by_filename()
39 NB! This needs a db opened in READ-WRITE mode currently, or it will crash
40 the python process. The is a limitation (=bug) of the underlying libnotmuch.
41 - Fixes where we would not throw NotmuchErrors when we should (Justus Winter)
42 - Update for n_d_find_message* API changes (see above).
47 - Wrap new library functions notmuch_database_{begin,end}_atomic.
48 - Add new exception Notmuch::UnbalancedAtomicError.
49 - Rename destroy to destroy! according to Ruby naming conventions.
50 - Update for n_d_find_message* API changes (see above).
55 * Add gpg callback to crypto sigstatus buttons to retrieve/refresh
57 * Add notmuch-show-refresh-view function (and corresponding binding)
58 to refresh the view of a notmuch-show buffer.
60 Reply formatting cleanup
61 ------------------------
63 "notmuch reply" no longer includes notification that non-leafnode
64 MIME parts are being suppressed.
66 Notmuch 0.8 (2011-09-10)
67 ========================
69 Improved handling of message/rfc822 parts
71 Both in the CLI and the emacs interface. Output of rfc822 parts now
72 includes the primary headers, as well as the body and all subparts.
73 Output of the completely raw rfc822-formatted message, including all
74 headers, is unfortunately not yet supported (but hopefully will be
77 Improved Build system portability
79 Certain parts of the shell script generating notmuch.sym were
80 specific to the GNU versions of sed and nm. The new version should
81 be more portable to e.g. OpenBSD.
83 Documentation update for Ruby bindings
85 Added documentation, typo fixes, and improved support for rdoc.
87 Unicode, iterator, PEP8 changes for python bindings
89 - PEP8 (code formatting) changes for python files.
90 - Remove Tags.__len__ ; see 0.6 release notes for motivation.
91 - Decode headers as UTF8, encode (unicode) database paths as UTF8.
93 Notmuch 0.7 (2011-08-01)
94 ========================
96 Vim interface improvements
97 --------------------------
99 Jason Woofenden provided a number of bug fixes for the Vim interface
101 * fix citation/signature fold lengths
102 * fix cig/cit parsing within multipart/*
103 * fix on-screen instructions for show-signature
104 * fix from list reformatting in search view
105 * fix space key: now archives (did opposite)
107 Uwe Kleine-König contributed
109 * use full path for sendmail/doc fix
110 * fix compose temp file name
112 Python Bindings changes
113 -----------------------
115 Sebastian Spaeth contributed two changes related to unicode and UTF8:
117 * message tags are now explicitly unicode
118 * query string is encoded as a UTF8 byte string
120 Build-System improvments
121 ------------------------
123 Generate notmuch.sym after the relevant object files
125 This fixes a bug in parallel building. Thanks to Thomas Jost for the
128 Notmuch 0.6.1 (2011-07-17)
129 ==========================
134 Re-export Xapian exception typeinfo symbols.
136 It turned out our aggressive symbol hiding caused problems for
137 people running gcc 4.4.5.
139 Notmuch 0.6 (2011-07-01)
140 =======================
141 New, general features
142 ---------------------
143 Folder-based searching
145 Notmuch queries can now include a search term to match the
146 directories in which mail files are stored (within the mail
147 storage). The syntax is as follows:
151 For example, one might use things such as:
157 to match any path containing a directory "spam", "work/todo", or
158 containing a directory starting with "2011-", respectively.
160 This feature is particularly useful for users of delivery-agent
161 software (such as procmail or maildrop) that is filtering mail and
162 delivering it to particular folders, or users of systems such as
163 Gmail that use filesystem directories to indicate message tags.
165 NOTE: Only messages that are newly indexed with this version of
166 notmuch will be searchable with folder: terms. In order to enable
167 this feature for all mail, the entire notmuch index will need to be
170 notmuch dump > notmuch.dump
171 # Backup, then remove notmuch database ($MAIL/.notmuch)
173 notmuch restore notmuch.dump
177 Both the command line interface and the emacs-interface have new
178 support for PGP/MIME, detailed below. Thanks to Daniel Kahn Gillmor
179 and Jameson Graef Rollins for making this happen.
181 New, automatic tags: "signed" and "encrypted"
183 These tags will automatically be applied to messages containing
184 multipart/signed and multipart/encrypted parts.
186 NOTE: Only messages that are newly indexed with this version of
187 notmuch will receive these tags.
189 New command-line features
190 -------------------------
191 Add new "notmuch show --verify" option for signature verification
193 This option instruct notmuch to verify the signature of
194 PGP/MIME-signed parts.
196 Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options
198 This option instructs notmuch to decrypt PGP/MIME-encrypted parts.
199 Note that this feature currently requires gpg-agent and a passphrase entry
200 tool (e.g. pinentry-gtk or pinentry-curses).
202 Proper nesting of multipart parts in "notmuch show" output
204 MIME parts are now display with proper nesting to reflect original
205 MIME hierarchy of a message. This allows clients to correctly
206 analyze the MIME structure, (such as, for example, determining to
207 which parts a signature part applies).
209 Add new "notmuch show --part" option
211 This is a replacement for the older "notmuch part" command, (which
212 is now deprecated—it should still work as always, but is no longer
213 documented). Putting part output under "notmuch show" allows for all
214 of the "notmuch show" options to be applied when extracting a single
215 part, (such as --format=json for extracting a message part with JSON
218 Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *")
220 The "notmuch search-tags" sub-command has been redundant since the
221 addition of the --output=tags option to "notmuch search". We now
222 make that more clear by deprecating "notmuch search-tags", (dropping
223 it from the documentation). We do continue to support the old syntax
224 by translating it internally to the new call.
226 Performance improvements
227 ------------------------
228 Faster searches (by doing fewer searches to construct threads)
230 Whenever a user asks for search results as threads, notmuch first
231 performs a search for messages matching the query, then performs
232 additional searches to find other messages in the resulting threads.
234 Removing inefficiencies and redundancies in these secondary searches
235 results in a measured speedups of 1.5x for a typical search.
237 Faster searches (by doing fewer passes to gather message data)
239 Optimizing Xapian data access patterns (using a single pass to get
240 all message-document data rather than a pass for each data type)
241 results in a measured speedup of 1.7x for a typical search.
243 The benefits of this optimization combine with the preceding
244 optimization. With both in place, Austin Clements measured a speedup
245 of 2.5x for a search of all messages in his inbox (was 4.5s, now
246 1.8s). Thanks, Austin!
248 Faster initial indexing
250 More efficient indexing of new messages results in a measured
251 speedup of 1.4x for the initial indexing of 3 GB of mail (1h 14m
252 rather than 1h 46m). Thanks to Austin Clements and Michal Sojka.
254 Make "notmuch new" faster for unchanged directories
256 Optimizing to not do any further examinations of sub-directories
257 when the filesystem indicates that a directory is unchanged from the
258 last "notmuch new" results in measured speedups of 8.5 for the "No
259 new mail" case, (was 0.77s, now 0.09s). Thanks to Karel Zak.
261 New emacs-interface features
262 ----------------------------
264 Support for PGP/MIME (GnuPG)
266 Automatically indicate validity of signatures for multipart/signed
267 messages. Automatically display decrypted content for
268 multipart/encrypted messages. See the emacs variable
269 notmuch-crypto-process-mime for more information. Note that this
270 needs gpg-agent and a pinentry tool just as the command line tools.
271 Also note there is no support SMIME yet.
273 Output of pipe command is now displayed if pipe command fails
275 This is extremely useful in the common use case of piping a patch to
276 "git am". If git fails to cleanly merge the patch the error messages
277 from the failed merge are now clearly displayed to the user, (where
278 previously they were silently hidden from the user).
280 User-selectable From address
282 A user can choose which configured email addresses should be used as
283 the From address whenever composing a new message. To do so, simply
284 press C-u before the command which will open a new message. Emacs
285 will prompt for the from address to use.
287 The user can customize the "Notmuch Identities" setting in the
288 notmuch customize group in order to use addresses other than those in
289 the notmuch configuration file if desired.
291 The user can also choose to always be prompted for the from address
292 when composing a new message (without having to use C-u) by setting
293 the "Notmuch Always Prompt For Sender" option in the notmuch
296 Hiding of repeated subjects in collapsed thread view
298 In notmuch-show mode, if a collapsed message has the same subject as
299 its parent, the subject is not shown.
301 Automatic detection and hiding of original message in top-posted message
303 When a message contains a line looking something like:
305 ----- Original Message -----
307 emacs hides this and all subsequent lines as an "original message",
308 (allowing the user to click or press enter on the "original message"
309 button to display it again). This makes the handling of top-posted
310 citations work much like conventional citations.
312 New hooks for running code when tags are modified
314 Some users want to perform additional actions whenever a particular
315 tag is added/removed from a message. This could be used to, for
316 example, interface with some external spam-recognition training
317 tool. To facilitate this, two new hooks are added which can be
318 modified in the following settings of the notmuch customize group:
320 Notmuch Before Tag Hook
321 Notmuch After Tag Hook
323 New optional support for hiding some multipart/alternative parts
325 Many emails are sent with redundant content within a
326 multipart/alternative group (such as a text/plain part as well as a
327 text/html part). Users can configure the setting:
329 Notmuch Show All Multipart/Alternative Parts
331 to "off" in the notmuch customize group to have the interface
332 automatically hide some part alternatives (such as text/html
333 parts). This new part hiding is not configured by default yet
334 because there's not yet a simple way to re-display such a hidden
335 part if it is not actually redundant with a displayed part.
337 Better rendering of text/x-vcalendar parts
339 These parts are now displayed in a format suitable for use with the
342 Avoid getting confused by Subject and Author fields with newline characters
344 Replacing all characters with ASCII code less than 32 with a question mark.
346 Cleaner display of From line in email messages (remove double quotes,
347 and drop "name" if it's actually just a repeat of the email address).
349 Vim interface improvements
350 --------------------------
351 Felipe Contreras provided a number of updates for the vim interface:
353 * Using sendmail directly rather than mailx,
354 * Implementing archive in show view
355 * Add support to mark as read in show and search views
356 * Add delete commands
359 Bindings improvements
360 ---------------------
361 Ruby bindings are now much more complete
363 Including QUERY.sort, QUERY.to_s, MESSAGE.maildir_flags_to_tags,
364 MESSAGE.tags_to_maildir_flags, and MESSAGE.get_filenames
366 * Python bindings have been upodated and extended
367 (docs online at http://packages.python.org/notmuch/)
370 - Message().get_filenames(),
371 - Message().tags_to_maildir_flags(),Message().maildir_flags_to_tags()
372 - list(Threads()) and list(Messages) works now
374 - Message().__cmp__() and __hash__()
375 These allow, for example:
378 As well as set arithmetic on Messages():
380 s1, s2= set(msgs1), set(msgs2)
385 - len(Messages()) as it exausted the iterator.
386 Use len(list(Messages())) or
387 Query.count_messages() to get the length.
389 Added initial Go bindings in bindings/go
391 New build-system features
392 -------------------------
393 Added support for building in a directory other than the source directory
395 This can be used with the widely-supported idiom of simply running
396 the configure script from some other directory:
403 Fix to save configure options for future, implicit runs of configure
405 When a user updates the source (such as with "git pull") calling
406 "make" may cause an automatic re-run of the configure script. When
407 this happens, the configure script will automatically be called with
408 the same options the user originally passed in the most-recent
409 manual invocation of configure.
411 New test-suite feature
412 ----------------------
413 Binary for bash for running test suite now located via PATH.
415 The notmuch test suite requires a fairly recent version of bash (>=
416 bash 4). As some systems supply an older version of bash at
417 /bin/bash, the test suite is now updated to search $PATH to locate
418 the bash binary. This allows users of systems with old /bin/bash to
419 simply install bash >= 4 somewhere on $PATH before /bin and then use
422 Support for testing output with a trailing newline.
424 Previously, some tests would fail to notice a difference in the
425 presence/absence of a trailing newline in a program output, (which
426 has led to bugs in the past). Now, carefully-written tests (using
427 test_expect_equal_file rather than test_expect_equal) will detect
428 any change in the presence/absence of a trailing newline. Many tests
429 are updated to take advantage of this.
431 Avoiding accessing user's $HOME while running test suite
433 The test suite now carefully creates its own HOME directory. This
434 allows the test suite to be run with no existing HOME directory, (as
435 some build systems apparently do), and avoids test-suite differences
436 due to configuration files in the users HOME directory.
441 Output *all* files for "notmuch search --output=files"
443 For the cases where multiple files have the same Message ID,
444 previous versions of notmuch would output only one such file. This
445 command is now fixed to correctly output all files.
447 Fixed spurious search results from "overlapped" indexing of addresses
449 This fixed a bug where a search for:
451 to:user@elsewhere.com
453 would incorrectly match a message sent:
455 To: user@example,com, someone@elsewhere.com
457 Fix --output=json when search has no results
459 A bug present since notmuch 0.4 had caused searches with no results
460 to produce an invalid json object. This is now fixed to cleanly
461 return a valid json object representing an empty array "[]" as
464 fix the automatic detection of the From address for "notmuch reply"
465 from the Received headers in some cases.
467 Fix core dump on DragonFlyBSD due to -1 return value from
468 sysconf(_SC_GETPW_R_SIZE_MAX).
470 Cleaned up several memory leaks
472 Eliminated a few, rare segmentation faults and a double-free.
474 Fix libnotmuch library to only export notmuch API functions
476 Previous release of the notmuch library also exported some Xapian
477 C++ exception type symbols. These were never part of the library
478 interface and were never intended to be exported.
480 Emacs-interface bug fixes
481 -------------------------
482 Display any unexpected output or errors from "notmuch search" invocations
484 Previously any misformatted output or trailing error messages were
485 silently ignored. This output is now clearly displayed. This fix was
486 very helpful in identifying and fixing the bug described below.
488 Fix bug where some threads would be missing from large search results
490 When a search returned a "large" number of results, the emacs
491 interface was incorrectly dropping one thread every time the output
492 of the "notmuch search" process spanned the emacs read-buffer. This
495 Avoid re-compression of .gz files (and similar) when saving attachment
497 Emacs was being too clever for its own good and trying to
498 re-compress pre-compressed .gz files when saving such attachments
499 (potentially corrupting the attachment). The emacs interface is
500 fixed to avoid this bug.
502 Fix hiding of a message when a previously-hidden citation is visible
504 Previously the citation would remain visible in this case. This is
505 fixed so that hiding a message hides all parts.
507 Notmuch 0.5 (2010-11-11)
508 ========================
509 New, general features
510 ---------------------
511 Maildir-flag synchronization
513 Notmuch now knows how to synchronize flags in maildir filenames with
514 tags in the notmuch database. The following flag/tag mappings are
523 'S' unread (added when 'S' flag is not present)
525 The synchronization occurs in both directions, (for example, adding
526 the 'S' flag to a file will cause the "unread" tag to be added, and
527 adding the "replied" tag to a message will cause the file to be
528 renamed with an 'R' flag).
530 This synchronization is enabled by default for users of the
531 command-line interface, (though only files in directories named
532 "cur" or "new" will be renamed). It can be disabled by setting the
533 new maildir.synchronize_flags option in the configuration file. For
536 notmuch config set maildir.synchronize_flags false
538 Users upgrading may also want to run "notmuch setup" once (just
539 accept the existing configuration) to get a new, nicely-commented
540 [maildir] section added to the configuration file.
542 For users of the notmuch library, the new synchronization
543 functionality is available with the following two new functions:
545 notmuch_message_maildir_flags_to_tags
546 notmuch_message_tags_to_maildir_flags
548 It is anticipated that future improvements to this support will
549 allow for safe synchronization of the 'T' flag with the "deleted"
550 tag, as well as support for custom flag/tag mappings.
554 Support for querying multiple filenames for a single message
556 It is common for the mailstore to contain multiple files with the
557 same message ID. Previously, notmuch would always hide these
558 duplicate files, (returning a single, arbitrary filename with
559 notmuch_message_get_filename).
561 With this release, library users can access all filenames for a
562 message with the new function:
564 notmuch_message_get_filenames
566 Together with notmuch_filenames_valid, notmuch_filenames_get, and
567 notmuch_filenames_move_to_next it is now possible to iterate over
568 all available filenames for a given message.
570 New command-line features
571 -------------------------
572 New "notmuch show --format=raw" for getting at original email contents
574 This new feature allows for a fully-functional email client to be
575 built on top of the notmuch command-line without needing any direct
576 access to the mail store itself.
578 For example, it's now possible to run "emacs -f notmuch" on a local
579 machine with only ssh access to the mail store/notmuch database. To
580 do this, simply set the notmuch-command variable in emacs to the
581 name of a script containing:
583 ssh user@host notmuch "$@"
585 If the ssh client has enabled connection sharing (ControlMaster
586 option in OpenSSH), the emacs interface can be quite responsive this
591 Fix "notmuch search" to print nothing when nothing matches
593 The 0.4 release had a bug in which:
595 notmuch search <expression-with-no-matches>
597 would produce a single blank line of output, (where previous
598 versions would produce no output. This fix also causes a change in
599 the --format=json output, (which would previously produce "[]" and
600 now produces nothing).
602 Emacs interface improvements
603 ----------------------------
604 Fix to allow pipe ('|') command to work when using notmuch over ssh
606 Fix count of lines in hidden signatures.
608 Omit repeated subject lines in (collapsed) thread display.
610 Display current thread subject in a header line.
612 Provide a "c i" binding to copy a thread ID from the search view.
614 Allow for notmuch-fcc-dirs to have a value of nil.
616 Also, the more complex form of notmuch-fcc-dirs now has a slightly
617 different format. It no longer has a special first-element, fallback
618 string. Instead it's now a list of cons cells where the car of each
619 cell is a regular expression to be matched against the sender
620 address, and the cdr is the name of a folder to use for an FCC. So
621 the old fallback behavior can be achieved by including a final cell
622 of (".*" . "default-fcc-folder").
624 Vim interface improvements
625 --------------------------
626 Felipe Contreras provided a number of updates for the vim interface.
628 These include optimizations, support for newer versions of vim, fixed
629 support for sending mail on modern systems, new commands, and
634 Added initial ruby bindings in bindings/ruby
636 Notmuch 0.4 (2010-11-01)
637 ========================
638 New command-line features
639 -------------------------
640 notmuch search --output=(summary|threads|messages|tags|files)
642 This new option allows for particular items to be returned from
643 notmuch searches. The "summary" option is the default and behaves
644 just as "notmuch search" has historically behaved.
646 The new option values allow for thread IDs, message IDs, lists of
647 tags, and lists of filenames to be returned from searches. It is
648 expected that this new option will be very useful in shell
649 scripts. For example:
651 for file in $(notmuch search --output=files <search-terms>); do
652 <operations-on> "$file"
655 notmuch show --format=mbox <search-specification>
657 This new option allows for the messages matching a search
658 specification to be presented as an mbox. Specifically the "mboxrd"
659 format is used which allows for reversible quoting of lines
660 beginning with "From ". A reader should remove a single '>' from the
661 beginning of all lines beginning with one or more '>' characters
662 followed by the 5 characters "From ".
664 notmuch config [get|set] <section>.<item> [value ...]
666 The new top-level "config" command allows for any value in the
667 notmuch configuration file to be queried or set to a new value. Both
668 single-valued and multi-valued items are supported, as our any
669 custom items stored in the configuration file.
671 Avoid setting Bcc header in "notmuch reply"
673 We decided that this was a bit heavy-handed as the actual mail
674 user-agent should be responsible for setting any Bcc option. Also,
675 see below for the notmuch/emacs user-agent now setting an Fcc by
676 default rather than Bcc.
680 Add notmuch_query_get_query_string and notmuch_query_get_sort
682 These are simply functions for querying properties of a
683 notmuch_query_t object.
687 Enable Fcc of all sent messages by default (to "sent" directory)
689 All messages sent from the emacs interface will now be saved to the
690 notmuch mail store where they will be incorporated to the database
691 by the next "notmuch new". By default, messages are saved to the
692 "sent" directory at the top-level of the mail store. This directory
693 can be customized by means of the "Notmuch Fcc Dirs" option in the
694 notmuch customize interface.
696 Ability to all open messages in a thread to a pipe
698 Historically, the '|' keybinding allows for piping a single message
699 to an external command. Now, by prefixing this key with a prefix
700 argument, (for example, by pressing "Control-U |"), all open
701 messages in the current thread will be sent to the external command.
703 Optional support for detecting inline patches
705 This hook is disabled by default but can be enabled with a checkbox
706 under "Notmuch Show Insert Text/Plain Hook" in the notmuch customize
707 interface. It allows for inline patches to be detected and treated
708 as if they were attachments, (with context-sensitive highlighting).
710 Automatically tag messages as "replied" when sending a reply
712 Messages replied to within the emacs interface will now be tagged as
713 "replied". This feature can easily be customized to add or remove
714 other tags as well. For example, a user might use a tag of
715 "needs-reply" and can configure this feature to automatically remove
716 that tag when replying. See "Notmuch Message Mark Replied" in the
717 notmuch customize interface.
719 Allow search-result color specifications to overlay each other
721 For example, one tag can specify the background color of matching
722 lines, while another can specify the foreground. With this change,
723 both settings will now be visible simultaneously, (which was not the
724 case in previous releases). See "Notmuch Search Line Faces" in the
725 notmuch customize interface.
727 Make hidden author names still available for incremental search.
729 When there is insufficient space to display all authors of a thread
730 in search results, the names of hidden authors are now still made
731 available to emacs' incremental search commands. As the user
732 searches, matching lines will temporarily expand to show the hidden
735 New binding of Control-TAB (works like TAB in reverse)
737 Many notmuch nodes already use TAB to navigate forward through
738 various items allowing actions, (message headers, email attachments,
739 etc.). The new Control-TAB binding operates similarly but in the
742 New build-system features
743 -------------------------
744 Various portability fixes have been applied
746 These include fixes for build failures on at least Solaris, FreeBSD,
747 and Fedora systems. We're hopeful that the notmuch code base is now
748 more portable than ever before.
750 Arrange for libnotmuch to be found automatically after make install
752 The notmuch build system is now careful to help the user avoid
753 errors of the form "libnotmuch.so could not be found" immediately
754 after installing. This support takes two forms:
756 1. If the library is installed to a system directory,
757 (configured in /etc/ld.so.conf), then "make install" will
758 automatically run ldconfig.
760 2. If the library is installed to a non-system directory, the
761 build system adds a DR_RUNPATH entry to the final binary
762 pointing to the directory to which the library is installed.
764 When this support works, the user should be able to run notmuch
765 immediately after "make install", without any errors trying to find
766 the notmuch library, and without having to manually set environment
767 variables such as LD_LIBRARY_PATH.
769 Check compiler/linker options before using them
771 The configure script now carefully checks that any desired
772 compilation options, (whether for enabling compiler warnings, or for
773 embedding rpath, etc.), are supported. Only supported options are
774 used in the resulting Makefile.
776 New test-suite features
777 -----------------------
778 New modularization of test suite.
780 Thanks to a gracious relicensing of the test-suite infrastructure
781 from the git project, notmuch now has a modular test suite. This
782 provides the ability to run individual sections of the test suite
783 rather than the whole things. It also provides better summary of
784 test results, with support for tests that are expected to fail
785 (BROKEN and FIXED) in addition to PASS and FAIL. Finally, it makes
786 it easy to run the test suite within valgrind (pass --valgrind to
787 notmuch-test or to any sub-script) which has been very useful.
789 New testing of emacs interface.
791 The test suite has been augmented to allow automated testing of the
792 emacs interfaces. So far, this includes basic searches, display of
793 threads, and tag manipulation. This also includes a test that a new
794 message can successfully be sent out through a (dummy) SMTP server
795 and that said message is successfully integrated into the notmuch
796 database via the FCC setting.
800 Fix potential corruption of database when "notmuch new " is interrupted.
802 Previously, an interruption of "notmuch new" would (rarely) result
803 in a corrupt database. The corruption would manifest itself by a
804 persistent error of the form:
806 document ID of 1234 has no thread ID
808 The message-adding code has been carefully audited and reworked to
809 avoid this sort of corruption regardless of when it is interrupted.
811 Fix failure with extremely long message ID headers.
813 Previously, a message with an extremely long message ID, (say, more
814 than 300 characters), would fail to be added to notmuch, (triggering
815 Xapian exceptions). This has now been fixed.
817 Fix for messages with "charset=unknown-8bit"
819 Previously, messages with this charset would cause notmuch to emit a
820 GMime warning, (which would then trip up emacs or other interfaces
821 parsing the notmuch results).
823 Fix notmuch_query_search_threads function to return NULL on any exception
825 Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails
827 Previously, this command could confusingly report a Xapian
828 exception, yet still return an error code of 0. It now correctly
829 returns a failing error code of 1 in this case.
833 Fix to handle a message with a subject containing, for example "[1234]"
835 Previously, a message subject containing a sequence of digits within
836 square brackets would cause the emacs interface to mis-parse the
837 output of "notmuch search". This would result in the message being
838 mis-displayed and prevent the user from manipulating the message in
841 Fix to correctly handle message IDs containing ".."
843 The emacs interface now properly quotes message IDs to avoid a
844 Xapian bug in which the ".." within a message ID would be
845 misinterpreted as a numeric range specification.
849 The python bindings for notmuch have been updated to work with python3.
851 Debian-specific fixes
852 ---------------------
853 Fix emacs initialization so "M-x notmuch" works for users by default.
855 Now, a new Debian user can immediately run "emacs -f notmuch" after
856 "apt-get install notmuch". Previously, the user would have had to
857 edit the ~/.emacs file to add "(require 'notmuch)" before this would
860 Notmuch 0.3.1 (2010-04-27)
861 ==========================
864 Fix an infinite loop in "notmuch reply"
866 This bug could be triggered by replying to a message where the
867 user's primary email address did not appear in the To: header and
868 the user had not configured any secondary email addresses. The bug
869 was a simple re-use of the same iterator variable in nested loops.
871 Fix a potential SEGV in "notmuch search"
873 This bug could be triggered by an author name ending in a ','.
874 Admittedly - that's almost certainly a spam email, but we never
875 want notmuch to crash.
879 Fix calculations for line wrapping in the primary "notmuch" view.
881 Fix Fcc support to prompt to create a directory if the specified Fcc
882 directory does not exist.
886 Fix build on OpenSolaris (at least) due to missing 'extern "C"' block.
888 Without this, the C++ sources could not find strcasestr and the
889 final linking of notmuch would fail.
891 Notmuch 0.3 (2010-04-27)
892 ========================
893 New command-line features
894 -------------------------
895 User-configurable tags for new messages
897 A new "new.tags" option is available in the configuration file to
898 determine which tags are applied to new messages. Run "notmuch
899 setup" to generate new documentation within ~/.notmuch-config on how
900 to specify this value.
902 Threads search results named based on subjects that match search
904 This means that when new mails arrived to a thread you've previously
905 read, and the new mails have a new subject, you will see that
906 subject in the search results rather than the old subject.
908 Faster operation of "notmuch tag" (avoid unneeded sorting)
910 Since the user just wants to tag all matching messages, we can make
911 things perform a bit faster by avoiding the sort.
913 Even Better guessing of From: header for "notmuch reply"
915 Notmuch now looks at a number of headers when trying to figure out
916 the best From: header to use in a reply. This is helpful if you have
917 several configured email addresses, and you also subscribe to various
918 mailing lists with different addresses, (so that mails you are
919 replying to won't always include your subscribed address in the To:
922 Indication of author names that match a search
924 When notmuch displays threads as the result of a search, it now
925 lists the authors that match the search before listing the other
926 authors in the thread. It inserts a pipe '|' symbol between the last
927 matching and first non-matching author. This is especially useful in
928 a search that includes tag:unread. Now the authors of the unread
929 messages in the thread are listed first.
933 Sebastian Spaeth has contributed his python bindings for the notmuch
934 library to the central repository. These bindings were previously
935 known as "cnotmuch" within python but have now been renamed to be
936 accessible with a simple, and more official-looking "import notmuch".
938 The bindings have already proven very useful as people proficient in
939 python have been able to easily develop programs to do notmuch-based
940 searches for email-address completion, maildir-flag synchronization,
943 These bindings are available within the bindings/python directory, but
944 are not yet integrated into the top-level Makefiles, nor the top-level
945 package-building scripts. Improvements are welcome.
947 Emacs interface improvements
948 ----------------------------
949 An entirely new initial view for notmuch, (friendly yet powerful)
951 Some of us call the new view "notmuch hello" but you can get at it
952 by simply calling "emacs -f notmuch". The new view provides a search
953 bar where new searches can be performed. It also displays a list of
954 recent searches, along with a button to save any of these, giving it
955 a new name as a "saved search". Many people find these "saved
956 searches" one of the most convenient ways of organizing their mail,
957 (providing all of the features of "folders" in other mail clients,
958 but without any of the disadvantages).
960 Finally, this view can also optionally display all of the tags that
961 exist in the database, along with a count for each tag, and a custom
962 search of messages with that tag that's simply a click (or keypress)
965 Note: For users that liked the original mode of "emacs -f notmuch"
966 immediately displaying a particular search result, we
967 recommend instead running something like:
969 emacs --eval '(notmuch search "tag:inbox" t)'
971 The "t" means to sort the messages in an "oldest first" order,
972 (as notmuch would do previously by default). You can also
973 leave that off to have your search results in "newest first"
976 Full-featured "customize" support for configuring notmuch
978 Notmuch now plugs in well to the emacs "customize" mode to make it
979 much simpler to find things about the notmuch interface that can be
982 You can get to this mode by starting at the main "Customize" menu in
983 emacs, then browsing through "Applications", "Mail", and
984 "Notmuch". Or you can go straight to "M-x customize-group"
987 Once you're at the customize screen, you'll see a list of documented
988 options that can be manipulated along with checkboxes, drop-down
989 selectors, and text-entry boxes for configuring the various
992 Support for doing tab-completion of email addresses
994 This support currently relies on an external program,
995 (notmuch-addresses), that is not yet shipped with notmuch
996 itself. But multiple, suitable implementations of this program have
997 already been written that generate address completions by doing
998 notmuch searches of your email collection. For example, providing
999 first those addresses that you have composed messages to in the
1002 One such program (implemented in python with the python bindings to
1003 notmuch) is available via:
1005 git clone http://jkr.acm.jhu.edu/git/notmuch_addresses.git
1007 Install that program as notmuch-addresses on your PATH, and then
1008 hitting TAB on a partial email address or name within the To: or Cc:
1009 line of an email message will provide matching completions.
1011 Support for file-based (Fcc) delivery of sent messages to mail store
1013 This isn't yet enabled by default. To enable this, one will have to
1014 set the "Notmuch Fcc Dirs" setting within the notmuch customize
1015 screen, (see its documentation there for details). We anticipate
1016 making this automatic in a future release.
1018 New 'G' key binding to trigger mail refresh (G == "Get new mail")
1020 The 'G' key works wherever '=' works. Before refreshing the screen
1021 it calls an external program that can be used to poll email servers,
1022 run notmuch new and setup specific tags for the new emails. The
1023 script to be called should be configured with the "Notmuch Poll
1024 Script" setting in the customize interface. This script will
1025 typically invoke "notmuch new" and then perhaps several "notmuch
1028 Implement emacs message display with the JSON output from notmuch.
1030 This is much more robust than the previous implementation, (where
1031 some HTML mails and mail quoting the notmuch code with the delimiter
1032 characters in it would cause the parser to fall over).
1034 Better handling of HTML messages and MIME attachments (inline images!)
1036 Allow for any MIME parts that emacs can display to be displayed
1037 inline. This includes inline viewing of image attachments, (provided
1038 the window is large enough to fit the image at its natural size).
1040 Much more robust handling of HTML messages. Currently both text/plain
1041 and text/html alternates will be rendered next to each other. In a
1042 future release, users will be able to decide to see only one or the
1043 other representation.
1045 Each attachment now has its own button so that attachments can be
1046 saved individually (the 'w' key is still available to save all
1049 Customizable support for tidying of text/plain message content
1051 Many new functions are available for tidying up message
1052 content. These include options such as wrapping long lines,
1053 compressing duplicate blank lines, etc.
1055 Most of these are disabled by default, but can easily be enabled by
1056 clicking the available check boxes under the "Notmuch Show Insert
1057 Text/Plain Hook" within the notmuch customize screen.
1059 New support for searchable citations (even when hidden)
1061 When portions of overly-long citations are hidden, the contents of
1062 these citations will still be available for emacs' standard
1063 "incremental search" functions. When the search matches any portion
1064 of a hidden citation, the citation will become visible temporarily
1065 to display the search result.
1067 More flexible handling of header visibility
1069 As an answer to complaints from many users, the To, Cc, and Date
1070 headers of messages are no longer hidden by default. For those users
1071 that liked that these were hidden, a new "Notmuch Messages Headers
1072 Visible" option in the customize interface can be set to nil. The
1073 visibility of headers can still be toggled on a per-message basis
1074 with the 'h' keybinding.
1076 For users that don't want to see some subset of those headers, the
1077 new "Notmuch Message Headers" variable can be customized to list
1078 only those headers that should be present in the display of a message.
1080 The Return key now toggles message visibility anywhere
1082 Previously this worked only on the first summary-line of a message.
1084 Customizable formatting of search results
1086 The user can easily customize the order, width, and formatting of
1087 the various fields in a "notmuch search" buffer. See the "Notmuch
1088 Search Result Format" section of the customize interface.
1090 Generate nicer names for search buffers when using a saved search.
1092 Add a notmuch User-Agent header when sending mail from notmuch/emacs.
1094 New keybinding (M-Ret) to open all collapsed messages in a thread.
1098 Provide a new NOTMUCH_SORT_UNSORTED value for queries
1100 This can be somewhat faster when sorting simply isn't desired. For
1101 example when collecting a set of messages that will all be
1102 manipulated identically, (adding a tag, removing a tag, deleting the
1103 messages), then there's no advantage to sorting the messages by
1108 Fix to compile against GMime 2.6
1110 Previously notmuch insisted on being able to find GMime 2.4, (even
1111 though GMime 2.6 would have worked all along).
1113 Fix configure script to accept (and ignore) various standard options.
1115 For example, those that the Gentoo build scripts expect configure to
1116 accept are now all accepted.
1120 A large number of new tests for the many new features.
1122 Better display of output from failed tests.
1124 Now shows failures with diff rather than forcing the user to gaze at
1125 complete actual and expected output looking for deviation.
1127 Notmuch 0.2 (2010-04-16)
1128 ========================
1129 This is the second release of the notmuch mail system, with actual
1130 detailed release notes this time!
1132 This release consists of a number of minor new features that make
1133 notmuch more pleasant to use, and a few fairly major bug fixes.
1135 We didn't quite hit our release target of "about a week" from the 0.1
1136 release, (0.2 is happening 11 days after 0.1), but we hope to do
1137 better for next week. Look forward to some major features coming to
1138 notmuch in subsequent releases.
1144 Better guessing of From: header.
1146 Notmuch now tries harder to guess which configured address should be
1147 used as the From: line in a "notmuch reply". It will examine the
1148 Received: headers if it fails to find any configured address in To:
1149 or Cc:. This allows it to often choose the correct address even when
1150 replying to a message sent to a mailing list, and not directly to a
1153 Make "notmuch count" with no arguments count all messages
1155 Previously, it was hard to construct a search term that was
1156 guaranteed to match all messages.
1158 Provide a new special-case search term of "*" to match all messages.
1160 This can be used in any command accepting a search term, such as
1161 "notmuch search '*'". Note that you'll want to take care that the
1162 shell doesn't expand * against the current files. And note that the
1163 support for "*" is a special case. It's only meaningful as a single
1164 search term and loses its special meaning when combined with any
1167 Automatically detect thread connections even when a parent message is
1170 Previously, if two or more message were received with a common
1171 parent, but that parent was not received, then these messages would
1172 not be recognized as belonging to the same thread. This is now fixed
1173 so that such messages are properly connected in a thread.
1177 Fix potential data loss in "notmuch new" with SIGINT
1179 One code path in "notmuch new" was not properly handling
1180 SIGINT. Previously, this could lead to messages being removed from
1181 the database (and their tags being lost) if the user pressed
1182 Control-C while "notmuch new" was working.
1184 Fix segfault when a message includes a MIME part that is empty.
1186 Fix handling of non-ASCII characters with --format=json
1188 Previously, characters outside the range of 7-bit ASCII were
1189 silently dropped from the JSON output. This led to corrupted display
1190 of utf-8 content in the upcoming notmuch web-based frontends.
1192 Fix headers to be properly decoded in "notmuch reply"
1194 Previously, the user might see:
1196 Subject: Re: =?iso-8859-2?q?Rozlu=E8ka?=
1200 Subject: Re: Rozlučka
1202 The former text is properly encoded to be RFC-compliant SMTP, will
1203 be sent correctly, and will be properly decoded by the
1204 recipient. But the user trying to edit the reply would likely be
1205 unable to read or edit that field in its encoded form.
1207 Emacs client features
1208 ---------------------
1209 Show the last few lines of citations as well as the first few lines.
1211 It's often the case that the last sentence of a citation is what is
1212 being replied to directly, so the last few lines are often much more
1213 important. The number of lines shown at the beginning and end of any
1214 citation can be configured, (notmuch-show-citation-lines-prefix and
1215 notmuch-show-citation-lines-suffix).
1217 The '+' and '-' commands in the search view can now add and remove
1220 Selective bulk tagging is now possible by selecting a region of
1221 threads and then using either the '+' or '-' keybindings. Bulk
1222 tagging is still available for all threads matching the current
1223 search with the '*' binding.
1225 More meaningful buffer names for thread-view buffers.
1227 Notmuch now uses the Subject of the thread as the buffer
1228 name. Previously it was using the thread ID, which is a meaningless
1231 Provide for customized colors of threads in search view based on tags.
1233 See the documentation of notmuch-search-line-faces, (or us "M-x
1234 customize" and browse to the "notmuch" group within "Applications"
1235 and "Mail"), for details on how to configure this colorization.
1237 Build-system features
1238 ---------------------
1239 Add support to properly build libnotmuch on Darwin systems (OS X).
1241 Add support to configure for many standard options.
1243 We include actual support for:
1245 --includedir --mandir --sysconfdir
1247 And accept and silently ignore several more:
1249 --build --infodir --libexecdir --localstatedir
1250 --disable-maintainer-mode --disable-dependency-tracking
1252 Install emacs client in "make install" rather than requiring a
1253 separate "make install-emacs".
1255 Automatically compute versions numbers between releases.
1257 This support uses the git-describe notation, so a version such as
1258 0.1-144-g43cbbfc indicates a version that is 144 commits since the
1259 0.1 release and is available as git commit "43cbbfc".
1261 Add a new "make test" target to run the test suite and actually verify
1264 Notmuch 0.1 (2010-04-05)
1265 ========================
1266 This is the first release of the notmuch mail system.
1268 It includes the libnotmuch library, the notmuch command-line
1269 interface, and an emacs-based interface to notmuch.
1271 Note: Notmuch will work best with Xapian 1.0.18 (or later) or Xapian
1272 1.1.4 (or later). Previous versions of Xapian (whether 1.0 or 1.1) had
1273 a performance bug that made notmuch very slow when modifying
1274 tags. This would cause distracting pauses when reading mail while
1275 notmuch would wait for Xapian when removing the "inbox" and "unread"
1276 tags from messages in a thread.