]> git.notmuchmail.org Git - obsolete/notmuch-wiki/blob - news/release-0.3.mdwn
let's see how this particular mdwn parses these news/* versions...
[obsolete/notmuch-wiki] / news / release-0.3.mdwn
1 [[!meta date="2010-04-27"]]
2
3 Notmuch 0.3 (2010-04-27)
4 ========================
5
6 New command-line features
7 -------------------------
8
9 #### User-configurable tags for new messages
10
11   A new "new.tags" option is available in the configuration file to
12   determine which tags are applied to new messages. Run "notmuch
13   setup" to generate new documentation within ~/.notmuch-config on how
14   to specify this value.
15
16 #### Threads search results named based on subjects that match search
17
18   This means that when new mails arrived to a thread you've previously
19   read, and the new mails have a new subject, you will see that
20   subject in the search results rather than the old subject.
21
22 #### Faster operation of "notmuch tag" (avoid unneeded sorting)
23
24   Since the user just wants to tag all matching messages, we can make
25   things perform a bit faster by avoiding the sort.
26
27 #### Even Better guessing of From: header for "notmuch reply"
28
29   Notmuch now looks at a number of headers when trying to figure out
30   the best From: header to use in a reply. This is helpful if you have
31   several configured email addresses, and you also subscribe to various
32   mailing lists with different addresses, (so that mails you are
33   replying to won't always include your subscribed address in the To:
34   header).
35
36 #### Indication of author names that match a search
37
38   When notmuch displays threads as the result of a search, it now
39   lists the authors that match the search before listing the other
40   authors in the thread. It inserts a pipe '|' symbol between the last
41   matching and first non-matching author. This is especially useful in
42   a search that includes tag:unread. Now the authors of the unread
43   messages in the thread are listed first.
44
45 New: Python bindings
46 --------------------
47
48 Sebastian Spaeth has contributed his python bindings for the notmuch
49 library to the central repository. These bindings were previously
50 known as "cnotmuch" within python but have now been renamed to be
51 accessible with a simple, and more official-looking "import notmuch".
52
53 The bindings have already proven very useful as people proficient in
54 python have been able to easily develop programs to do notmuch-based
55 searches for email-address completion, maildir-flag synchronization,
56 and other tasks.
57
58 These bindings are available within the bindings/python directory, but
59 are not yet integrated into the top-level Makefiles, nor the top-level
60 package-building scripts. Improvements are welcome.
61
62 Emacs interface improvements
63 ----------------------------
64
65 #### An entirely new initial view for notmuch, (friendly yet powerful)
66
67   Some of us call the new view "notmuch hello" but you can get at it
68   by simply calling "emacs -f notmuch". The new view provides a search
69   bar where new searches can be performed. It also displays a list of
70   recent searches, along with a button to save any of these, giving it
71   a new name as a "saved search". Many people find these "saved
72   searches" one of the most convenient ways of organizing their mail,
73   (providing all of the features of "folders" in other mail clients,
74   but without any of the disadvantages).
75
76   Finally, this view can also optionally display all of the tags that
77   exist in the database, along with a count for each tag, and a custom
78   search of messages with that tag that's simply a click (or keypress)
79   away.
80
81   Note: For users that liked the original mode of "emacs -f notmuch"
82         immediately displaying a particular search result, we
83         recommend instead running something like:
84
85                 emacs --eval '(notmuch search "tag:inbox" t)'
86
87         The "t" means to sort the messages in an "oldest first" order,
88         (as notmuch would do previously by default). You can also
89         leave that off to have your search results in "newest first"
90         order.
91
92 #### Full-featured "customize" support for configuring notmuch
93
94   Notmuch now plugs in well to the emacs "customize" mode to make it
95   much simpler to find things about the notmuch interface that can be
96   tweaked by the user.
97
98   You can get to this mode by starting at the main "Customize" menu in
99   emacs, then browsing through "Applications", "Mail", and
100   "Notmuch". Or you can go straight to "M-x customize-group"
101   "notmuch".
102
103   Once you're at the customize screen, you'll see a list of documented
104   options that can be manipulated along with checkboxes, drop-down
105   selectors, and text-entry boxes for configuring the various
106   settings.
107
108 #### Support for doing tab-completion of email addresses
109
110   This support currently relies on an external program,
111   (notmuch-addresses), that is not yet shipped with notmuch
112   itself. But multiple, suitable implementations of this program have
113   already been written that generate address completions by doing
114   notmuch searches of your email collection. For example, providing
115   first those addresses that you have composed messages to in the
116   past, etc.
117
118   One such program (implemented in python with the python bindings to
119   notmuch) is available via:
120
121         git clone  http://jkr.acm.jhu.edu/git/notmuch_addresses.git
122
123   Install that program as notmuch-addresses on your PATH, and then
124   hitting TAB on a partial email address or name within the To: or Cc:
125   line of an email message will provide matching completions.
126
127 #### Support for file-based (Fcc) delivery of sent messages to mail store
128
129   This isn't yet enabled by default. To enable this, one will have to
130   set the "Notmuch Fcc Dirs" setting within the notmuch customize
131   screen, (see its documentation there for details). We anticipate
132   making this automatic in a future release.
133
134 #### New 'G' key binding to trigger mail refresh (G == "Get new mail")
135
136   The 'G' key works wherever '=' works. Before refreshing the screen
137   it calls an external program that can be used to poll email servers,
138   run notmuch new and setup specific tags for the new emails. The
139   script to be called should be configured with the "Notmuch Poll
140   Script" setting in the customize interface. This script will
141   typically invoke "notmuch new" and then perhaps several "notmuch
142   tag" commands.
143
144 #### Implement emacs message display with the JSON output from notmuch
145
146   This is much more robust than the previous implementation, (where
147   some HTML mails and mail quoting the notmuch code with the delimiter
148   characters in it would cause the parser to fall over).
149
150 #### Better handling of HTML messages and MIME attachments (inline images!)
151
152   Allow for any MIME parts that emacs can display to be displayed
153   inline. This includes inline viewing of image attachments, (provided
154   the window is large enough to fit the image at its natural size).
155
156   Much more robust handling of HTML messages. Currently both text/plain
157   and text/html alternates will be rendered next to each other. In a
158   future release, users will be able to decide to see only one or the
159   other representation.
160
161   Each attachment now has its own button so that attachments can be
162   saved individually (the 'w' key is still available to save all
163   attachments).
164
165 #### Customizable support for tidying of text/plain message content
166
167   Many new functions are available for tidying up message
168   content. These include options such as wrapping long lines,
169   compressing duplicate blank lines, etc.
170
171   Most of these are disabled by default, but can easily be enabled by
172   clicking the available check boxes under the "Notmuch Show Insert
173   Text/Plain Hook" within the notmuch customize screen.
174
175 #### New support for searchable citations (even when hidden)
176
177   When portions of overly-long citations are hidden, the contents of
178   these citations will still be available for emacs' standard
179   "incremental search" functions. When the search matches any portion
180   of a hidden citation, the citation will become visible temporarily
181   to display the search result.
182
183 #### More flexible handling of header visibility
184
185   As an answer to complaints from many users, the To, Cc, and Date
186   headers of messages are no longer hidden by default. For those users
187   that liked that these were hidden, a new "Notmuch Messages Headers
188   Visible" option in the customize interface can be set to nil. The
189   visibility of headers can still be toggled on a per-message basis
190   with the 'h' keybinding.
191
192   For users that don't want to see some subset of those headers, the
193   new "Notmuch Message Headers" variable can be customized to list
194   only those headers that should be present in the display of a message.
195
196 #### The Return key now toggles message visibility anywhere
197
198   Previously this worked only on the first summary-line of a message.
199
200 #### Customizable formatting of search results
201
202   The user can easily customize the order, width, and formatting of
203   the various fields in a "notmuch search" buffer. See the "Notmuch
204   Search Result Format" section of the customize interface.
205
206 #### Generate nicer names for search buffers when using a saved search
207
208 #### Add a notmuch User-Agent header when sending mail from notmuch/emacs
209
210 #### New keybinding (M-Ret) to open all collapsed messages in a thread
211
212 New library feature
213 -------------------
214
215 #### Provide a new `NOTMUCH_SORT_UNSORTED` value for queries
216
217   This can be somewhat faster when sorting simply isn't desired. For
218   example when collecting a set of messages that will all be
219   manipulated identically, (adding a tag, removing a tag, deleting the
220   messages), then there's no advantage to sorting the messages by
221   date.
222
223 Build fixes
224 -----------
225
226 #### Fix to compile against GMime 2.6
227
228   Previously notmuch insisted on being able to find GMime 2.4, (even
229   though GMime 2.6 would have worked all along).
230
231 #### Fix configure script to accept (and ignore) various standard options
232
233   For example, those that the Gentoo build scripts expect configure to
234   accept are now all accepted.
235
236 Test suite
237 ----------
238
239 #### A large number of new tests for the many new features
240
241 #### Better display of output from failed tests
242
243   Now shows failures with diff rather than forcing the user to gaze at
244   complete actual and expected output looking for deviation.