summary refs log tree commit diff stats
path: root/doc/aerc-notmuch.5.scd
diff options
context:
space:
mode:
Diffstat (limited to 'doc/aerc-notmuch.5.scd')
-rw-r--r--doc/aerc-notmuch.5.scd61
1 files changed, 61 insertions, 0 deletions
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.