[PATCH 1/2] NEWS: markup changes to make mdwn->html look slightly better
authorTomi Ollila <tomi.ollila@iki.fi>
Wed, 1 Feb 2012 15:22:49 +0000 (17:22 +0200)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:43:54 +0000 (09:43 -0800)
0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a [new file with mode: 0644]

diff --git a/0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a b/0e/afb9c8f49a75c8daacd6706be4d9db6eb3235a
new file mode 100644 (file)
index 0000000..74d2ce3
--- /dev/null
@@ -0,0 +1,1588 @@
+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