NEWS: describe easier FCC configuration
[notmuch] / NEWS
1 New emacs features
2 ------------------
3 Add a new, optional hook for detecting inline patches
4
5   This hook is disabled by default but can be enabled with a checkbox
6   under ""Notmuch Show Insert Text/Plain Hook" in the notmuch
7   customize interface. It allows for inline patches to be detected and
8   treated as if they were attachments, (with context-sensitive
9   highlighting).
10
11 Automatically tag messages as "replied" when sending a reply
12
13   This feature adds a "replied" tag by default, but can easily be
14   customized to add or remove other tags as well. For example, a user
15   might use a tag of "needs-reply" and can configure this feature to
16   automatically remove that tag when replying. See "Notmuch Message
17   Mark Replied" in the notmuch customize interface.
18
19 Emacs mail improvements
20 -----------------------
21
22 Easier way to define a fcc directory
23     
24   In the common case that a user only has one FCC (save outgoing mail
25   in the Mail directory, it is now possible to simply configure a
26   string such as "Sent" in the notmuch-fcc-dirs variable. More complex
27   options, depending on a users email address, are possible and
28   described in the variable customization help text.
29     
30 Notmuch 0.3.1 (2010-04-27)
31 ==========================
32 General bug fixes
33 -----------------
34 Fix an infinite loop in "notmuch reply"
35
36   This bug could be triggered by replying to a message where the
37   user's primary email address did not appear in the To: header and
38   the user had not configured any secondary email addresses. The bug
39   was a simple re-use of the same iterator variable in nested loops.
40
41 Fix a potential SEGV in "notmuch search"
42
43   This bug could be triggered by an author name ending in a ','.
44   Admittedly - that's almost certainly a spam email, but we never
45   want notmuch to crash.
46
47 Emacs bug fixes
48 ---------------
49 Fix calculations for line wrapping in the primary "notmuch" view.
50
51 Fix Fcc support to prompt to create a directory if the specified Fcc
52 directory does not exist.
53
54 Build fix
55 ---------
56 Fix build on OpenSolaris (at least) due to missing 'extern "C"' block.
57
58   Without this, the C++ sources could not find strcasestr and the
59   final linking of notmuch would fail.
60
61 Notmuch 0.3 (2010-04-27)
62 ========================
63 New command-line features
64 -------------------------
65 User-configurable tags for new messages
66
67   A new "new.tags" option is available in the configuration file to
68   determine which tags are applied to new messages. Run "notmuch
69   setup" to generate new documentation within ~/.notmuch-config on how
70   to specify this value.
71
72 Threads search results named based on subjects that match search
73
74   This means that when new mails arrived to a thread you've previously
75   read, and the new mails have a new subject, you will see that
76   subject in the search results rather than the old subject.
77
78 Faster operation of "notmuch tag" (avoid unneeded sorting)
79
80   Since the user just wants to tag all matching messages, we can make
81   things perform a bit faster by avoiding the sort.
82
83 Even Better guessing of From: header for "notmuch reply"
84
85   Notmuch now looks at a number of headers when trying to figure out
86   the best From: header to use in a reply. This is helpful if you have
87   several configured email addresses, and you also subscribe to various
88   mailing lists with different addresses, (so that mails you are
89   replying to won't always include your subscribed address in the To:
90   header).
91
92 Indication of author names that match a search
93
94   When notmuch displays threads as the result of a search, it now
95   lists the authors that match the search before listing the other
96   authors in the thread. It inserts a pipe '|' symbol between the last
97   matching and first non-matching author. This is especially useful in
98   a search that includes tag:unread. Now the authors of the unread
99   messages in the thread are listed first.
100
101 New: Python bindings
102 --------------------
103 Sebastian Spaeth has contributed his python bindings for the notmuch
104 library to the central repository. These bindings were previously
105 known as "cnotmuch" within python but have now been renamed to be
106 accessible with a simple, and more official-looking "import notmuch".
107
108 The bindings have already proven very useful as people proficient in
109 python have been able to easily develop programs to do notmuch-based
110 searches for email-address completion, maildir-flag synchronization,
111 and other tasks.
112
113 These bindings are available within the bindings/python directory, but
114 are not yet integrated into the top-level Makefiles, nor the top-level
115 package-building scripts. Improvements are welcome.
116
117 Emacs interface improvements
118 ----------------------------
119 An entirely new initial view for notmuch, (friendly yet powerful)
120
121   Some of us call the new view "notmuch hello" but you can get at it
122   by simply calling "emacs -f notmuch". The new view provides a search
123   bar where new searches can be performed. It also displays a list of
124   recent searches, along with a button to save any of these, giving it
125   a new name as a "saved search". Many people find these "saved
126   searches" one of the most convenient ways of organizing their mail,
127   (providing all of the features of "folders" in other mail clients,
128   but without any of the disadvantages).
129
130   Finally, this view can also optionally display all of the tags that
131   exist in the database, along with a count for each tag, and a custom
132   search of messages with that tag that's simply a click (or keypress)
133   away.
134
135   Note: For users that liked the original mode of "emacs -f notmuch"
136         immediately displaying a particular search result, we
137         recommend instead running something like:
138
139                 emacs --eval '(notmuch search "tag:inbox" t)'
140
141         The "t" means to sort the messages in an "oldest first" order,
142         (as notmuch would do previously by default). You can also
143         leave that off to have your search results in "newest first"
144         order.
145
146 Full-featured "customize" support for configuring notmuch
147
148   Notmuch now plugs in well to the emacs "customize" mode to make it
149   much simpler to find things about the notmuch interface that can be
150   tweaked by the user.
151
152   You can get to this mode by starting at the main "Customize" menu in
153   emacs, then browsing through "Applications", "Mail", and
154   "Notmuch". Or you can go straight to "M-x customize-group"
155   "notmuch".
156
157   Once you're at the customize screen, you'll see a list of documented
158   options that can be manipulated along with checkboxes, drop-down
159   selectors, and text-entry boxes for configuring the various
160   settings.
161
162 Support for doing tab-completion of email addresses
163
164   This support currently relies on an external program,
165   (notmuch-addresses), that is not yet shipped with notmuch
166   itself. But multiple, suitable implementations of this program have
167   already been written that generate address completions by doing
168   notmuch searches of your email collection. For example, providing
169   first those addresses that you have composed messages to in the
170   past, etc.
171
172   One such program (implemented in python with the python bindings to
173   notmuch) is available via:
174
175         git clone  http://jkr.acm.jhu.edu/git/notmuch_addresses.git
176
177   Install that program as notmuch-addresses on your PATH, and then
178   hitting TAB on a partial email address or name within the To: or Cc:
179   line of an email message will provide matching completions.
180
181 Support for file-based (Fcc) delivery of sent messages to mail store
182
183   This isn't yet enabled by default. To enable this, one will have to
184   set the "Notmuch Fcc Dirs" setting within the notmuch customize
185   screen, (see its documentation there for details). We anticipate
186   making this automatic in a future release.
187
188 New 'G' key binding to trigger mail refresh (G == "Get new mail")
189
190   The 'G' key works wherever '=' works. Before refreshing the screen
191   it calls an external program that can be used to poll email servers,
192   run notmuch new and setup specific tags for the new emails. The
193   script to be called should be configured with the "Notmuch Poll
194   Script" setting in the customize interface. This script will
195   typically invoke "notmuch new" and then perhaps several "notmuch
196   tag" commands.
197
198 Implement emacs message display with the JSON output from notmuch.
199
200   This is much more robust than the previous implementation, (where
201   some HTML mails and mail quoting the notmuch code with the delimiter
202   characters in it would cause the parser to fall over).
203
204 Better handling of HTML messages and MIME attachments (inline images!)
205
206   Allow for any MIME parts that emacs can display to be displayed
207   inline. This includes inline viewing of image attachments, (provided
208   the window is large enough to fit the image at its natural size).
209
210   Much more robust handling of HTML messages. Currently both text/plain
211   and text/html alternates will be rendered next to each other. In a
212   future release, users will be able to decide to see only one or the
213   other representation.
214
215   Each attachment now has its own button so that attachments can be
216   saved individually (the 'w' key is still available to save all
217   attachments).
218
219 Customizable support for tidying of text/plain message content
220
221   Many new functions are available for tidying up message
222   content. These include options such as wrapping long lines,
223   compressing duplicate blank lines, etc.
224
225   Most of these are disabled by default, but can easily be enabled by
226   clicking the available check boxes under the "Notmuch Show Insert
227   Text/Plain Hook" within the notmuch customize screen.
228
229 New support for searchable citations (even when hidden)
230
231   When portions of overly-long citations are hidden, the contents of
232   these citations will still be available for emacs' standard
233   "incremental search" functions. When the search matches any portion
234   of a hidden citation, the citation will become visible temporarily
235   to display the search result.
236
237 More flexible handling of header visibility
238
239   As an answer to complaints from many users, the To, Cc, and Date
240   headers of messages are no longer hidden by default. For those users
241   that liked that these were hidden, a new "Notmuch Messages Headers
242   Visible" option in the customize interface can be set to nil. The
243   visibility of headers can still be toggled on a per-message basis
244   with the 'h' keybinding.
245
246   For users that don't want to see some subset of those headers, the
247   new "Notmuch Message Headers" variable can be customized to list
248   only those headers that should be present in the display of a message.
249
250 The Return key now toggles message visibility anywhere
251
252   Previously this worked only on the first summary-line of a message.
253
254 Customizable formatting of search results
255
256   The user can easily customize the order, width, and formatting of
257   the various fields in a "notmuch search" buffer. See the "Notmuch
258   Search Result Format" section of the customize interface.
259
260 Generate nicer names for search buffers when using a saved search.
261
262 Add a notmuch User-Agent header when sending mail from notmuch/emacs.
263
264 New keybinding (M-Ret) to open all collapsed messages in a thread.
265
266 New library feature
267 -------------------
268 Provide a new NOTMUCH_SORT_UNSORTED value for queries
269
270   This can be somewhat faster when sorting simply isn't desired. For
271   example when collecting a set of messages that will all be
272   manipulated identically, (adding a tag, removing a tag, deleting the
273   messages), then there's no advantage to sorting the messages by
274   date.
275
276 Build fixes
277 -----------
278 Fix to compile against GMime 2.6
279
280   Previously notmuch insisted on being able to find GMime 2.4, (even
281   though GMime 2.6 would have worked all along).
282
283 Fix configure script to accept (and ignore) various standard options.
284
285   For example, those that the gentoo build scripts expect configure to
286   accept are now all accepted.
287
288 Test suite
289 ----------
290 A large number of new tests for the many new features.
291
292 Better display of output from failed tests.
293
294   Now shows failures with diff rather than forcing the user to gaze at
295   complete actual and expected output looking for deviation.
296
297 Notmuch 0.2 (2010-04-16)
298 ========================
299 This is the second release of the notmuch mail system, with actual
300 detailed release notes this time!
301
302 This release consists of a number of minor new features that make
303 notmuch more pleasant to use, and a few fairly major bug fixes.
304
305 We didn't quite hit our release target of "about a week" from the 0.1
306 release, (0.2 is happening 11 days after 0.1), but we hope to do
307 better for next week. Look forward to some major features coming to
308 notmuch in subsequent releases.
309
310 -Carl
311
312 General features
313 ----------------
314 Better guessing of From: header.
315
316   Notmuch now tries harder to guess which configured address should be
317   used as the From: line in a "notmuch reply". It will examine the
318   Received: headers if it fails to find any configured address in To:
319   or Cc:. This allows it to often choose the correct address even when
320   replying to a message sent to a mailing list, and not directly to a
321   configured address.
322
323 Make "notmuch count" with no arguments count all messages
324
325   Previously, it was hard to construct a search term that was
326   guaranteed to match all messages.
327
328 Provide a new special-case search term of "*" to match all messages.
329
330   This can be used in any command accepting a search term, such as
331   "notmuch search '*'". Note that you'll want to take care that the
332   shell doesn't expand * against the current files. And note that the
333   support for "*" is a special case. It's only meaningful as a single
334   search term and loses its special meaning when combined with any
335   other search terms.
336
337 Automatically detect thread connections even when a parent message is
338 missing.
339
340   Previously, if two or more message were received with a common
341   parent, but that parent was not received, then these messages would
342   not be recognized as belonging to the same thread. This is now fixed
343   so that such messages are properly connected in a thread.
344
345 General bug fixes
346 -----------------
347 Fix potential data loss in "notmuch new" with SIGINT
348
349   One code path in "notmuch new" was not properly handling
350   SIGINT. Previously, this could lead to messages being removed from
351   the database (and their tags being lost) if the user pressed
352   Control-C while "notmuch new" was working.
353
354 Fix segfault when a message includes a MIME part that is empty.
355
356 Fix handling of non-ASCII characters with --format=json
357
358   Previously, characters outside the range of 7-bit ASCII were
359   silently dropped from the JSON output. This led to corrupted display
360   of utf-8 content in the upcoming notmuch web-based frontends.
361
362 Fix headers to be properly decoded in "notmuch reply"
363
364   Previously, the user might see:
365
366         Subject: Re: =?iso-8859-2?q?Rozlu=E8ka?=
367
368   rather than:
369
370         Subject: Re: Rozlu─Źka
371
372   The former text is properly encoded to be RFC-compliant SMTP, will
373   be sent correctly, and will be properly decoded by the
374   recipient. But the user trying to edit the reply would likely be
375   unable to read or edit that field in its encoded form.
376
377 Emacs client features
378 ---------------------
379 Show the last few lines of citations as well as the first few lines.
380
381   It's often the case that the last sentence of a citation is what is
382   being replied to directly, so the last few lines are often much more
383   important. The number of lines shown at the beginning and end of any
384   citation can be configured, (notmuch-show-citation-lines-prefix and
385   notmuch-show-citation-lines-suffix).
386
387 The '+' and '-' commands in the search view can now add and remove
388 tags by region.
389
390   Selective bulk tagging is now possible by selecting a region of
391   threads and then using either the '+' or '-' keybindings. Bulk
392   tagging is still available for all threads matching the current
393   search with th '*' binding.
394
395 More meaningful buffer names for thread-view buffers.
396
397   Notmuch now uses the Subject of the thread as the buffer
398   name. Previously it was using the thread ID, which is a meaningless
399   number to the user.
400
401 Provide for customized colors of threads in search view based on tags.
402
403   See the documentation of notmuch-search-line-faces, (or us "M-x
404   customize" and browse to the "notmuch" group within "Applications"
405   and "Mail"), for details on how to configure this colorization.
406
407 Build-system features
408 ---------------------
409 Add support to properly build libnotmuch on Darwin systems (OS X).
410
411 Add support to configure for many standard options.
412
413   We include actual support for:
414
415         --includedir --mandir --sysconfdir
416
417   And accept and silently ignore several more:
418
419         --build --infodir --libexecdir --localstatedir
420         --disable-maintainer-mode --disable-dependency-tracking
421
422 Install emacs client in "make install" rather than requiring a
423 separate "make install-emacs".
424
425 Automatically compute versions numbers between releases.
426
427   This support uses the git-describe notation, so a version such as
428   0.1-144-g43cbbfc indicates a version that is 144 commits since the
429   0.1 release and is available as git commit "43cbbfc".
430
431 Add a new "make test" target to run the test suite and actually verify
432 its results.
433
434 Notmuch 0.1 (2010-04-05)
435 ========================
436 This is the first release of the notmuch mail system.
437
438 It includes the libnotmuch library, the notmuch command-line
439 interface, and an emacs-based interface to notmuch.
440
441 Note: Notmuch will work best with Xapian 1.0.18 (or later) or Xapian
442 1.1.4 (or later). Previous versions of Xapian (whether 1.0 or 1.1) had
443 a performance bug that made notmuch very slow when modifying
444 tags. This would cause distracting pauses when reading mail while
445 notmuch would wait for Xapian when removing the "inbox" and "unread"
446 tags from messages in a thread.