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