X-Git-Url: https://git.cworth.org/git?p=obsolete%2Fnotmuch-wiki;a=blobdiff_plain;f=manpages%2Fnotmuch-search-1.mdwn;h=e8b6c279d39d364d44f8556352293b1b90f2e058;hp=11c3ba6366fdebda7d1eec55f31d11f1512cc98c;hb=HEAD;hpb=db09ec4bfe12f883997a17e7a06ccee2d5ce7296
diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn
index 11c3ba6..e8b6c27 100644
--- a/manpages/notmuch-search-1.mdwn
+++ b/manpages/notmuch-search-1.mdwn
@@ -82,8 +82,8 @@
--sort=(newest-first|oldest-first)
This option can be used to present results in either chronolog-
- ical order (oldest-first) or reverse chronological order
- (newest-first).
+ ical order (oldest-first) or reverse chronological order (new-
+ est-first).
Note: The thread order will be distinct between these two
options (beyond being simply reversed). When sorting by old-
@@ -103,13 +103,28 @@
Limit the number of displayed results to N.
- --exclude=(true|false|flag)
+ --exclude=(true|false|all|flag)
- Specify whether to omit messages matching search.tag_exclude
- from the search results (the default) or not. The extra option
- flag only has an effect when --output=summary In this case all
- matching threads are returned but the "match count" is the num-
- ber of matching non-excluded messages in the thread.
+ A message is called "excluded" if it matches at least one tag
+ in search.tag_exclude that does not appear explicitly in the
+ search terms. This option specifies whether to omit excluded
+ messages in the search process.
+
+ The default value, true, prevents excluded messages from match-
+ ing the search terms.
+
+ all additionally prevents excluded messages from appearing in
+ displayed results, in effect behaving as though the excluded
+ messages do not exist.
+
+ false allows excluded messages to match search terms and appear
+ in displayed results. Excluded messages are still marked in the
+ relevant outputs.
+
+ flag only has an effect when --output=summary. The output is
+ almost identical to false, but the "match count" is the number
+ of matching non-excluded messages in the thread, rather than
+ the number of matching messages.
EXIT STATUS
@@ -123,9 +138,10 @@
SEE ALSO
- notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
- much-hooks(5), notmuch-new(1), notmuch-reply(1), notmuch-restore(1),
- notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
+ notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
+ much-hooks(5), notmuch-insert(1), notmuch-new(1), notmuch-reply(1),
+ notmuch-restore(1), notmuch-search-terms(7), notmuch-show(1), notmuch-
+ tag(1)
-Notmuch 0.15.2
+Notmuch 0.16