aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Bremner <david@tethera.net>2016-03-22 07:54:54 -0300
committerDavid Bremner <david@tethera.net>2016-05-25 07:40:44 -0300
commitb9bf3f44eacd42ce53885c79f9dad8d82c76f13d (patch)
treedbf4064112caa61dcf8fd6b22d27fad0e1ad81e2 /doc
parent30caaf52b022be5f0f695f3088286fb56e82c782 (diff)
lib: add support for named queries
This relies on the optional presense of xapian field processors, and the library config API.
Diffstat (limited to 'doc')
-rw-r--r--doc/man7/notmuch-search-terms.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst
index adedf5a3..223031b8 100644
--- a/doc/man7/notmuch-search-terms.rst
+++ b/doc/man7/notmuch-search-terms.rst
@@ -56,6 +56,8 @@ indicate user-supplied values):
- lastmod:<initial-revision>..<final-revision>
+- query:<name>
+
The **from:** prefix is used to match the name or address of the sender
of an email message.
@@ -132,6 +134,11 @@ were added/removed or filenames changed). This is usually used in
conjunction with the **--uuid** argument to **notmuch search**
to find messages that have changed since an earlier query.
+The **query:** prefix allows queries to refer to previously saved
+queries added with **notmuch-config(1)**. Named queries are only
+available if notmuch is built with **Xapian Field Processors** (see
+below).
+
Operators
---------
@@ -385,6 +392,7 @@ notmuch was built against a sufficiently recent version of Xapian by running
Currently the following features require field processor support:
- non-range date queries, e.g. "date:today"
+- named queries e.g. "query:my_special_query"
SEE ALSO
========