Re: [PATCH] emacs: wash: make word-wrap bound message width
[notmuch-archives.git] / 0e / afb9c8f49a75c8daacd6706be4d9db6eb3235a
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 23995429E34\r
6         for <notmuch@notmuchmail.org>; Wed,  1 Feb 2012 07:22:57 -0800 (PST)\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 51HnTi+2Pmp4 for <notmuch@notmuchmail.org>;\r
16         Wed,  1 Feb 2012 07:22:52 -0800 (PST)\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 81377431E64\r
19         for <notmuch@notmuchmail.org>; Wed,  1 Feb 2012 07:22:51 -0800 (PST)\r
20 Received: by guru.guru-group.fi (Postfix, from userid 501)\r
21         id 718E868055; Wed,  1 Feb 2012 17:22:52 +0200 (EET)\r
22 From: Tomi Ollila <tomi.ollila@iki.fi>\r
23 To: notmuch@notmuchmail.org\r
24 Subject:\r
25  [PATCH 1/2] NEWS: markup changes to make mdwn->html look slightly better\r
26 Date: Wed,  1 Feb 2012 17:22:49 +0200\r
27 Message-Id: <1328109770-29279-1-git-send-email-tomi.ollila@iki.fi>\r
28 X-Mailer: git-send-email 1.7.6.1\r
29 MIME-Version: 1.0\r
30 Content-Type: text/plain; charset=UTF-8\r
31 Content-Transfer-Encoding: 8bit\r
32 Cc: Tomi Ollila <tomi.ollila@iki.fi>\r
33 X-BeenThere: notmuch@notmuchmail.org\r
34 X-Mailman-Version: 2.1.13\r
35 Precedence: list\r
36 List-Id: "Use and development of the notmuch mail system."\r
37         <notmuch.notmuchmail.org>\r
38 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
39         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
40 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
41 List-Post: <mailto:notmuch@notmuchmail.org>\r
42 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
43 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
44         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
45 X-List-Received-Date: Wed, 01 Feb 2012 15:22:57 -0000\r
46 \r
47 Some formatting in NEWS file has been changed so that it could\r
48 be given to markdown processing almost verbatim.\r
49 More effort has been put into formatting of version 0.11 (and 0.12)\r
50 of notmuch NEWS than previous versions but everything is in better\r
51 shape that those used to be.\r
52 ---\r
53 See http://notmuchmail.org/news/ (as of 2012-02-01) to see current\r
54 output (newssplit.pl -generated)\r
55  NEWS |  509 ++++++++++++++++++++++++++++++++++++------------------------------\r
56  1 files changed, 280 insertions(+), 229 deletions(-)\r
57 \r
58 diff --git a/NEWS b/NEWS\r
59 index 2acdce5..1e23ec7 100644\r
60 --- a/NEWS\r
61 +++ b/NEWS\r
62 @@ -4,35 +4,35 @@ Notmuch 0.12 (2012-xx-xx)\r
63  Command-Line Interface\r
64  ----------------------\r
65  \r
66 -Reply to sender\r
67 +* Reply to sender\r
68  \r
69 -  "notmuch reply" has gained the ability to create a reply template\r
70 +  `notmuch reply` has gained the ability to create a reply template\r
71    for replying just to the sender of the message, in addition to reply\r
72    to all. The feature is available through the new command line option\r
73 -  --reply-to=(all|sender).\r
74 +  `--reply-to=(all|sender)`.\r
75  \r
76 -Tag exclusion\r
77 +* Tag exclusion\r
78  \r
79    Tags can be automatically excluded from search results by adding them\r
80 -  to the new 'search.exclude_tags' option in the Notmuch config file.\r
81 +  to the new `search.exclude_tags` option in the Notmuch config file.\r
82  \r
83    This behaviour can be overridden by explicitly including an excluded\r
84    tag in your query, for example:\r
85  \r
86 -    notmuch search $your_query and tag:$excluded_tag\r
87 +       notmuch search $your_query and tag:$excluded_tag\r
88  \r
89 -  Existing users will probably want to run "notmuch setup" again to add\r
90 +  Existing users will probably want to run `notmuch setup` again to add\r
91    the new well-commented [search] section to the configuration file.\r
92  \r
93    For new configurations, accepting the default setting will cause the\r
94    tags "deleted" and "spam" to be excluded, equivalent to running:\r
95  \r
96 -    notmuch config set search.exclude_tags deleted spam\r
97 +       notmuch config set search.exclude_tags deleted spam\r
98  \r
99  Emacs Interface\r
100  ---------------\r
101  \r
102 -Reply to sender\r
103 +* Reply to sender\r
104  \r
105    The Emacs interface has, with the new CLI support, gained the\r
106    ability to reply to sender in addition to reply to all. In both show\r
107 @@ -42,15 +42,15 @@ Reply to sender\r
108  Library changes\r
109  ---------------\r
110  \r
111 -New functions\r
112 +* New functions\r
113  \r
114 -  notmuch_query_add_tag_exclude supports the new tag exclusion\r
115 +  `notmuch_query_add_tag_exclude` supports the new tag exclusion\r
116    feature.\r
117  \r
118  Build fixes\r
119  -----------\r
120  \r
121 -Compatibility with GMime 2.6\r
122 +* Compatibility with GMime 2.6\r
123  \r
124    It is now possible to build notmuch against both GMime 2.4 and 2.6.\r
125    However, a bug in current GMime 2.6 causes notmuch not to report\r
126 @@ -62,38 +62,38 @@ Notmuch 0.11 (2012-01-13)\r
127  Command-Line Interface\r
128  ----------------------\r
129  \r
130 -Hooks\r
131 +* Hooks\r
132  \r
133    Hooks have been introduced to notmuch. Hooks are scripts that notmuch\r
134 -  invokes before and after certain actions. Initially, "notmuch new"\r
135 -  supports "pre-new" and "post-new" hooks that are run before and after\r
136 +  invokes before and after certain actions. Initially, `notmuch new`\r
137 +  supports `pre-new` and `post-new` hooks that are run before and after\r
138    importing new messages into the database.\r
139  \r
140 -notmuch reply --decrypt bugfix\r
141 +* `notmuch reply --decrypt bugfix`\r
142  \r
143 -  The "notmuch reply" command with --decrypt argument had a rarely\r
144 +  The `notmuch reply` command with `--decrypt` argument had a rarely\r
145    occurring bug that caused an encrypted message not to be decrypted\r
146    sometimes. This is now fixed.\r
147  \r
148  Performance\r
149  -----------\r
150  \r
151 -Automatic tag query optimization\r
152 +* Automatic tag query optimization\r
153  \r
154 -  "notmuch tag" now automatically optimizes the user's query to\r
155 +  `notmuch tag` now automatically optimizes the user's query to\r
156    exclude messages whose tags won't change.  In the past, we've\r
157    suggested that people do this by hand; this is no longer necessary.\r
158  \r
159 -Don't sort messages when creating a dump file\r
160 +* Don't sort messages when creating a dump file\r
161  \r
162    This speeds up tag dumps considerably, without any loss of\r
163    information. To replicate the old behavior of sorted output (for\r
164 -  example to compare two dump files), one can use e.g. sort(1).\r
165 +  example to compare two dump files), one can use e.g. `sort(1)`.\r
166  \r
167  Memory Management\r
168  -----------------\r
169  \r
170 -Reduction of memory leaks\r
171 +* Reduction of memory leaks\r
172  \r
173    Two memory leaks when searching and showing messages were identified\r
174    and fixed in this release.\r
175 @@ -101,63 +101,63 @@ Reduction of memory leaks\r
176  Emacs Interface\r
177  ---------------\r
178  \r
179 -Bug fixes\r
180 +* Bug fixes\r
181  \r
182    notmuch-show-advance (bound to the spacebar in notmuch-show-mode) had\r
183    a bug that caused it to always jump to the next message, even if it\r
184    should have scrolled down to show more of the current message instead.\r
185    This is now fixed.\r
186  \r
187 -Support "notmuch new" as a notmuch-poll-script\r
188 +* Support `notmuch new` as a notmuch-poll-script\r
189  \r
190 -  It's now possible to use "notmuch new" as a notmuch-poll-script\r
191 +  It's now possible to use `notmuch new` as a notmuch-poll-script\r
192    directly. This is also the new default. This allows taking better\r
193 -  advantage of the "notmuch new" hooks from emacs without intermediate\r
194 +  advantage of the `notmuch new` hooks from emacs without intermediate\r
195    scripts.\r
196  \r
197 -Improvements in saved search management\r
198 +* Improvements in saved search management\r
199  \r
200    New saved searches are now appended to the list of saved searches,\r
201    not inserted in front. It's also possible to define a sort function\r
202    for displaying saved searches; alphabetical sort is provided.\r
203  \r
204 -Hooks for notmuch-hello\r
205 +* Hooks for notmuch-hello\r
206  \r
207    Two new hooks have been added: "notmuch-hello-mode-hook" (called after\r
208    entering notmuch-hello-mode) and "notmuch-hello-refresh-hook" (called\r
209    after updating a notmuch-hello buffer).\r
210  \r
211 -New face for crypto parts headers\r
212 +* New face for crypto parts headers\r
213  \r
214    Crypto parts used to be displayed with a hardcoded color. A new face\r
215    has been introduced to fix this: notmuch-crypto-part-header. It\r
216    defaults to the same value as before, but can be customized to match\r
217    other color themes.\r
218  \r
219 -Use space as default thousands separator\r
220 +* Use space as default thousands separator\r
221  \r
222    Large numbers in notmuch-hello are now displayed using a space as\r
223    thousands separator (e.g. "123 456" instead of "123,456"). This can be\r
224    changed by customizing "notmuch-hello-thousands-separator".\r
225  \r
226 -Call notmuch-show instead of notmuch-search when clicking on\r
227 -buttonized id: links.\r
228 +* Call notmuch-show instead of notmuch-search when clicking on\r
229 +  buttonized id: links.\r
230  \r
231 -New function notmuch-show-advance\r
232 +* New function notmuch-show-advance\r
233  \r
234    This new function advances through just the current thread, and is\r
235    less invasive than notmuch-show-advance-and-archive.  It can easily\r
236    be bound to SPC with:\r
237  \r
238 -  (define-key notmuch-show-mode-map " " 'notmuch-show-advance)\r
239 +       (define-key notmuch-show-mode-map " " 'notmuch-show-advance)\r
240  \r
241 -Various performance improvements.\r
242 +* Various performance improvements\r
243  \r
244  New add-on tool\r
245  ---------------\r
246  \r
247 -The tool contrib/notmuch-deliver helps with initial delivery and\r
248 -tagging of mail (replacing running notmuch new).\r
249 +The tool `contrib/notmuch-deliver` helps with initial delivery and\r
250 +tagging of mail (replacing running `notmuch new`).\r
251  \r
252  \r
253  Notmuch 0.10.2 (2011-12-04)\r
254 @@ -166,9 +166,9 @@ Notmuch 0.10.2 (2011-12-04)\r
255  Bug-fix release.\r
256  ----------------\r
257  \r
258 -Fix crash in python bindings.\r
259 +* Fix crash in python bindings\r
260  \r
261 -  The python bindings did not call g_type_init, which caused crashes\r
262 +  The python bindings did not call `g_type_init`, which caused crashes\r
263    for some, but not all users.\r
264  \r
265  Notmuch 0.10.1 (2011-11-25)\r
266 @@ -177,7 +177,7 @@ Notmuch 0.10.1 (2011-11-25)\r
267  Bug-fix release.\r
268  ----------------\r
269  \r
270 -Fix --help argument\r
271 +* Fix --help argument\r
272  \r
273    Argument processing changes in 0.10 introduced a bug where "notmuch\r
274    --help" crashed while "notmuch help" worked fine. This is fixed in\r
275 @@ -198,24 +198,24 @@ Full test coverage of the stashing feature in Emacs.\r
276  New command-line features\r
277  -------------------------\r
278  \r
279 -Add "notmuch restore --accumulate" option\r
280 +* Add "notmuch restore --accumulate" option\r
281  \r
282    The --accumulate switch causes the union of the existing and new tags to be\r
283    applied, instead of replacing each message's tags as they are read in from\r
284    the dump file.\r
285  \r
286 -Add search terms to  "notmuch dump"\r
287 +* Add search terms to  "notmuch dump"\r
288  \r
289    The dump command now takes an optional search term much like notmuch\r
290    search/show/tag. The output file argument of dump is deprecated in\r
291    favour of using stdout.\r
292  \r
293 -Add "notmuch search" --offset and --limit options\r
294 +* Add "notmuch search" --offset and --limit options\r
295  \r
296    The search command now takes options --offset=[-]N and --limit=N to limit\r
297    the number of results shown.\r
298  \r
299 -Add "notmuch count --output" option\r
300 +* Add "notmuch count --output" option\r
301  \r
302    The count command is now capable of counting threads in addition to\r
303    messages. This is selected using the new --output=(threads|messages) option.\r
304 @@ -223,21 +223,21 @@ Add "notmuch count --output" option\r
305  New emacs UI features\r
306  ---------------------\r
307  \r
308 -Add tab-completion for notmuch-search and notmuch-search-filter\r
309 +* Add tab-completion for notmuch-search and notmuch-search-filter\r
310  \r
311    These functions now support completion tags for query parts\r
312    starting with "tag:".\r
313  \r
314 -Turn "id:MSG-ID" links into buttons associated with notmuch searches\r
315 +* Turn "id:MSG-ID" links into buttons associated with notmuch searches\r
316  \r
317    Text of the form "id:MSG-ID" in mails is now a clickable button that\r
318    opens a notmuch search for the given message id.\r
319  \r
320 -Add keybinding ('c I') for stashing Message-ID's without an id: prefix\r
321 +* Add keybinding ('c I') for stashing Message-ID's without an id: prefix\r
322  \r
323    Reduces manual labour when stashing them for use outside notmuch.\r
324  \r
325 -Do not query on notmuch-search exit\r
326 +* Do not query on notmuch-search exit\r
327  \r
328    It is harmless to kill the external notmuch process, so the user\r
329    is no longer interrogated when they interrupt a search.\r
330 @@ -245,9 +245,9 @@ Do not query on notmuch-search exit\r
331  Performance\r
332  -----------\r
333  \r
334 -Emacs now constructs large search buffers more efficiently\r
335 +* Emacs now constructs large search buffers more efficiently\r
336  \r
337 -Search avoids opening and parsing message files\r
338 +* Search avoids opening and parsing message files\r
339  \r
340    We now store more information in the database so search no longer\r
341    has to open every message file to get basic headers.  This can\r
342 @@ -267,7 +267,7 @@ tools are not part of notmuch, and you should check their individual\r
343  licenses.  Feel free to report problems with them to the notmuch\r
344  mailing list.\r
345  \r
346 -nmbug - share tags with a given prefix\r
347 +* nmbug - share tags with a given prefix\r
348  \r
349    nmbug helps maintain a git repo containing all tags with a given\r
350    prefix (by default "notmuch::"). Tags can be shared by commiting\r
351 @@ -279,7 +279,7 @@ Notmuch 0.9 (2011-10-01)\r
352  New, general features\r
353  ---------------------\r
354  \r
355 -Correct handling of interruptions during "notmuch new"\r
356 +* Correct handling of interruptions during "notmuch new"\r
357  \r
358    "notmuch new" now operates as a series of small, self-consistent\r
359    transactions, so it can correctly resume after an interruption or\r
360 @@ -290,16 +290,16 @@ Correct handling of interruptions during "notmuch new"\r
361  Library changes\r
362  ---------------\r
363  \r
364 -New functions\r
365 +* New functions\r
366  \r
367 -  notmuch_database_begin_atomic and notmuch_database_end_atomic allow\r
368 -  multiple database operations to be performed atomically.\r
369 +  `notmuch_database_begin_atomic` and `notmuch_database_end_atomic`\r
370 +  allow multiple database operations to be performed atomically.\r
371  \r
372 -  notmuch_database_find_message_by_filename does exactly what it says.\r
373 +  `notmuch_database_find_message_by_filename` does exactly what it says.\r
374  \r
375 -API changes\r
376 +* API changes\r
377  \r
378 -  notmuch_database_find_message (and n_d_f_m_by_filename) now return\r
379 +  `notmuch_database_find_message` (and `n_d_f_m_by_filename`) now return\r
380    a status indicator and uses an output parameter for the\r
381    message. This change required changing the SONAME of libnotmuch to\r
382    libnotmuch.so.2\r
383 @@ -309,8 +309,8 @@ Python bindings changes\r
384  \r
385    - Re-encode python unicode objects to utf-8 before passing back to\r
386      libnotmuch.\r
387 -  - Support Database().begin_atomic()/end_atomic()\r
388 -  - Support Database().find_message_by_filename()\r
389 +  - Support `Database().begin_atomic()/end_atomic()`\r
390 +  - Support `Database().find_message_by_filename()`\r
391      NB! This needs a db opened in READ-WRITE mode currently, or it will crash\r
392      the python process. The is a limitation (=bug) of the underlying libnotmuch.\r
393    - Fixes where we would not throw NotmuchErrors when we should (Justus Winter)\r
394 @@ -319,17 +319,17 @@ Python bindings changes\r
395  Ruby bindings changes\r
396  ---------------------\r
397  \r
398 -  - Wrap new library functions notmuch_database_{begin,end}_atomic.\r
399 -  - Add new exception Notmuch::UnbalancedAtomicError.\r
400 +  - Wrap new library functions `notmuch_database_{begin,end}_atomic.`\r
401 +  - Add new exception `Notmuch::UnbalancedAtomicError.`\r
402    - Rename destroy  to destroy! according to Ruby naming conventions.\r
403 -  - Update for n_d_find_message* API changes (see above).\r
404 +  - Update for `n_d_find_message*` API changes (see above).\r
405  \r
406  Emacs improvements\r
407  ------------------\r
408  \r
409    * Add gpg callback to crypto sigstatus buttons to retrieve/refresh\r
410      signing key.\r
411 -  * Add notmuch-show-refresh-view function (and corresponding binding)\r
412 +  * Add `notmuch-show-refresh-view` function (and corresponding binding)\r
413      to refresh the view of a notmuch-show buffer.\r
414  \r
415  Reply formatting cleanup\r
416 @@ -341,7 +341,7 @@ Reply formatting cleanup\r
417  Notmuch 0.8 (2011-09-10)\r
418  ========================\r
419  \r
420 -Improved handling of message/rfc822 parts\r
421 +* Improved handling of message/rfc822 parts\r
422  \r
423    Both in the CLI and the emacs interface.  Output of rfc822 parts now\r
424    includes the primary headers, as well as the body and all subparts.\r
425 @@ -349,20 +349,20 @@ Improved handling of message/rfc822 parts\r
426    headers, is unfortunately not yet supported (but hopefully will be\r
427    soon).\r
428  \r
429 -Improved Build system portability\r
430 +* Improved Build system portability\r
431  \r
432    Certain parts of the shell script generating notmuch.sym were\r
433    specific to the GNU versions of sed and nm. The new version should\r
434    be more portable to e.g. OpenBSD.\r
435  \r
436 -Documentation update for Ruby bindings\r
437 +* Documentation update for Ruby bindings\r
438  \r
439    Added documentation, typo fixes, and improved support for rdoc.\r
440  \r
441 -Unicode, iterator, PEP8 changes for python bindings\r
442 +* Unicode, iterator, PEP8 changes for python bindings\r
443  \r
444    - PEP8 (code formatting) changes for python files.\r
445 -  - Remove Tags.__len__ ; see 0.6 release notes for motivation.\r
446 +  - Remove `Tags.__len__` ; see 0.6 release notes for motivation.\r
447    - Decode headers as UTF8, encode (unicode) database paths as UTF8.\r
448  \r
449  Notmuch 0.7 (2011-08-01)\r
450 @@ -393,9 +393,9 @@ Sebastian Spaeth contributed two changes related to unicode and UTF8:\r
451    * query string is encoded as a UTF8 byte string\r
452  \r
453  Build-System improvements\r
454 -------------------------\r
455 +-------------------------\r
456  \r
457 -Generate notmuch.sym after the relevant object files\r
458 +* Generate notmuch.sym after the relevant object files\r
459  \r
460    This fixes a bug in parallel building. Thanks to Thomas Jost for the\r
461    patch.\r
462 @@ -403,19 +403,21 @@ Generate notmuch.sym after the relevant object files\r
463  Notmuch 0.6.1 (2011-07-17)\r
464  ==========================\r
465  \r
466 -Bug-fix release.\r
467 -----------------\r
468 +Bug-fix release\r
469 +---------------\r
470  \r
471 -Re-export Xapian exception typeinfo symbols.\r
472 +* Re-export Xapian exception typeinfo symbols\r
473  \r
474    It turned out our aggressive symbol hiding caused problems for\r
475    people running gcc 4.4.5.\r
476  \r
477  Notmuch 0.6 (2011-07-01)\r
478  =======================\r
479 +\r
480  New, general features\r
481  ---------------------\r
482 -Folder-based searching\r
483 +\r
484 +* Folder-based searching\r
485  \r
486    Notmuch queries can now include a search term to match the\r
487    directories in which mail files are stored (within the mail\r
488 @@ -447,13 +449,13 @@ Folder-based searching\r
489         notmuch new\r
490         notmuch restore notmuch.dump\r
491  \r
492 -Support for PGP/MIME\r
493 +* Support for PGP/MIME\r
494  \r
495 -  Both the command line interface and the emacs-interface have new\r
496 +  Both the command-line interface and the emacs-interface have new\r
497    support for PGP/MIME, detailed below. Thanks to Daniel Kahn Gillmor\r
498    and Jameson Graef Rollins for making this happen.\r
499  \r
500 -New, automatic tags: "signed" and "encrypted"\r
501 +* New, automatic tags: "signed" and "encrypted"\r
502  \r
503    These tags will automatically be applied to messages containing\r
504    multipart/signed and multipart/encrypted parts.\r
505 @@ -463,25 +465,26 @@ New, automatic tags: "signed" and "encrypted"\r
506  \r
507  New command-line features\r
508  -------------------------\r
509 -Add new "notmuch show --verify" option for signature verification\r
510 +\r
511 +* Add new "notmuch show --verify" option for signature verification\r
512  \r
513    This option instruct notmuch to verify the signature of\r
514    PGP/MIME-signed parts.\r
515  \r
516 -Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options\r
517 +* Add new "notmuch show --decrypt" and "notmuch reply --decrypt" options\r
518  \r
519    This option instructs notmuch to decrypt PGP/MIME-encrypted parts.\r
520    Note that this feature currently requires gpg-agent and a passphrase entry\r
521    tool (e.g. pinentry-gtk or pinentry-curses).\r
522  \r
523 -Proper nesting of multipart parts in "notmuch show" output\r
524 +* Proper nesting of multipart parts in "notmuch show" output\r
525  \r
526    MIME parts are now display with proper nesting to reflect original\r
527    MIME hierarchy of a message. This allows clients to correctly\r
528    analyze the MIME structure, (such as, for example, determining to\r
529    which parts a signature part applies).\r
530  \r
531 -Add new "notmuch show --part" option\r
532 +* Add new "notmuch show --part" option\r
533  \r
534    This is a replacement for the older "notmuch part" command, (which\r
535    is now deprecated—it should still work as always, but is no longer\r
536 @@ -490,7 +493,7 @@ Add new "notmuch show --part" option\r
537    part, (such as --format=json for extracting a message part with JSON\r
538    formatting).\r
539  \r
540 -Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *")\r
541 +* Deprecate "notmuch search-tags" (in favor of "notmuch search --output=tags *")\r
542  \r
543    The "notmuch search-tags" sub-command has been redundant since the\r
544    addition of the --output=tags option to "notmuch search". We now\r
545 @@ -500,7 +503,8 @@ Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *")\r
546  \r
547  Performance improvements\r
548  ------------------------\r
549 -Faster searches (by doing fewer searches to construct threads)\r
550 +\r
551 +* Faster searches (by doing fewer searches to construct threads)\r
552  \r
553    Whenever a user asks for search results as threads, notmuch first\r
554    performs a search for messages matching the query, then performs\r
555 @@ -509,7 +513,7 @@ Faster searches (by doing fewer searches to construct threads)\r
556    Removing inefficiencies and redundancies in these secondary searches\r
557    results in a measured speedups of 1.5x for a typical search.\r
558  \r
559 -Faster searches (by doing fewer passes to gather message data)\r
560 +* Faster searches (by doing fewer passes to gather message data)\r
561  \r
562    Optimizing Xapian data access patterns (using a single pass to get\r
563    all message-document data rather than a pass for each data type)\r
564 @@ -520,13 +524,13 @@ Faster searches (by doing fewer passes to gather message data)\r
565    of 2.5x for a search of all messages in his inbox (was 4.5s, now\r
566    1.8s). Thanks, Austin!\r
567  \r
568 -Faster initial indexing\r
569 +* Faster initial indexing\r
570  \r
571    More efficient indexing of new messages results in a measured\r
572    speedup of 1.4x for the initial indexing of 3 GB of mail (1h 14m\r
573    rather than 1h 46m). Thanks to Austin Clements and Michal Sojka.\r
574  \r
575 -Make "notmuch new" faster for unchanged directories\r
576 +* Make "notmuch new" faster for unchanged directories\r
577  \r
578    Optimizing to not do any further examinations of sub-directories\r
579    when the filesystem indicates that a directory is unchanged from the\r
580 @@ -536,23 +540,23 @@ Make "notmuch new" faster for unchanged directories\r
581  New emacs-interface features\r
582  ----------------------------\r
583  \r
584 -Support for PGP/MIME (GnuPG)\r
585 +* Support for PGP/MIME (GnuPG)\r
586  \r
587    Automatically indicate validity of signatures for multipart/signed\r
588    messages.  Automatically display decrypted content for\r
589    multipart/encrypted messages.  See the emacs variable\r
590    notmuch-crypto-process-mime for more information. Note that this\r
591 -  needs gpg-agent and a pinentry tool just as the command line tools.\r
592 +  needs gpg-agent and a pinentry tool just as the command-line tools.\r
593    Also note there is no support SMIME yet.\r
594  \r
595 -Output of pipe command is now displayed if pipe command fails\r
596 +* Output of pipe command is now displayed if pipe command fails\r
597  \r
598    This is extremely useful in the common use case of piping a patch to\r
599    "git am". If git fails to cleanly merge the patch the error messages\r
600    from the failed merge are now clearly displayed to the user, (where\r
601    previously they were silently hidden from the user).\r
602  \r
603 -User-selectable From address\r
604 +* User-selectable From address\r
605  \r
606    A user can choose which configured email addresses should be used as\r
607    the From address whenever composing a new message. To do so, simply\r
608 @@ -568,12 +572,13 @@ User-selectable From address\r
609    the "Notmuch Always Prompt For Sender" option in the notmuch\r
610    customize group.\r
611  \r
612 -Hiding of repeated subjects in collapsed thread view\r
613 +* Hiding of repeated subjects in collapsed thread view\r
614  \r
615    In notmuch-show mode, if a collapsed message has the same subject as\r
616    its parent, the subject is not shown.\r
617  \r
618 -Automatic detection and hiding of original message in top-posted message\r
619 +* Automatic detection and hiding of original message in top-posted \r
620 +  message\r
621  \r
622    When a message contains a line looking something like:\r
623  \r
624 @@ -584,7 +589,7 @@ Automatic detection and hiding of original message in top-posted message\r
625    button to display it again). This makes the handling of top-posted\r
626    citations work much like conventional citations.\r
627  \r
628 -New hooks for running code when tags are modified\r
629 +* New hooks for running code when tags are modified\r
630  \r
631    Some users want to perform additional actions whenever a particular\r
632    tag is added/removed from a message. This could be used to, for\r
633 @@ -595,7 +600,7 @@ New hooks for running code when tags are modified\r
634         Notmuch Before Tag Hook\r
635         Notmuch After Tag Hook\r
636  \r
637 -New optional support for hiding some multipart/alternative parts\r
638 +* New optional support for hiding some multipart/alternative parts\r
639  \r
640    Many emails are sent with redundant content within a\r
641    multipart/alternative group (such as a text/plain part as well as a\r
642 @@ -609,12 +614,13 @@ New optional support for hiding some multipart/alternative parts\r
643    because there's not yet a simple way to re-display such a hidden\r
644    part if it is not actually redundant with a displayed part.\r
645  \r
646 -Better rendering of text/x-vcalendar parts\r
647 +* Better rendering of text/x-vcalendar parts\r
648  \r
649    These parts are now displayed in a format suitable for use with the\r
650    emacs diary.\r
651  \r
652 -Avoid getting confused by Subject and Author fields with newline characters\r
653 +* Avoid getting confused by Subject and Author fields with newline\r
654 +  characters\r
655  \r
656    Replacing all characters with ASCII code less than 32 with a question mark.\r
657  \r
658 @@ -623,6 +629,7 @@ and drop "name" if it's actually just a repeat of the email address).\r
659  \r
660  Vim interface improvements\r
661  --------------------------\r
662 +\r
663  Felipe Contreras provided a number of updates for the vim interface:\r
664  \r
665    * Using sendmail directly rather than mailx,\r
666 @@ -633,39 +640,43 @@ Felipe Contreras provided a number of updates for the vim interface:\r
667  \r
668  Bindings improvements\r
669  ---------------------\r
670 -Ruby bindings are now much more complete\r
671  \r
672 -  Including QUERY.sort, QUERY.to_s, MESSAGE.maildir_flags_to_tags,\r
673 -  MESSAGE.tags_to_maildir_flags, and MESSAGE.get_filenames\r
674 +* Ruby bindings are now much more complete\r
675 +\r
676 +  Including `QUERY.sort`, `QUERY.to_s`, `MESSAGE.maildir_flags_to_tags`,\r
677 +  `MESSAGE.tags_to_maildir_flags`, and `MESSAGE.get_filenames`\r
678  \r
679  * Python bindings have been updated and extended\r
680 +\r
681    (docs online at http://packages.python.org/notmuch/)\r
682  \r
683    New bindings:\r
684 -  - Message().get_filenames(),\r
685 -  - Message().tags_to_maildir_flags(),Message().maildir_flags_to_tags()\r
686 -  - list(Threads()) and list(Messages) works now\r
687 +  - `Message().get_filenames()`,\r
688 +  - `Message().tags_to_maildir_flags()`, `Message().maildir_flags_to_tags()`\r
689 +  - `list(Threads())` and `list(Messages)` works now\r
690  \r
691 -  - Message().__cmp__() and __hash__()\r
692 -  These allow, for example:\r
693 +  - `Message().__cmp__() and __hash__()`\r
694 +    These allow, for example:\r
695         if msg1 == msg2: ...\r
696  \r
697 -  As well as set arithmetic on Messages():\r
698 +  As well as set arithmetic on `Messages()`:\r
699  \r
700         s1, s2= set(msgs1), set(msgs2)\r
701         s1.union(s2)\r
702         s2 -= s1\r
703  \r
704    Removed:\r
705 -     - len(Messages()) as it exhausted the iterator.\r
706 -       Use len(list(Messages())) or\r
707 -       Query.count_messages() to get the length.\r
708 +  - len(Messages()) as it exhausted the iterator.\r
709 +    Use len(list(Messages())) or\r
710 +    `Query.count_messages()` to get the length.\r
711  \r
712 -Added initial Go bindings in bindings/go\r
713 +* Added initial Go bindings in bindings/go\r
714  \r
715  New build-system features\r
716  -------------------------\r
717 -Added support for building in a directory other than the source directory\r
718 +\r
719 +* Added support for building in a directory other than the source\r
720 +  directory\r
721  \r
722    This can be used with the widely-supported idiom of simply running\r
723    the configure script from some other directory:\r
724 @@ -675,7 +686,7 @@ Added support for building in a directory other than the source directory\r
725         ../configure\r
726         make\r
727  \r
728 -Fix to save configure options for future, implicit runs of configure\r
729 +* Fix to save configure options for future, implicit runs of configure\r
730  \r
731    When a user updates the source (such as with "git pull") calling\r
732    "make" may cause an automatic re-run of the configure script. When\r
733 @@ -685,7 +696,8 @@ Fix to save configure options for future, implicit runs of configure\r
734  \r
735  New test-suite feature\r
736  ----------------------\r
737 -Binary for bash for running test suite now located via PATH.\r
738 +\r
739 +* Binary for bash for running test suite now located via PATH\r
740  \r
741    The notmuch test suite requires a fairly recent version of bash (>=\r
742    bash 4). As some systems supply an older version of bash at\r
743 @@ -694,16 +706,16 @@ Binary for bash for running test suite now located via PATH.\r
744    simply install bash >= 4 somewhere on $PATH before /bin and then use\r
745    the test suite.\r
746  \r
747 -Support for testing output with a trailing newline.\r
748 +* Support for testing output with a trailing newline\r
749  \r
750    Previously, some tests would fail to notice a difference in the\r
751    presence/absence of a trailing newline in a program output, (which\r
752    has led to bugs in the past). Now, carefully-written tests (using\r
753 -  test_expect_equal_file rather than test_expect_equal) will detect\r
754 +  `test_expect_equal_file` rather than `test_expect_equal`) will detect\r
755    any change in the presence/absence of a trailing newline. Many tests\r
756    are updated to take advantage of this.\r
757  \r
758 -Avoiding accessing user's $HOME while running test suite\r
759 +* Avoiding accessing user's $HOME while running test suite\r
760  \r
761    The test suite now carefully creates its own HOME directory. This\r
762    allows the test suite to be run with no existing HOME directory, (as\r
763 @@ -713,13 +725,14 @@ Avoiding accessing user's $HOME while running test suite\r
764  \r
765  General bug fixes\r
766  -----------------\r
767 -Output *all* files for "notmuch search --output=files"\r
768 +\r
769 +* Output *all* files for "notmuch search --output=files"\r
770  \r
771    For the cases where multiple files have the same Message ID,\r
772    previous versions of notmuch would output only one such file. This\r
773    command is now fixed to correctly output all files.\r
774  \r
775 -Fixed spurious search results from "overlapped" indexing of addresses\r
776 +* Fixed spurious search results from "overlapped" indexing of addresses\r
777  \r
778    This fixed a bug where a search for:\r
779  \r
780 @@ -729,24 +742,24 @@ Fixed spurious search results from "overlapped" indexing of addresses\r
781  \r
782         To: user@example,com, someone@elsewhere.com\r
783  \r
784 -Fix --output=json when search has no results\r
785 +* Fix --output=json when search has no results\r
786  \r
787    A bug present since notmuch 0.4 had caused searches with no results\r
788    to produce an invalid json object. This is now fixed to cleanly\r
789    return a valid json object representing an empty array "[]" as\r
790    expected.\r
791  \r
792 -fix the automatic detection of the From address for "notmuch reply"\r
793 -from the Received headers in some cases.\r
794 +* Fix the automatic detection of the From address for "notmuch reply"\r
795 +  from the Received headers in some cases.\r
796  \r
797 -Fix core dump on DragonFlyBSD due to -1 return value from\r
798 -sysconf(_SC_GETPW_R_SIZE_MAX).\r
799 +* Fix core dump on DragonFlyBSD due to -1 return value from\r
800 +  `sysconf(_SC_GETPW_R_SIZE_MAX)`.\r
801  \r
802 -Cleaned up several memory leaks\r
803 +* Cleaned up several memory leaks\r
804  \r
805 -Eliminated a few, rare segmentation faults and a double-free.\r
806 +* Eliminated a few, rare segmentation faults and a double-free\r
807  \r
808 -Fix libnotmuch library to only export notmuch API functions\r
809 +* Fix libnotmuch library to only export notmuch API functions\r
810  \r
811    Previous release of the notmuch library also exported some Xapian\r
812    C++ exception type symbols. These were never part of the library\r
813 @@ -754,48 +767,52 @@ Fix libnotmuch library to only export notmuch API functions\r
814  \r
815  Emacs-interface bug fixes\r
816  -------------------------\r
817 -Display any unexpected output or errors from "notmuch search" invocations\r
818 +\r
819 +* Display any unexpected output or errors from "notmuch search"\r
820 +invocations\r
821  \r
822    Previously any misformatted output or trailing error messages were\r
823    silently ignored. This output is now clearly displayed. This fix was\r
824    very helpful in identifying and fixing the bug described below.\r
825  \r
826 -Fix bug where some threads would be missing from large search results\r
827 +* Fix bug where some threads would be missing from large search results\r
828  \r
829    When a search returned a "large" number of results, the emacs\r
830    interface was incorrectly dropping one thread every time the output\r
831    of the "notmuch search" process spanned the emacs read-buffer. This\r
832    is now fixed.\r
833  \r
834 -Avoid re-compression of .gz files (and similar) when saving attachment\r
835 +* Avoid re-compression of .gz files (and similar) when saving attachment\r
836  \r
837    Emacs was being too clever for its own good and trying to\r
838    re-compress pre-compressed .gz files when saving such attachments\r
839    (potentially corrupting the attachment). The emacs interface is\r
840    fixed to avoid this bug.\r
841  \r
842 -Fix hiding of a message when a previously-hidden citation is visible\r
843 +* Fix hiding of a message when a previously-hidden citation is visible\r
844  \r
845    Previously the citation would remain visible in this case. This is\r
846    fixed so that hiding a message hides all parts.\r
847  \r
848  Notmuch 0.5 (2010-11-11)\r
849  ========================\r
850 +\r
851  New, general features\r
852  ---------------------\r
853 -Maildir-flag synchronization\r
854 +\r
855 +* Maildir-flag synchronization\r
856  \r
857    Notmuch now knows how to synchronize flags in maildir filenames with\r
858    tags in the notmuch database. The following flag/tag mappings are\r
859    supported:\r
860  \r
861 -       Flag <-> Tag\r
862 -       ----     -----\r
863 -       'D'      draft\r
864 -       'F'      flagged\r
865 -       'P'      passed\r
866 -       'R'      replied\r
867 -       'S'      unread (added when 'S' flag is not present)\r
868 +           Flag <-> Tag\r
869 +           ----     -----\r
870 +           'D'      draft\r
871 +           'F'      flagged\r
872 +           'P'      passed\r
873 +           'R'      replied\r
874 +           'S'      unread (added when 'S' flag is not present)\r
875  \r
876    The synchronization occurs in both directions, (for example, adding\r
877    the 'S' flag to a file will cause the "unread" tag to be added, and\r
878 @@ -805,7 +822,7 @@ Maildir-flag synchronization\r
879    This synchronization is enabled by default for users of the\r
880    command-line interface, (though only files in directories named\r
881    "cur" or "new" will be renamed). It can be disabled by setting the\r
882 -  new maildir.synchronize_flags option in the configuration file. For\r
883 +  new `maildir.synchronize_flags` option in the configuration file. For\r
884    example:\r
885  \r
886         notmuch config set maildir.synchronize_flags false\r
887 @@ -826,25 +843,27 @@ Maildir-flag synchronization\r
888  \r
889  New library features\r
890  --------------------\r
891 -Support for querying multiple filenames for a single message\r
892 +\r
893 +* Support for querying multiple filenames for a single message\r
894  \r
895    It is common for the mailstore to contain multiple files with the\r
896    same message ID. Previously, notmuch would always hide these\r
897    duplicate files, (returning a single, arbitrary filename with\r
898 -  notmuch_message_get_filename).\r
899 +  `notmuch_message_get_filename`).\r
900  \r
901    With this release, library users can access all filenames for a\r
902    message with the new function:\r
903  \r
904         notmuch_message_get_filenames\r
905  \r
906 -  Together with notmuch_filenames_valid, notmuch_filenames_get, and\r
907 -  notmuch_filenames_move_to_next it is now possible to iterate over\r
908 -  all available filenames for a given message.\r
909 +  Together with `notmuch_filenames_valid`, `notmuch_filenames_get`,\r
910 +  and `notmuch_filenames_move_to_next` it is now possible to iterate\r
911 +  over all available filenames for a given message.\r
912  \r
913  New command-line features\r
914  -------------------------\r
915 -New "notmuch show --format=raw" for getting at original email contents\r
916 +\r
917 +* New "notmuch show --format=raw" for getting at original email contents\r
918  \r
919    This new feature allows for a fully-functional email client to be\r
920    built on top of the notmuch command-line without needing any direct\r
921 @@ -863,7 +882,8 @@ New "notmuch show --format=raw" for getting at original email contents\r
922  \r
923  General bug fixes\r
924  -----------------\r
925 -Fix "notmuch search" to print nothing when nothing matches\r
926 +\r
927 +* Fix "notmuch search" to print nothing when nothing matches\r
928  \r
929    The 0.4 release had a bug in which:\r
930  \r
931 @@ -876,17 +896,18 @@ Fix "notmuch search" to print nothing when nothing matches\r
932  \r
933  Emacs interface improvements\r
934  ----------------------------\r
935 -Fix to allow pipe ('|') command to work when using notmuch over ssh\r
936  \r
937 -Fix count of lines in hidden signatures.\r
938 +* Fix to allow pipe ('|') command to work when using notmuch over ssh\r
939 +\r
940 +* Fix count of lines in hidden signatures\r
941  \r
942 -Omit repeated subject lines in (collapsed) thread display.\r
943 +* Omit repeated subject lines in (collapsed) thread display\r
944  \r
945 -Display current thread subject in a header line.\r
946 +* Display current thread subject in a header line\r
947  \r
948 -Provide a "c i" binding to copy a thread ID from the search view.\r
949 +* Provide a "c i" binding to copy a thread ID from the search view\r
950  \r
951 -Allow for notmuch-fcc-dirs to have a value of nil.\r
952 +* Allow for notmuch-fcc-dirs to have a value of nil\r
953  \r
954    Also, the more complex form of notmuch-fcc-dirs now has a slightly\r
955    different format. It no longer has a special first-element, fallback\r
956 @@ -898,7 +919,8 @@ Allow for notmuch-fcc-dirs to have a value of nil.\r
957  \r
958  Vim interface improvements\r
959  --------------------------\r
960 -Felipe Contreras provided a number of updates for the vim interface.\r
961 +\r
962 +Felipe Contreras provided a number of updates for the vim interface\r
963  \r
964    These include optimizations, support for newer versions of vim, fixed\r
965    support for sending mail on modern systems, new commands, and\r
966 @@ -906,13 +928,16 @@ Felipe Contreras provided a number of updates for the vim interface.\r
967  \r
968  New bindings\r
969  ------------\r
970 +\r
971  Added initial ruby bindings in bindings/ruby\r
972  \r
973  Notmuch 0.4 (2010-11-01)\r
974  ========================\r
975 +\r
976  New command-line features\r
977  -------------------------\r
978 -notmuch search --output=(summary|threads|messages|tags|files)\r
979 +\r
980 +* `notmuch search --output=(summary|threads|messages|tags|files)`\r
981  \r
982    This new option allows for particular items to be returned from\r
983    notmuch searches. The "summary" option is the default and behaves\r
984 @@ -927,7 +952,7 @@ notmuch search --output=(summary|threads|messages|tags|files)\r
985                 <operations-on> "$file"\r
986         done\r
987  \r
988 -notmuch show --format=mbox <search-specification>\r
989 +* `notmuch show --format=mbox <search-specification>`\r
990  \r
991    This new option allows for the messages matching a search\r
992    specification to be presented as an mbox. Specifically the "mboxrd"\r
993 @@ -936,14 +961,14 @@ notmuch show --format=mbox <search-specification>\r
994    beginning of all lines beginning with one or more '>' characters\r
995    followed by the 5 characters "From ".\r
996  \r
997 -notmuch config [get|set] <section>.<item> [value ...]\r
998 +* `notmuch config [get|set] <section>.<item> [value ...]`\r
999  \r
1000    The new top-level "config" command allows for any value in the\r
1001    notmuch configuration file to be queried or set to a new value. Both\r
1002    single-valued and multi-valued items are supported, as our any\r
1003    custom items stored in the configuration file.\r
1004  \r
1005 -Avoid setting Bcc header in "notmuch reply"\r
1006 +* Avoid setting Bcc header in "notmuch reply"\r
1007  \r
1008    We decided that this was a bit heavy-handed as the actual mail\r
1009    user-agent should be responsible for setting any Bcc option. Also,\r
1010 @@ -952,14 +977,16 @@ Avoid setting Bcc header in "notmuch reply"\r
1011  \r
1012  New library features\r
1013  --------------------\r
1014 -Add notmuch_query_get_query_string and notmuch_query_get_sort\r
1015 +\r
1016 +* Add `notmuch_query_get_query_string` and `notmuch_query_get_sort`\r
1017  \r
1018    These are simply functions for querying properties of a\r
1019 -  notmuch_query_t object.\r
1020 +  `notmuch_query_t` object.\r
1021  \r
1022  New emacs features\r
1023  ------------------\r
1024 -Enable Fcc of all sent messages by default (to "sent" directory)\r
1025 +\r
1026 +* Enable Fcc of all sent messages by default (to "sent" directory)\r
1027  \r
1028    All messages sent from the emacs interface will now be saved to the\r
1029    notmuch mail store where they will be incorporated to the database\r
1030 @@ -968,21 +995,21 @@ Enable Fcc of all sent messages by default (to "sent" directory)\r
1031    can be customized by means of the "Notmuch Fcc Dirs" option in the\r
1032    notmuch customize interface.\r
1033  \r
1034 -Ability to all open messages in a thread to a pipe\r
1035 +* Ability to all open messages in a thread to a pipe\r
1036  \r
1037    Historically, the '|' keybinding allows for piping a single message\r
1038    to an external command. Now, by prefixing this key with a prefix\r
1039    argument, (for example, by pressing "Control-U |"), all open\r
1040    messages in the current thread will be sent to the external command.\r
1041  \r
1042 -Optional support for detecting inline patches\r
1043 +* Optional support for detecting inline patches\r
1044  \r
1045    This hook is disabled by default but can be enabled with a checkbox\r
1046    under "Notmuch Show Insert Text/Plain Hook" in the notmuch customize\r
1047    interface. It allows for inline patches to be detected and treated\r
1048    as if they were attachments, (with context-sensitive highlighting).\r
1049  \r
1050 -Automatically tag messages as "replied" when sending a reply\r
1051 +* Automatically tag messages as "replied" when sending a reply\r
1052  \r
1053    Messages replied to within the emacs interface will now be tagged as\r
1054    "replied". This feature can easily be customized to add or remove\r
1055 @@ -991,7 +1018,7 @@ Automatically tag messages as "replied" when sending a reply\r
1056    that tag when replying. See "Notmuch Message Mark Replied" in the\r
1057    notmuch customize interface.\r
1058  \r
1059 -Allow search-result color specifications to overlay each other\r
1060 +* Allow search-result color specifications to overlay each other\r
1061  \r
1062    For example, one tag can specify the background color of matching\r
1063    lines, while another can specify the foreground. With this change,\r
1064 @@ -999,7 +1026,7 @@ Allow search-result color specifications to overlay each other\r
1065    case in previous releases). See "Notmuch Search Line Faces" in the\r
1066    notmuch customize interface.\r
1067  \r
1068 -Make hidden author names still available for incremental search.\r
1069 +* Make hidden author names still available for incremental search\r
1070  \r
1071    When there is insufficient space to display all authors of a thread\r
1072    in search results, the names of hidden authors are now still made\r
1073 @@ -1007,7 +1034,7 @@ Make hidden author names still available for incremental search.\r
1074    searches, matching lines will temporarily expand to show the hidden\r
1075    names.\r
1076  \r
1077 -New binding of Control-TAB (works like TAB in reverse)\r
1078 +* New binding of Control-TAB (works like TAB in reverse)\r
1079  \r
1080    Many notmuch nodes already use TAB to navigate forward through\r
1081    various items allowing actions, (message headers, email attachments,\r
1082 @@ -1016,13 +1043,14 @@ New binding of Control-TAB (works like TAB in reverse)\r
1083  \r
1084  New build-system features\r
1085  -------------------------\r
1086 -Various portability fixes have been applied\r
1087 +\r
1088 +* Various portability fixes have been applied\r
1089  \r
1090    These include fixes for build failures on at least Solaris, FreeBSD,\r
1091    and Fedora systems. We're hopeful that the notmuch code base is now\r
1092    more portable than ever before.\r
1093  \r
1094 -Arrange for libnotmuch to be found automatically after make install\r
1095 +* Arrange for libnotmuch to be found automatically after make install\r
1096  \r
1097    The notmuch build system is now careful to help the user avoid\r
1098    errors of the form "libnotmuch.so could not be found" immediately\r
1099 @@ -1039,9 +1067,9 @@ Arrange for libnotmuch to be found automatically after make install\r
1100    When this support works, the user should be able to run notmuch\r
1101    immediately after "make install", without any errors trying to find\r
1102    the notmuch library, and without having to manually set environment\r
1103 -  variables such as LD_LIBRARY_PATH.\r
1104 +  variables such as `LD_LIBRARY_PATH`.\r
1105  \r
1106 -Check compiler/linker options before using them\r
1107 +* Check compiler/linker options before using them\r
1108  \r
1109    The configure script now carefully checks that any desired\r
1110    compilation options, (whether for enabling compiler warnings, or for\r
1111 @@ -1050,7 +1078,8 @@ Check compiler/linker options before using them\r
1112  \r
1113  New test-suite features\r
1114  -----------------------\r
1115 -New modularization of test suite.\r
1116 +\r
1117 +* New modularization of test suite\r
1118  \r
1119    Thanks to a gracious relicensing of the test-suite infrastructure\r
1120    from the git project, notmuch now has a modular test suite. This\r
1121 @@ -1061,7 +1090,7 @@ New modularization of test suite.\r
1122    it easy to run the test suite within valgrind (pass --valgrind to\r
1123    notmuch-test or to any sub-script) which has been very useful.\r
1124  \r
1125 -New testing of emacs interface.\r
1126 +* New testing of emacs interface\r
1127  \r
1128    The test suite has been augmented to allow automated testing of the\r
1129    emacs interfaces. So far, this includes basic searches, display of\r
1130 @@ -1072,7 +1101,8 @@ New testing of emacs interface.\r
1131  \r
1132  General bug fixes\r
1133  -----------------\r
1134 -Fix potential corruption of database when "notmuch new " is interrupted.\r
1135 +\r
1136 +* Fix potential corruption of database when "notmuch new " is interrupted\r
1137  \r
1138    Previously, an interruption of "notmuch new" would (rarely) result\r
1139    in a corrupt database. The corruption would manifest itself by a\r
1140 @@ -1083,21 +1113,22 @@ Fix potential corruption of database when "notmuch new " is interrupted.\r
1141    The message-adding code has been carefully audited and reworked to\r
1142    avoid this sort of corruption regardless of when it is interrupted.\r
1143  \r
1144 -Fix failure with extremely long message ID headers.\r
1145 +* Fix failure with extremely long message ID headers\r
1146  \r
1147    Previously, a message with an extremely long message ID, (say, more\r
1148    than 300 characters), would fail to be added to notmuch, (triggering\r
1149    Xapian exceptions). This has now been fixed.\r
1150  \r
1151 -Fix for messages with "charset=unknown-8bit"\r
1152 +* Fix for messages with "charset=unknown-8bit"\r
1153  \r
1154    Previously, messages with this charset would cause notmuch to emit a\r
1155    GMime warning, (which would then trip up emacs or other interfaces\r
1156    parsing the notmuch results).\r
1157  \r
1158 -Fix notmuch_query_search_threads function to return NULL on any exception\r
1159 +* Fix `notmuch_query_search_threads` function to return NULL on any exception\r
1160  \r
1161 -Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails\r
1162 +* Fix "notmuch search" to return non-zero if `notmuch_query_search_threads`\r
1163 +  fails\r
1164  \r
1165    Previously, this command could confusingly report a Xapian\r
1166    exception, yet still return an error code of 0. It now correctly\r
1167 @@ -1105,7 +1136,8 @@ Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails\r
1168  \r
1169  Emacs bug fixes\r
1170  ---------------\r
1171 -Fix to handle a message with a subject containing, for example "[1234]"\r
1172 +\r
1173 +* Fix to handle a message with a subject containing, for example "[1234]"\r
1174  \r
1175    Previously, a message subject containing a sequence of digits within\r
1176    square brackets would cause the emacs interface to mis-parse the\r
1177 @@ -1113,7 +1145,7 @@ Fix to handle a message with a subject containing, for example "[1234]"\r
1178    mis-displayed and prevent the user from manipulating the message in\r
1179    the emacs interface.\r
1180  \r
1181 -Fix to correctly handle message IDs containing ".."\r
1182 +* Fix to correctly handle message IDs containing ".."\r
1183  \r
1184    The emacs interface now properly quotes message IDs to avoid a\r
1185    Xapian bug in which the ".." within a message ID would be\r
1186 @@ -1121,11 +1153,13 @@ Fix to correctly handle message IDs containing ".."\r
1187  \r
1188  Python-binding fixes\r
1189  --------------------\r
1190 +\r
1191  The python bindings for notmuch have been updated to work with python3.\r
1192  \r
1193  Debian-specific fixes\r
1194  ---------------------\r
1195 -Fix emacs initialization so "M-x notmuch" works for users by default.\r
1196 +\r
1197 +* Fix emacs initialization so "M-x notmuch" works for users by default\r
1198  \r
1199    Now, a new Debian user can immediately run "emacs -f notmuch" after\r
1200    "apt-get install notmuch". Previously, the user would have had to\r
1201 @@ -1134,16 +1168,18 @@ Fix emacs initialization so "M-x notmuch" works for users by default.\r
1202  \r
1203  Notmuch 0.3.1 (2010-04-27)\r
1204  ==========================\r
1205 +\r
1206  General bug fixes\r
1207  -----------------\r
1208 -Fix an infinite loop in "notmuch reply"\r
1209 +\r
1210 +* Fix an infinite loop in "notmuch reply"\r
1211  \r
1212    This bug could be triggered by replying to a message where the\r
1213    user's primary email address did not appear in the To: header and\r
1214    the user had not configured any secondary email addresses. The bug\r
1215    was a simple re-use of the same iterator variable in nested loops.\r
1216  \r
1217 -Fix a potential SEGV in "notmuch search"\r
1218 +* Fix a potential SEGV in "notmuch search"\r
1219  \r
1220    This bug could be triggered by an author name ending in a ','.\r
1221    Admittedly - that's almost certainly a spam email, but we never\r
1222 @@ -1151,6 +1187,7 @@ Fix a potential SEGV in "notmuch search"\r
1223  \r
1224  Emacs bug fixes\r
1225  ---------------\r
1226 +\r
1227  Fix calculations for line wrapping in the primary "notmuch" view.\r
1228  \r
1229  Fix Fcc support to prompt to create a directory if the specified Fcc\r
1230 @@ -1158,34 +1195,37 @@ directory does not exist.\r
1231  \r
1232  Build fix\r
1233  ---------\r
1234 -Fix build on OpenSolaris (at least) due to missing 'extern "C"' block.\r
1235 +\r
1236 +* Fix build on OpenSolaris (at least) due to missing 'extern "C"' block\r
1237  \r
1238    Without this, the C++ sources could not find strcasestr and the\r
1239    final linking of notmuch would fail.\r
1240  \r
1241  Notmuch 0.3 (2010-04-27)\r
1242  ========================\r
1243 +\r
1244  New command-line features\r
1245  -------------------------\r
1246 -User-configurable tags for new messages\r
1247 +\r
1248 +* User-configurable tags for new messages\r
1249  \r
1250    A new "new.tags" option is available in the configuration file to\r
1251    determine which tags are applied to new messages. Run "notmuch\r
1252    setup" to generate new documentation within ~/.notmuch-config on how\r
1253    to specify this value.\r
1254  \r
1255 -Threads search results named based on subjects that match search\r
1256 +* Threads search results named based on subjects that match search\r
1257  \r
1258    This means that when new mails arrived to a thread you've previously\r
1259    read, and the new mails have a new subject, you will see that\r
1260    subject in the search results rather than the old subject.\r
1261  \r
1262 -Faster operation of "notmuch tag" (avoid unneeded sorting)\r
1263 +* Faster operation of "notmuch tag" (avoid unneeded sorting)\r
1264  \r
1265    Since the user just wants to tag all matching messages, we can make\r
1266    things perform a bit faster by avoiding the sort.\r
1267  \r
1268 -Even Better guessing of From: header for "notmuch reply"\r
1269 +* Even Better guessing of From: header for "notmuch reply"\r
1270  \r
1271    Notmuch now looks at a number of headers when trying to figure out\r
1272    the best From: header to use in a reply. This is helpful if you have\r
1273 @@ -1194,7 +1234,7 @@ Even Better guessing of From: header for "notmuch reply"\r
1274    replying to won't always include your subscribed address in the To:\r
1275    header).\r
1276  \r
1277 -Indication of author names that match a search\r
1278 +* Indication of author names that match a search\r
1279  \r
1280    When notmuch displays threads as the result of a search, it now\r
1281    lists the authors that match the search before listing the other\r
1282 @@ -1205,6 +1245,7 @@ Indication of author names that match a search\r
1283  \r
1284  New: Python bindings\r
1285  --------------------\r
1286 +\r
1287  Sebastian Spaeth has contributed his python bindings for the notmuch\r
1288  library to the central repository. These bindings were previously\r
1289  known as "cnotmuch" within python but have now been renamed to be\r
1290 @@ -1221,7 +1262,8 @@ package-building scripts. Improvements are welcome.\r
1291  \r
1292  Emacs interface improvements\r
1293  ----------------------------\r
1294 -An entirely new initial view for notmuch, (friendly yet powerful)\r
1295 +\r
1296 +* An entirely new initial view for notmuch, (friendly yet powerful)\r
1297  \r
1298    Some of us call the new view "notmuch hello" but you can get at it\r
1299    by simply calling "emacs -f notmuch". The new view provides a search\r
1300 @@ -1248,7 +1290,7 @@ An entirely new initial view for notmuch, (friendly yet powerful)\r
1301         leave that off to have your search results in "newest first"\r
1302         order.\r
1303  \r
1304 -Full-featured "customize" support for configuring notmuch\r
1305 +* Full-featured "customize" support for configuring notmuch\r
1306  \r
1307    Notmuch now plugs in well to the emacs "customize" mode to make it\r
1308    much simpler to find things about the notmuch interface that can be\r
1309 @@ -1264,7 +1306,7 @@ Full-featured "customize" support for configuring notmuch\r
1310    selectors, and text-entry boxes for configuring the various\r
1311    settings.\r
1312  \r
1313 -Support for doing tab-completion of email addresses\r
1314 +* Support for doing tab-completion of email addresses\r
1315  \r
1316    This support currently relies on an external program,\r
1317    (notmuch-addresses), that is not yet shipped with notmuch\r
1318 @@ -1283,14 +1325,14 @@ Support for doing tab-completion of email addresses\r
1319    hitting TAB on a partial email address or name within the To: or Cc:\r
1320    line of an email message will provide matching completions.\r
1321  \r
1322 -Support for file-based (Fcc) delivery of sent messages to mail store\r
1323 +* Support for file-based (Fcc) delivery of sent messages to mail store\r
1324  \r
1325    This isn't yet enabled by default. To enable this, one will have to\r
1326    set the "Notmuch Fcc Dirs" setting within the notmuch customize\r
1327    screen, (see its documentation there for details). We anticipate\r
1328    making this automatic in a future release.\r
1329  \r
1330 -New 'G' key binding to trigger mail refresh (G == "Get new mail")\r
1331 +* New 'G' key binding to trigger mail refresh (G == "Get new mail")\r
1332  \r
1333    The 'G' key works wherever '=' works. Before refreshing the screen\r
1334    it calls an external program that can be used to poll email servers,\r
1335 @@ -1300,13 +1342,13 @@ New 'G' key binding to trigger mail refresh (G == "Get new mail")\r
1336    typically invoke "notmuch new" and then perhaps several "notmuch\r
1337    tag" commands.\r
1338  \r
1339 -Implement emacs message display with the JSON output from notmuch.\r
1340 +* Implement emacs message display with the JSON output from notmuch\r
1341  \r
1342    This is much more robust than the previous implementation, (where\r
1343    some HTML mails and mail quoting the notmuch code with the delimiter\r
1344    characters in it would cause the parser to fall over).\r
1345  \r
1346 -Better handling of HTML messages and MIME attachments (inline images!)\r
1347 +* Better handling of HTML messages and MIME attachments (inline images!)\r
1348  \r
1349    Allow for any MIME parts that emacs can display to be displayed\r
1350    inline. This includes inline viewing of image attachments, (provided\r
1351 @@ -1321,7 +1363,7 @@ Better handling of HTML messages and MIME attachments (inline images!)\r
1352    saved individually (the 'w' key is still available to save all\r
1353    attachments).\r
1354  \r
1355 -Customizable support for tidying of text/plain message content\r
1356 +* Customizable support for tidying of text/plain message content\r
1357  \r
1358    Many new functions are available for tidying up message\r
1359    content. These include options such as wrapping long lines,\r
1360 @@ -1331,7 +1373,7 @@ Customizable support for tidying of text/plain message content\r
1361    clicking the available check boxes under the "Notmuch Show Insert\r
1362    Text/Plain Hook" within the notmuch customize screen.\r
1363  \r
1364 -New support for searchable citations (even when hidden)\r
1365 +* New support for searchable citations (even when hidden)\r
1366  \r
1367    When portions of overly-long citations are hidden, the contents of\r
1368    these citations will still be available for emacs' standard\r
1369 @@ -1339,7 +1381,7 @@ New support for searchable citations (even when hidden)\r
1370    of a hidden citation, the citation will become visible temporarily\r
1371    to display the search result.\r
1372  \r
1373 -More flexible handling of header visibility\r
1374 +* More flexible handling of header visibility\r
1375  \r
1376    As an answer to complaints from many users, the To, Cc, and Date\r
1377    headers of messages are no longer hidden by default. For those users\r
1378 @@ -1352,25 +1394,26 @@ More flexible handling of header visibility\r
1379    new "Notmuch Message Headers" variable can be customized to list\r
1380    only those headers that should be present in the display of a message.\r
1381  \r
1382 -The Return key now toggles message visibility anywhere\r
1383 +* The Return key now toggles message visibility anywhere\r
1384  \r
1385    Previously this worked only on the first summary-line of a message.\r
1386  \r
1387 -Customizable formatting of search results\r
1388 +* Customizable formatting of search results\r
1389  \r
1390    The user can easily customize the order, width, and formatting of\r
1391    the various fields in a "notmuch search" buffer. See the "Notmuch\r
1392    Search Result Format" section of the customize interface.\r
1393  \r
1394 -Generate nicer names for search buffers when using a saved search.\r
1395 +* Generate nicer names for search buffers when using a saved search\r
1396  \r
1397 -Add a notmuch User-Agent header when sending mail from notmuch/emacs.\r
1398 +* Add a notmuch User-Agent header when sending mail from notmuch/emacs\r
1399  \r
1400 -New keybinding (M-Ret) to open all collapsed messages in a thread.\r
1401 +* New keybinding (M-Ret) to open all collapsed messages in a thread\r
1402  \r
1403  New library feature\r
1404  -------------------\r
1405 -Provide a new NOTMUCH_SORT_UNSORTED value for queries\r
1406 +\r
1407 +* Provide a new `NOTMUCH_SORT_UNSORTED` value for queries\r
1408  \r
1409    This can be somewhat faster when sorting simply isn't desired. For\r
1410    example when collecting a set of messages that will all be\r
1411 @@ -1380,27 +1423,30 @@ Provide a new NOTMUCH_SORT_UNSORTED value for queries\r
1412  \r
1413  Build fixes\r
1414  -----------\r
1415 -Fix to compile against GMime 2.6\r
1416 +\r
1417 +* Fix to compile against GMime 2.6\r
1418  \r
1419    Previously notmuch insisted on being able to find GMime 2.4, (even\r
1420    though GMime 2.6 would have worked all along).\r
1421  \r
1422 -Fix configure script to accept (and ignore) various standard options.\r
1423 +* Fix configure script to accept (and ignore) various standard options\r
1424  \r
1425    For example, those that the Gentoo build scripts expect configure to\r
1426    accept are now all accepted.\r
1427  \r
1428  Test suite\r
1429  ----------\r
1430 -A large number of new tests for the many new features.\r
1431  \r
1432 -Better display of output from failed tests.\r
1433 +* A large number of new tests for the many new features\r
1434 +\r
1435 +* Better display of output from failed tests\r
1436  \r
1437    Now shows failures with diff rather than forcing the user to gaze at\r
1438    complete actual and expected output looking for deviation.\r
1439  \r
1440  Notmuch 0.2 (2010-04-16)\r
1441  ========================\r
1442 +\r
1443  This is the second release of the notmuch mail system, with actual\r
1444  detailed release notes this time!\r
1445  \r
1446 @@ -1416,7 +1462,8 @@ notmuch in subsequent releases.\r
1447  \r
1448  General features\r
1449  ----------------\r
1450 -Better guessing of From: header.\r
1451 +\r
1452 +* Better guessing of From: header\r
1453  \r
1454    Notmuch now tries harder to guess which configured address should be\r
1455    used as the From: line in a "notmuch reply". It will examine the\r
1456 @@ -1425,12 +1472,12 @@ Better guessing of From: header.\r
1457    replying to a message sent to a mailing list, and not directly to a\r
1458    configured address.\r
1459  \r
1460 -Make "notmuch count" with no arguments count all messages\r
1461 +* Make "notmuch count" with no arguments count all messages\r
1462  \r
1463    Previously, it was hard to construct a search term that was\r
1464    guaranteed to match all messages.\r
1465  \r
1466 -Provide a new special-case search term of "*" to match all messages.\r
1467 +* Provide a new special-case search term of "*" to match all messages\r
1468  \r
1469    This can be used in any command accepting a search term, such as\r
1470    "notmuch search '*'". Note that you'll want to take care that the\r
1471 @@ -1439,8 +1486,8 @@ Provide a new special-case search term of "*" to match all messages.\r
1472    search term and loses its special meaning when combined with any\r
1473    other search terms.\r
1474  \r
1475 -Automatically detect thread connections even when a parent message is\r
1476 -missing.\r
1477 +* Automatically detect thread connections even when a parent message\r
1478 +  is missing\r
1479  \r
1480    Previously, if two or more message were received with a common\r
1481    parent, but that parent was not received, then these messages would\r
1482 @@ -1449,22 +1496,23 @@ missing.\r
1483  \r
1484  General bug fixes\r
1485  -----------------\r
1486 -Fix potential data loss in "notmuch new" with SIGINT\r
1487 +\r
1488 +* Fix potential data loss in "notmuch new" with SIGINT\r
1489  \r
1490    One code path in "notmuch new" was not properly handling\r
1491    SIGINT. Previously, this could lead to messages being removed from\r
1492    the database (and their tags being lost) if the user pressed\r
1493    Control-C while "notmuch new" was working.\r
1494  \r
1495 -Fix segfault when a message includes a MIME part that is empty.\r
1496 +* Fix segfault when a message includes a MIME part that is empty\r
1497  \r
1498 -Fix handling of non-ASCII characters with --format=json\r
1499 +* Fix handling of non-ASCII characters with --format=json\r
1500  \r
1501    Previously, characters outside the range of 7-bit ASCII were\r
1502    silently dropped from the JSON output. This led to corrupted display\r
1503    of utf-8 content in the upcoming notmuch web-based frontends.\r
1504  \r
1505 -Fix headers to be properly decoded in "notmuch reply"\r
1506 +* Fix headers to be properly decoded in "notmuch reply"\r
1507  \r
1508    Previously, the user might see:\r
1509  \r
1510 @@ -1481,7 +1529,8 @@ Fix headers to be properly decoded in "notmuch reply"\r
1511  \r
1512  Emacs client features\r
1513  ---------------------\r
1514 -Show the last few lines of citations as well as the first few lines.\r
1515 +\r
1516 +* Show the last few lines of citations as well as the first few lines\r
1517  \r
1518    It's often the case that the last sentence of a citation is what is\r
1519    being replied to directly, so the last few lines are often much more\r
1520 @@ -1489,21 +1538,21 @@ Show the last few lines of citations as well as the first few lines.\r
1521    citation can be configured, (notmuch-show-citation-lines-prefix and\r
1522    notmuch-show-citation-lines-suffix).\r
1523  \r
1524 -The '+' and '-' commands in the search view can now add and remove\r
1525 -tags by region.\r
1526 +* The '+' and '-' commands in the search view can now add and remove\r
1527 +  tags by region\r
1528  \r
1529    Selective bulk tagging is now possible by selecting a region of\r
1530    threads and then using either the '+' or '-' keybindings. Bulk\r
1531    tagging is still available for all threads matching the current\r
1532    search with the '*' binding.\r
1533  \r
1534 -More meaningful buffer names for thread-view buffers.\r
1535 +* More meaningful buffer names for thread-view buffers\r
1536  \r
1537    Notmuch now uses the Subject of the thread as the buffer\r
1538    name. Previously it was using the thread ID, which is a meaningless\r
1539    number to the user.\r
1540  \r
1541 -Provide for customized colors of threads in search view based on tags.\r
1542 +* Provide for customized colors of threads in search view based on tags\r
1543  \r
1544    See the documentation of notmuch-search-line-faces, (or us "M-x\r
1545    customize" and browse to the "notmuch" group within "Applications"\r
1546 @@ -1511,9 +1560,10 @@ Provide for customized colors of threads in search view based on tags.\r
1547  \r
1548  Build-system features\r
1549  ---------------------\r
1550 -Add support to properly build libnotmuch on Darwin systems (OS X).\r
1551  \r
1552 -Add support to configure for many standard options.\r
1553 +* Add support to properly build libnotmuch on Darwin systems (OS X)\r
1554 +\r
1555 +* Add support to configure for many standard options\r
1556  \r
1557    We include actual support for:\r
1558  \r
1559 @@ -1524,20 +1574,21 @@ Add support to configure for many standard options.\r
1560         --build --infodir --libexecdir --localstatedir\r
1561         --disable-maintainer-mode --disable-dependency-tracking\r
1562  \r
1563 -Install emacs client in "make install" rather than requiring a\r
1564 -separate "make install-emacs".\r
1565 +* Install emacs client in "make install" rather than requiring a\r
1566 +  separate "make install-emacs"\r
1567  \r
1568 -Automatically compute versions numbers between releases.\r
1569 +* Automatically compute versions numbers between releases\r
1570  \r
1571    This support uses the git-describe notation, so a version such as\r
1572    0.1-144-g43cbbfc indicates a version that is 144 commits since the\r
1573    0.1 release and is available as git commit "43cbbfc".\r
1574  \r
1575 -Add a new "make test" target to run the test suite and actually verify\r
1576 -its results.\r
1577 +* Add a new "make test" target to run the test suite and actually\r
1578 +  verify its results\r
1579  \r
1580  Notmuch 0.1 (2010-04-05)\r
1581  ========================\r
1582 +\r
1583  This is the first release of the notmuch mail system.\r
1584  \r
1585  It includes the libnotmuch library, the notmuch command-line\r
1586 -- \r
1587 1.7.6.5\r
1588 \r