diff options
author | Mark Walters <markwalters1009@gmail.com> | 2012-04-07 17:10:06 +0100 |
---|---|---|
committer | David Bremner <bremner@debian.org> | 2012-04-07 23:05:56 -0300 |
commit | 903327279c38d6750e8347eba23262fa487c6951 (patch) | |
tree | 9cb18ad39ce406bb7c069a8713965e97f1ff9406 /man/man1 | |
parent | fd62a25f91c6ecdd6d60c86b4439321b8e84b309 (diff) |
cli: move show to the new --exclude= option naming scheme.
This moves notmuch show to the --exclude=(true|false) naming
scheme. When exclude=false show returns all threads that match
including those that only match in an excluded message. The excluded
messages are flagged.
When exclude=true the behaviour depends on whether --entire-thread is
set. If it is not set then show only returns the messages which match
and are not excluded. If it is set then show returns all messages in
the threads that match in a non-excluded message, flagging the excluded
messages in these threads. The rationale is that it is awkward to use
a thread with some missing messages.
Diffstat (limited to 'man/man1')
-rw-r--r-- | man/man1/notmuch-show.1 | 16 |
1 files changed, 14 insertions, 2 deletions
diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1 index b81cce69..83cc5750 100644 --- a/man/man1/notmuch-show.1 +++ b/man/man1/notmuch-show.1 @@ -135,9 +135,21 @@ content. .RS 4 .TP 4 -.B \-\-no-exclude +.BR \-\-exclude=(true|false) + +Specify whether to omit threads only matching search.tag_exclude from +the search results (the default) or not. In either case the excluded +message will be marked with the exclude flag (except when output=mbox +when there is nowhere to put the flag). + +If --entire-thread is specified then complete threads are returned +regardless (with the excluded flag being set when appropriate) but +threads that only match in an excluded message are not returned when +.B --exclude=true. + +The default is +.B --exclude=true. -Do not exclude the messages matching search.exclude_tags in the config file. .RE A common use of |