From bf4ac2a31d4b8220d28b36de018a4ad516d60baf Mon Sep 17 00:00:00 2001 From: Tomi Ollila Date: Fri, 30 Oct 2015 13:44:08 +0200 Subject: [PATCH] manpages (0.21) update --- manpages/notmuch-1.mdwn | 19 ++++++++++++++++--- manpages/notmuch-address-1.mdwn | 28 +++++++++++++++++++++++++--- manpages/notmuch-compact-1.mdwn | 4 ++-- manpages/notmuch-config-1.mdwn | 4 ++-- manpages/notmuch-count-1.mdwn | 9 +++++++-- manpages/notmuch-dump-1.mdwn | 4 ++-- manpages/notmuch-hooks-5.mdwn | 4 ++-- manpages/notmuch-insert-1.mdwn | 4 ++-- manpages/notmuch-new-1.mdwn | 4 ++-- manpages/notmuch-reply-1.mdwn | 4 ++-- manpages/notmuch-restore-1.mdwn | 4 ++-- manpages/notmuch-search-1.mdwn | 4 ++-- manpages/notmuch-search-terms-7.mdwn | 26 ++++++++++++++++++-------- manpages/notmuch-show-1.mdwn | 4 ++-- manpages/notmuch-tag-1.mdwn | 4 ++-- 15 files changed, 88 insertions(+), 38 deletions(-) diff --git a/manpages/notmuch-1.mdwn b/manpages/notmuch-1.mdwn index 2e45c93..2776742 100644 --- a/manpages/notmuch-1.mdwn +++ b/manpages/notmuch-1.mdwn @@ -41,7 +41,9 @@ 
        Supported global options for notmuch include
 
-          --help Print a synopsis of available commands and exit.
+          --help [command-name]
+                 Print a synopsis of available commands  and  exit.   With  an
+                 optional command name, show the man page for that subcommand.
 
           --version
                  Print the installed version of notmuch, and exit.
@@ -49,6 +51,17 @@
           --config=FILE
                  Specify the configuration file to  use.  This  overrides  any
                  configuration file specified by ${NOTMUCH_CONFIG}.
+
+          --uuid=HEX
+                 Enforce that the database UUID  (a  unique  identifier  which
+                 persists  until  e.g. the database is compacted) is HEX; exit
+                 with an error if it is not. This is useful to detect rollover
+                 in  modification  counts  on messages. You can find this UUID
+                 using e.g. notmuch count --lastmod
+
+       All global options except --config can also be specified after the com‐
+       mand.  For example, notmuch subcommand --uuid=HEX is equivalent to not-
+       much --uuid=HEX subcommand.

COMMANDS

@@ -149,7 +162,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-address-1.mdwn b/manpages/notmuch-address-1.mdwn index 4346373..b3f6f82 100644 --- a/manpages/notmuch-address-1.mdwn +++ b/manpages/notmuch-address-1.mdwn @@ -53,6 +53,26 @@ Note: With this option, addresses are printed only after the whole search is finished. This may take long time. + --deduplicate=(no|mailbox|address) + Control the deduplication of results. + + no Output all occurences of addresses in the matching mes‐ + sages. This is not applicable with --output=count. + + mailbox + Deduplicate addresses based on the full, case sensitive + name and email address, or mailbox. This is effectively + the same as piping the --deduplicate=no output to sort | + uniq, except for the order of results. This is the + default. + + address + Deduplicate addresses based on the case insensitive + address part of the mailbox. Of all the variants (with + different name or case), print the one occurring most + frequently among the matching messages. If --output=count + is specified, include all variants in the count. + --sort=(newest-first|oldest-first) This option can be used to present results in either chrono‐ logical order (oldest-first) or reverse chronological order @@ -62,7 +82,9 @@ cal order, (that is, the newest results will be displayed first). - This option is not supported with --output=count. + However, if either --output=count or --deduplicate=address is + specified, this option is ignored and the order of the + results is unspecified. --exclude=(true|false) A message is called "excluded" if it matches at least one tag @@ -101,7 +123,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-compact-1.mdwn b/manpages/notmuch-compact-1.mdwn index fad318c..bc83cb6 100644 --- a/manpages/notmuch-compact-1.mdwn +++ b/manpages/notmuch-compact-1.mdwn @@ -61,7 +61,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-config-1.mdwn b/manpages/notmuch-config-1.mdwn index 4dfa612..4efc3cf 100644 --- a/manpages/notmuch-config-1.mdwn +++ b/manpages/notmuch-config-1.mdwn @@ -157,7 +157,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-count-1.mdwn b/manpages/notmuch-count-1.mdwn index 2bd7357..4678361 100644 --- a/manpages/notmuch-count-1.mdwn +++ b/manpages/notmuch-count-1.mdwn @@ -49,6 +49,11 @@ option is not compatible with specifying search terms on the command line. + --lastmod + Append lastmod (counter for number of database updates) and + UUID to the output. lastmod values are only comparable + between databases with the same UUID. + --input=<filename> Read input from given file, instead of from stdin. Implies --batch. @@ -69,7 +74,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-dump-1.mdwn b/manpages/notmuch-dump-1.mdwn index 18ed9a2..9ba6476 100644 --- a/manpages/notmuch-dump-1.mdwn +++ b/manpages/notmuch-dump-1.mdwn @@ -87,7 +87,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-hooks-5.mdwn b/manpages/notmuch-hooks-5.mdwn index 08f07ce..3d6ccec 100644 --- a/manpages/notmuch-hooks-5.mdwn +++ b/manpages/notmuch-hooks-5.mdwn @@ -63,7 +63,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-insert-1.mdwn b/manpages/notmuch-insert-1.mdwn index 00d27c4..49a8eb7 100644 --- a/manpages/notmuch-insert-1.mdwn +++ b/manpages/notmuch-insert-1.mdwn @@ -78,7 +78,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-new-1.mdwn b/manpages/notmuch-new-1.mdwn index d809fcc..3af25ff 100644 --- a/manpages/notmuch-new-1.mdwn +++ b/manpages/notmuch-new-1.mdwn @@ -60,7 +60,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-reply-1.mdwn b/manpages/notmuch-reply-1.mdwn index f3dd705..0c36791 100644 --- a/manpages/notmuch-reply-1.mdwn +++ b/manpages/notmuch-reply-1.mdwn @@ -116,7 +116,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn index a005ded..8aca220 100644 --- a/manpages/notmuch-restore-1.mdwn +++ b/manpages/notmuch-restore-1.mdwn @@ -80,7 +80,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn index c9b8b85..355dca6 100644 --- a/manpages/notmuch-search-1.mdwn +++ b/manpages/notmuch-search-1.mdwn @@ -163,7 +163,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-search-terms-7.mdwn b/manpages/notmuch-search-terms-7.mdwn index a6b61f3..b36c16b 100644 --- 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 from: 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 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.

  Operators

@@ -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:<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. (Note that entering date:<expr> without "..", for example + date:yesterday, won't work, as it'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 '_', or (in most cases) '-', 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:..<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

@@ -358,7 +368,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-show-1.mdwn b/manpages/notmuch-show-1.mdwn index 4b3c40f..ae337e7 100644 --- a/manpages/notmuch-show-1.mdwn +++ b/manpages/notmuch-show-1.mdwn @@ -185,7 +185,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index 9de1b64..3225843 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -114,7 +114,7 @@

COPYRIGHT

-       2015, Carl Worth and many others
+       2009-2015, Carl Worth and many others
-

0.20.2

+

0.21

-- 2.43.0