[PATCH 1/8] NEWS: news for initial revision tracking support (0.21)

diff --git a/8b/15fb7abecbde9f6c04ddad4c843b2723420cc7 b/8b/15fb7abecbde9f6c04ddad4c843b2723420cc7
new file mode 100644 (file)
index 0000000..7f0f044
--- /dev/null
+++ b/8b/15fb7abecbde9f6c04ddad4c843b2723420cc7
@@ -0,0 +1,102 @@
+Return-Path: <bremner@tesseract.cs.unb.ca>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+ by arlo.cworth.org (Postfix) with ESMTP id 049566DE19CE\r
+ for <notmuch@notmuchmail.org>; Sat, 17 Oct 2015 13:45:22 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at cworth.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0.108\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0.108 tagged_above=-999 required=5 tests=[AWL=0.098, \r
+ T_HEADER_FROM_DIFFERENT_DOMAINS=0.01] autolearn=disabled\r
+Received: from arlo.cworth.org ([127.0.0.1])\r
+ by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
+ with ESMTP id 4K1Jtw8QzKPw for <notmuch@notmuchmail.org>;\r
+ Sat, 17 Oct 2015 13:45:20 -0700 (PDT)\r
+Received: from gitolite.debian.net (gitolite.debian.net [87.98.215.224])\r
+ by arlo.cworth.org (Postfix) with ESMTPS id 45DF26DE19E8\r
+ for <notmuch@notmuchmail.org>; Sat, 17 Oct 2015 13:45:20 -0700 (PDT)\r
+Received: from remotemail by gitolite.debian.net with local (Exim 4.80)\r
+ (envelope-from <bremner@tesseract.cs.unb.ca>)\r
+ id 1ZnYLG-0006uo-Gc; Sat, 17 Oct 2015 20:44:38 +0000\r
+Received: (nullmailer pid 25679 invoked by uid 1000); Sat, 17 Oct 2015\r
+ 20:43:04 -0000\r
+From: David Bremner <david@tethera.net>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH 1/8] NEWS: news for initial revision tracking support (0.21)\r
+Date: Sat, 17 Oct 2015 17:42:46 -0300\r
+Message-Id: <1445114573-25561-2-git-send-email-david@tethera.net>\r
+X-Mailer: git-send-email 2.5.3\r
+In-Reply-To: <1445114573-25561-1-git-send-email-david@tethera.net>\r
+References: <1445114573-25561-1-git-send-email-david@tethera.net>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.18\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+ <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch/>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sat, 17 Oct 2015 20:45:22 -0000\r
+\r
+---\r
+ NEWS | 31 +++++++++++++++++++++++++++++++\r
+ 1 file changed, 31 insertions(+)\r
+\r
+diff --git a/NEWS b/NEWS\r
+index 3593ded..019da55 100644\r
+--- a/NEWS\r
++++ b/NEWS\r
+@@ -7,6 +7,31 @@ General\r
+ Notmuch now requires gmime >= 2.6.7. The gmime 2.4 series is no longer\r
+ supported.\r
+ \r
++Database revision tracking: `lastmod:` queries\r
++\r
++  Each message now has a metadata revision number that increases with\r
++  every tagging operation. See the discussion of `lastmod:` in\r
++  `notmuch-search-terms(7)` for more information.\r
++\r
++Notmuch database upgrade to support `lastmod:` queries\r
++\r
++  The above mentioned `lastmod:` prefix. This will be done\r
++  automatically, without prompting on the next time `notmuch new` is\r
++  run after the upgrade. The upgrade is not reversible, and the\r
++  upgraded database will not be readable by older versions of\r
++  Notmuch. As a safeguard, a database dump will be created in the\r
++  `.notmuch` directory before upgrading.\r
++\r
++Command Line Interface\r
++----------------------\r
++\r
++Database revision tracking\r
++\r
++  Two new options were added to support revision tracking. A global\r
++  option "--uuid" (`notmuch(1)`) was added for to detect counter\r
++  rollover and reinitialization, and `notmuch-count(1)` gained a\r
++  `--lastmod` option to query database revision tracking data.\r
++\r
+ Emacs Interface\r
+ ---------------\r
+ \r
+@@ -27,6 +52,12 @@ Library\r
+ The use of absolute paths is now enforced when calling\r
+ `notmuch_database_{open, create}`.\r
+ \r
++Database revision tracking\r
++\r
++  Revision tracking is supported via a new prefix "lastmod:" in the\r
++  query parser and the new function\r
++  `notmuch_database_get_revision`. For the latter, see `notmuch(3)`.\r
++\r
+ Notmuch 0.20.2 (2015-06-27)\r
+ ===========================\r
+ \r
+-- \r
+2.5.3\r
+\r