X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=man%2Fman1%2Fnotmuch-search.1;h=1c1e049b19c6bead87f6729951616b74a01b9c06;hb=92c0591db92963fec03f48608404a120af72dccc;hp=59e8f3416e0d0bb55abfb1abe621c5da4273ff1b;hpb=ea0e75702d3bb4a45d271f9ba23bc8fd6c21cb86;p=notmuch diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1 index 59e8f341..1c1e049b 100644 --- a/man/man1/notmuch-search.1 +++ b/man/man1/notmuch-search.1 @@ -130,7 +130,7 @@ Limit the number of displayed results to N. .RS 4 .TP 4 -.BR \-\-exclude=(true|false|flag) +.BR \-\-exclude=(true|false|all|flag) 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. @@ -141,15 +141,21 @@ The default value, .BR true , prevents excluded messages from matching the search terms. +.B all +additionally prevents excluded messages from appearing in displayed +results, in effect behaving as though the excluded messages do not exist. + .B false allows excluded messages to match search terms and appear in displayed results. Excluded messages are still marked in the relevant outputs. .B flag only has an effect when -.B --output=summary -In this case all matching threads are returned but the "match count" -is the number of matching non-excluded messages in the thread. +.BR --output=summary . +The output is almost identical to +.BR false , +but the "match count" is the number of matching non-excluded messages in the +thread, rather than the number of matching messages. .RE .SH EXIT STATUS