Re: [PATCH] configure: add --without-api-docs option
[notmuch-archives.git] / ea / b1fe55d8cf051b5423fe6dcea0728290ede8a9
1 Return-Path: <cworth@cworth.org>\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 80F4B4196F0\r
6         for <notmuch@notmuchmail.org>; Tue, 27 Apr 2010 02:41:00 -0700 (PDT)\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
8 X-Spam-Flag: NO\r
9 X-Spam-Score: -2.89\r
10 X-Spam-Level: \r
11 X-Spam-Status: No, score=-2.89 tagged_above=-999 required=5\r
12         tests=[ALL_TRUSTED=-1, BAYES_00=-1.9, T_MIME_NO_TEXT=0.01]\r
13         autolearn=ham\r
14 Received: from olra.theworths.org ([127.0.0.1])\r
15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
16         with ESMTP id C2KPXlLjaDqq for <notmuch@notmuchmail.org>;\r
17         Tue, 27 Apr 2010 02:40:58 -0700 (PDT)\r
18 Received: from yoom.home.cworth.org (localhost [127.0.0.1])\r
19         by olra.theworths.org (Postfix) with ESMTP id 46BA5431FC1\r
20         for <notmuch@notmuchmail.org>; Tue, 27 Apr 2010 02:40:58 -0700 (PDT)\r
21 Received: by yoom.home.cworth.org (Postfix, from userid 1000)\r
22         id CDA15568DEB; Tue, 27 Apr 2010 02:40:57 -0700 (PDT)\r
23 From: Carl Worth <cworth@cworth.org>\r
24 To: notmuch@notmuchmail.org\r
25 Subject: [Announce] notmuch release 0.3 now available\r
26 User-Agent: Notmuch/0.2-251-g8514e59 (http://notmuchmail.org) Emacs/23.1.1\r
27         (i486-pc-linux-gnu)\r
28 Date: Tue, 27 Apr 2010 02:40:57 -0700\r
29 Message-ID: <87tyqxmdw6.fsf@yoom.home.cworth.org>\r
30 MIME-Version: 1.0\r
31 Content-Type: multipart/signed; boundary="=-=-=";\r
32         micalg=pgp-sha1; protocol="application/pgp-signature"\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: Tue, 27 Apr 2010 09:41:00 -0000\r
46 \r
47 --=-=-=\r
48 Content-Transfer-Encoding: quoted-printable\r
49 \r
50 We're delighted to announce the 0.3 release of notmuch. We were closer\r
51 than ever to hitting our release target of "about a week" since 0.2,\r
52 (one week, one weekend, one day, and one long night).\r
53 \r
54 The major theme of this release is a huge number of improvements to the\r
55 emacs interface to notmuch. There's now a lovely new "welcome screen"\r
56 that provides a search bar, recent searches, and saved searches. It\r
57 looks nice, it's extremely convenient to use, and we think it makes a\r
58 great model for what a "search-based email interface" should look\r
59 like. (So we're hoping that someone will imitate it in an upcoming\r
60 graphical interface to notmuch).\r
61 \r
62 Other major improvements to the emacs interface include better HTML and\r
63 MIME support, including support for inline-image display within emacs.\r
64 Kudos to David Edmondson for most of the work on the emacs interface for\r
65 this release.\r
66 \r
67 Kudos also to Sebastian Spaeth who dominated "git shortlog 0.2..0.3"\r
68 with 105 commits. Many of these were for the new python bindings to the\r
69 notmuch library now included in the tar file, (but not yet uploaded as\r
70 a Debian package). Check them out.\r
71 \r
72 Dirk Hohndel and Jesse Rosenthal round out the list of major\r
73 contributors for the 0.3 release with a number of useful features each,\r
74 (better guessing of From address for replies, authors of messages\r
75 matching the search listed first for thread, subject of messages\r
76 matching the search listed for the thread, support for Fcc within emacs,\r
77 etc.).\r
78 \r
79 Finally, a long-anticipated general feature was added in 0.3 which is\r
80 the ability to configure which tags get added to new messages by\r
81 default. You can stick with the default "inbox and unread", expand it to\r
82 something like "inbox, unread, and new", trim it down to just "new" or\r
83 do anything else you like. Just run "notmuch setup" for a painless\r
84 introduction. Ben Gamari wrote the actual patch that was included, but\r
85 others such as Anthony Towns had written the nearly identical features.\r
86 \r
87 There are many more, long-anticipated features that will be coming out\r
88 in 0.4. It will be a slightly longer release cycle. Our goal is "a\r
89 little more than two weeks" for this one. That release will include a\r
90 number of changes to the notmuch database schema which will be fairly\r
91 invasive.\r
92 \r
93 Take a look at the release notes below for more details on what's in\r
94 0.3. There are a lot of goodies here.\r
95 \r
96 =2DCarl\r
97 \r
98 =2D-=20\r
99 carl.d.worth@intel.com\r
100 \r
101 \r
102 Where to obtain notmuch 0.3\r
103 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=\r
104 =3D=3D\r
105   http://notmuchmail.org/releases/notmuch-0.3.tar.gz\r
106 \r
107 Which can be verified with:\r
108 \r
109   http://notmuchmail.org/releases/notmuch-0.3.tar.gz.sha1\r
110   d65866323cb76b99fd3004c7f9af7f0e322743b3  notmuch-0.3.tar.gz\r
111 \r
112   http://notmuchmail.org/releases/notmuch-0.3.tar.gz.sha1.asc\r
113   (signed by Carl Worth)\r
114 \r
115 What's new in notmuch 0.3\r
116 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D\r
117 New command-line features\r
118 =2D------------------------\r
119 User-configurable tags for new messages\r
120 \r
121   A new "new.tags" option is available in the configuration file to\r
122   determine which tags are applied to new messages. Run "notmuch\r
123   setup" to generate new documentation within ~/.notmuch-config on how\r
124   to specify this value.\r
125 \r
126 Threads search results named based on subjects that match search\r
127 \r
128   This means that when new mails arrived to a thread you've previously\r
129   read, and the new mails have a new subject, you will see that\r
130   subject in the search results rather than the old subject.\r
131 \r
132 Faster operation of "notmuch tag" (avoid unneeded sorting)\r
133 \r
134   Since the user just wants to tag all matching messages, we can make\r
135   things perform a bit faster by avoiding the sort.\r
136 \r
137 Even Better guessing of From: header for "notmuch reply"\r
138 \r
139   Notmuch now looks at a number of headers when trying to figure out\r
140   the best From: header to use in a reply. This is helpful if you have\r
141   several configured email addresses, and you also subscribe to various\r
142   mailing lists with different addresses, (so that mails you are\r
143   replying to won't always include your subscribed address in the To:\r
144   header).\r
145 \r
146 Indication of author names that match a search\r
147 \r
148   When notmuch displays threads as the result of a search, it now\r
149   lists the authors that match the search before listing the other\r
150   authors in the thread. It inserts a pipe '|' symbol between the last\r
151   matching and first non-matching author. This is especially useful in\r
152   a search that includes tag:unread. Now the authors of the unread\r
153   messages in the thread are listed first.\r
154 \r
155 New: Python bindings\r
156 =2D-------------------\r
157 Sebastian Spaeth has contributed his python bindings for the notmuch\r
158 library to the central repository. These bindings were previously\r
159 known as "cnotmuch" within python but have now been renamed to be\r
160 accessible with a simple, and more official-looking "import notmuch".\r
161 \r
162 The bindings have already proven very useful as people proficient in\r
163 python have been able to easily develop programs to do notmuch-based\r
164 searches for email-address completion, maildir-flag synchronization,\r
165 and other tasks.\r
166 \r
167 These bindings are available within the bindings/python directory, but\r
168 are not yet integrated into the top-level Makefiles, nor the top-level\r
169 package-building scripts. Improvements are welcome.\r
170 \r
171 Emacs interface improvements\r
172 =2D---------------------------\r
173 An entirely new initial view for notmuch, (friendly yet powerful)\r
174 \r
175   Some of us call the new view "notmuch hello" but you can get at it\r
176   by simply calling "emacs -f notmuch". The new view provides a search\r
177   bar where new searches can be performed. It also displays a list of\r
178   recent searches, along with a button to save any of these, giving it\r
179   a new name as a "saved search". Many people find these "saved\r
180   searches" one of the most convenient ways of organizing their mail,\r
181   (providing all of the features of "folders" in other mail clients,\r
182   but without any of the disadvantages).\r
183 \r
184   Finally, this view can also optionally display all of the tags that\r
185   exist in the database, along with a count for each tag, and a custom\r
186   search of messages with that tag that's simply a click (or keypress)\r
187   away.\r
188 \r
189   Note: For users that liked the original mode of "emacs -f notmuch"\r
190         immediately displaying a particular search result, we\r
191         recommend instead running something like:\r
192 \r
193                 emacs --eval '(notmuch search "tag:inbox" t)'\r
194 \r
195         The "t" means to sort the messages in an "oldest first" order,\r
196         (as notmuch would do previously by default). You can also\r
197         leave that off to have your search results in "newest first"\r
198         order.\r
199 \r
200 Full-featured "customize" support for configuring notmuch\r
201 \r
202   Notmuch now plugs in well to the emacs "customize" mode to make it\r
203   much simpler to find things about the notmuch interface that can be\r
204   tweaked by the user.\r
205 \r
206   You can get to this mode by starting at the main "Customize" menu in\r
207   emacs, then browsing through "Applications", "Mail", and\r
208   "Notmuch". Or you can go straight to "M-x customize-group"\r
209   "notmuch".\r
210 \r
211   Once you're at the customize screen, you'll see a list of documented\r
212   options that can be manipulated along with checkboxes, drop-down\r
213   selectors, and text-entry boxes for configuring the various\r
214   settings.\r
215 \r
216 Support for doing tab-completion of email addresses\r
217 \r
218   This support currently relies on an external program,\r
219   (notmuch-addresses), that is not yet shipped with notmuch\r
220   itself. But multiple, suitable implementations of this program have\r
221   already been written that generate address completions by doing\r
222   notmuch searches of your email collection. For example, providing\r
223   first those addresses that you have composed messages to in the\r
224   past, etc.\r
225 \r
226   One such program (implemented in python with the python bindings to\r
227   notmuch) is available via:\r
228 \r
229         git clone  http://jkr.acm.jhu.edu/git/notmuch_addresses.git\r
230 \r
231   Install that program as notmuch-addresses on your PATH, and then\r
232   hitting TAB on a partial email address or name within the To: or Cc:\r
233   line of an email message will provide matching completions.\r
234 \r
235 Support for file-based (Fcc) delivery of sent messages to mail store\r
236 \r
237   This isn't yet enabled by default. To enable this, one will have to\r
238   set the "Notmuch Fcc Dirs" setting within the notmuch customize\r
239   screen, (see its documentation there for details). We anticipate\r
240   making this automatic in a future release.\r
241 \r
242 New 'G' key binding to trigger mail refresh (G =3D=3D "Get new mail")\r
243 \r
244   The 'G' key works wherever '=3D' works. Before refreshing the screen\r
245   it calls an external program that can be used to poll email servers,\r
246   run notmuch new and setup specific tags for the new emails. The\r
247   script to be called should be configured with the "Notmuch Poll\r
248   Script" setting in the customize interface. This script will\r
249   typically invoke "notmuch new" and then perhaps several "notmuch\r
250   tag" commands.\r
251 \r
252 Implement emacs message display with the JSON output from notmuch.\r
253 \r
254   This is much more robust than the previous implementation, (where\r
255   some HTML mails and mail quoting the notmuch code with the delimiter\r
256   characters in it would cause the parser to fall over).\r
257 \r
258 Better handling of HTML messages and MIME attachments (inline images!)\r
259 \r
260   Allow for any MIME parts that emacs can display to be displayed\r
261   inline. This includes inline viewing of image attachments, (provided\r
262   the window is large enough to fit the image at its natural size).\r
263 \r
264   Much more robust handling of HTML messages. Currently both text/plan\r
265   and text/html alternates will be rendered next to each other. In a\r
266   future release, users will be able to decide to see only one or the\r
267   other representation.\r
268 \r
269   Each attachment now has its own button so that attachments can be\r
270   saved individually (the 'w' key is still available to save all\r
271   attachments).\r
272 \r
273 Customizable support for tidying of text/plain message content\r
274 \r
275   Many new functions are available for tidying up message\r
276   content. These include options such as wrapping long lines,\r
277   compressing duplicate blank lines, etc.\r
278 \r
279   Most of these are disabled by default, but can easily be enabled by\r
280   clicking the available check boxes under the "Notmuch Show Insert\r
281   Text/Plain Hook" within the notmuch customize screen.\r
282 \r
283 New support for searchable citations (even when hidden)\r
284 \r
285   When portions of overly-long citations are hidden, the contents of\r
286   these citations will still be available for emacs' standard\r
287   "incremental search" functions. When the search matches any portion\r
288   of a hidden citation, the citation will become visible temporarily\r
289   to display the search result.\r
290 \r
291 More flexible handling of header visibility\r
292 \r
293   As an answer to complaints from many users, the To, Cc, and Date\r
294   headers of messages are no longer hidden by default. For those users\r
295   that liked that these were hidden, a new "Notmuch Messages Headers\r
296   Visible" option in the customize interface can be set to nil. The\r
297   visibility of headers can still be toggled on a per-message basis\r
298   with the 'h' keybinding.\r
299 \r
300   For users that don't want to see some subset of those headers, the\r
301   new "Notmuch Message Headers" variable can be customized to list\r
302   only those headers that should be present in the display of a message.\r
303 \r
304 The Return key now toggles message visibility anywhere\r
305 \r
306   Previously this worked only on the first summary-line of a message.\r
307 \r
308 Customizable formatting of search results\r
309 \r
310   The user can easily customize the order, width, and formatting of\r
311   the various fields in a "notmuch search" buffer. See the "Notmuch\r
312   Search Result Format" section of the customize interface.\r
313 \r
314 Generate nicer names for search buffers when using a saved search.\r
315 \r
316 Add a notmuch User-Agent header when sending mail from notmuch/emacs.\r
317 \r
318 New keybinding (M-Ret) to open all collapsed messages in a thread.\r
319 \r
320 New library feature\r
321 =2D------------------\r
322 Provide a new NOTMUCH_SORT_UNSORTED value for queries\r
323 \r
324   This can be somewhat faster when sorting simply isn't desired. For\r
325   example when collecting a set of messages that will all be\r
326   manipulated identically, (adding a tag, removing a tag, deleting the\r
327   messages), then there's no advantage to sorting the messages by\r
328   date.\r
329 \r
330 Build fixes\r
331 =2D----------\r
332 Fix to compile against GMime 2.6\r
333 \r
334   Previously notmuch insisted on being able to find GMime 2.4, (even\r
335   though GMime 2.6 would have worked all along).\r
336 \r
337 Fix configure script to accept (and ignore) various standard options.\r
338 \r
339   For example, those that the gentoo build scripts expect configure to\r
340   accept are now all accepted.\r
341 \r
342 Test suite\r
343 =2D---------\r
344 A large number of new tests for the many new features.\r
345 \r
346 Better display of output from failed tests.\r
347 \r
348   Now shows failures with diff rather than forcing the user to gaze at\r
349   complete actual and expected output looking for deviation.\r
350 \r
351 What is notmuch\r
352 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D\r
353 Notmuch is a system for indexing, searching, reading, and tagging\r
354 large collections of email messages in maildir or mh format. It uses\r
355 the Xapian library to provide fast, full-text search with a convenient\r
356 search syntax.\r
357 \r
358 For more about notmuch, see http://notmuchmail.org\r
359 \r
360 --=-=-=\r
361 Content-Type: application/pgp-signature\r
362 \r
363 -----BEGIN PGP SIGNATURE-----\r
364 Version: GnuPG v1.4.10 (GNU/Linux)\r
365 \r
366 iD8DBQFL1rEp6JDdNq8qSWgRAj9rAJsHDR7+iM62tzg0GbTI2d+u6f6KkQCfXsnZ\r
367 mLFomty+HmV2cJozA1o6wxg=\r
368 =sxBv\r
369 -----END PGP SIGNATURE-----\r
370 --=-=-=--\r