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

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

[Jani Nikula]

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

[PATCH] NEWS: mbox files are no longer supported

[Jani Nikula]

---
 NEWS | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/NEWS b/NEWS
index a85af71e7341..d03c9c374d99 100644
--- a/NEWS
+++ b/NEWS
@@ -44,6 +44,13 @@ Notmuch database upgrade
   case, but in practise there have been no database upgrades in any
   released version of Notmuch before now.
 
+Support for indexing mbox files has been dropped
+
+  There has never been proper support for mbox files containing
+  multiple messages, and the support for single-message mbox files has
+  been deprecated since Notmuch 0.15. The support has now been
+  dropped, and all mbox files will be rejected during indexing.
+
 Command-Line Interface
 ----------------------
 
-- 
1.9.2

[PATCH] NEWS: message header parser changes

[Jani Nikula]

---
 NEWS | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/NEWS b/NEWS
index d03c9c374d99..829cf91a102f 100644
--- a/NEWS
+++ b/NEWS
@@ -51,6 +51,15 @@ Support for indexing mbox files has been dropped
   been deprecated since Notmuch 0.15. The support has now been
   dropped, and all mbox files will be rejected during indexing.
 
+Message header parsing changes
+
+  Notmuch previously had an internal parser for message headers. The
+  parser has now been dropped in favour of letting GMime parse both
+  the headers and the message MIME structure at the same pass. This is
+  mostly an internal change, but the GMime parser is stricter in its
+  interpretation of the headers. This may result in messages with
+  slightly malformed message headers being now rejected.
+
 Command-Line Interface
 ----------------------
 
-- 
1.9.2

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

[David Bremner]

Jani Nikula <jani@nikula.org> writes:

> Related news together.

series pushed to release branch

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

[David Edmondson]

On Sun, Apr 27 2014, Jani Nikula wrote:
> +The `folder:` search prefix now requires an exact match

I think that it would be clearer to say:

  The `folder:` search prefix no longer supports wildcard matching

(Or something like that.)

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

[Mark Walters]

I don't like the wildcard bit as an important part of the change was the
removal of stemming. Perhaps keep exact in the headline and in the body
say explicitly what the changes are no stemming, no wildcards (except
globbing), etc (maybe case sensitivity is different?)

Best wishes

Mark



On Thu, 01 May 2014, David Edmondson <dme@dme.org> wrote:
> On Sun, Apr 27 2014, Jani Nikula wrote:
>> +The `folder:` search prefix now requires an exact match
>
> I think that it would be clearer to say:
>
>   The `folder:` search prefix no longer supports wildcard matching
>
> (Or something like that.)
> _______________________________________________
> notmuch mailing list
> notmuch@notmuchmail.org
> http://notmuchmail.org/mailman/listinfo/notmuch

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

[David Edmondson]

[-- Attachment #1: Type: text/plain, Size: 950 bytes --]

On Fri, May 02 2014, Mark Walters wrote:
> I don't like the wildcard bit as an important part of the change was the
> removal of stemming. Perhaps keep exact in the headline and in the body
> say explicitly what the changes are no stemming, no wildcards (except
> globbing), etc (maybe case sensitivity is different?)

I'm not too upset about exactly what it says.

I wonder how many users care about "the removal of stemming" as opposed
to "wildcards no longer work", though :-)

> On Thu, 01 May 2014, David Edmondson <dme@dme.org> wrote:
>> On Sun, Apr 27 2014, Jani Nikula wrote:
>>> +The `folder:` search prefix now requires an exact match
>>
>> I think that it would be clearer to say:
>>
>>   The `folder:` search prefix no longer supports wildcard matching
>>
>> (Or something like that.)
>> _______________________________________________
>> notmuch mailing list
>> notmuch@notmuchmail.org
>> http://notmuchmail.org/mailman/listinfo/notmuch

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 310 bytes --]

[PATCH] NEWS: make it explicit that wildcard matching is no longer supported

[Jani Nikula]

Wildcard matching was a feature of the probabilistic prefix, and we no
longer have it for the boolean prefix. Also note that top-level folder
can now be searched.
---
 NEWS | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/NEWS b/NEWS
index 75dba6f963b0..f10c280be328 100644
--- a/NEWS
+++ b/NEWS
@@ -21,12 +21,13 @@ 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.
+  by the exact, case sensitive maildir or MH folder name. Wildcard
+  matching (`folder:foo*`) is no longer supported. The new behaviour
+  allows for more accurate mail folder based searches, makes it
+  possible to search for messages in the top-level folder, 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.
 
-- 
1.9.2

Re: [PATCH] NEWS: make it explicit that wildcard matching is no longer supported

[David Edmondson]

[-- Attachment #1: Type: text/plain, Size: 24 bytes --]

Good for me, thank you.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 310 bytes --]

Re: [PATCH] NEWS: make it explicit that wildcard matching is no longer supported

[David Bremner]

Jani Nikula <jani@nikula.org> writes:

> Wildcard matching was a feature of the probabilistic prefix, and we no
> longer have it for the boolean prefix. Also note that top-level folder
> can now be searched.

pushed to release.

d