diff options
| author |  Mark Walters <markwalters1009@gmail.com> | 2012-04-07 17:10:05 +0100 |
|---|---|---|
| committer |  David Bremner <bremner@debian.org> | 2012-04-07 23:05:41 -0300 |
| commit | fd62a25f91c6ecdd6d60c86b4439321b8e84b309 (patch) | |
| tree | 948fca44eec306b4836040f8b887827cf40f2ed0 /man | |
| parent | 785c1e497f05cb89365669fea33cfbf9078a4b12 (diff) | |
cli: move search to the new --exclude= naming scheme.
This commit replaces the --no-exclude option with a
--exclude=(true|false|flag) option. The default is to omit the
excluded messages.
The flag option only makes sense if output=summary (as otherwise there
is nowhere to print the flag). In summary output exclude=false and
exclude=flag give almost identical output:
they differ in that with the exclude=flag option the match count
(i.e., the x in [x/n] in the output) is the number of matching
non-excluded messages rather than the number of matching messages.
Note this changes the default for output=summary when no --exclude=
option is given: it used to default to flag and now defaults to true
(i.e. omit excluded messages). This is neccesary to keep the cli
output uncluttered and for speed reasons.
Diffstat (limited to 'man')
| -rw-r--r-- | man/man1/notmuch-search.1 | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1 index 06d81a6f..ebb61fc6 100644 --- a/man/man1/notmuch-search.1 +++ b/man/man1/notmuch-search.1 @@ -114,9 +114,15 @@ Limit the number of displayed results to N. .RS 4 .TP 4 -.BR \-\-no\-exclude - -Do not exclude the messages matching search.exclude_tags in the config file. +.BR \-\-exclude=(true|false|flag) + +Specify whether to omit messages matching search.tag_exclude from the +search results (the default) or not. The extra option +.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. .RE .SH SEE ALSO |