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.

diff --git a/notmuch-config.c b/notmuch-config.c
index 8123e4381003bd89509edc8d7970737893b1992b..f7e59f1ea3de3010e16f7e6039475ee6ca47dc37 100644 (file)
--- 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 d925acea352e41dd3133d4062cdf4ac025a075e8..5d96be7f429f744b0ac50e7bbe7af20aa0ed015a 100644 (file)
--- 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