manpages (0.21) update

[notmuch-wiki] / manpages / notmuch-search-terms-7.mdwn

diff --git a/manpages/notmuch-search-terms-7.mdwn b/manpages/notmuch-search-terms-7.mdwn
index a6b61f3fa607bb0874c57c9b50c532ca8f8d3f07..b36c16b2fe0a7f3674f75d737c3f6b9ddc7944ee 100644 (file)
--- a/manpages/notmuch-search-terms-7.mdwn
+++ b/manpages/notmuch-search-terms-7.mdwn
@@ -57,6 +57,8 @@
 
        · date:<since>..<until>
 
+       · lastmod:<initial-revision>..<final-revision>
+
        The <b>from:</b> prefix is used to match the name or address of the sender  of
        an email message.
 
@@ -122,6 +124,12 @@
 
        Each  timestamp  is  a  number representing the number of seconds since
        1970-01-01 00:00:00 UTC.
+
+       The <b>lastmod:</b> 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 <b>--uuid</b> argument to <b>notmuch</b> <b>search</b> to find messages that
+       have changed since an earlier query.
 </pre>
 
 <h3> &nbsp; Operators</h3>
@@ -254,7 +262,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:&lt;expr&gt;..!  can be used as a shorthand for date:&lt;expr&gt;..&lt;expr&gt;. The
+       expansion takes place before interpretation,  and  thus,  for  example,
+       date:monday..!  matches  from  the beginning of Monday until the end of
+       Monday. (Note that  entering  date:&lt;expr&gt;  without  &quot;..&quot;,  for  example
+       date:yesterday,  won&apos;t work, as it&apos;s not interpreted as a range expres‐
+       sion at all. Again, use date:yesterday..!)
+
+       Currently, we do not support  spaces  in  range  expressions.  You  can
        replace the spaces with &apos;_&apos;, or (in most cases) &apos;-&apos;, or (in some cases)
        leave  the  spaces out altogether. Examples in this man page use spaces
        for clarity.
@@ -263,11 +278,6 @@
        ble  to specify date:..&lt;until&gt; or date:&lt;since&gt;.. 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  &quot;..&quot;  (for  example date:yesterday) won&apos;t
-       work, as it&apos;s not interpreted as a range expression  at  all.  You  can
-       achieve  the expected result by duplicating the expr both sides of &quot;..&quot;
-       (for example date:yesterday..yesterday).
 </pre>
 
 <h3> &nbsp; Relative date and time</h3>
@@ -358,7 +368,7 @@
 
 <h2>COPYRIGHT</h2>
 <pre>
-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
 </pre>
 
-<h2>0.20.2</h2>
+<h2>0.21</h2>