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