1 [[!meta date="2015-10-29"]]
3 Notmuch 0.21 (2015-10-29)
4 =========================
9 Notmuch now requires gmime >= 2.6.7. The gmime 2.4 series is no longer
12 ### Database revision tracking: `lastmod:` queries
14 Each message now has a metadata revision number that increases with
15 every tagging operation. See the discussion of `lastmod:` in
16 `notmuch-search-terms(7)` for more information.
18 ### Date queries now support `date:<expr>..!` shorthand for `date:<expr>..<expr>`
20 You can use, for example, `date:yesterday..!` to match from the
21 beginning of yesterday to the end of yesterday. For further details,
22 please refer to the `notmuch-search-terms` manual page.
24 ### Notmuch database upgrade to support `lastmod:` queries
26 The above mentioned `lastmod:` prefix. This will be done
27 automatically, without prompting on the next time `notmuch new` is
28 run after the upgrade. The upgrade is not reversible, and the
29 upgraded database will not be readable by older versions of
30 Notmuch. As a safeguard, a database dump will be created in the
31 `.notmuch` directory before upgrading.
36 The ruby bindings are now built as part of the main notmuch build
37 process. This can be disabled with the `--without-ruby` option to
40 Building the documentation can be disabled with the `--without-docs`
43 Skipped individual tests are no longer considered as failures.
45 Command Line Interface
46 ----------------------
48 ### Database revision tracking
50 Two new options were added to support revision tracking. A global
51 option "--uuid" (`notmuch(1)`) was added for to detect counter
52 rollover and reinitialization, and `notmuch-count(1)` gained a
53 `--lastmod` option to query database revision tracking data.
55 ### The `notmuch address` command supports new deduplication schemes
57 `notmuch address` has gained a new `--deduplicate` option to specify
58 how the results should be deduplicated, if at all. The alternatives
59 are `no` (do not deduplicate, useful for processing the results with
60 external tools), `mailbox` (deduplicate based on the full, case
61 sensitive name and email address), and `address` (deduplicate based
62 on the case insensitive address part). See the `notmuch-address`
63 manual page for further information.
68 ### `notmuch-emacs-version` is used in `User-Agent` header
70 The value of recently introduced variable `notmuch-emacs-version` is
71 now used as a part of `User-Agent` header when sending emails.
73 ### Removed `notmuch-version` function by renaming it to `notmuch-cli-version`
75 With existing variable `notmuch-emacs-version` the accompanied
76 function which retrieves the version of `notmuch-command` is
77 better named as `notmuch-cli-version`.
79 ### Query input now supports completion for "is:<tag>"
81 ### New message composition mode: `notmuch-compose-mode`
83 This is mainly to fix fcc handling, but may be useful for user
84 customization as well.
86 ### Allow filtering of search results in `notmuch-show`
88 ### Add function to rerun current tree-view search in search mode
90 ### Bug fix for replying to encrypted messages in `notmuch-tree` mode
92 ### Allow saved searched to specify tree view rather than search view
94 Applies to saved searches run from `notmuch-hello`, or by a keyboard
95 shortcut (`notmuch-jump`). Can be set in the customize interface, or
96 by adding :search-type tree to the appropriate saved search plist in
97 `notmuch-saved-searches`.
99 ### Increase maximum size of rendered text parts
101 The variable `notmuch-show-max-text-part-size` controls the maximum
102 size (in bytes) which is automatically rendered. This may make
103 rendering large threads slower. To get the previous behaviour set
104 this variable to 10000.
109 ### The use of absolute paths is now enforced when calling `notmuch_database_{open, create}`
111 ### New function `notmuch_directory_delete` to delete directory documents
113 Previously there was no way to delete directory documents from the
114 database, leading to confusing results when the "ghost" directory
115 document of a renamed or deleted filesystem directory was
116 encountered every time the parent directory was being scanned by
117 `notmuch new`. The mtime of the old directory document was also used
118 if a directory by the same name was added again in the filesystem,
119 potentially bypassing the scan for the directory. The issues are
120 fixed by providing a library call to delete directory documents, and
121 deleting the old documents in `notmuch new` on filesystem directory
124 ### Database revision tracking
126 Revision tracking is supported via a new prefix "lastmod:" in the
127 query parser and the new function
128 `notmuch_database_get_revision`. For the latter, see `notmuch(3)`.
130 ### New status code returning API for n_query_count_{messages,threads}
132 ### Deprecated functions
134 `notmuch_query_search_threads`, `notmuch_query_search_messages`,
135 `notmuch_query_count_messages`, and `notmuch_query_count_threads`
136 are all deprecated as of this release. Clients are encouraged to
137 transition to the `_st` variants supporting better error reporting.
142 `nmbug-status` now supports specifying the sort order for each view.