X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=doc%2Fman1%2Fnotmuch-search.rst;h=4e660a6facbbb25295688795a28c8b7991627809;hb=caa9dcb70798bbd06bc52489109988ed1c01806c;hp=b6607c922cc083c35b9add629c771d6d3927da1b;hpb=3cc8ed5978157e26cf302ca5b1c9669efeb9ee44;p=notmuch diff --git a/doc/man1/notmuch-search.rst b/doc/man1/notmuch-search.rst index b6607c92..4e660a6f 100644 --- a/doc/man1/notmuch-search.rst +++ b/doc/man1/notmuch-search.rst @@ -35,7 +35,7 @@ Supported options for **search** include intended for programs that invoke **notmuch(1)** internally. If omitted, the latest supported version will be used. - ``--output=(summary|threads|messages|files|tags|sender|recipients)`` + ``--output=(summary|threads|messages|files|tags)`` **summary** Output a summary of each thread with any message matching @@ -78,26 +78,6 @@ Supported options for **search** include by null characters (--format=text0), as a JSON array (--format=json), or as an S-Expression list (--format=sexp). - **sender** - Output all addresses from the *From* header that appear on - any message matching the search terms, either one per line - (--format=text), separated by null characters - (--format=text0), as a JSON array (--format=json), or as - an S-Expression list (--format=sexp). - - Note: Searching for **sender** should be much faster than - searching for **recipients**, because sender addresses are - cached directly in the database whereas other addresses - need to be fetched from message files. - - **recipients** - Like **sender** but for addresses from *To*, *Cc* and - *Bcc* headers. - - This option can be given multiple times to combine different - outputs. Currently, this is only supported for **sender** and - **recipients** outputs. - ``--sort=``\ (**newest-first**\ \|\ **oldest-first**) This option can be used to present results in either chronological order (**oldest-first**) or reverse chronological @@ -142,10 +122,14 @@ Supported options for **search** include rather than the number of matching messages. ``--duplicate=N`` - Effective with ``--output=files``, output the Nth filename - associated with each message matching the query (N is 1-based). - If N is greater than the number of files associated with the - message, don't print anything. + For ``--output=files``, output the Nth filename associated + with each message matching the query (N is 1-based). If N is + greater than the number of files associated with the message, + don't print anything. + + For ``--output=messages``, only output message IDs of messages + matching the search terms that have at least N filenames + associated with them. Note that this option is orthogonal with the **folder:** search prefix. The prefix matches messages based on filenames. This @@ -169,3 +153,4 @@ SEE ALSO **notmuch-dump(1)**, **notmuch-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-address(1)**