]> git.notmuchmail.org Git - notmuch/commitdiff
doc: document user header indexing.
authorDavid Bremner <david@tethera.net>
Mon, 18 Feb 2019 13:08:48 +0000 (09:08 -0400)
committerDavid Bremner <david@tethera.net>
Sat, 25 May 2019 10:21:21 +0000 (07:21 -0300)
It's a bit odd that the primary documentation is in notmuch-config,
but it is consistent with the "query:" prefix.

doc/man1/notmuch-config.rst
doc/man7/notmuch-search-terms.rst

index 899098084ae2beafea74017b3064de261c0a8917..28487079b43b75bc07714a63ee9d3d81402c16f7 100644 (file)
@@ -195,6 +195,15 @@ The available configuration items are described below.
 
     Default: ``auto``.
 
+**index.header.<prefix>** **[STORED IN DATABASE]**
+    Define the query prefix <prefix>, based on a mail header. For
+    example ``index.header.List=List-Id`` will add a probabilistic
+    prefix ``List:`` that searches the ``List-Id`` field.  User
+    defined prefixes must not start with 'a'...'z'; in particular
+    adding a prefix with same name as a predefined prefix is not
+    supported. See **notmuch-search-terms(7)** for a list of existing
+    prefixes, and an explanation of probabilistic prefixes.
+
 **built_with.<name>**
     Compile time feature <name>. Current possibilities include
     "compact" (see **notmuch-compact(1)**) and "field_processor" (see
index fd8bf634363d9b757c2317b611d4c7ed69d8d985..1dd2dc5813f5c40da3b9c95b15aa8eaae0491542 100644 (file)
@@ -169,6 +169,9 @@ property:<key>=<value>
     can be present on a given message with several different values.
     See **notmuch-properties(7)** for more details.
 
+User defined prefixes are also supported, see **notmuch-config(1)** for
+details.
+
 Operators
 ---------