X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=NEWS;h=f1d549996abc689a39cf235424bd8d6602af7cd3;hb=320f86c30a51017c2afd1b5ac02aaf2cb0affcd7;hp=d4f4ea4e898887799d82eaf2fb412636b869bf00;hpb=7102b8c7827fdb89ae4dba9b498b77e2a28e23da;p=notmuch

diff --git a/NEWS b/NEWS
index d4f4ea4e..f1d54999 100644
--- a/NEWS
+++ b/NEWS
@@ -15,7 +15,30 @@ Command-Line Interface
 Emacs Interface
 ---------------
 
-Bug fix for saved searches with newlines in them.
+Changed format for saved searches
+
+  The format for `notmuch-saved-searches` has changed, but old style
+  saved searches are still supported. The new style means that a saved
+  search can store the desired sort order for the search, and it can
+  store a separate query to use for generating the count notmuch
+  shows.
+
+  The variable is fully customizable and any configuration done
+  through customize should *just work*, with the additional options
+  mentioned above. For manual customization see the documentation for
+  `notmuch-saved-searches`.
+
+  IMPORTANT: a new style notmuch-saved-searches variable will break
+  previous versions of notmuch-emacs (even search will not work); to
+  fix remove the customization for notmuch-saved-searches.
+
+  If you have a custom saved search sort function (not unsorted or
+  alphabetical) then the sort function will need to be
+  modified. Replacing (car saved-search) by (notmuch-saved-search-get
+  saved-search :name) and (cdr saved-search) by
+  (notmuch-saved-search-get saved-search :query) should be sufficient.
+
+Bug fix for saved searches with newlines in them
 
   Split lines confuse `notmuch count --batch`, so we remove embedded
   newlines before calling notmuch count.