[PATCH] NEWS: user visible config related changes for 0.32

Subject: [PATCH] NEWS: user visible config related changes for 0.32

Date: Sat, 10 Apr 2021 09:52:07 -0300

To: David Bremner, notmuch@notmuchmail.org

Cc: Floris Bruynooghe, Jonas Bernoulli

From: David Bremner


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

diff --git a/NEWS b/NEWS
index 6e88ebd9..a699b48e 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,44 @@
+Notmuch 0.32 (UNRELEASED)
+=========================
+
+General
+-------
+
+This release includes a significant overhaul of the configuration
+management facilities for notmuch.  The previous distinction between
+configuration items that can be modified via plain text configuration
+files and those that must be set in the database via the "notmuch
+config" subcommand is gone, and all configuration items can be set in
+both ways.  The external configuration file overrides configuration
+items in the database. The location of database, hooks, and
+configuration files is now more flexible, with several new
+configuration variables. In particular XDG locations are now supported
+as fallbacks for database, configuration and hooks. For more
+information see `notmuch-config(1)`.
+
+Library
+-------
+
+To support the new configuration facilities, several functions and
+constants have been added to the notmuch API. Most notably:
+
+- `notmuch_database_create_with_config`
+- `notmuch_database_open_with_config`
+- `notmuch_database_load_config`
+- `notmuch_config_get`
+
+A previously requested API change is that `notmuch_database_reopen` is
+now exposed (and generalized).
+
+As always, the canonical source of API documentation is
+`lib/notmuch.h`, or the doxygen formated documentation in `notmuch(3)`
+
+CLI
+---
+
+The `notmuch config set` subcommand gained a `--database` argument to
+specify that the database should be updated, rather than a config file.
+
 Notmuch 0.31.4 (2021-02-18)
 ===========================
 
-- 
2.30.2
_______________________________________________
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-leave@notmuchmail.org

Thread: