X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=man%2Fman1%2Fnotmuch-search.1;h=07f6051ced1ac984c5ea67048c785256e51ba0c3;hp=59e8f3416e0d0bb55abfb1abe621c5da4273ff1b;hb=80b25792b2fdbb7f495556db360148798e224930;hpb=ea0e75702d3bb4a45d271f9ba23bc8fd6c21cb86 diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1 index 59e8f341..07f6051c 100644 --- a/man/man1/notmuch-search.1 +++ b/man/man1/notmuch-search.1 @@ -1,4 +1,4 @@ -.TH NOTMUCH-SEARCH 1 2013-02-17 "Notmuch 0.15.2" +.TH NOTMUCH-SEARCH 1 2013-07-28 "Notmuch 0.16" .SH NAME notmuch-search \- search for messages matching the given search terms .SH SYNOPSIS @@ -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 @@ -166,7 +172,8 @@ The requested format version is too new. .SH SEE ALSO \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1), -\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1), +\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), +\fBnotmuch-insert\fR(1), \fBnotmuch-new\fR(1), \fBnotmuch-reply\fR(1), \fBnotmuch-restore\fR(1), \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1), \fBnotmuch-tag\fR(1)