Re: [PATCH v4 13/16] add indexopts to notmuch python bindings.
[notmuch-archives.git] / 4b / 17d70b4f8627aa35e0135d72244e2bd316f137
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 26606431FDB\r
6         for <notmuch@notmuchmail.org>; Thu, 26 Apr 2012 12:52:42 -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: 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 bb8AoXN9OB26 for <notmuch@notmuchmail.org>;\r
16         Thu, 26 Apr 2012 12:52:39 -0700 (PDT)\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 93AC7431FB6\r
19         for <notmuch@notmuchmail.org>; Thu, 26 Apr 2012 12:52:38 -0700 (PDT)\r
20 Received: by guru.guru-group.fi (Postfix, from userid 501)\r
21         id AD41768056; Thu, 26 Apr 2012 22:52:34 +0300 (EEST)\r
22 From: Tomi Ollila <tomi.ollila@iki.fi>\r
23 To: notmuch@notmuchmail.org\r
24 Subject: [PATCH 2/3] NEWS: spacing changes\r
25 Date: Thu, 26 Apr 2012 22:52:30 +0300\r
26 Message-Id: <1335469951-22477-2-git-send-email-tomi.ollila@iki.fi>\r
27 X-Mailer: git-send-email 1.7.6.1\r
28 In-Reply-To: <1335469951-22477-1-git-send-email-tomi.ollila@iki.fi>\r
29 References: <1335469951-22477-1-git-send-email-tomi.ollila@iki.fi>\r
30 Cc: Tomi Ollila <tomi.ollila@iki.fi>\r
31 X-BeenThere: notmuch@notmuchmail.org\r
32 X-Mailman-Version: 2.1.13\r
33 Precedence: list\r
34 List-Id: "Use and development of the notmuch mail system."\r
35         <notmuch.notmuchmail.org>\r
36 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
37         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
38 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
39 List-Post: <mailto:notmuch@notmuchmail.org>\r
40 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
41 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
42         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
43 X-List-Received-Date: Thu, 26 Apr 2012 19:52:42 -0000\r
44 \r
45 With these whitespace changes the spacing looks generally\r
46 the same throughout the whole file.\r
47 ---\r
48  NEWS |  123 ++++++++++++++++++++++++++++++++++++++++++++++--------------------\r
49  1 files changed, 86 insertions(+), 37 deletions(-)\r
50 \r
51 diff --git a/NEWS b/NEWS\r
52 index a00f1c8..fe4c3f0 100644\r
53 --- a/NEWS\r
54 +++ b/NEWS\r
55 @@ -129,11 +129,11 @@ More flexible and consistent tagging operations\r
56    argument, `notmuch-show-tag-message' should be used instead.  Custom\r
57    bindings using these functions should be updated, e.g.:\r
58  \r
59 -    (notmuch-show-remove-tag "unread")\r
60 +        (notmuch-show-remove-tag "unread")\r
61  \r
62    should be changed to:\r
63  \r
64 -    (notmuch-show-tag-message "-unread")\r
65 +        (notmuch-show-tag-message "-unread")\r
66  \r
67  Refreshing the show view ('=' by default) no longer opens or closes messages\r
68  \r
69 @@ -342,7 +342,7 @@ New function notmuch-show-advance\r
70    less invasive than notmuch-show-advance-and-archive.  It can easily\r
71    be bound to SPC with:\r
72  \r
73 -  (define-key notmuch-show-mode-map " " 'notmuch-show-advance)\r
74 +        (define-key notmuch-show-mode-map " " 'notmuch-show-advance)\r
75  \r
76  Various performance improvements.\r
77  \r
78 @@ -606,8 +606,10 @@ Re-export Xapian exception typeinfo symbols.\r
79  \r
80  Notmuch 0.6 (2011-07-01)\r
81  =======================\r
82 +\r
83  New, general features\r
84  ---------------------\r
85 +\r
86  Folder-based searching\r
87  \r
88    Notmuch queries can now include a search term to match the\r
89 @@ -656,6 +658,7 @@ New, automatic tags: "signed" and "encrypted"\r
90  \r
91  New command-line features\r
92  -------------------------\r
93 +\r
94  Add new "notmuch show --verify" option for signature verification\r
95  \r
96    This option instruct notmuch to verify the signature of\r
97 @@ -693,6 +696,7 @@ Deprecate "notmuch search-tags", (in favor of "notmuch search --output=tags *")\r
98  \r
99  Performance improvements\r
100  ------------------------\r
101 +\r
102  Faster searches (by doing fewer searches to construct threads)\r
103  \r
104    Whenever a user asks for search results as threads, notmuch first\r
105 @@ -816,6 +820,7 @@ and drop "name" if it's actually just a repeat of the email address).\r
106  \r
107  Vim interface improvements\r
108  --------------------------\r
109 +\r
110  Felipe Contreras provided a number of updates for the vim interface:\r
111  \r
112    * Using sendmail directly rather than mailx,\r
113 @@ -826,38 +831,45 @@ Felipe Contreras provided a number of updates for the vim interface:\r
114  \r
115  Bindings improvements\r
116  ---------------------\r
117 +\r
118  Ruby bindings are now much more complete\r
119  \r
120    Including QUERY.sort, QUERY.to_s, MESSAGE.maildir_flags_to_tags,\r
121    MESSAGE.tags_to_maildir_flags, and MESSAGE.get_filenames\r
122  \r
123  * Python bindings have been updated and extended\r
124 +\r
125    (docs online at http://packages.python.org/notmuch/)\r
126  \r
127    New bindings:\r
128 -  - Message().get_filenames(),\r
129 -  - Message().tags_to_maildir_flags(),Message().maildir_flags_to_tags()\r
130 -  - list(Threads()) and list(Messages) works now\r
131  \r
132 +  - Message().get_filenames(), Message().tags_to_maildir_flags(),\r
133 +    Message().maildir_flags_to_tags(), list(Threads()) and\r
134 +    list(Messages) works now\r
135    - Message().__cmp__() and __hash__()\r
136 +\r
137    These allow, for example:\r
138 +\r
139          if msg1 == msg2: ...\r
140  \r
141    As well as set arithmetic on Messages():\r
142  \r
143 -        s1, s2= set(msgs1), set(msgs2)\r
144 +        s1, s2 = set(msgs1), set(msgs2)\r
145          s1.union(s2)\r
146          s2 -= s1\r
147  \r
148    Removed:\r
149 -     - len(Messages()) as it exhausted the iterator.\r
150 -       Use len(list(Messages())) or\r
151 -       Query.count_messages() to get the length.\r
152 +\r
153 +  - len(Messages()) as it exhausted the iterator\r
154 +\r
155 +  Use len(list(Messages())) or Query.count_messages()\r
156 +  to get the length.\r
157  \r
158  Added initial Go bindings in bindings/go\r
159  \r
160  New build-system features\r
161  -------------------------\r
162 +\r
163  Added support for building in a directory other than the source directory\r
164  \r
165    This can be used with the widely-supported idiom of simply running\r
166 @@ -878,7 +890,8 @@ Fix to save configure options for future, implicit runs of configure\r
167  \r
168  New test-suite feature\r
169  ----------------------\r
170 -Binary for bash for running test suite now located via PATH.\r
171 +\r
172 +Binary for bash for running test suite now located via PATH\r
173  \r
174    The notmuch test suite requires a fairly recent version of bash (>=\r
175    bash 4). As some systems supply an older version of bash at\r
176 @@ -906,6 +919,7 @@ Avoiding accessing user's $HOME while running test suite\r
177  \r
178  General bug fixes\r
179  -----------------\r
180 +\r
181  Output *all* files for "notmuch search --output=files"\r
182  \r
183    For the cases where multiple files have the same Message ID,\r
184 @@ -947,6 +961,7 @@ Fix libnotmuch library to only export notmuch API functions\r
185  \r
186  Emacs-interface bug fixes\r
187  -------------------------\r
188 +\r
189  Display any unexpected output or errors from "notmuch search" invocations\r
190  \r
191    Previously any misformatted output or trailing error messages were\r
192 @@ -974,8 +989,10 @@ Fix hiding of a message when a previously-hidden citation is visible\r
193  \r
194  Notmuch 0.5 (2010-11-11)\r
195  ========================\r
196 +\r
197  New, general features\r
198  ---------------------\r
199 +\r
200  Maildir-flag synchronization\r
201  \r
202    Notmuch now knows how to synchronize flags in maildir filenames with\r
203 @@ -1019,6 +1036,7 @@ Maildir-flag synchronization\r
204  \r
205  New library features\r
206  --------------------\r
207 +\r
208  Support for querying multiple filenames for a single message\r
209  \r
210    It is common for the mailstore to contain multiple files with the\r
211 @@ -1037,6 +1055,7 @@ Support for querying multiple filenames for a single message\r
212  \r
213  New command-line features\r
214  -------------------------\r
215 +\r
216  New "notmuch show --format=raw" for getting at original email contents\r
217  \r
218    This new feature allows for a fully-functional email client to be\r
219 @@ -1056,6 +1075,7 @@ New "notmuch show --format=raw" for getting at original email contents\r
220  \r
221  General bug fixes\r
222  -----------------\r
223 +\r
224  Fix "notmuch search" to print nothing when nothing matches\r
225  \r
226    The 0.4 release had a bug in which:\r
227 @@ -1069,6 +1089,7 @@ Fix "notmuch search" to print nothing when nothing matches\r
228  \r
229  Emacs interface improvements\r
230  ----------------------------\r
231 +\r
232  Fix to allow pipe ('|') command to work when using notmuch over ssh\r
233  \r
234  Fix count of lines in hidden signatures.\r
235 @@ -1091,7 +1112,8 @@ Allow for notmuch-fcc-dirs to have a value of nil.\r
236  \r
237  Vim interface improvements\r
238  --------------------------\r
239 -Felipe Contreras provided a number of updates for the vim interface.\r
240 +\r
241 +Felipe Contreras provided a number of updates for the vim interface\r
242  \r
243    These include optimizations, support for newer versions of vim, fixed\r
244    support for sending mail on modern systems, new commands, and\r
245 @@ -1099,12 +1121,15 @@ Felipe Contreras provided a number of updates for the vim interface.\r
246  \r
247  New bindings\r
248  ------------\r
249 +\r
250  Added initial ruby bindings in bindings/ruby\r
251  \r
252  Notmuch 0.4 (2010-11-01)\r
253  ========================\r
254 +\r
255  New command-line features\r
256  -------------------------\r
257 +\r
258  notmuch search --output=(summary|threads|messages|tags|files)\r
259  \r
260    This new option allows for particular items to be returned from\r
261 @@ -1145,6 +1170,7 @@ Avoid setting Bcc header in "notmuch reply"\r
262  \r
263  New library features\r
264  --------------------\r
265 +\r
266  Add notmuch_query_get_query_string and notmuch_query_get_sort\r
267  \r
268    These are simply functions for querying properties of a\r
269 @@ -1152,6 +1178,7 @@ Add notmuch_query_get_query_string and notmuch_query_get_sort\r
270  \r
271  New emacs features\r
272  ------------------\r
273 +\r
274  Enable Fcc of all sent messages by default (to "sent" directory)\r
275  \r
276    All messages sent from the emacs interface will now be saved to the\r
277 @@ -1221,13 +1248,13 @@ Arrange for libnotmuch to be found automatically after make install\r
278    errors of the form "libnotmuch.so could not be found" immediately\r
279    after installing. This support takes two forms:\r
280  \r
281 -        1. If the library is installed to a system directory,\r
282 -           (configured in /etc/ld.so.conf), then "make install" will\r
283 -           automatically run ldconfig.\r
284 +  1. If the library is installed to a system directory,\r
285 +     (configured in /etc/ld.so.conf), then "make install" will\r
286 +     automatically run ldconfig.\r
287  \r
288 -        2. If the library is installed to a non-system directory, the\r
289 -           build system adds a DR_RUNPATH entry to the final binary\r
290 -           pointing to the directory to which the library is installed.\r
291 +  2. If the library is installed to a non-system directory, the\r
292 +     build system adds a DR_RUNPATH entry to the final binary\r
293 +     pointing to the directory to which the library is installed.\r
294  \r
295    When this support works, the user should be able to run notmuch\r
296    immediately after "make install", without any errors trying to find\r
297 @@ -1243,7 +1270,8 @@ Check compiler/linker options before using them\r
298  \r
299  New test-suite features\r
300  -----------------------\r
301 -New modularization of test suite.\r
302 +\r
303 +New modularization of test suite\r
304  \r
305    Thanks to a gracious relicensing of the test-suite infrastructure\r
306    from the git project, notmuch now has a modular test suite. This\r
307 @@ -1265,7 +1293,8 @@ New testing of emacs interface.\r
308  \r
309  General bug fixes\r
310  -----------------\r
311 -Fix potential corruption of database when "notmuch new " is interrupted.\r
312 +\r
313 +Fix potential corruption of database when "notmuch new" is interrupted\r
314  \r
315    Previously, an interruption of "notmuch new" would (rarely) result\r
316    in a corrupt database. The corruption would manifest itself by a\r
317 @@ -1298,6 +1327,7 @@ Fix "notmuch search" to return non-zero if notmuch_query_search_threads fails\r
318  \r
319  Emacs bug fixes\r
320  ---------------\r
321 +\r
322  Fix to handle a message with a subject containing, for example "[1234]"\r
323  \r
324    Previously, a message subject containing a sequence of digits within\r
325 @@ -1314,11 +1344,13 @@ Fix to correctly handle message IDs containing ".."\r
326  \r
327  Python-binding fixes\r
328  --------------------\r
329 +\r
330  The python bindings for notmuch have been updated to work with python3.\r
331  \r
332  Debian-specific fixes\r
333  ---------------------\r
334 -Fix emacs initialization so "M-x notmuch" works for users by default.\r
335 +\r
336 +Fix emacs initialization so "M-x notmuch" works for users by default\r
337  \r
338    Now, a new Debian user can immediately run "emacs -f notmuch" after\r
339    "apt-get install notmuch". Previously, the user would have had to\r
340 @@ -1327,8 +1359,10 @@ Fix emacs initialization so "M-x notmuch" works for users by default.\r
341  \r
342  Notmuch 0.3.1 (2010-04-27)\r
343  ==========================\r
344 +\r
345  General bug fixes\r
346  -----------------\r
347 +\r
348  Fix an infinite loop in "notmuch reply"\r
349  \r
350    This bug could be triggered by replying to a message where the\r
351 @@ -1344,22 +1378,26 @@ Fix a potential SEGV in "notmuch search"\r
352  \r
353  Emacs bug fixes\r
354  ---------------\r
355 -Fix calculations for line wrapping in the primary "notmuch" view.\r
356 +\r
357 +Fix calculations for line wrapping in the primary "notmuch" view\r
358  \r
359  Fix Fcc support to prompt to create a directory if the specified Fcc\r
360  directory does not exist.\r
361  \r
362  Build fix\r
363  ---------\r
364 -Fix build on OpenSolaris (at least) due to missing 'extern "C"' block.\r
365 +\r
366 +Fix build on OpenSolaris (at least) due to missing 'extern "C"' block\r
367  \r
368    Without this, the C++ sources could not find strcasestr and the\r
369    final linking of notmuch would fail.\r
370  \r
371  Notmuch 0.3 (2010-04-27)\r
372  ========================\r
373 +\r
374  New command-line features\r
375  -------------------------\r
376 +\r
377  User-configurable tags for new messages\r
378  \r
379    A new "new.tags" option is available in the configuration file to\r
380 @@ -1398,6 +1436,7 @@ Indication of author names that match a search\r
381  \r
382  New: Python bindings\r
383  --------------------\r
384 +\r
385  Sebastian Spaeth has contributed his python bindings for the notmuch\r
386  library to the central repository. These bindings were previously\r
387  known as "cnotmuch" within python but have now been renamed to be\r
388 @@ -1414,6 +1453,7 @@ package-building scripts. Improvements are welcome.\r
389  \r
390  Emacs interface improvements\r
391  ----------------------------\r
392 +\r
393  An entirely new initial view for notmuch, (friendly yet powerful)\r
394  \r
395    Some of us call the new view "notmuch hello" but you can get at it\r
396 @@ -1430,16 +1470,16 @@ An entirely new initial view for notmuch, (friendly yet powerful)\r
397    search of messages with that tag that's simply a click (or keypress)\r
398    away.\r
399  \r
400 -  Note: For users that liked the original mode of "emacs -f notmuch"\r
401 -        immediately displaying a particular search result, we\r
402 -        recommend instead running something like:\r
403 +  NOTE: For users that liked the original mode of "emacs -f notmuch"\r
404 +  immediately displaying a particular search result, we recommend\r
405 +  instead running something like:\r
406  \r
407 -                emacs --eval '(notmuch search "tag:inbox" t)'\r
408 +        emacs --eval '(notmuch search "tag:inbox" t)'\r
409  \r
410 -        The "t" means to sort the messages in an "oldest first" order,\r
411 -        (as notmuch would do previously by default). You can also\r
412 -        leave that off to have your search results in "newest first"\r
413 -        order.\r
414 +  The "t" means to sort the messages in an "oldest first" order,\r
415 +  (as notmuch would do previously by default). You can also\r
416 +  leave that off to have your search results in "newest first"\r
417 +  order.\r
418  \r
419  Full-featured "customize" support for configuring notmuch\r
420  \r
421 @@ -1563,6 +1603,7 @@ New keybinding (M-Ret) to open all collapsed messages in a thread.\r
422  \r
423  New library feature\r
424  -------------------\r
425 +\r
426  Provide a new NOTMUCH_SORT_UNSORTED value for queries\r
427  \r
428    This can be somewhat faster when sorting simply isn't desired. For\r
429 @@ -1573,6 +1614,7 @@ Provide a new NOTMUCH_SORT_UNSORTED value for queries\r
430  \r
431  Build fixes\r
432  -----------\r
433 +\r
434  Fix to compile against GMime 2.6\r
435  \r
436    Previously notmuch insisted on being able to find GMime 2.4, (even\r
437 @@ -1585,15 +1627,17 @@ Fix configure script to accept (and ignore) various standard options.\r
438  \r
439  Test suite\r
440  ----------\r
441 -A large number of new tests for the many new features.\r
442  \r
443 -Better display of output from failed tests.\r
444 +A large number of new tests for the many new features\r
445 +\r
446 +Better display of output from failed tests\r
447  \r
448    Now shows failures with diff rather than forcing the user to gaze at\r
449    complete actual and expected output looking for deviation.\r
450  \r
451  Notmuch 0.2 (2010-04-16)\r
452  ========================\r
453 +\r
454  This is the second release of the notmuch mail system, with actual\r
455  detailed release notes this time!\r
456  \r
457 @@ -1609,7 +1653,8 @@ notmuch in subsequent releases.\r
458  \r
459  General features\r
460  ----------------\r
461 -Better guessing of From: header.\r
462 +\r
463 +Better guessing of From: header\r
464  \r
465    Notmuch now tries harder to guess which configured address should be\r
466    used as the From: line in a "notmuch reply". It will examine the\r
467 @@ -1642,6 +1687,7 @@ missing.\r
468  \r
469  General bug fixes\r
470  -----------------\r
471 +\r
472  Fix potential data loss in "notmuch new" with SIGINT\r
473  \r
474    One code path in "notmuch new" was not properly handling\r
475 @@ -1674,7 +1720,8 @@ Fix headers to be properly decoded in "notmuch reply"\r
476  \r
477  Emacs client features\r
478  ---------------------\r
479 -Show the last few lines of citations as well as the first few lines.\r
480 +\r
481 +Show the last few lines of citations as well as the first few lines\r
482  \r
483    It's often the case that the last sentence of a citation is what is\r
484    being replied to directly, so the last few lines are often much more\r
485 @@ -1704,9 +1751,10 @@ Provide for customized colors of threads in search view based on tags.\r
486  \r
487  Build-system features\r
488  ---------------------\r
489 -Add support to properly build libnotmuch on Darwin systems (OS X).\r
490  \r
491 -Add support to configure for many standard options.\r
492 +Add support to properly build libnotmuch on Darwin systems (OS X)\r
493 +\r
494 +Add support to configure for many standard options\r
495  \r
496    We include actual support for:\r
497  \r
498 @@ -1731,6 +1779,7 @@ its results.\r
499  \r
500  Notmuch 0.1 (2010-04-05)\r
501  ========================\r
502 +\r
503  This is the first release of the notmuch mail system.\r
504  \r
505  It includes the libnotmuch library, the notmuch command-line\r
506 -- \r
507 1.7.7.6\r
508 \r