NEWS: news for initial revision tracking support (0.21)

[notmuch] / NEWS

diff --git a/NEWS b/NEWS
index 024359a29e59442ef4ed3d06573bd109eafec4b0..019da55a5d0aff513167ea57a2710082b0d8a312 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,37 @@
 Notmuch 0.21 (UNRELEASED)
 =========================
 
+General
+-------
+
+Notmuch now requires gmime >= 2.6.7. The gmime 2.4 series is no longer
+supported.
+
+Database revision tracking: `lastmod:` queries
+
+  Each message now has a metadata revision number that increases with
+  every tagging operation. See the discussion of `lastmod:` in
+  `notmuch-search-terms(7)` for more information.
+
+Notmuch database upgrade to support `lastmod:` queries
+
+  The above mentioned `lastmod:` prefix. This will be done
+  automatically, without prompting on the next time `notmuch new` is
+  run after the upgrade. The upgrade is not reversible, and the
+  upgraded database will not be readable by older versions of
+  Notmuch. As a safeguard, a database dump will be created in the
+  `.notmuch` directory before upgrading.
+
+Command Line Interface
+----------------------
+
+Database revision tracking
+
+  Two new options were added to support revision tracking. A global
+  option "--uuid" (`notmuch(1)`) was added for to detect counter
+  rollover and reinitialization, and `notmuch-count(1)` gained a
+  `--lastmod` option to query database revision tracking data.
+
 Emacs Interface
 ---------------
 
@@ -21,6 +52,12 @@ Library
 The use of absolute paths is now enforced when calling
 `notmuch_database_{open, create}`.
 
+Database revision tracking
+
+  Revision tracking is supported via a new prefix "lastmod:" in the
+  query parser and the new function
+  `notmuch_database_get_revision`. For the latter, see `notmuch(3)`.
+
 Notmuch 0.20.2 (2015-06-27)
 ===========================