Return-Path: <jani@nikula.org>
X-Original-To: notmuch@notmuchmail.org
Delivered-To: notmuch@notmuchmail.org
Received: from localhost (localhost [127.0.0.1])
	by olra.theworths.org (Postfix) with ESMTP id 75E8E431FBD
	for <notmuch@notmuchmail.org>; Sun, 27 Apr 2014 07:46:27 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
X-Spam-Flag: NO
X-Spam-Score: -0.7
X-Spam-Level: 
X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5
	tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled
Received: from olra.theworths.org ([127.0.0.1])
	by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id b1zZVB9DpdoC for <notmuch@notmuchmail.org>;
	Sun, 27 Apr 2014 07:46:23 -0700 (PDT)
Received: from mail-ee0-f45.google.com (mail-ee0-f45.google.com
 [74.125.83.45])	(using TLSv1 with cipher RC4-SHA (128/128 bits))	(No client
 certificate requested)	by olra.theworths.org (Postfix) with ESMTPS id
 D8951431FBC	for <notmuch@notmuchmail.org>; Sun, 27 Apr 2014 07:46:22 -0700
 (PDT)
Received: by mail-ee0-f45.google.com with SMTP id d17so4090305eek.32
	for <notmuch@notmuchmail.org>; Sun, 27 Apr 2014 07:46:21 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20130820;
	h=x-gm-message-state:from:to:cc:subject:date:message-id;
	bh=/Qir+/2BZnWSi83FZ1GkH7vuwkKAHbQpOch6Dp577q8=;
	b=J/ur3CIAtP8Z2oWvBn7sZBsBlMiizHZHHAamIfo3tzXwJCwJR+DUScn+wVJJ/jhWyU
	an1BBBEayZuvmfP8Rgi02Gzljhksmf6yZnrRNLZxjQsMGuKmBCIiuKG3MA/5JJ14nVU7
	LWwKjlfr5GlsEybvM5SwkUHuqOfV2NbdS8yWpPkZPoJ3Y5v4zFNRkKNYZ2Qiz6J4MFBL
	X4hy/6MJp2pVIOAVHCGo8UrIUZfgDOJEd1dEBb6jDriveypvGhpKkmvLqB+eMyEg0eM4
	J2G1fvqLh3y55h2gfFwm/z/k0LAn33XaQyTW6+mdAkjDlAEMVKxthj4/bhPeE0AqHbtb
	ojbw==
X-Gm-Message-State:
 ALoCoQkW3QORiahIH0IdURWDwgyzI0S+DxHeMgChnOF/Fy4nlAef9Txj3xOFDxFW2i5hwTKORaXV
X-Received: by 10.14.246.196 with SMTP id q44mr25939361eer.45.1398609980369;
	Sun, 27 Apr 2014 07:46:20 -0700 (PDT)
Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.
	[88.195.111.91]) by mx.google.com with ESMTPSA id
	t50sm42194224eev.28.2014.04.27.07.46.18 for <multiple recipients>
	(version=TLSv1.2 cipher=RC4-SHA bits=128/128);
	Sun, 27 Apr 2014 07:46:19 -0700 (PDT)
From: Jani Nikula <jani@nikula.org>
To: notmuch@notmuchmail.org
Subject: [PATCH] NEWS: folder:, path:, and database upgrade
Date: Sun, 27 Apr 2014 17:46:17 +0300
Message-Id: <1398609977-9943-1-git-send-email-jani@nikula.org>
X-Mailer: git-send-email 1.9.2
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: "Use and development of the notmuch mail system."
	<notmuch.notmuchmail.org>
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Sun, 27 Apr 2014 14:46:27 -0000

Related news together.
---
 NEWS | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/NEWS b/NEWS
index bcd311d4b11b..7cdcb4b3871e 100644
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,49 @@
 Notmuch 0.18~rc0 (2014-04-22)
 =============================
 
+General
+-------
+
+The `folder:` search prefix now requires an exact match
+
+  The `folder:` prefix has been changed to search for email messages
+  by the exact, case sensitive maildir or MH folder name. The new
+  behaviour allows for more accurate mail folder based searches, and
+  should lead to less surprising results than the old behaviour. Users
+  are advised to see the `notmuch-search-terms` manual page for
+  details, and review how the change affects their existing `folder:`
+  searches.
+
+There is a new `path:` search prefix.
+
+  The new `path:` search prefix complements the `folder:` prefix. The
+  `path:` prefix searches for email messages that are in particular
+  directories within the mail store, optionally recursively using a
+  special syntax. See the `notmuch-search-terms` manual page for
+  details.
+
+Notmuch database upgrade due to `folder:` and `path:` changes
+
+  The above mentioned changes to the `folder:` prefix and the addition
+  of `path:` prefix require a Notmuch database upgrade. 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.
+
+Library changes
+---------------
+
+Notmuch database upgrade
+
+  The libnotmuch consumers are reminded to handle database upgrades
+  properly, either by relying on running `notmuch new`, or checking
+  `notmuch_database_needs_upgrade()` and calling
+  `notmuch_database_upgrade()` as necessary. This has always been the
+  case, but in practise there have been no database upgrades in any
+  released version of Notmuch before now.
+
 Command-Line Interface
 ----------------------
 
-- 
1.9.2