]> git.cworth.org Git - obsolete/notmuch-wiki/blob - news/release-0.10.mdwn
add a page describing the email corpus
[obsolete/notmuch-wiki] / news / release-0.10.mdwn
1 [[!meta date="2011-11-23"]]
2
3 Notmuch 0.10 (2011-11-23)
4 =========================
5
6 New build and testing features
7 ------------------------------
8
9 Emacs tests are now done in `dtach`. This means that dtach is now
10 needed to run the notmuch test suite, at least until the checking for
11 prerequisites is improved.
12
13 Full test coverage of the stashing feature in Emacs.
14
15 New command-line features
16 -------------------------
17
18 ### Add `notmuch restore --accumulate` option
19
20 The `--accumulate` switch causes the union of the existing and new tags to
21 be applied, instead of replacing each message's tags as they are read in
22 from the dump file.
23
24 ### Add search terms to `notmuch dump`
25
26 The dump command now takes an optional search term much like notmuch
27 search/show/tag. The output file argument of dump is deprecated in
28 favour of using stdout.
29
30 ### Add `notmuch search` `--offset` and `--limit` options
31
32 The search command now takes options `--offset=[-]N` and `--limit=N` to
33 limit the number of results shown.
34
35 ### Add `notmuch count --output` option
36
37 The count command is now capable of counting threads in addition to
38 messages. This is selected using the new `--output=(threads|messages)`
39 option.
40
41 New emacs UI features
42 ---------------------
43
44 ### Add tab-completion for `notmuch-search` and `notmuch-search-filter`
45
46 These functions now support completion tags for query parts
47 starting with "tag:".
48
49 ### Turn "id:MSG-ID" links into buttons associated with notmuch searches
50
51 Text of the form "id:MSG-ID" in mails is now a clickable button that
52 opens a notmuch search for the given message id.
53
54 ### Add keybinding ('c I') for stashing Message-ID's without an id: prefix
55
56 Reduces manual labour when stashing them for use outside notmuch.
57
58 ### Do not query on `notmuch-search` exit
59
60 It is harmless to kill the external notmuch process, so the user
61 is no longer interrogated when they interrupt a search.
62
63 Performance
64 -----------
65
66 ### Emacs now constructs large search buffers more efficiently
67
68 ### Search avoids opening and parsing message files
69
70 We now store more information in the database so search no longer
71 has to open every message file to get basic headers.  This can
72 improve search speed by as much as 10X, but taking advantage of this
73 requires a database rebuild:
74
75         notmuch dump > notmuch.dump
76         # Backup, then remove notmuch database ($MAIL/.notmuch)
77         notmuch new
78         notmuch restore notmuch.dump
79
80 New collection of add-on tools
81 ------------------------------
82
83 The source directory "contrib" contains tools built on notmuch.  These
84 tools are not part of notmuch, and you should check their individual
85 licenses.  Feel free to report problems with them to the notmuch
86 mailing list.
87
88 ### nmbug - share tags with a given prefix
89
90 nmbug helps maintain a git repo containing all tags with a given
91 prefix (by default "notmuch::"). Tags can be shared by commiting
92 them to git in one location and restoring in another.