Add notmuch docs

3 files changed, 64 insertions, 1 deletions

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 <sir@cmpwn.com>, who is assisted by other open
+source contributors. For more information about aerc development, see
+https://git.sr.ht/~sircmpwn/aerc.