From 14150416dd8e9d824e57566368ae79a23a90f593 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Thu, 21 Sep 2023 16:50:02 -0300 Subject: [PATCH] CLI: update commentary in config file to better match code This comment has been out of date since notmuch 0.32. Although it isn't really possible to explain all the options here, explain both one new "split" way of doing things and the traditional one with database inside $MAIL_ROOT/.notmuch. --- notmuch-config.c | 12 +++++++----- test/setup.expected-output/config-with-comments | 12 +++++++----- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/notmuch-config.c b/notmuch-config.c index 8123e438..f7e59f1e 100644 --- a/notmuch-config.c +++ b/notmuch-config.c @@ -40,11 +40,13 @@ static const struct config_group { "database", " Database configuration\n" "\n" - " The only value supported here is 'path' which should be the top-level\n" - " directory where your mail currently exists and to where mail will be\n" - " delivered in the future. Files should be individual email messages.\n" - " Notmuch will store its database within a sub-directory of the path\n" - " configured here named \".notmuch\".\n" + " Supported values are 'mail_root' and 'path'. The recommended option\n" + " is to set 'mail_root' to the directory where your mail currently exists\n" + " and to where mail will be delivered in the future. Files should be\n" + " individual email messages. By default notmuch will store its database\n" + " in $XDG_DATA_HOME/notmuch; you can override this by setting 'path'.\n" + " If only 'path' is set, this directory is for 'mail_root' and for\n" + " the database location (in a subdirectory called \".notmuch\").\n" }, { "user", diff --git a/test/setup.expected-output/config-with-comments b/test/setup.expected-output/config-with-comments index d925acea..5d96be7f 100644 --- a/test/setup.expected-output/config-with-comments +++ b/test/setup.expected-output/config-with-comments @@ -3,11 +3,13 @@ # For more information about notmuch, see https://notmuchmail.org # Database configuration # -# The only value supported here is 'path' which should be the top-level -# directory where your mail currently exists and to where mail will be -# delivered in the future. Files should be individual email messages. -# Notmuch will store its database within a sub-directory of the path -# configured here named ".notmuch". +# Supported values are 'mail_root' and 'path'. The recommended option +# is to set 'mail_root' to the directory where your mail currently exists +# and to where mail will be delivered in the future. Files should be +# individual email messages. By default notmuch will store its database +# in $XDG_DATA_HOME/notmuch; you can override this by setting 'path'. +# If only 'path' is set, this directory is for 'mail_root' and for +# the database location (in a subdirectory called ".notmuch"). # [database] path=/path/to/maildir