unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
From: David Bremner <david@tethera.net>
To: David Bremner <david@tethera.net>, notmuch@notmuchmail.org
Cc: Floris Bruynooghe <flub@devork.be>, Jonas Bernoulli <jonas@bernoul.li>
Subject: [PATCH] NEWS: user visible config related changes for 0.32
Date: Sat, 10 Apr 2021 09:52:07 -0300	[thread overview]
Message-ID: <20210410125207.24527-1-david@tethera.net> (raw)
In-Reply-To: <87eefitjb9.fsf@tethera.net>

---
 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

  reply	other threads:[~2021-04-10 12:52 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-10 12:28 Release process for 0.32 David Bremner
2021-04-10 12:52 ` David Bremner [this message]
2021-04-16 12:02   ` [PATCH] NEWS: user visible config related changes " David Bremner
2021-04-24 16:36 ` Release process " David Bremner
2021-04-25 16:55   ` Felipe Contreras
2021-04-28 10:35   ` David Bremner
2021-04-28 13:24     ` Michael J Gruber
2021-04-28 14:14       ` David Bremner
2021-04-28  7:21 ` Jonas Bernoulli

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://notmuchmail.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210410125207.24527-1-david@tethera.net \
    --to=david@tethera.net \
    --cc=flub@devork.be \
    --cc=jonas@bernoul.li \
    --cc=notmuch@notmuchmail.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).