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.
This commit is contained in:
David Bremner 2023-09-21 16:50:02 -03:00
parent a1921a25b7
commit 14150416dd
2 changed files with 14 additions and 10 deletions

View file

@ -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",

View file

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