X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-search-terms-7.mdwn;h=c1377349c017b8daee80bc0e7d4cac2b7e2ca23d;hb=dd8c0d25288488dc30b41c04c35bdd552bf04e71;hp=a6b61f3fa607bb0874c57c9b50c532ca8f8d3f07;hpb=971fc82cc6d07e9b058d4ade139d9d2145cb5a3f;p=notmuch-wiki
diff --git a/manpages/notmuch-search-terms-7.mdwn b/manpages/notmuch-search-terms-7.mdwn
index a6b61f3..c137734 100644
--- a/manpages/notmuch-search-terms-7.mdwn
+++ b/manpages/notmuch-search-terms-7.mdwn
@@ -57,6 +57,10 @@
· date:<since>..<until>
+ · 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.
@@ -122,6 +126,16 @@
Each timestamp is a number representing the number of seconds since
1970-01-01 00:00:00 UTC.
+
+ The lastmod: prefix can be used to restrict the result by the database
+ revision number of when messages were last modified (tags were
+ added/removed or filenames changed). This is usually used in conjuncâ
+ tion 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 notâ
+ much is built with Xapian Field Processors (see below).
Operators
@@ -189,14 +203,11 @@
flexible term based searching. The prefixes currently supported by notâ
much are as follows.
- âââââââââââââââââââââââââââââ¬âââââââââââââââââââââââââââââ
- âBoolean
- âââââââââââââââââââââââââââââ¼âââââââââââââââââââââââââââââ¤
- â
- â
- â thread: folder: â subject: attachâ â
- â path: â ment: mimetype: â
- âââââââââââââââââââââââââââââ´âââââââââââââââââââââââââââââ
+ Boolean
+ tag:, id:, thread:, folder:, path:
+
+ Probabilistic
+ from:, to:, subject:, attachment:, mimetype:
Terms and phrases
@@ -254,7 +265,14 @@
could describe (the end of yesterday). Similarly, date:january..februâ
ary matches from the beginning of January to the end of February.
- Currently, we do not support spaces in range expressions. You can
+ date:<expr>..! can be used as a shorthand for date:<expr>..<expr>. The
+ expansion takes place before interpretation, and thus, for example,
+ date:monday..! matches from the beginning of Monday until the end of
+ Monday. With Xapian Field Processor support (see below), non-range
+ date queries such as date:yesterday will work, but otherwise will give
+ unexpected results; if in doubt use date:yesterday..!
+
+ Currently, we do not support spaces in range expressions. You can
replace the spaces with '_', or (in most cases) '-', or (in some cases)
leave the spaces out altogether. Examples in this man page use spaces
for clarity.
@@ -263,11 +281,6 @@
ble to specify date:..<until> or date:<since>.. to not limit the start
or end time, respectively. Pre-1.2.1 Xapian does not report an error on
open ended ranges, but it does not work as expected either.
-
- Entering date:expr without ".." (for example date:yesterday) won't
- work, as it's not interpreted as a range expression at all. You can
- achieve the expected result by duplicating the expr both sides of ".."
- (for example date:yesterday..yesterday).
Relative date and time
@@ -344,6 +357,22 @@
Some time zone codes, e.g. UTC, EET.
+XAPIAN FIELD PROCESSORS
+
+ Certain optional features of the notmuch query processor rely on the
+ presence of the Xapian field processor API. You can determine if your
+ notmuch was built against a sufficiently recent version of Xapian by
+ running
+
+ % notmuch config get built_with.field_processor
+
+ 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
notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), notâ
@@ -358,7 +387,7 @@
COPYRIGHT
- 2015, Carl Worth and many others
+ 2009-2016, Carl Worth and many others
-0.20.2
+0.22.1