2f/a7a34f85eaffd503ca0cf1a02d0c22a700e156

   1 Return-Path: <too@guru.guru-group.fi>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 5DD3D431FD6\r
   6         for <notmuch@notmuchmail.org>; Thu, 26 Apr 2012 12:52:48 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 0\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
  12         autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id J1pTvjZN6nJZ for <notmuch@notmuchmail.org>;\r
  16         Thu, 26 Apr 2012 12:52:40 -0700 (PDT)\r
  17 Received: from guru.guru-group.fi (guru-group.fi [87.108.86.66])\r
  18         by olra.theworths.org (Postfix) with ESMTP id 46180431FAE\r
  19         for <notmuch@notmuchmail.org>; Thu, 26 Apr 2012 12:52:39 -0700 (PDT)\r
  20 Received: by guru.guru-group.fi (Postfix, from userid 501)\r
  21         id 5582F68055; Thu, 26 Apr 2012 22:52:35 +0300 (EEST)\r
  22 From: Tomi Ollila <tomi.ollila@iki.fi>\r
  23 To: notmuch@notmuchmail.org\r
  24 Subject: [PATCH 3/3] NEWS: Insert markdown formatting commands\r
  25 Date: Thu, 26 Apr 2012 22:52:31 +0300\r
  26 Message-Id: <1335469951-22477-3-git-send-email-tomi.ollila@iki.fi>\r
  27 X-Mailer: git-send-email 1.7.6.1\r
  28 In-Reply-To: <1335469951-22477-1-git-send-email-tomi.ollila@iki.fi>\r
  29 References: <1335469951-22477-1-git-send-email-tomi.ollila@iki.fi>\r
  30 Cc: Tomi Ollila <tomi.ollila@iki.fi>\r
  31 X-BeenThere: notmuch@notmuchmail.org\r
  32 X-Mailman-Version: 2.1.13\r
  33 Precedence: list\r
  34 List-Id: "Use and development of the notmuch mail system."\r
  35         <notmuch.notmuchmail.org>\r
  36 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  37         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  38 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  39 List-Post: <mailto:notmuch@notmuchmail.org>\r
  40 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  41 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  42         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  43 X-List-Received-Date: Thu, 26 Apr 2012 19:52:49 -0000\r
  44 \r
  45 To make updating the notmuchmail.org wiki 'news' section more\r
  46 straightforward the content of the NEWS file has now been brought\r
  47 to almost the same as the *.mdwn files in the wiki page.\r
  48 \r
  49 The changes are basically insertion of mdwn formatting "commands".\r
  50 \r
  51 More effort has been put into formatting the newer release entries\r
  52 (0.12, 0.11 & 0.10) than older. Commit to format 0.13 entries will\r
  53 be made available separately.\r
  54 ---\r
  55  NEWS |  271 +++++++++++++++++++++++++++++++++--------------------------------\r
  56  1 files changed, 138 insertions(+), 133 deletions(-)\r
  57 \r
  58 diff --git a/NEWS b/NEWS\r
  59 index fe4c3f0..d3f925d 100644\r
  60 --- a/NEWS\r
  61 +++ b/NEWS\r
  62 @@ -81,16 +81,16 @@ Command-Line Interface\r
  63  \r
  64  Reply to sender\r
  65  \r
  66 -  "notmuch reply" has gained the ability to create a reply template\r
  67 +  `notmuch reply` has gained the ability to create a reply template\r
  68    for replying just to the sender of the message, in addition to reply\r
  69    to all. The feature is available through the new command line option\r
  70 -  --reply-to=(all|sender).\r
  71 +  `--reply-to=(all|sender)`.\r
  72  \r
  73  Mail store folder/file ignore\r
  74  \r
  75    A new configuration option, `new.ignore`, lets users specify a\r
  76    ;-separated list of file and directory names that will not be\r
  77 -  searched for messages by "notmuch new".\r
  78 +  searched for messages by `notmuch new`.\r
  79  \r
  80    NOTE: *Every* file/directory that goes by one of those names will\r
  81    be ignored, independent of its depth/location in the mail store.\r
  82 @@ -119,14 +119,14 @@ Reply to sender\r
  83  \r
  84  More flexible and consistent tagging operations\r
  85  \r
  86 -  All tagging operations ("+", "-", "*") now accept multiple tags with\r
  87 -  "+" or "-" prefix, like "*" operation in notmuch-search view before.\r
  88 +  All tagging operations ('+', '-', '*') now accept multiple tags with\r
  89 +  '+' or '-' prefix, like '*' operation in notmuch-search view before.\r
  90  \r
  91 -  "*" operation (`notmuch-show-tag-all') is now available in\r
  92 +  '*' operation (`notmuch-show-tag-all`) is now available in\r
  93    notmuch-show view.\r
  94  \r
  95 -  `Notmuch-show-{add,remove}-tag' functions no longer accept tag\r
  96 -  argument, `notmuch-show-tag-message' should be used instead.  Custom\r
  97 +  `notmuch-show-{add,remove}-tag` functions no longer accept tag\r
  98 +  argument, `notmuch-show-tag-message` should be used instead.  Custom\r
  99    bindings using these functions should be updated, e.g.:\r
 100  \r
 101          (notmuch-show-remove-tag "unread")\r
 102 @@ -138,7 +138,7 @@ More flexible and consistent tagging operations\r
 103  Refreshing the show view ('=' by default) no longer opens or closes messages\r
 104  \r
 105    To get the old behavior of putting messages back in their initial\r
 106 -  opened/closed state, use a prefix argument, e.g., C-u =.\r
 107 +  opened/closed state, use a prefix argument, e.g., 'C-u ='.\r
 108  \r
 109  Attachment buttons can be used to view or save attachments.\r
 110  \r
 111 @@ -151,14 +151,14 @@ Attachment buttons can be used to view or save attachments.\r
 112  \r
 113  New functions\r
 114  \r
 115 -  `notmuch-show-stash-mlarchive-link{,-and-go}' allow stashing and\r
 116 +  `notmuch-show-stash-mlarchive-link{,-and-go}` allow stashing and\r
 117    optionally visiting a URI to the current message at one of a number\r
 118    of Mailing List Archives.\r
 119  \r
 120  Fix MML tag quoting in replies\r
 121  \r
 122    The MML tag quoting fix of 0.11.1 unintentionally quoted tags\r
 123 -  inserted in `message-setup-hook'. Quoting is now limited to the\r
 124 +  inserted in `message-setup-hook`. Quoting is now limited to the\r
 125    cited message.\r
 126  \r
 127  Show view archiving key binding changes\r
 128 @@ -182,9 +182,9 @@ Generate inline patch fake attachment file names from message subject\r
 129    'git format-patch' instead of just "inline patch". See "Notmuch Show\r
 130    Insert Text/Plain Hook" in the notmuch customize interface.\r
 131  \r
 132 -Enable `notmuch-search-line-faces' by default\r
 133 +Enable `notmuch-search-line-faces` by default\r
 134  \r
 135 -  Make the `notmuch-search-line-faces' functionality more discoverable\r
 136 +  Make the `notmuch-search-line-faces` functionality more discoverable\r
 137    for new users by showing "unread" messages bold and "flagged"\r
 138    messages blue by default in the search view.\r
 139  \r
 140 @@ -198,7 +198,7 @@ Library changes\r
 141  \r
 142  New functions\r
 143  \r
 144 -  notmuch_query_add_tag_exclude supports the new tag exclusion\r
 145 +  `notmuch_query_add_tag_exclude` supports the new tag exclusion\r
 146    feature.\r
 147  \r
 148  Python bindings changes\r
 149 @@ -228,10 +228,10 @@ Compatibility with GMime 2.6\r
 150  Notmuch 0.11.1 (2012-02-03)\r
 151  ===========================\r
 152  \r
 153 -Bug-fix release.\r
 154 -----------------\r
 155 +Bug-fix release\r
 156 +---------------\r
 157  \r
 158 -Fix error handling in python bindings.\r
 159 +Fix error handling in python bindings\r
 160  \r
 161    The python bindings in 0.11 failed to detect NULL pointers being\r
 162    returned from libnotmuch functions and thus failed to raise\r
 163 @@ -258,13 +258,13 @@ Command-Line Interface\r
 164  Hooks\r
 165  \r
 166    Hooks have been introduced to notmuch. Hooks are scripts that notmuch\r
 167 -  invokes before and after certain actions. Initially, "notmuch new"\r
 168 -  supports "pre-new" and "post-new" hooks that are run before and after\r
 169 +  invokes before and after certain actions. Initially, `notmuch new`\r
 170 +  supports `pre-new` and `post-new` hooks that are run before and after\r
 171    importing new messages into the database.\r
 172  \r
 173 -notmuch reply --decrypt bugfix\r
 174 +`notmuch reply --decrypt bugfix`\r
 175  \r
 176 -  The "notmuch reply" command with --decrypt argument had a rarely\r
 177 +  The `notmuch reply` command with `--decrypt` argument had a rarely\r
 178    occurring bug that caused an encrypted message not to be decrypted\r
 179    sometimes. This is now fixed.\r
 180  \r
 181 @@ -273,7 +273,7 @@ Performance\r
 182  \r
 183  Automatic tag query optimization\r
 184  \r
 185 -  "notmuch tag" now automatically optimizes the user's query to\r
 186 +  `notmuch tag` now automatically optimizes the user's query to\r
 187    exclude messages whose tags won't change.  In the past, we've\r
 188    suggested that people do this by hand; this is no longer necessary.\r
 189  \r
 190 @@ -281,7 +281,7 @@ Don't sort messages when creating a dump file\r
 191  \r
 192    This speeds up tag dumps considerably, without any loss of\r
 193    information. To replicate the old behavior of sorted output (for\r
 194 -  example to compare two dump files), one can use e.g. sort(1).\r
 195 +  example to compare two dump files), one can use e.g. `sort(1)`.\r
 196  \r
 197  Memory Management\r
 198  -----------------\r
 199 @@ -301,11 +301,11 @@ Bug fixes\r
 200    should have scrolled down to show more of the current message instead.\r
 201    This is now fixed.\r
 202  \r
 203 -Support "notmuch new" as a notmuch-poll-script\r
 204 +Support `notmuch new` as a notmuch-poll-script\r
 205  \r
 206 -  It's now possible to use "notmuch new" as a notmuch-poll-script\r
 207 +  It's now possible to use `notmuch new` as a notmuch-poll-script\r
 208    directly. This is also the new default. This allows taking better\r
 209 -  advantage of the "notmuch new" hooks from emacs without intermediate\r
 210 +  advantage of the `notmuch new` hooks from emacs without intermediate\r
 211    scripts.\r
 212  \r
 213  Improvements in saved search management\r
 214 @@ -334,7 +334,7 @@ Use space as default thousands separator\r
 215    changed by customizing "notmuch-hello-thousands-separator".\r
 216  \r
 217  Call notmuch-show instead of notmuch-search when clicking on\r
 218 -buttonized id: links.\r
 219 +buttonized id: links\r
 220  \r
 221  New function notmuch-show-advance\r
 222  \r
 223 @@ -344,37 +344,37 @@ New function notmuch-show-advance\r
 224  \r
 225          (define-key notmuch-show-mode-map " " 'notmuch-show-advance)\r
 226  \r
 227 -Various performance improvements.\r
 228 +Various performance improvements\r
 229  \r
 230  New add-on tool\r
 231  ---------------\r
 232  \r
 233 -The tool contrib/notmuch-deliver helps with initial delivery and\r
 234 -tagging of mail (replacing running notmuch new).\r
 235 +The tool `contrib/notmuch-deliver` helps with initial delivery and\r
 236 +tagging of mail (replacing running `notmuch new`).\r
 237  \r
 238  \r
 239  Notmuch 0.10.2 (2011-12-04)\r
 240  ===========================\r
 241  \r
 242 -Bug-fix release.\r
 243 -----------------\r
 244 +Bug-fix release\r
 245 +---------------\r
 246  \r
 247 -Fix crash in python bindings.\r
 248 +Fix crash in python bindings\r
 249  \r
 250 -  The python bindings did not call g_type_init, which caused crashes\r
 251 +  The python bindings did not call `g_type_init`, which caused crashes\r
 252    for some, but not all users.\r
 253  \r
 254  Notmuch 0.10.1 (2011-11-25)\r
 255  ===========================\r
 256  \r
 257 -Bug-fix release.\r
 258 -----------------\r
 259 +Bug-fix release\r
 260 +---------------\r
 261  \r
 262 -Fix --help argument\r
 263 +Fix `--help` argument\r
 264  \r
 265 -  Argument processing changes in 0.10 introduced a bug where "notmuch\r
 266 -  --help" crashed while "notmuch help" worked fine. This is fixed in\r
 267 -  0.10.1.\r
 268 +  Argument processing changes in 0.10 introduced a bug where\r
 269 +  `notmuch --help` crashed while `notmuch help` worked fine.\r
 270 +  This is fixed in 0.10.1.\r
 271  \r
 272  Notmuch 0.10 (2011-11-23)\r
 273  =========================\r
 274 @@ -382,7 +382,7 @@ Notmuch 0.10 (2011-11-23)\r
 275  New build and testing features\r
 276  ------------------------------\r
 277  \r
 278 -Emacs tests are now done in dtach. This means that dtach  is now\r
 279 +Emacs tests are now done in `dtach`. This means that dtach is now\r
 280  needed to run the notmuch test suite, at least until the checking for\r
 281  prerequisites is improved.\r
 282  \r
 283 @@ -391,32 +391,33 @@ Full test coverage of the stashing feature in Emacs.\r
 284  New command-line features\r
 285  -------------------------\r
 286  \r
 287 -Add "notmuch restore --accumulate" option\r
 288 +Add `notmuch restore --accumulate` option\r
 289  \r
 290 -  The --accumulate switch causes the union of the existing and new tags to be\r
 291 -  applied, instead of replacing each message's tags as they are read in from\r
 292 -  the dump file.\r
 293 +  The `--accumulate` switch causes the union of the existing and new tags to\r
 294 +  be applied, instead of replacing each message's tags as they are read in\r
 295 +  from the dump file.\r
 296  \r
 297 -Add search terms to  "notmuch dump"\r
 298 +Add search terms to `notmuch dump`\r
 299  \r
 300    The dump command now takes an optional search term much like notmuch\r
 301    search/show/tag. The output file argument of dump is deprecated in\r
 302    favour of using stdout.\r
 303  \r
 304 -Add "notmuch search" --offset and --limit options\r
 305 +Add `notmuch search` `--offset` and `--limit` options\r
 306  \r
 307 -  The search command now takes options --offset=[-]N and --limit=N to limit\r
 308 -  the number of results shown.\r
 309 +  The search command now takes options `--offset=[-]N` and `--limit=N` to\r
 310 +  limit the number of results shown.\r
 311  \r
 312 -Add "notmuch count --output" option\r
 313 +Add `notmuch count --output` option\r
 314  \r
 315    The count command is now capable of counting threads in addition to\r
 316 -  messages. This is selected using the new --output=(threads|messages) option.\r
 317 +  messages. This is selected using the new `--output=(threads|messages)`\r
 318 +  option.\r
 319  \r
 320  New emacs UI features\r
 321  ---------------------\r
 322  \r
 323 -Add tab-completion for notmuch-search and notmuch-search-filter\r
 324 +Add tab-completion for `notmuch-search` and `notmuch-search-filter`\r
 325  \r
 326    These functions now support completion tags for query parts\r
 327    starting with "tag:".\r
 328 @@ -430,7 +431,7 @@ Add keybinding ('c I') for stashing Message-ID's without an id: prefix\r
 329  \r
 330    Reduces manual labour when stashing them for use outside notmuch.\r
 331  \r
 332 -Do not query on notmuch-search exit\r
 333 +Do not query on `notmuch-search` exit\r
 334  \r
 335    It is harmless to kill the external notmuch process, so the user\r
 336    is no longer interrogated when they interrupt a search.\r
 337 @@ -472,9 +473,9 @@ Notmuch 0.9 (2011-10-01)\r
 338  New, general features\r
 339  ---------------------\r
 340  \r
 341 -Correct handling of interruptions during "notmuch new"\r
 342 +Correct handling of interruptions during `notmuch new`\r
 343  \r
 344 -  "notmuch new" now operates as a series of small, self-consistent\r
 345 +  `notmuch new` now operates as a series of small, self-consistent\r
 346    transactions, so it can correctly resume after an interruption or\r
 347    crash.  Previously, interruption could lose existing tags, fail to\r
 348    detect messages on resume, or leave the database in a state\r
 349 @@ -485,14 +486,14 @@ Library changes\r
 350  \r
 351  New functions\r
 352  \r
 353 -  notmuch_database_begin_atomic and notmuch_database_end_atomic allow\r
 354 -  multiple database operations to be performed atomically.\r
 355 +  `notmuch_database_begin_atomic` and `notmuch_database_end_atomic`\r
 356 +  allow multiple database operations to be performed atomically.\r
 357  \r
 358 -  notmuch_database_find_message_by_filename does exactly what it says.\r
 359 +  `notmuch_database_find_message_by_filename` does exactly what it says.\r
 360  \r
 361  API changes\r
 362  \r
 363 -  notmuch_database_find_message (and n_d_f_m_by_filename) now return\r
 364 +  `notmuch_database_find_message` (and `n_d_f_m_by_filename`) now return\r
 365    a status indicator and uses an output parameter for the\r
 366    message. This change required changing the SONAME of libnotmuch to\r
 367    libnotmuch.so.2\r
 368 @@ -502,33 +503,33 @@ Python bindings changes\r
 369  \r
 370    - Re-encode python unicode objects to utf-8 before passing back to\r
 371      libnotmuch.\r
 372 -  - Support Database().begin_atomic()/end_atomic()\r
 373 -  - Support Database().find_message_by_filename()\r
 374 +  - Support `Database().begin_atomic()/end_atomic()`\r
 375 +  - Support `Database().find_message_by_filename()`\r
 376      NB! This needs a db opened in READ-WRITE mode currently, or it will crash\r
 377      the python process. The is a limitation (=bug) of the underlying libnotmuch.\r
 378    - Fixes where we would not throw NotmuchErrors when we should (Justus Winter)\r
 379 -  - Update for n_d_find_message* API changes (see above).\r
 380 +  - Update for `n_d_find_message*` API changes (see above).\r
 381  \r
 382  Ruby bindings changes\r
 383  ---------------------\r
 384  \r
 385 -  - Wrap new library functions notmuch_database_{begin,end}_atomic.\r
 386 -  - Add new exception Notmuch::UnbalancedAtomicError.\r
 387 -  - Rename destroy  to destroy! according to Ruby naming conventions.\r
 388 -  - Update for n_d_find_message* API changes (see above).\r
 389 +  - Wrap new library functions `notmuch_database_{begin,end}_atomic.`\r
 390 +  - Add new exception `Notmuch::UnbalancedAtomicError.`\r
 391 +  - Rename destroy to destroy! according to Ruby naming conventions.\r
 392 +  - Update for `n_d_find_message*` API changes (see above).\r
 393  \r
 394  Emacs improvements\r
 395  ------------------\r
 396  \r
 397    * Add gpg callback to crypto sigstatus buttons to retrieve/refresh\r
 398      signing key.\r
 399 -  * Add notmuch-show-refresh-view function (and corresponding binding)\r
 400 +  * Add `notmuch-show-refresh-view` function (and corresponding binding)\r
 401      to refresh the view of a notmuch-show buffer.\r
 402  \r
 403  Reply formatting cleanup\r
 404  ------------------------\r
 405  \r
 406 -  "notmuch reply" no longer includes notification that non-leafnode\r
 407 +  `notmuch reply` no longer includes notification that non-leafnode\r
 408    MIME parts are being suppressed.\r
 409  \r
 410  Notmuch 0.8 (2011-09-10)\r
 411 @@ -555,7 +556,7 @@ Documentation update for Ruby bindings\r
 412  Unicode, iterator, PEP8 changes for python bindings\r
 413  \r
 414    - PEP8 (code formatting) changes for python files.\r
 415 -  - Remove Tags.__len__ ; see 0.6 release notes for motivation.\r
 416 +  - Remove `Tags.__len__` ; see 0.6 release notes for motivation.\r
 417    - Decode headers as UTF8, encode (unicode) database paths as UTF8.\r
 418  \r
 419  Notmuch 0.7 (2011-08-01)\r
 420 @@ -586,7 +587,7 @@ Sebastian Spaeth contributed two changes related to unicode and UTF8:\r
 421    * query string is encoded as a UTF8 byte string\r
 422  \r
 423  Build-System improvements\r
 424 -------------------------\r
 425 +-------------------------\r
 426  \r
 427  Generate notmuch.sym after the relevant object files\r
 428  \r
 429 @@ -596,10 +597,10 @@ Generate notmuch.sym after the relevant object files\r
 430  Notmuch 0.6.1 (2011-07-17)\r
 431  ==========================\r
 432  \r
 433 -Bug-fix release.\r
 434 -----------------\r
 435 +Bug-fix release\r
 436 +---------------\r
 437  \r
 438 -Re-export Xapian exception typeinfo symbols.\r
 439 +Re-export Xapian exception typeinfo symbols\r
 440  \r
 441    It turned out our aggressive symbol hiding caused problems for\r
 442    people running gcc 4.4.5.\r
 443 @@ -644,7 +645,7 @@ Folder-based searching\r
 444  \r
 445  Support for PGP/MIME\r
 446  \r
 447 -  Both the command line interface and the emacs-interface have new\r
 448 +  Both the command-line interface and the emacs-interface have new\r
 449    support for PGP/MIME, detailed below. Thanks to Daniel Kahn Gillmor\r
 450    and Jameson Graef Rollins for making this happen.\r
 451  \r
 452 @@ -686,7 +687,7 @@ Add new "notmuch show --part" option\r
 453    part, (such as --format=json for extracting a message part with JSON\r
 454    formatting).\r
 455  \r
 456 -Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *")\r
 457 +Deprecate "notmuch search-tags" (in favor of "notmuch search --output=tags *")\r
 458  \r
 459    The "notmuch search-tags" sub-command has been redundant since the\r
 460    addition of the --output=tags option to "notmuch search". We now\r
 461 @@ -739,7 +740,7 @@ Support for PGP/MIME (GnuPG)\r
 462    messages.  Automatically display decrypted content for\r
 463    multipart/encrypted messages.  See the emacs variable\r
 464    notmuch-crypto-process-mime for more information. Note that this\r
 465 -  needs gpg-agent and a pinentry tool just as the command line tools.\r
 466 +  needs gpg-agent and a pinentry tool just as the command-line tools.\r
 467    Also note there is no support SMIME yet.\r
 468  \r
 469  Output of pipe command is now displayed if pipe command fails\r
 470 @@ -815,8 +816,10 @@ Avoid getting confused by Subject and Author fields with newline characters\r
 471  \r
 472    Replacing all characters with ASCII code less than 32 with a question mark.\r
 473  \r
 474 -Cleaner display of From line in email messages (remove double quotes,\r
 475 -and drop "name" if it's actually just a repeat of the email address).\r
 476 +Cleaner display of From line in email messages\r
 477 +\r
 478 +  Remove double quotes, and drop "name" if it's actually just a repeat of\r
 479 +  the email address.\r
 480  \r
 481  Vim interface improvements\r
 482  --------------------------\r
 483 @@ -834,25 +837,25 @@ Bindings improvements\r
 484  \r
 485  Ruby bindings are now much more complete\r
 486  \r
 487 -  Including QUERY.sort, QUERY.to_s, MESSAGE.maildir_flags_to_tags,\r
 488 -  MESSAGE.tags_to_maildir_flags, and MESSAGE.get_filenames\r
 489 +  Including `QUERY.sort`, `QUERY.to_s`, `MESSAGE.maildir_flags_to_tags`,\r
 490 +  `MESSAGE.tags_to_maildir_flags`, and `MESSAGE.get_filenames`\r
 491  \r
 492 -* Python bindings have been updated and extended\r
 493 +Python bindings have been updated and extended\r
 494  \r
 495    (docs online at http://packages.python.org/notmuch/)\r
 496  \r
 497    New bindings:\r
 498  \r
 499 -  - Message().get_filenames(), Message().tags_to_maildir_flags(),\r
 500 -    Message().maildir_flags_to_tags(), list(Threads()) and\r
 501 -    list(Messages) works now\r
 502 -  - Message().__cmp__() and __hash__()\r
 503 +  - `Message().get_filenames()`, `Message().tags_to_maildir_flags()`,\r
 504 +    `Message().maildir_flags_to_tags()`, `list(Threads())` and\r
 505 +    `list(Messages)` works now\r
 506 +  - `Message().__cmp__()` and `__hash__()`\r
 507  \r
 508    These allow, for example:\r
 509  \r
 510          if msg1 == msg2: ...\r
 511  \r
 512 -  As well as set arithmetic on Messages():\r
 513 +  As well as set arithmetic on `Messages()`:\r
 514  \r
 515          s1, s2 = set(msgs1), set(msgs2)\r
 516          s1.union(s2)\r
 517 @@ -860,9 +863,9 @@ Ruby bindings are now much more complete\r
 518  \r
 519    Removed:\r
 520  \r
 521 -  - len(Messages()) as it exhausted the iterator\r
 522 +  - `len(Messages())` as it exhausted the iterator\r
 523  \r
 524 -  Use len(list(Messages())) or Query.count_messages()\r
 525 +  Use `len(list(Messages()))` or `Query.count_messages()`\r
 526    to get the length.\r
 527  \r
 528  Added initial Go bindings in bindings/go\r
 529 @@ -900,12 +903,12 @@ Binary for bash for running test suite now located via PATH\r
 530    simply install bash >= 4 somewhere on $PATH before /bin and then use\r
 531    the test suite.\r
 532  \r
 533 -Support for testing output with a trailing newline.\r
 534 +Support for testing output with a trailing newline\r
 535  \r
 536    Previously, some tests would fail to notice a difference in the\r
 537    presence/absence of a trailing newline in a program output, (which\r
 538    has led to bugs in the past). Now, carefully-written tests (using\r
 539 -  test_expect_equal_file rather than test_expect_equal) will detect\r
 540 +  `test_expect_equal_file` rather than `test_expect_equal`) will detect\r
 541    any change in the presence/absence of a trailing newline. Many tests\r
 542    are updated to take advantage of this.\r
 543  \r
 544 @@ -943,15 +946,15 @@ Fix --output=json when search has no results\r
 545    return a valid json object representing an empty array "[]" as\r
 546    expected.\r
 547  \r
 548 -fix the automatic detection of the From address for "notmuch reply"\r
 549 -from the Received headers in some cases.\r
 550 +Fix the automatic detection of the From address for "notmuch reply"\r
 551 +from the Received headers in some cases\r
 552  \r
 553  Fix core dump on DragonFlyBSD due to -1 return value from\r
 554 -sysconf(_SC_GETPW_R_SIZE_MAX).\r
 555 +`sysconf(_SC_GETPW_R_SIZE_MAX)`\r
 556  \r
 557  Cleaned up several memory leaks\r
 558  \r
 559 -Eliminated a few, rare segmentation faults and a double-free.\r
 560 +Eliminated a few, rare segmentation faults and a double-free\r
 561  \r
 562  Fix libnotmuch library to only export notmuch API functions\r
 563  \r
 564 @@ -1015,7 +1018,7 @@ Maildir-flag synchronization\r
 565    This synchronization is enabled by default for users of the\r
 566    command-line interface, (though only files in directories named\r
 567    "cur" or "new" will be renamed). It can be disabled by setting the\r
 568 -  new maildir.synchronize_flags option in the configuration file. For\r
 569 +  new `maildir.synchronize_flags` option in the configuration file. For\r
 570    example:\r
 571  \r
 572          notmuch config set maildir.synchronize_flags false\r
 573 @@ -1042,16 +1045,16 @@ Support for querying multiple filenames for a single message\r
 574    It is common for the mailstore to contain multiple files with the\r
 575    same message ID. Previously, notmuch would always hide these\r
 576    duplicate files, (returning a single, arbitrary filename with\r
 577 -  notmuch_message_get_filename).\r
 578 +  `notmuch_message_get_filename`).\r
 579  \r
 580    With this release, library users can access all filenames for a\r
 581    message with the new function:\r
 582  \r
 583          notmuch_message_get_filenames\r
 584  \r
 585 -  Together with notmuch_filenames_valid, notmuch_filenames_get, and\r
 586 -  notmuch_filenames_move_to_next it is now possible to iterate over\r
 587 -  all available filenames for a given message.\r
 588 +  Together with `notmuch_filenames_valid`, `notmuch_filenames_get`,\r
 589 +  and `notmuch_filenames_move_to_next` it is now possible to iterate\r
 590 +  over all available filenames for a given message.\r
 591  \r
 592  New command-line features\r
 593  -------------------------\r
 594 @@ -1092,15 +1095,15 @@ Emacs interface improvements\r
 595  \r
 596  Fix to allow pipe ('|') command to work when using notmuch over ssh\r
 597  \r
 598 -Fix count of lines in hidden signatures.\r
 599 +Fix count of lines in hidden signatures\r
 600  \r
 601 -Omit repeated subject lines in (collapsed) thread display.\r
 602 +Omit repeated subject lines in (collapsed) thread display\r
 603  \r
 604 -Display current thread subject in a header line.\r
 605 +Display current thread subject in a header line\r
 606  \r
 607 -Provide a "c i" binding to copy a thread ID from the search view.\r
 608 +Provide a "c i" binding to copy a thread ID from the search view\r
 609  \r
 610 -Allow for notmuch-fcc-dirs to have a value of nil.\r
 611 +Allow for notmuch-fcc-dirs to have a value of nil\r
 612  \r
 613    Also, the more complex form of notmuch-fcc-dirs now has a slightly\r
 614    different format. It no longer has a special first-element, fallback\r
 615 @@ -1130,7 +1133,7 @@ Notmuch 0.4 (2010-11-01)\r
 616  New command-line features\r
 617  -------------------------\r
 618  \r
 619 -notmuch search --output=(summary|threads|messages|tags|files)\r
 620 +`notmuch search --output=(summary|threads|messages|tags|files)`\r
 621  \r
 622    This new option allows for particular items to be returned from\r
 623    notmuch searches. The "summary" option is the default and behaves\r
 624 @@ -1145,7 +1148,7 @@ notmuch search --output=(summary|threads|messages|tags|files)\r
 625                  <operations-on> "$file"\r
 626          done\r
 627  \r
 628 -notmuch show --format=mbox <search-specification>\r
 629 +`notmuch show --format=mbox <search-specification>`\r
 630  \r
 631    This new option allows for the messages matching a search\r
 632    specification to be presented as an mbox. Specifically the "mboxrd"\r
 633 @@ -1154,7 +1157,7 @@ notmuch show --format=mbox <search-specification>\r
 634    beginning of all lines beginning with one or more '>' characters\r
 635    followed by the 5 characters "From ".\r
 636  \r
 637 -notmuch config [get|set] <section>.<item> [value ...]\r
 638 +`notmuch config [get|set] <section>.<item> [value ...]`\r
 639  \r
 640    The new top-level "config" command allows for any value in the\r
 641    notmuch configuration file to be queried or set to a new value. Both\r
 642 @@ -1171,10 +1174,10 @@ Avoid setting Bcc header in "notmuch reply"\r
 643  New library features\r
 644  --------------------\r
 645  \r
 646 -Add notmuch_query_get_query_string and notmuch_query_get_sort\r
 647 +Add `notmuch_query_get_query_string` and `notmuch_query_get_sort`\r
 648  \r
 649    These are simply functions for querying properties of a\r
 650 -  notmuch_query_t object.\r
 651 +  `notmuch_query_t` object.\r
 652  \r
 653  New emacs features\r
 654  ------------------\r
 655 @@ -1219,7 +1222,7 @@ Allow search-result color specifications to overlay each other\r
 656    case in previous releases). See "Notmuch Search Line Faces" in the\r
 657    notmuch customize interface.\r
 658  \r
 659 -Make hidden author names still available for incremental search.\r
 660 +Make hidden author names still available for incremental search\r
 661  \r
 662    When there is insufficient space to display all authors of a thread\r
 663    in search results, the names of hidden authors are now still made\r
 664 @@ -1236,6 +1239,7 @@ New binding of Control-TAB (works like TAB in reverse)\r
 665  \r
 666  New build-system features\r
 667  -------------------------\r
 668 +\r
 669  Various portability fixes have been applied\r
 670  \r
 671    These include fixes for build failures on at least Solaris, FreeBSD,\r
 672 @@ -1253,13 +1257,13 @@ Arrange for libnotmuch to be found automatically after make install\r
 673       automatically run ldconfig.\r
 674  \r
 675    2. If the library is installed to a non-system directory, the\r
 676 -     build system adds a DR_RUNPATH entry to the final binary\r
 677 +     build system adds a `DR_RUNPATH` entry to the final binary\r
 678       pointing to the directory to which the library is installed.\r
 679  \r
 680    When this support works, the user should be able to run notmuch\r
 681    immediately after "make install", without any errors trying to find\r
 682    the notmuch library, and without having to manually set environment\r
 683 -  variables such as LD_LIBRARY_PATH.\r
 684 +  variables such as `LD_LIBRARY_PATH`.\r
 685  \r
 686  Check compiler/linker options before using them\r
 687  \r
 688 @@ -1282,7 +1286,7 @@ New modularization of test suite\r
 689    it easy to run the test suite within valgrind (pass --valgrind to\r
 690    notmuch-test or to any sub-script) which has been very useful.\r
 691  \r
 692 -New testing of emacs interface.\r
 693 +New testing of emacs interface\r
 694  \r
 695    The test suite has been augmented to allow automated testing of the\r
 696    emacs interfaces. So far, this includes basic searches, display of\r
 697 @@ -1305,7 +1309,7 @@ Fix potential corruption of database when "notmuch new" is interrupted\r
 698    The message-adding code has been carefully audited and reworked to\r
 699    avoid this sort of corruption regardless of when it is interrupted.\r
 700  \r
 701 -Fix failure with extremely long message ID headers.\r
 702 +Fix failure with extremely long message ID headers\r
 703  \r
 704    Previously, a message with an extremely long message ID, (say, more\r
 705    than 300 characters), would fail to be added to notmuch, (triggering\r
 706 @@ -1317,9 +1321,10 @@ Fix for messages with "charset=unknown-8bit"\r
 707    GMime warning, (which would then trip up emacs or other interfaces\r
 708    parsing the notmuch results).\r
 709  \r
 710 -Fix notmuch_query_search_threads function to return NULL on any exception\r
 711 +Fix `notmuch_query_search_threads` function to return NULL on any exception\r
 712  \r
 713 -Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails\r
 714 +Fix "notmuch search" to return non-zero if `notmuch_query_search_threads`\r
 715 +fails\r
 716  \r
 717    Previously, this command could confusingly report a Xapian\r
 718    exception, yet still return an error code of 0. It now correctly\r
 719 @@ -1382,7 +1387,7 @@ Emacs bug fixes\r
 720  Fix calculations for line wrapping in the primary "notmuch" view\r
 721  \r
 722  Fix Fcc support to prompt to create a directory if the specified Fcc\r
 723 -directory does not exist.\r
 724 +directory does not exist\r
 725  \r
 726  Build fix\r
 727  ---------\r
 728 @@ -1533,7 +1538,7 @@ New 'G' key binding to trigger mail refresh (G == "Get new mail")\r
 729    typically invoke "notmuch new" and then perhaps several "notmuch\r
 730    tag" commands.\r
 731  \r
 732 -Implement emacs message display with the JSON output from notmuch.\r
 733 +Implement emacs message display with the JSON output from notmuch\r
 734  \r
 735    This is much more robust than the previous implementation, (where\r
 736    some HTML mails and mail quoting the notmuch code with the delimiter\r
 737 @@ -1595,16 +1600,16 @@ Customizable formatting of search results\r
 738    the various fields in a "notmuch search" buffer. See the "Notmuch\r
 739    Search Result Format" section of the customize interface.\r
 740  \r
 741 -Generate nicer names for search buffers when using a saved search.\r
 742 +Generate nicer names for search buffers when using a saved search\r
 743  \r
 744 -Add a notmuch User-Agent header when sending mail from notmuch/emacs.\r
 745 +Add a notmuch User-Agent header when sending mail from notmuch/emacs\r
 746  \r
 747 -New keybinding (M-Ret) to open all collapsed messages in a thread.\r
 748 +New keybinding (M-Ret) to open all collapsed messages in a thread\r
 749  \r
 750  New library feature\r
 751  -------------------\r
 752  \r
 753 -Provide a new NOTMUCH_SORT_UNSORTED value for queries\r
 754 +Provide a new `NOTMUCH_SORT_UNSORTED` value for queries\r
 755  \r
 756    This can be somewhat faster when sorting simply isn't desired. For\r
 757    example when collecting a set of messages that will all be\r
 758 @@ -1620,7 +1625,7 @@ Fix to compile against GMime 2.6\r
 759    Previously notmuch insisted on being able to find GMime 2.4, (even\r
 760    though GMime 2.6 would have worked all along).\r
 761  \r
 762 -Fix configure script to accept (and ignore) various standard options.\r
 763 +Fix configure script to accept (and ignore) various standard options\r
 764  \r
 765    For example, those that the Gentoo build scripts expect configure to\r
 766    accept are now all accepted.\r
 767 @@ -1668,7 +1673,7 @@ Make "notmuch count" with no arguments count all messages\r
 768    Previously, it was hard to construct a search term that was\r
 769    guaranteed to match all messages.\r
 770  \r
 771 -Provide a new special-case search term of "*" to match all messages.\r
 772 +Provide a new special-case search term of "*" to match all messages\r
 773  \r
 774    This can be used in any command accepting a search term, such as\r
 775    "notmuch search '*'". Note that you'll want to take care that the\r
 776 @@ -1678,7 +1683,7 @@ Provide a new special-case search term of "*" to match all messages.\r
 777    other search terms.\r
 778  \r
 779  Automatically detect thread connections even when a parent message is\r
 780 -missing.\r
 781 +missing\r
 782  \r
 783    Previously, if two or more message were received with a common\r
 784    parent, but that parent was not received, then these messages would\r
 785 @@ -1695,7 +1700,7 @@ Fix potential data loss in "notmuch new" with SIGINT\r
 786    the database (and their tags being lost) if the user pressed\r
 787    Control-C while "notmuch new" was working.\r
 788  \r
 789 -Fix segfault when a message includes a MIME part that is empty.\r
 790 +Fix segfault when a message includes a MIME part that is empty\r
 791  \r
 792  Fix handling of non-ASCII characters with --format=json\r
 793  \r
 794 @@ -1730,20 +1735,20 @@ Show the last few lines of citations as well as the first few lines\r
 795    notmuch-show-citation-lines-suffix).\r
 796  \r
 797  The '+' and '-' commands in the search view can now add and remove\r
 798 -tags by region.\r
 799 +tags by region\r
 800  \r
 801    Selective bulk tagging is now possible by selecting a region of\r
 802    threads and then using either the '+' or '-' keybindings. Bulk\r
 803    tagging is still available for all threads matching the current\r
 804    search with the '*' binding.\r
 805  \r
 806 -More meaningful buffer names for thread-view buffers.\r
 807 +More meaningful buffer names for thread-view buffers\r
 808  \r
 809    Notmuch now uses the Subject of the thread as the buffer\r
 810    name. Previously it was using the thread ID, which is a meaningless\r
 811    number to the user.\r
 812  \r
 813 -Provide for customized colors of threads in search view based on tags.\r
 814 +Provide for customized colors of threads in search view based on tags\r
 815  \r
 816    See the documentation of notmuch-search-line-faces, (or us "M-x\r
 817    customize" and browse to the "notmuch" group within "Applications"\r
 818 @@ -1766,16 +1771,16 @@ Add support to configure for many standard options\r
 819          --disable-maintainer-mode --disable-dependency-tracking\r
 820  \r
 821  Install emacs client in "make install" rather than requiring a\r
 822 -separate "make install-emacs".\r
 823 +separate "make install-emacs"\r
 824  \r
 825 -Automatically compute versions numbers between releases.\r
 826 +Automatically compute versions numbers between releases\r
 827  \r
 828    This support uses the git-describe notation, so a version such as\r
 829    0.1-144-g43cbbfc indicates a version that is 144 commits since the\r
 830    0.1 release and is available as git commit "43cbbfc".\r
 831  \r
 832 -Add a new "make test" target to run the test suite and actually verify\r
 833 -its results.\r
 834 +Add a new "make test" target to run the test suite and actually\r
 835 +verify its results\r
 836  \r
 837  Notmuch 0.1 (2010-04-05)\r
 838  ========================\r
 839 -- \r
 840 1.7.7.6\r
 841 \r