From 00167752785a50158e9aebbe72ad3f05f49e347e Mon Sep 17 00:00:00 2001 From: Reto Brunner Date: Mon, 5 Aug 2019 09:16:10 +0200 Subject: Add notmuch docs --- doc/aerc-config.5.scd | 2 ++ doc/aerc-maildir.5.scd | 2 +- doc/aerc-notmuch.5.scd | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 64 insertions(+), 1 deletion(-) create mode 100644 doc/aerc-notmuch.5.scd (limited to 'doc') diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd index a57f760..995fe75 100644 --- a/doc/aerc-config.5.scd +++ b/doc/aerc-config.5.scd @@ -257,6 +257,7 @@ Note that many of these configuration options are written for you, such as - *aerc-imap*(5) - *aerc-maildir*(5) + - *aerc-notmuch*(5) Default: none @@ -423,6 +424,7 @@ following special keys are supported: # SEE ALSO *aerc*(1) *aerc-imap*(5) *aerc-smtp*(5) *aerc-maildir*(5) *aerc-sendmail*(5) +*aerc-notmuch*(5) # AUTHORS diff --git a/doc/aerc-maildir.5.scd b/doc/aerc-maildir.5.scd index 5765bf8..37a654b 100644 --- a/doc/aerc-maildir.5.scd +++ b/doc/aerc-maildir.5.scd @@ -31,7 +31,7 @@ The following maildir-specific options are available: # SEE ALSO -*aerc*(1) *aerc-config*(5) *aerc-smtp*(5) +*aerc*(1) *aerc-config*(5) *aerc-smtp*(5) *aerc-notmuch*(5) # AUTHORS diff --git a/doc/aerc-notmuch.5.scd b/doc/aerc-notmuch.5.scd new file mode 100644 index 0000000..6e98285 --- /dev/null +++ b/doc/aerc-notmuch.5.scd @@ -0,0 +1,61 @@ +aerc-notmuch(5) + +# NAME + +aerc-notmuch - notmuch configuration for *aerc*(1) + +# SYNOPSIS + +aerc supports using the notmuch email system as a backend, for fast indexing +and searching. + +For this to be enabled, aerc needs to be build with notmuch support.++ +Refer to the installation instructions for details. + +# CONFIGURATION + +Notmuch accounts currently are not supported with the :new-account command and +must be added manually. + +In accounts.conf (see *aerc-config*(5)), the following notmuch-specific +options are available: + +*source* + notmuch://path + + The *source* indicates the path to the directory containing your notmuch + database (usually a .notmuch folder). + + The path portion of the URL following _notmuch://_ must be either an absolute + path prefixed by */* or a path relative to your home directory prefixed with + *~*. For example: + + source = notmuch:///home/me/mail + + source = notmuch://~/mail + +*query-map* + Path to a file containing a mapping from display name to notmuch query in + the form of NAME=QUERY.++ +Multiple entries can be specified, one per line. + + e.g. inbox=tag:inbox and not tag:archived + + Default: none + +*exclude-tags* + Comma separated list of tags which will be excluded from query results, + unless explicitly mentioned in the query.++ +This can for example be useful if you use an archive or spam tag. + + Default: none + +# SEE ALSO + +*aerc*(1) *aerc-config*(5) *aerc-smtp*(5) *aerc-maildir*(5) + +# AUTHORS + +Maintained by Drew DeVault , who is assisted by other open +source contributors. For more information about aerc development, see +https://git.sr.ht/~sircmpwn/aerc. -- cgit v1.2.3