[PATCH] NEWS: folder:, path:, and database upgrade

diff --git a/fa/4a5e56a89b13ed6c2744542b3805da1763c88f b/fa/4a5e56a89b13ed6c2744542b3805da1763c88f
new file mode 100644 (file)
index 0000000..acafefb
--- /dev/null
+++ b/fa/4a5e56a89b13ed6c2744542b3805da1763c88f
@@ -0,0 +1,124 @@
+Return-Path: <jani@nikula.org>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 75E8E431FBD\r
+       for <notmuch@notmuchmail.org>; Sun, 27 Apr 2014 07:46:27 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id b1zZVB9DpdoC for <notmuch@notmuchmail.org>;\r
+       Sun, 27 Apr 2014 07:46:23 -0700 (PDT)\r
+Received: from mail-ee0-f45.google.com (mail-ee0-f45.google.com\r
+ [74.125.83.45])       (using TLSv1 with cipher RC4-SHA (128/128 bits))        (No client\r
+ certificate requested)        by olra.theworths.org (Postfix) with ESMTPS id\r
+ D8951431FBC   for <notmuch@notmuchmail.org>; Sun, 27 Apr 2014 07:46:22 -0700\r
+ (PDT)\r
+Received: by mail-ee0-f45.google.com with SMTP id d17so4090305eek.32\r
+       for <notmuch@notmuchmail.org>; Sun, 27 Apr 2014 07:46:21 -0700 (PDT)\r
+X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
+       d=1e100.net; s=20130820;\r
+       h=x-gm-message-state:from:to:cc:subject:date:message-id;\r
+       bh=/Qir+/2BZnWSi83FZ1GkH7vuwkKAHbQpOch6Dp577q8=;\r
+       b=J/ur3CIAtP8Z2oWvBn7sZBsBlMiizHZHHAamIfo3tzXwJCwJR+DUScn+wVJJ/jhWyU\r
+       an1BBBEayZuvmfP8Rgi02Gzljhksmf6yZnrRNLZxjQsMGuKmBCIiuKG3MA/5JJ14nVU7\r
+       LWwKjlfr5GlsEybvM5SwkUHuqOfV2NbdS8yWpPkZPoJ3Y5v4zFNRkKNYZ2Qiz6J4MFBL\r
+       X4hy/6MJp2pVIOAVHCGo8UrIUZfgDOJEd1dEBb6jDriveypvGhpKkmvLqB+eMyEg0eM4\r
+       J2G1fvqLh3y55h2gfFwm/z/k0LAn33XaQyTW6+mdAkjDlAEMVKxthj4/bhPeE0AqHbtb\r
+       ojbw==\r
+X-Gm-Message-State:\r
+ ALoCoQkW3QORiahIH0IdURWDwgyzI0S+DxHeMgChnOF/Fy4nlAef9Txj3xOFDxFW2i5hwTKORaXV\r
+X-Received: by 10.14.246.196 with SMTP id q44mr25939361eer.45.1398609980369;\r
+       Sun, 27 Apr 2014 07:46:20 -0700 (PDT)\r
+Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.\r
+       [88.195.111.91]) by mx.google.com with ESMTPSA id\r
+       t50sm42194224eev.28.2014.04.27.07.46.18 for <multiple recipients>\r
+       (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
+       Sun, 27 Apr 2014 07:46:19 -0700 (PDT)\r
+From: Jani Nikula <jani@nikula.org>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH] NEWS: folder:, path:, and database upgrade\r
+Date: Sun, 27 Apr 2014 17:46:17 +0300\r
+Message-Id: <1398609977-9943-1-git-send-email-jani@nikula.org>\r
+X-Mailer: git-send-email 1.9.2\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\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: Sun, 27 Apr 2014 14:46:27 -0000\r
+\r
+Related news together.\r
+---\r
+ NEWS | 43 +++++++++++++++++++++++++++++++++++++++++++\r
+ 1 file changed, 43 insertions(+)\r
+\r
+diff --git a/NEWS b/NEWS\r
+index bcd311d4b11b..7cdcb4b3871e 100644\r
+--- a/NEWS\r
++++ b/NEWS\r
+@@ -1,6 +1,49 @@\r
+ Notmuch 0.18~rc0 (2014-04-22)\r
+ =============================\r
+ \r
++General\r
++-------\r
++\r
++The `folder:` search prefix now requires an exact match\r
++\r
++  The `folder:` prefix has been changed to search for email messages\r
++  by the exact, case sensitive maildir or MH folder name. The new\r
++  behaviour allows for more accurate mail folder based searches, and\r
++  should lead to less surprising results than the old behaviour. Users\r
++  are advised to see the `notmuch-search-terms` manual page for\r
++  details, and review how the change affects their existing `folder:`\r
++  searches.\r
++\r
++There is a new `path:` search prefix.\r
++\r
++  The new `path:` search prefix complements the `folder:` prefix. The\r
++  `path:` prefix searches for email messages that are in particular\r
++  directories within the mail store, optionally recursively using a\r
++  special syntax. See the `notmuch-search-terms` manual page for\r
++  details.\r
++\r
++Notmuch database upgrade due to `folder:` and `path:` changes\r
++\r
++  The above mentioned changes to the `folder:` prefix and the addition\r
++  of `path:` prefix require a Notmuch database upgrade. This will be\r
++  done automatically, without prompting on the next time `notmuch new`\r
++  is 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
++Library changes\r
++---------------\r
++\r
++Notmuch database upgrade\r
++\r
++  The libnotmuch consumers are reminded to handle database upgrades\r
++  properly, either by relying on running `notmuch new`, or checking\r
++  `notmuch_database_needs_upgrade()` and calling\r
++  `notmuch_database_upgrade()` as necessary. This has always been the\r
++  case, but in practise there have been no database upgrades in any\r
++  released version of Notmuch before now.\r
++\r
+ Command-Line Interface\r
+ ----------------------\r
+ \r
+-- \r
+1.9.2\r
+\r