From ddc42fcf740c45bd876ce5a1f15b3da200aa76eb Mon Sep 17 00:00:00 2001 From: Tomi Ollila Date: Wed, 1 Feb 2012 17:22:49 +0200 Subject: [PATCH] [PATCH 1/2] NEWS: markup changes to make mdwn->html look slightly better --- 0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a | 1588 +++++++++++++++++++++ 1 file changed, 1588 insertions(+) create mode 100644 0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a diff --git a/0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a b/0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a new file mode 100644 index 000000000..74d2ce3e1 --- /dev/null +++ b/0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a @@ -0,0 +1,1588 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id 23995429E34 + for ; Wed, 1 Feb 2012 07:22:57 -0800 (PST) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: 0 +X-Spam-Level: +X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none] + autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id 51HnTi+2Pmp4 for ; + Wed, 1 Feb 2012 07:22:52 -0800 (PST) +Received: from guru.guru-group.fi (guru-group.fi [87.108.86.66]) + by olra.theworths.org (Postfix) with ESMTP id 81377431E64 + for ; Wed, 1 Feb 2012 07:22:51 -0800 (PST) +Received: by guru.guru-group.fi (Postfix, from userid 501) + id 718E868055; Wed, 1 Feb 2012 17:22:52 +0200 (EET) +From: Tomi Ollila +To: notmuch@notmuchmail.org +Subject: + [PATCH 1/2] NEWS: markup changes to make mdwn->html look slightly better +Date: Wed, 1 Feb 2012 17:22:49 +0200 +Message-Id: <1328109770-29279-1-git-send-email-tomi.ollila@iki.fi> +X-Mailer: git-send-email 1.7.6.1 +MIME-Version: 1.0 +Content-Type: text/plain; charset=UTF-8 +Content-Transfer-Encoding: 8bit +Cc: Tomi Ollila +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Wed, 01 Feb 2012 15:22:57 -0000 + +Some formatting in NEWS file has been changed so that it could +be given to markdown processing almost verbatim. +More effort has been put into formatting of version 0.11 (and 0.12) +of notmuch NEWS than previous versions but everything is in better +shape that those used to be. +--- +See http://notmuchmail.org/news/ (as of 2012-02-01) to see current +output (newssplit.pl -generated) + NEWS | 509 ++++++++++++++++++++++++++++++++++++------------------------------ + 1 files changed, 280 insertions(+), 229 deletions(-) + +diff --git a/NEWS b/NEWS +index 2acdce5..1e23ec7 100644 +--- a/NEWS ++++ b/NEWS +@@ -4,35 +4,35 @@ Notmuch 0.12 (2012-xx-xx) + Command-Line Interface + ---------------------- + +-Reply to sender ++* Reply to sender + +- "notmuch reply" has gained the ability to create a reply template ++ `notmuch reply` has gained the ability to create a reply template + for replying just to the sender of the message, in addition to reply + to all. The feature is available through the new command line option +- --reply-to=(all|sender). ++ `--reply-to=(all|sender)`. + +-Tag exclusion ++* Tag exclusion + + Tags can be automatically excluded from search results by adding them +- to the new 'search.exclude_tags' option in the Notmuch config file. ++ to the new `search.exclude_tags` option in the Notmuch config file. + + This behaviour can be overridden by explicitly including an excluded + tag in your query, for example: + +- notmuch search $your_query and tag:$excluded_tag ++ notmuch search $your_query and tag:$excluded_tag + +- Existing users will probably want to run "notmuch setup" again to add ++ Existing users will probably want to run `notmuch setup` again to add + the new well-commented [search] section to the configuration file. + + For new configurations, accepting the default setting will cause the + tags "deleted" and "spam" to be excluded, equivalent to running: + +- notmuch config set search.exclude_tags deleted spam ++ notmuch config set search.exclude_tags deleted spam + + Emacs Interface + --------------- + +-Reply to sender ++* Reply to sender + + The Emacs interface has, with the new CLI support, gained the + ability to reply to sender in addition to reply to all. In both show +@@ -42,15 +42,15 @@ Reply to sender + Library changes + --------------- + +-New functions ++* New functions + +- notmuch_query_add_tag_exclude supports the new tag exclusion ++ `notmuch_query_add_tag_exclude` supports the new tag exclusion + feature. + + Build fixes + ----------- + +-Compatibility with GMime 2.6 ++* Compatibility with GMime 2.6 + + It is now possible to build notmuch against both GMime 2.4 and 2.6. + However, a bug in current GMime 2.6 causes notmuch not to report +@@ -62,38 +62,38 @@ Notmuch 0.11 (2012-01-13) + Command-Line Interface + ---------------------- + +-Hooks ++* Hooks + + Hooks have been introduced to notmuch. Hooks are scripts that notmuch +- invokes before and after certain actions. Initially, "notmuch new" +- supports "pre-new" and "post-new" hooks that are run before and after ++ invokes before and after certain actions. Initially, `notmuch new` ++ supports `pre-new` and `post-new` hooks that are run before and after + importing new messages into the database. + +-notmuch reply --decrypt bugfix ++* `notmuch reply --decrypt bugfix` + +- The "notmuch reply" command with --decrypt argument had a rarely ++ The `notmuch reply` command with `--decrypt` argument had a rarely + occurring bug that caused an encrypted message not to be decrypted + sometimes. This is now fixed. + + Performance + ----------- + +-Automatic tag query optimization ++* Automatic tag query optimization + +- "notmuch tag" now automatically optimizes the user's query to ++ `notmuch tag` now automatically optimizes the user's query to + exclude messages whose tags won't change. In the past, we've + suggested that people do this by hand; this is no longer necessary. + +-Don't sort messages when creating a dump file ++* Don't sort messages when creating a dump file + + This speeds up tag dumps considerably, without any loss of + information. To replicate the old behavior of sorted output (for +- example to compare two dump files), one can use e.g. sort(1). ++ example to compare two dump files), one can use e.g. `sort(1)`. + + Memory Management + ----------------- + +-Reduction of memory leaks ++* Reduction of memory leaks + + Two memory leaks when searching and showing messages were identified + and fixed in this release. +@@ -101,63 +101,63 @@ Reduction of memory leaks + Emacs Interface + --------------- + +-Bug fixes ++* Bug fixes + + notmuch-show-advance (bound to the spacebar in notmuch-show-mode) had + a bug that caused it to always jump to the next message, even if it + should have scrolled down to show more of the current message instead. + This is now fixed. + +-Support "notmuch new" as a notmuch-poll-script ++* Support `notmuch new` as a notmuch-poll-script + +- It's now possible to use "notmuch new" as a notmuch-poll-script ++ It's now possible to use `notmuch new` as a notmuch-poll-script + directly. This is also the new default. This allows taking better +- advantage of the "notmuch new" hooks from emacs without intermediate ++ advantage of the `notmuch new` hooks from emacs without intermediate + scripts. + +-Improvements in saved search management ++* Improvements in saved search management + + New saved searches are now appended to the list of saved searches, + not inserted in front. It's also possible to define a sort function + for displaying saved searches; alphabetical sort is provided. + +-Hooks for notmuch-hello ++* Hooks for notmuch-hello + + Two new hooks have been added: "notmuch-hello-mode-hook" (called after + entering notmuch-hello-mode) and "notmuch-hello-refresh-hook" (called + after updating a notmuch-hello buffer). + +-New face for crypto parts headers ++* New face for crypto parts headers + + Crypto parts used to be displayed with a hardcoded color. A new face + has been introduced to fix this: notmuch-crypto-part-header. It + defaults to the same value as before, but can be customized to match + other color themes. + +-Use space as default thousands separator ++* Use space as default thousands separator + + Large numbers in notmuch-hello are now displayed using a space as + thousands separator (e.g. "123 456" instead of "123,456"). This can be + changed by customizing "notmuch-hello-thousands-separator". + +-Call notmuch-show instead of notmuch-search when clicking on +-buttonized id: links. ++* Call notmuch-show instead of notmuch-search when clicking on ++ buttonized id: links. + +-New function notmuch-show-advance ++* New function notmuch-show-advance + + This new function advances through just the current thread, and is + less invasive than notmuch-show-advance-and-archive. It can easily + be bound to SPC with: + +- (define-key notmuch-show-mode-map " " 'notmuch-show-advance) ++ (define-key notmuch-show-mode-map " " 'notmuch-show-advance) + +-Various performance improvements. ++* Various performance improvements + + New add-on tool + --------------- + +-The tool contrib/notmuch-deliver helps with initial delivery and +-tagging of mail (replacing running notmuch new). ++The tool `contrib/notmuch-deliver` helps with initial delivery and ++tagging of mail (replacing running `notmuch new`). + + + Notmuch 0.10.2 (2011-12-04) +@@ -166,9 +166,9 @@ Notmuch 0.10.2 (2011-12-04) + Bug-fix release. + ---------------- + +-Fix crash in python bindings. ++* Fix crash in python bindings + +- The python bindings did not call g_type_init, which caused crashes ++ The python bindings did not call `g_type_init`, which caused crashes + for some, but not all users. + + Notmuch 0.10.1 (2011-11-25) +@@ -177,7 +177,7 @@ Notmuch 0.10.1 (2011-11-25) + Bug-fix release. + ---------------- + +-Fix --help argument ++* Fix --help argument + + Argument processing changes in 0.10 introduced a bug where "notmuch + --help" crashed while "notmuch help" worked fine. This is fixed in +@@ -198,24 +198,24 @@ Full test coverage of the stashing feature in Emacs. + New command-line features + ------------------------- + +-Add "notmuch restore --accumulate" option ++* Add "notmuch restore --accumulate" option + + The --accumulate switch causes the union of the existing and new tags to be + applied, instead of replacing each message's tags as they are read in from + the dump file. + +-Add search terms to "notmuch dump" ++* Add search terms to "notmuch dump" + + The dump command now takes an optional search term much like notmuch + search/show/tag. The output file argument of dump is deprecated in + favour of using stdout. + +-Add "notmuch search" --offset and --limit options ++* Add "notmuch search" --offset and --limit options + + The search command now takes options --offset=[-]N and --limit=N to limit + the number of results shown. + +-Add "notmuch count --output" option ++* Add "notmuch count --output" option + + The count command is now capable of counting threads in addition to + messages. This is selected using the new --output=(threads|messages) option. +@@ -223,21 +223,21 @@ Add "notmuch count --output" option + New emacs UI features + --------------------- + +-Add tab-completion for notmuch-search and notmuch-search-filter ++* Add tab-completion for notmuch-search and notmuch-search-filter + + These functions now support completion tags for query parts + starting with "tag:". + +-Turn "id:MSG-ID" links into buttons associated with notmuch searches ++* Turn "id:MSG-ID" links into buttons associated with notmuch searches + + Text of the form "id:MSG-ID" in mails is now a clickable button that + opens a notmuch search for the given message id. + +-Add keybinding ('c I') for stashing Message-ID's without an id: prefix ++* Add keybinding ('c I') for stashing Message-ID's without an id: prefix + + Reduces manual labour when stashing them for use outside notmuch. + +-Do not query on notmuch-search exit ++* Do not query on notmuch-search exit + + It is harmless to kill the external notmuch process, so the user + is no longer interrogated when they interrupt a search. +@@ -245,9 +245,9 @@ Do not query on notmuch-search exit + Performance + ----------- + +-Emacs now constructs large search buffers more efficiently ++* Emacs now constructs large search buffers more efficiently + +-Search avoids opening and parsing message files ++* Search avoids opening and parsing message files + + We now store more information in the database so search no longer + has to open every message file to get basic headers. This can +@@ -267,7 +267,7 @@ tools are not part of notmuch, and you should check their individual + licenses. Feel free to report problems with them to the notmuch + mailing list. + +-nmbug - share tags with a given prefix ++* nmbug - share tags with a given prefix + + nmbug helps maintain a git repo containing all tags with a given + prefix (by default "notmuch::"). Tags can be shared by commiting +@@ -279,7 +279,7 @@ Notmuch 0.9 (2011-10-01) + New, general features + --------------------- + +-Correct handling of interruptions during "notmuch new" ++* Correct handling of interruptions during "notmuch new" + + "notmuch new" now operates as a series of small, self-consistent + transactions, so it can correctly resume after an interruption or +@@ -290,16 +290,16 @@ Correct handling of interruptions during "notmuch new" + Library changes + --------------- + +-New functions ++* New functions + +- notmuch_database_begin_atomic and notmuch_database_end_atomic allow +- multiple database operations to be performed atomically. ++ `notmuch_database_begin_atomic` and `notmuch_database_end_atomic` ++ allow multiple database operations to be performed atomically. + +- notmuch_database_find_message_by_filename does exactly what it says. ++ `notmuch_database_find_message_by_filename` does exactly what it says. + +-API changes ++* API changes + +- notmuch_database_find_message (and n_d_f_m_by_filename) now return ++ `notmuch_database_find_message` (and `n_d_f_m_by_filename`) now return + a status indicator and uses an output parameter for the + message. This change required changing the SONAME of libnotmuch to + libnotmuch.so.2 +@@ -309,8 +309,8 @@ Python bindings changes + + - Re-encode python unicode objects to utf-8 before passing back to + libnotmuch. +- - Support Database().begin_atomic()/end_atomic() +- - Support Database().find_message_by_filename() ++ - Support `Database().begin_atomic()/end_atomic()` ++ - Support `Database().find_message_by_filename()` + NB! This needs a db opened in READ-WRITE mode currently, or it will crash + the python process. The is a limitation (=bug) of the underlying libnotmuch. + - Fixes where we would not throw NotmuchErrors when we should (Justus Winter) +@@ -319,17 +319,17 @@ Python bindings changes + Ruby bindings changes + --------------------- + +- - Wrap new library functions notmuch_database_{begin,end}_atomic. +- - Add new exception Notmuch::UnbalancedAtomicError. ++ - Wrap new library functions `notmuch_database_{begin,end}_atomic.` ++ - Add new exception `Notmuch::UnbalancedAtomicError.` + - Rename destroy to destroy! according to Ruby naming conventions. +- - Update for n_d_find_message* API changes (see above). ++ - Update for `n_d_find_message*` API changes (see above). + + Emacs improvements + ------------------ + + * Add gpg callback to crypto sigstatus buttons to retrieve/refresh + signing key. +- * Add notmuch-show-refresh-view function (and corresponding binding) ++ * Add `notmuch-show-refresh-view` function (and corresponding binding) + to refresh the view of a notmuch-show buffer. + + Reply formatting cleanup +@@ -341,7 +341,7 @@ Reply formatting cleanup + Notmuch 0.8 (2011-09-10) + ======================== + +-Improved handling of message/rfc822 parts ++* Improved handling of message/rfc822 parts + + Both in the CLI and the emacs interface. Output of rfc822 parts now + includes the primary headers, as well as the body and all subparts. +@@ -349,20 +349,20 @@ Improved handling of message/rfc822 parts + headers, is unfortunately not yet supported (but hopefully will be + soon). + +-Improved Build system portability ++* Improved Build system portability + + Certain parts of the shell script generating notmuch.sym were + specific to the GNU versions of sed and nm. The new version should + be more portable to e.g. OpenBSD. + +-Documentation update for Ruby bindings ++* Documentation update for Ruby bindings + + Added documentation, typo fixes, and improved support for rdoc. + +-Unicode, iterator, PEP8 changes for python bindings ++* Unicode, iterator, PEP8 changes for python bindings + + - PEP8 (code formatting) changes for python files. +- - Remove Tags.__len__ ; see 0.6 release notes for motivation. ++ - Remove `Tags.__len__` ; see 0.6 release notes for motivation. + - Decode headers as UTF8, encode (unicode) database paths as UTF8. + + Notmuch 0.7 (2011-08-01) +@@ -393,9 +393,9 @@ Sebastian Spaeth contributed two changes related to unicode and UTF8: + * query string is encoded as a UTF8 byte string + + Build-System improvements +------------------------- ++------------------------- + +-Generate notmuch.sym after the relevant object files ++* Generate notmuch.sym after the relevant object files + + This fixes a bug in parallel building. Thanks to Thomas Jost for the + patch. +@@ -403,19 +403,21 @@ Generate notmuch.sym after the relevant object files + Notmuch 0.6.1 (2011-07-17) + ========================== + +-Bug-fix release. +----------------- ++Bug-fix release ++--------------- + +-Re-export Xapian exception typeinfo symbols. ++* Re-export Xapian exception typeinfo symbols + + It turned out our aggressive symbol hiding caused problems for + people running gcc 4.4.5. + + Notmuch 0.6 (2011-07-01) + ======================= ++ + New, general features + --------------------- +-Folder-based searching ++ ++* Folder-based searching + + Notmuch queries can now include a search term to match the + directories in which mail files are stored (within the mail +@@ -447,13 +449,13 @@ Folder-based searching + notmuch new + notmuch restore notmuch.dump + +-Support for PGP/MIME ++* Support for PGP/MIME + +- Both the command line interface and the emacs-interface have new ++ Both the command-line interface and the emacs-interface have new + support for PGP/MIME, detailed below. Thanks to Daniel Kahn Gillmor + and Jameson Graef Rollins for making this happen. + +-New, automatic tags: "signed" and "encrypted" ++* New, automatic tags: "signed" and "encrypted" + + These tags will automatically be applied to messages containing + multipart/signed and multipart/encrypted parts. +@@ -463,25 +465,26 @@ New, automatic tags: "signed" and "encrypted" + + New command-line features + ------------------------- +-Add new "notmuch show --verify" option for signature verification ++ ++* Add new "notmuch show --verify" option for signature verification + + This option instruct notmuch to verify the signature of + PGP/MIME-signed parts. + +-Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options ++* Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options + + This option instructs notmuch to decrypt PGP/MIME-encrypted parts. + Note that this feature currently requires gpg-agent and a passphrase entry + tool (e.g. pinentry-gtk or pinentry-curses). + +-Proper nesting of multipart parts in "notmuch show" output ++* Proper nesting of multipart parts in "notmuch show" output + + MIME parts are now display with proper nesting to reflect original + MIME hierarchy of a message. This allows clients to correctly + analyze the MIME structure, (such as, for example, determining to + which parts a signature part applies). + +-Add new "notmuch show --part" option ++* Add new "notmuch show --part" option + + This is a replacement for the older "notmuch part" command, (which + is now deprecated—it should still work as always, but is no longer +@@ -490,7 +493,7 @@ Add new "notmuch show --part" option + part, (such as --format=json for extracting a message part with JSON + formatting). + +-Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *") ++* Deprecate "notmuch search-tags" (in favor of "notmuch search --output=tags *") + + The "notmuch search-tags" sub-command has been redundant since the + addition of the --output=tags option to "notmuch search". We now +@@ -500,7 +503,8 @@ Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *") + + Performance improvements + ------------------------ +-Faster searches (by doing fewer searches to construct threads) ++ ++* Faster searches (by doing fewer searches to construct threads) + + Whenever a user asks for search results as threads, notmuch first + performs a search for messages matching the query, then performs +@@ -509,7 +513,7 @@ Faster searches (by doing fewer searches to construct threads) + Removing inefficiencies and redundancies in these secondary searches + results in a measured speedups of 1.5x for a typical search. + +-Faster searches (by doing fewer passes to gather message data) ++* Faster searches (by doing fewer passes to gather message data) + + Optimizing Xapian data access patterns (using a single pass to get + all message-document data rather than a pass for each data type) +@@ -520,13 +524,13 @@ Faster searches (by doing fewer passes to gather message data) + of 2.5x for a search of all messages in his inbox (was 4.5s, now + 1.8s). Thanks, Austin! + +-Faster initial indexing ++* Faster initial indexing + + More efficient indexing of new messages results in a measured + speedup of 1.4x for the initial indexing of 3 GB of mail (1h 14m + rather than 1h 46m). Thanks to Austin Clements and Michal Sojka. + +-Make "notmuch new" faster for unchanged directories ++* Make "notmuch new" faster for unchanged directories + + Optimizing to not do any further examinations of sub-directories + when the filesystem indicates that a directory is unchanged from the +@@ -536,23 +540,23 @@ Make "notmuch new" faster for unchanged directories + New emacs-interface features + ---------------------------- + +-Support for PGP/MIME (GnuPG) ++* Support for PGP/MIME (GnuPG) + + Automatically indicate validity of signatures for multipart/signed + messages. Automatically display decrypted content for + multipart/encrypted messages. See the emacs variable + notmuch-crypto-process-mime for more information. Note that this +- needs gpg-agent and a pinentry tool just as the command line tools. ++ needs gpg-agent and a pinentry tool just as the command-line tools. + Also note there is no support SMIME yet. + +-Output of pipe command is now displayed if pipe command fails ++* Output of pipe command is now displayed if pipe command fails + + This is extremely useful in the common use case of piping a patch to + "git am". If git fails to cleanly merge the patch the error messages + from the failed merge are now clearly displayed to the user, (where + previously they were silently hidden from the user). + +-User-selectable From address ++* User-selectable From address + + A user can choose which configured email addresses should be used as + the From address whenever composing a new message. To do so, simply +@@ -568,12 +572,13 @@ User-selectable From address + the "Notmuch Always Prompt For Sender" option in the notmuch + customize group. + +-Hiding of repeated subjects in collapsed thread view ++* Hiding of repeated subjects in collapsed thread view + + In notmuch-show mode, if a collapsed message has the same subject as + its parent, the subject is not shown. + +-Automatic detection and hiding of original message in top-posted message ++* Automatic detection and hiding of original message in top-posted ++ message + + When a message contains a line looking something like: + +@@ -584,7 +589,7 @@ Automatic detection and hiding of original message in top-posted message + button to display it again). This makes the handling of top-posted + citations work much like conventional citations. + +-New hooks for running code when tags are modified ++* New hooks for running code when tags are modified + + Some users want to perform additional actions whenever a particular + tag is added/removed from a message. This could be used to, for +@@ -595,7 +600,7 @@ New hooks for running code when tags are modified + Notmuch Before Tag Hook + Notmuch After Tag Hook + +-New optional support for hiding some multipart/alternative parts ++* New optional support for hiding some multipart/alternative parts + + Many emails are sent with redundant content within a + multipart/alternative group (such as a text/plain part as well as a +@@ -609,12 +614,13 @@ New optional support for hiding some multipart/alternative parts + because there's not yet a simple way to re-display such a hidden + part if it is not actually redundant with a displayed part. + +-Better rendering of text/x-vcalendar parts ++* Better rendering of text/x-vcalendar parts + + These parts are now displayed in a format suitable for use with the + emacs diary. + +-Avoid getting confused by Subject and Author fields with newline characters ++* Avoid getting confused by Subject and Author fields with newline ++ characters + + Replacing all characters with ASCII code less than 32 with a question mark. + +@@ -623,6 +629,7 @@ and drop "name" if it's actually just a repeat of the email address). + + Vim interface improvements + -------------------------- ++ + Felipe Contreras provided a number of updates for the vim interface: + + * Using sendmail directly rather than mailx, +@@ -633,39 +640,43 @@ Felipe Contreras provided a number of updates for the vim interface: + + Bindings improvements + --------------------- +-Ruby bindings are now much more complete + +- Including QUERY.sort, QUERY.to_s, MESSAGE.maildir_flags_to_tags, +- MESSAGE.tags_to_maildir_flags, and MESSAGE.get_filenames ++* Ruby bindings are now much more complete ++ ++ Including `QUERY.sort`, `QUERY.to_s`, `MESSAGE.maildir_flags_to_tags`, ++ `MESSAGE.tags_to_maildir_flags`, and `MESSAGE.get_filenames` + + * Python bindings have been updated and extended ++ + (docs online at http://packages.python.org/notmuch/) + + New bindings: +- - Message().get_filenames(), +- - Message().tags_to_maildir_flags(),Message().maildir_flags_to_tags() +- - list(Threads()) and list(Messages) works now ++ - `Message().get_filenames()`, ++ - `Message().tags_to_maildir_flags()`, `Message().maildir_flags_to_tags()` ++ - `list(Threads())` and `list(Messages)` works now + +- - Message().__cmp__() and __hash__() +- These allow, for example: ++ - `Message().__cmp__() and __hash__()` ++ These allow, for example: + if msg1 == msg2: ... + +- As well as set arithmetic on Messages(): ++ As well as set arithmetic on `Messages()`: + + s1, s2= set(msgs1), set(msgs2) + s1.union(s2) + s2 -= s1 + + Removed: +- - len(Messages()) as it exhausted the iterator. +- Use len(list(Messages())) or +- Query.count_messages() to get the length. ++ - len(Messages()) as it exhausted the iterator. ++ Use len(list(Messages())) or ++ `Query.count_messages()` to get the length. + +-Added initial Go bindings in bindings/go ++* Added initial Go bindings in bindings/go + + New build-system features + ------------------------- +-Added support for building in a directory other than the source directory ++ ++* Added support for building in a directory other than the source ++ directory + + This can be used with the widely-supported idiom of simply running + the configure script from some other directory: +@@ -675,7 +686,7 @@ Added support for building in a directory other than the source directory + ../configure + make + +-Fix to save configure options for future, implicit runs of configure ++* Fix to save configure options for future, implicit runs of configure + + When a user updates the source (such as with "git pull") calling + "make" may cause an automatic re-run of the configure script. When +@@ -685,7 +696,8 @@ Fix to save configure options for future, implicit runs of configure + + New test-suite feature + ---------------------- +-Binary for bash for running test suite now located via PATH. ++ ++* Binary for bash for running test suite now located via PATH + + The notmuch test suite requires a fairly recent version of bash (>= + bash 4). As some systems supply an older version of bash at +@@ -694,16 +706,16 @@ Binary for bash for running test suite now located via PATH. + simply install bash >= 4 somewhere on $PATH before /bin and then use + the test suite. + +-Support for testing output with a trailing newline. ++* Support for testing output with a trailing newline + + Previously, some tests would fail to notice a difference in the + presence/absence of a trailing newline in a program output, (which + has led to bugs in the past). Now, carefully-written tests (using +- test_expect_equal_file rather than test_expect_equal) will detect ++ `test_expect_equal_file` rather than `test_expect_equal`) will detect + any change in the presence/absence of a trailing newline. Many tests + are updated to take advantage of this. + +-Avoiding accessing user's $HOME while running test suite ++* Avoiding accessing user's $HOME while running test suite + + The test suite now carefully creates its own HOME directory. This + allows the test suite to be run with no existing HOME directory, (as +@@ -713,13 +725,14 @@ Avoiding accessing user's $HOME while running test suite + + General bug fixes + ----------------- +-Output *all* files for "notmuch search --output=files" ++ ++* Output *all* files for "notmuch search --output=files" + + For the cases where multiple files have the same Message ID, + previous versions of notmuch would output only one such file. This + command is now fixed to correctly output all files. + +-Fixed spurious search results from "overlapped" indexing of addresses ++* Fixed spurious search results from "overlapped" indexing of addresses + + This fixed a bug where a search for: + +@@ -729,24 +742,24 @@ Fixed spurious search results from "overlapped" indexing of addresses + + To: user@example,com, someone@elsewhere.com + +-Fix --output=json when search has no results ++* Fix --output=json when search has no results + + A bug present since notmuch 0.4 had caused searches with no results + to produce an invalid json object. This is now fixed to cleanly + return a valid json object representing an empty array "[]" as + expected. + +-fix the automatic detection of the From address for "notmuch reply" +-from the Received headers in some cases. ++* Fix the automatic detection of the From address for "notmuch reply" ++ from the Received headers in some cases. + +-Fix core dump on DragonFlyBSD due to -1 return value from +-sysconf(_SC_GETPW_R_SIZE_MAX). ++* Fix core dump on DragonFlyBSD due to -1 return value from ++ `sysconf(_SC_GETPW_R_SIZE_MAX)`. + +-Cleaned up several memory leaks ++* Cleaned up several memory leaks + +-Eliminated a few, rare segmentation faults and a double-free. ++* Eliminated a few, rare segmentation faults and a double-free + +-Fix libnotmuch library to only export notmuch API functions ++* Fix libnotmuch library to only export notmuch API functions + + Previous release of the notmuch library also exported some Xapian + C++ exception type symbols. These were never part of the library +@@ -754,48 +767,52 @@ Fix libnotmuch library to only export notmuch API functions + + Emacs-interface bug fixes + ------------------------- +-Display any unexpected output or errors from "notmuch search" invocations ++ ++* Display any unexpected output or errors from "notmuch search" ++invocations + + Previously any misformatted output or trailing error messages were + silently ignored. This output is now clearly displayed. This fix was + very helpful in identifying and fixing the bug described below. + +-Fix bug where some threads would be missing from large search results ++* Fix bug where some threads would be missing from large search results + + When a search returned a "large" number of results, the emacs + interface was incorrectly dropping one thread every time the output + of the "notmuch search" process spanned the emacs read-buffer. This + is now fixed. + +-Avoid re-compression of .gz files (and similar) when saving attachment ++* Avoid re-compression of .gz files (and similar) when saving attachment + + Emacs was being too clever for its own good and trying to + re-compress pre-compressed .gz files when saving such attachments + (potentially corrupting the attachment). The emacs interface is + fixed to avoid this bug. + +-Fix hiding of a message when a previously-hidden citation is visible ++* Fix hiding of a message when a previously-hidden citation is visible + + Previously the citation would remain visible in this case. This is + fixed so that hiding a message hides all parts. + + Notmuch 0.5 (2010-11-11) + ======================== ++ + New, general features + --------------------- +-Maildir-flag synchronization ++ ++* Maildir-flag synchronization + + Notmuch now knows how to synchronize flags in maildir filenames with + tags in the notmuch database. The following flag/tag mappings are + supported: + +- Flag <-> Tag +- ---- ----- +- 'D' draft +- 'F' flagged +- 'P' passed +- 'R' replied +- 'S' unread (added when 'S' flag is not present) ++ Flag <-> Tag ++ ---- ----- ++ 'D' draft ++ 'F' flagged ++ 'P' passed ++ 'R' replied ++ 'S' unread (added when 'S' flag is not present) + + The synchronization occurs in both directions, (for example, adding + the 'S' flag to a file will cause the "unread" tag to be added, and +@@ -805,7 +822,7 @@ Maildir-flag synchronization + This synchronization is enabled by default for users of the + command-line interface, (though only files in directories named + "cur" or "new" will be renamed). It can be disabled by setting the +- new maildir.synchronize_flags option in the configuration file. For ++ new `maildir.synchronize_flags` option in the configuration file. For + example: + + notmuch config set maildir.synchronize_flags false +@@ -826,25 +843,27 @@ Maildir-flag synchronization + + New library features + -------------------- +-Support for querying multiple filenames for a single message ++ ++* Support for querying multiple filenames for a single message + + It is common for the mailstore to contain multiple files with the + same message ID. Previously, notmuch would always hide these + duplicate files, (returning a single, arbitrary filename with +- notmuch_message_get_filename). ++ `notmuch_message_get_filename`). + + With this release, library users can access all filenames for a + message with the new function: + + notmuch_message_get_filenames + +- Together with notmuch_filenames_valid, notmuch_filenames_get, and +- notmuch_filenames_move_to_next it is now possible to iterate over +- all available filenames for a given message. ++ Together with `notmuch_filenames_valid`, `notmuch_filenames_get`, ++ and `notmuch_filenames_move_to_next` it is now possible to iterate ++ over all available filenames for a given message. + + New command-line features + ------------------------- +-New "notmuch show --format=raw" for getting at original email contents ++ ++* New "notmuch show --format=raw" for getting at original email contents + + This new feature allows for a fully-functional email client to be + built on top of the notmuch command-line without needing any direct +@@ -863,7 +882,8 @@ New "notmuch show --format=raw" for getting at original email contents + + General bug fixes + ----------------- +-Fix "notmuch search" to print nothing when nothing matches ++ ++* Fix "notmuch search" to print nothing when nothing matches + + The 0.4 release had a bug in which: + +@@ -876,17 +896,18 @@ Fix "notmuch search" to print nothing when nothing matches + + Emacs interface improvements + ---------------------------- +-Fix to allow pipe ('|') command to work when using notmuch over ssh + +-Fix count of lines in hidden signatures. ++* Fix to allow pipe ('|') command to work when using notmuch over ssh ++ ++* Fix count of lines in hidden signatures + +-Omit repeated subject lines in (collapsed) thread display. ++* Omit repeated subject lines in (collapsed) thread display + +-Display current thread subject in a header line. ++* Display current thread subject in a header line + +-Provide a "c i" binding to copy a thread ID from the search view. ++* Provide a "c i" binding to copy a thread ID from the search view + +-Allow for notmuch-fcc-dirs to have a value of nil. ++* Allow for notmuch-fcc-dirs to have a value of nil + + Also, the more complex form of notmuch-fcc-dirs now has a slightly + different format. It no longer has a special first-element, fallback +@@ -898,7 +919,8 @@ Allow for notmuch-fcc-dirs to have a value of nil. + + Vim interface improvements + -------------------------- +-Felipe Contreras provided a number of updates for the vim interface. ++ ++Felipe Contreras provided a number of updates for the vim interface + + These include optimizations, support for newer versions of vim, fixed + support for sending mail on modern systems, new commands, and +@@ -906,13 +928,16 @@ Felipe Contreras provided a number of updates for the vim interface. + + New bindings + ------------ ++ + Added initial ruby bindings in bindings/ruby + + Notmuch 0.4 (2010-11-01) + ======================== ++ + New command-line features + ------------------------- +-notmuch search --output=(summary|threads|messages|tags|files) ++ ++* `notmuch search --output=(summary|threads|messages|tags|files)` + + This new option allows for particular items to be returned from + notmuch searches. The "summary" option is the default and behaves +@@ -927,7 +952,7 @@ notmuch search --output=(summary|threads|messages|tags|files) + "$file" + done + +-notmuch show --format=mbox ++* `notmuch show --format=mbox ` + + This new option allows for the messages matching a search + specification to be presented as an mbox. Specifically the "mboxrd" +@@ -936,14 +961,14 @@ notmuch show --format=mbox + beginning of all lines beginning with one or more '>' characters + followed by the 5 characters "From ". + +-notmuch config [get|set]
. [value ...] ++* `notmuch config [get|set]
. [value ...]` + + The new top-level "config" command allows for any value in the + notmuch configuration file to be queried or set to a new value. Both + single-valued and multi-valued items are supported, as our any + custom items stored in the configuration file. + +-Avoid setting Bcc header in "notmuch reply" ++* Avoid setting Bcc header in "notmuch reply" + + We decided that this was a bit heavy-handed as the actual mail + user-agent should be responsible for setting any Bcc option. Also, +@@ -952,14 +977,16 @@ Avoid setting Bcc header in "notmuch reply" + + New library features + -------------------- +-Add notmuch_query_get_query_string and notmuch_query_get_sort ++ ++* Add `notmuch_query_get_query_string` and `notmuch_query_get_sort` + + These are simply functions for querying properties of a +- notmuch_query_t object. ++ `notmuch_query_t` object. + + New emacs features + ------------------ +-Enable Fcc of all sent messages by default (to "sent" directory) ++ ++* Enable Fcc of all sent messages by default (to "sent" directory) + + All messages sent from the emacs interface will now be saved to the + notmuch mail store where they will be incorporated to the database +@@ -968,21 +995,21 @@ Enable Fcc of all sent messages by default (to "sent" directory) + can be customized by means of the "Notmuch Fcc Dirs" option in the + notmuch customize interface. + +-Ability to all open messages in a thread to a pipe ++* Ability to all open messages in a thread to a pipe + + Historically, the '|' keybinding allows for piping a single message + to an external command. Now, by prefixing this key with a prefix + argument, (for example, by pressing "Control-U |"), all open + messages in the current thread will be sent to the external command. + +-Optional support for detecting inline patches ++* Optional support for detecting inline patches + + This hook is disabled by default but can be enabled with a checkbox + under "Notmuch Show Insert Text/Plain Hook" in the notmuch customize + interface. It allows for inline patches to be detected and treated + as if they were attachments, (with context-sensitive highlighting). + +-Automatically tag messages as "replied" when sending a reply ++* Automatically tag messages as "replied" when sending a reply + + Messages replied to within the emacs interface will now be tagged as + "replied". This feature can easily be customized to add or remove +@@ -991,7 +1018,7 @@ Automatically tag messages as "replied" when sending a reply + that tag when replying. See "Notmuch Message Mark Replied" in the + notmuch customize interface. + +-Allow search-result color specifications to overlay each other ++* Allow search-result color specifications to overlay each other + + For example, one tag can specify the background color of matching + lines, while another can specify the foreground. With this change, +@@ -999,7 +1026,7 @@ Allow search-result color specifications to overlay each other + case in previous releases). See "Notmuch Search Line Faces" in the + notmuch customize interface. + +-Make hidden author names still available for incremental search. ++* Make hidden author names still available for incremental search + + When there is insufficient space to display all authors of a thread + in search results, the names of hidden authors are now still made +@@ -1007,7 +1034,7 @@ Make hidden author names still available for incremental search. + searches, matching lines will temporarily expand to show the hidden + names. + +-New binding of Control-TAB (works like TAB in reverse) ++* New binding of Control-TAB (works like TAB in reverse) + + Many notmuch nodes already use TAB to navigate forward through + various items allowing actions, (message headers, email attachments, +@@ -1016,13 +1043,14 @@ New binding of Control-TAB (works like TAB in reverse) + + New build-system features + ------------------------- +-Various portability fixes have been applied ++ ++* Various portability fixes have been applied + + These include fixes for build failures on at least Solaris, FreeBSD, + and Fedora systems. We're hopeful that the notmuch code base is now + more portable than ever before. + +-Arrange for libnotmuch to be found automatically after make install ++* Arrange for libnotmuch to be found automatically after make install + + The notmuch build system is now careful to help the user avoid + errors of the form "libnotmuch.so could not be found" immediately +@@ -1039,9 +1067,9 @@ Arrange for libnotmuch to be found automatically after make install + When this support works, the user should be able to run notmuch + immediately after "make install", without any errors trying to find + the notmuch library, and without having to manually set environment +- variables such as LD_LIBRARY_PATH. ++ variables such as `LD_LIBRARY_PATH`. + +-Check compiler/linker options before using them ++* Check compiler/linker options before using them + + The configure script now carefully checks that any desired + compilation options, (whether for enabling compiler warnings, or for +@@ -1050,7 +1078,8 @@ Check compiler/linker options before using them + + New test-suite features + ----------------------- +-New modularization of test suite. ++ ++* New modularization of test suite + + Thanks to a gracious relicensing of the test-suite infrastructure + from the git project, notmuch now has a modular test suite. This +@@ -1061,7 +1090,7 @@ New modularization of test suite. + it easy to run the test suite within valgrind (pass --valgrind to + notmuch-test or to any sub-script) which has been very useful. + +-New testing of emacs interface. ++* New testing of emacs interface + + The test suite has been augmented to allow automated testing of the + emacs interfaces. So far, this includes basic searches, display of +@@ -1072,7 +1101,8 @@ New testing of emacs interface. + + General bug fixes + ----------------- +-Fix potential corruption of database when "notmuch new " is interrupted. ++ ++* Fix potential corruption of database when "notmuch new " is interrupted + + Previously, an interruption of "notmuch new" would (rarely) result + in a corrupt database. The corruption would manifest itself by a +@@ -1083,21 +1113,22 @@ Fix potential corruption of database when "notmuch new " is interrupted. + The message-adding code has been carefully audited and reworked to + avoid this sort of corruption regardless of when it is interrupted. + +-Fix failure with extremely long message ID headers. ++* Fix failure with extremely long message ID headers + + Previously, a message with an extremely long message ID, (say, more + than 300 characters), would fail to be added to notmuch, (triggering + Xapian exceptions). This has now been fixed. + +-Fix for messages with "charset=unknown-8bit" ++* Fix for messages with "charset=unknown-8bit" + + Previously, messages with this charset would cause notmuch to emit a + GMime warning, (which would then trip up emacs or other interfaces + parsing the notmuch results). + +-Fix notmuch_query_search_threads function to return NULL on any exception ++* Fix `notmuch_query_search_threads` function to return NULL on any exception + +-Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails ++* Fix "notmuch search" to return non-zero if `notmuch_query_search_threads` ++ fails + + Previously, this command could confusingly report a Xapian + exception, yet still return an error code of 0. It now correctly +@@ -1105,7 +1136,8 @@ Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails + + Emacs bug fixes + --------------- +-Fix to handle a message with a subject containing, for example "[1234]" ++ ++* Fix to handle a message with a subject containing, for example "[1234]" + + Previously, a message subject containing a sequence of digits within + square brackets would cause the emacs interface to mis-parse the +@@ -1113,7 +1145,7 @@ Fix to handle a message with a subject containing, for example "[1234]" + mis-displayed and prevent the user from manipulating the message in + the emacs interface. + +-Fix to correctly handle message IDs containing ".." ++* Fix to correctly handle message IDs containing ".." + + The emacs interface now properly quotes message IDs to avoid a + Xapian bug in which the ".." within a message ID would be +@@ -1121,11 +1153,13 @@ Fix to correctly handle message IDs containing ".." + + Python-binding fixes + -------------------- ++ + The python bindings for notmuch have been updated to work with python3. + + Debian-specific fixes + --------------------- +-Fix emacs initialization so "M-x notmuch" works for users by default. ++ ++* Fix emacs initialization so "M-x notmuch" works for users by default + + Now, a new Debian user can immediately run "emacs -f notmuch" after + "apt-get install notmuch". Previously, the user would have had to +@@ -1134,16 +1168,18 @@ Fix emacs initialization so "M-x notmuch" works for users by default. + + Notmuch 0.3.1 (2010-04-27) + ========================== ++ + General bug fixes + ----------------- +-Fix an infinite loop in "notmuch reply" ++ ++* Fix an infinite loop in "notmuch reply" + + This bug could be triggered by replying to a message where the + user's primary email address did not appear in the To: header and + the user had not configured any secondary email addresses. The bug + was a simple re-use of the same iterator variable in nested loops. + +-Fix a potential SEGV in "notmuch search" ++* Fix a potential SEGV in "notmuch search" + + This bug could be triggered by an author name ending in a ','. + Admittedly - that's almost certainly a spam email, but we never +@@ -1151,6 +1187,7 @@ Fix a potential SEGV in "notmuch search" + + Emacs bug fixes + --------------- ++ + Fix calculations for line wrapping in the primary "notmuch" view. + + Fix Fcc support to prompt to create a directory if the specified Fcc +@@ -1158,34 +1195,37 @@ directory does not exist. + + Build fix + --------- +-Fix build on OpenSolaris (at least) due to missing 'extern "C"' block. ++ ++* Fix build on OpenSolaris (at least) due to missing 'extern "C"' block + + Without this, the C++ sources could not find strcasestr and the + final linking of notmuch would fail. + + Notmuch 0.3 (2010-04-27) + ======================== ++ + New command-line features + ------------------------- +-User-configurable tags for new messages ++ ++* User-configurable tags for new messages + + A new "new.tags" option is available in the configuration file to + determine which tags are applied to new messages. Run "notmuch + setup" to generate new documentation within ~/.notmuch-config on how + to specify this value. + +-Threads search results named based on subjects that match search ++* Threads search results named based on subjects that match search + + This means that when new mails arrived to a thread you've previously + read, and the new mails have a new subject, you will see that + subject in the search results rather than the old subject. + +-Faster operation of "notmuch tag" (avoid unneeded sorting) ++* Faster operation of "notmuch tag" (avoid unneeded sorting) + + Since the user just wants to tag all matching messages, we can make + things perform a bit faster by avoiding the sort. + +-Even Better guessing of From: header for "notmuch reply" ++* Even Better guessing of From: header for "notmuch reply" + + Notmuch now looks at a number of headers when trying to figure out + the best From: header to use in a reply. This is helpful if you have +@@ -1194,7 +1234,7 @@ Even Better guessing of From: header for "notmuch reply" + replying to won't always include your subscribed address in the To: + header). + +-Indication of author names that match a search ++* Indication of author names that match a search + + When notmuch displays threads as the result of a search, it now + lists the authors that match the search before listing the other +@@ -1205,6 +1245,7 @@ Indication of author names that match a search + + New: Python bindings + -------------------- ++ + Sebastian Spaeth has contributed his python bindings for the notmuch + library to the central repository. These bindings were previously + known as "cnotmuch" within python but have now been renamed to be +@@ -1221,7 +1262,8 @@ package-building scripts. Improvements are welcome. + + Emacs interface improvements + ---------------------------- +-An entirely new initial view for notmuch, (friendly yet powerful) ++ ++* An entirely new initial view for notmuch, (friendly yet powerful) + + Some of us call the new view "notmuch hello" but you can get at it + by simply calling "emacs -f notmuch". The new view provides a search +@@ -1248,7 +1290,7 @@ An entirely new initial view for notmuch, (friendly yet powerful) + leave that off to have your search results in "newest first" + order. + +-Full-featured "customize" support for configuring notmuch ++* Full-featured "customize" support for configuring notmuch + + Notmuch now plugs in well to the emacs "customize" mode to make it + much simpler to find things about the notmuch interface that can be +@@ -1264,7 +1306,7 @@ Full-featured "customize" support for configuring notmuch + selectors, and text-entry boxes for configuring the various + settings. + +-Support for doing tab-completion of email addresses ++* Support for doing tab-completion of email addresses + + This support currently relies on an external program, + (notmuch-addresses), that is not yet shipped with notmuch +@@ -1283,14 +1325,14 @@ Support for doing tab-completion of email addresses + hitting TAB on a partial email address or name within the To: or Cc: + line of an email message will provide matching completions. + +-Support for file-based (Fcc) delivery of sent messages to mail store ++* Support for file-based (Fcc) delivery of sent messages to mail store + + This isn't yet enabled by default. To enable this, one will have to + set the "Notmuch Fcc Dirs" setting within the notmuch customize + screen, (see its documentation there for details). We anticipate + making this automatic in a future release. + +-New 'G' key binding to trigger mail refresh (G == "Get new mail") ++* New 'G' key binding to trigger mail refresh (G == "Get new mail") + + The 'G' key works wherever '=' works. Before refreshing the screen + it calls an external program that can be used to poll email servers, +@@ -1300,13 +1342,13 @@ New 'G' key binding to trigger mail refresh (G == "Get new mail") + typically invoke "notmuch new" and then perhaps several "notmuch + tag" commands. + +-Implement emacs message display with the JSON output from notmuch. ++* Implement emacs message display with the JSON output from notmuch + + This is much more robust than the previous implementation, (where + some HTML mails and mail quoting the notmuch code with the delimiter + characters in it would cause the parser to fall over). + +-Better handling of HTML messages and MIME attachments (inline images!) ++* Better handling of HTML messages and MIME attachments (inline images!) + + Allow for any MIME parts that emacs can display to be displayed + inline. This includes inline viewing of image attachments, (provided +@@ -1321,7 +1363,7 @@ Better handling of HTML messages and MIME attachments (inline images!) + saved individually (the 'w' key is still available to save all + attachments). + +-Customizable support for tidying of text/plain message content ++* Customizable support for tidying of text/plain message content + + Many new functions are available for tidying up message + content. These include options such as wrapping long lines, +@@ -1331,7 +1373,7 @@ Customizable support for tidying of text/plain message content + clicking the available check boxes under the "Notmuch Show Insert + Text/Plain Hook" within the notmuch customize screen. + +-New support for searchable citations (even when hidden) ++* New support for searchable citations (even when hidden) + + When portions of overly-long citations are hidden, the contents of + these citations will still be available for emacs' standard +@@ -1339,7 +1381,7 @@ New support for searchable citations (even when hidden) + of a hidden citation, the citation will become visible temporarily + to display the search result. + +-More flexible handling of header visibility ++* More flexible handling of header visibility + + As an answer to complaints from many users, the To, Cc, and Date + headers of messages are no longer hidden by default. For those users +@@ -1352,25 +1394,26 @@ More flexible handling of header visibility + new "Notmuch Message Headers" variable can be customized to list + only those headers that should be present in the display of a message. + +-The Return key now toggles message visibility anywhere ++* The Return key now toggles message visibility anywhere + + Previously this worked only on the first summary-line of a message. + +-Customizable formatting of search results ++* Customizable formatting of search results + + The user can easily customize the order, width, and formatting of + the various fields in a "notmuch search" buffer. See the "Notmuch + Search Result Format" section of the customize interface. + +-Generate nicer names for search buffers when using a saved search. ++* Generate nicer names for search buffers when using a saved search + +-Add a notmuch User-Agent header when sending mail from notmuch/emacs. ++* Add a notmuch User-Agent header when sending mail from notmuch/emacs + +-New keybinding (M-Ret) to open all collapsed messages in a thread. ++* New keybinding (M-Ret) to open all collapsed messages in a thread + + New library feature + ------------------- +-Provide a new NOTMUCH_SORT_UNSORTED value for queries ++ ++* Provide a new `NOTMUCH_SORT_UNSORTED` value for queries + + This can be somewhat faster when sorting simply isn't desired. For + example when collecting a set of messages that will all be +@@ -1380,27 +1423,30 @@ Provide a new NOTMUCH_SORT_UNSORTED value for queries + + Build fixes + ----------- +-Fix to compile against GMime 2.6 ++ ++* Fix to compile against GMime 2.6 + + Previously notmuch insisted on being able to find GMime 2.4, (even + though GMime 2.6 would have worked all along). + +-Fix configure script to accept (and ignore) various standard options. ++* Fix configure script to accept (and ignore) various standard options + + For example, those that the Gentoo build scripts expect configure to + accept are now all accepted. + + Test suite + ---------- +-A large number of new tests for the many new features. + +-Better display of output from failed tests. ++* A large number of new tests for the many new features ++ ++* Better display of output from failed tests + + Now shows failures with diff rather than forcing the user to gaze at + complete actual and expected output looking for deviation. + + Notmuch 0.2 (2010-04-16) + ======================== ++ + This is the second release of the notmuch mail system, with actual + detailed release notes this time! + +@@ -1416,7 +1462,8 @@ notmuch in subsequent releases. + + General features + ---------------- +-Better guessing of From: header. ++ ++* Better guessing of From: header + + Notmuch now tries harder to guess which configured address should be + used as the From: line in a "notmuch reply". It will examine the +@@ -1425,12 +1472,12 @@ Better guessing of From: header. + replying to a message sent to a mailing list, and not directly to a + configured address. + +-Make "notmuch count" with no arguments count all messages ++* Make "notmuch count" with no arguments count all messages + + Previously, it was hard to construct a search term that was + guaranteed to match all messages. + +-Provide a new special-case search term of "*" to match all messages. ++* Provide a new special-case search term of "*" to match all messages + + This can be used in any command accepting a search term, such as + "notmuch search '*'". Note that you'll want to take care that the +@@ -1439,8 +1486,8 @@ Provide a new special-case search term of "*" to match all messages. + search term and loses its special meaning when combined with any + other search terms. + +-Automatically detect thread connections even when a parent message is +-missing. ++* Automatically detect thread connections even when a parent message ++ is missing + + Previously, if two or more message were received with a common + parent, but that parent was not received, then these messages would +@@ -1449,22 +1496,23 @@ missing. + + General bug fixes + ----------------- +-Fix potential data loss in "notmuch new" with SIGINT ++ ++* Fix potential data loss in "notmuch new" with SIGINT + + One code path in "notmuch new" was not properly handling + SIGINT. Previously, this could lead to messages being removed from + the database (and their tags being lost) if the user pressed + Control-C while "notmuch new" was working. + +-Fix segfault when a message includes a MIME part that is empty. ++* Fix segfault when a message includes a MIME part that is empty + +-Fix handling of non-ASCII characters with --format=json ++* Fix handling of non-ASCII characters with --format=json + + Previously, characters outside the range of 7-bit ASCII were + silently dropped from the JSON output. This led to corrupted display + of utf-8 content in the upcoming notmuch web-based frontends. + +-Fix headers to be properly decoded in "notmuch reply" ++* Fix headers to be properly decoded in "notmuch reply" + + Previously, the user might see: + +@@ -1481,7 +1529,8 @@ Fix headers to be properly decoded in "notmuch reply" + + Emacs client features + --------------------- +-Show the last few lines of citations as well as the first few lines. ++ ++* Show the last few lines of citations as well as the first few lines + + It's often the case that the last sentence of a citation is what is + being replied to directly, so the last few lines are often much more +@@ -1489,21 +1538,21 @@ Show the last few lines of citations as well as the first few lines. + citation can be configured, (notmuch-show-citation-lines-prefix and + notmuch-show-citation-lines-suffix). + +-The '+' and '-' commands in the search view can now add and remove +-tags by region. ++* The '+' and '-' commands in the search view can now add and remove ++ tags by region + + Selective bulk tagging is now possible by selecting a region of + threads and then using either the '+' or '-' keybindings. Bulk + tagging is still available for all threads matching the current + search with the '*' binding. + +-More meaningful buffer names for thread-view buffers. ++* More meaningful buffer names for thread-view buffers + + Notmuch now uses the Subject of the thread as the buffer + name. Previously it was using the thread ID, which is a meaningless + number to the user. + +-Provide for customized colors of threads in search view based on tags. ++* Provide for customized colors of threads in search view based on tags + + See the documentation of notmuch-search-line-faces, (or us "M-x + customize" and browse to the "notmuch" group within "Applications" +@@ -1511,9 +1560,10 @@ Provide for customized colors of threads in search view based on tags. + + Build-system features + --------------------- +-Add support to properly build libnotmuch on Darwin systems (OS X). + +-Add support to configure for many standard options. ++* Add support to properly build libnotmuch on Darwin systems (OS X) ++ ++* Add support to configure for many standard options + + We include actual support for: + +@@ -1524,20 +1574,21 @@ Add support to configure for many standard options. + --build --infodir --libexecdir --localstatedir + --disable-maintainer-mode --disable-dependency-tracking + +-Install emacs client in "make install" rather than requiring a +-separate "make install-emacs". ++* Install emacs client in "make install" rather than requiring a ++ separate "make install-emacs" + +-Automatically compute versions numbers between releases. ++* Automatically compute versions numbers between releases + + This support uses the git-describe notation, so a version such as + 0.1-144-g43cbbfc indicates a version that is 144 commits since the + 0.1 release and is available as git commit "43cbbfc". + +-Add a new "make test" target to run the test suite and actually verify +-its results. ++* Add a new "make test" target to run the test suite and actually ++ verify its results + + Notmuch 0.1 (2010-04-05) + ======================== ++ + This is the first release of the notmuch mail system. + + It includes the libnotmuch library, the notmuch command-line +-- +1.7.6.5 + -- 2.26.2