Supported options for <b>address</b> include
- <b>--format=</b>(<b>json</b>|<b>sexp</b>|<b>text</b>|<b>text0</b>)
+ <b>--format=(json|sexp|text|text0)</b>
Presents the results in either JSON, S-Expressions, newline
character separated plain-text (default), or null character sep‐
arated plain-text (compatible with <b>xargs</b>(1) -0 option where
available).
<b>--format-version=N</b>
- Use the specified structured output format version. This is
- intended for programs that invoke <a href='../notmuch-1/'>notmuch</a>(1) internally. If
- omitted, the latest supported version will be used.
+ Use the specified structured output format version. This is in‐
+ tended for programs that invoke <a href='../notmuch-1/'>notmuch</a>(1) internally. If omit‐
+ ted, the latest supported version will be used.
<b>--output=(sender|recipients|count|address)</b>
Controls which information appears in the output. This option
can be given multiple times to combine different outputs. When
- neither --output=sender nor --output=recipients is given, --out‐
- put=sender is implied.
+ neither <b>--output=sender</b> nor <b>--output=recipients</b> is given, <b>--out-</b>
+ <b>put=sender</b> is implied.
<b>sender</b> Output all addresses from the <u>From</u> header.
Control the deduplication of results.
<b>no</b> Output all occurrences of addresses in the matching mes‐
- sages. This is not applicable with --output=count.
+ sages. This is not applicable with <b>--output=count</b>.
<b>mailbox</b>
Deduplicate addresses based on the full, case sensitive
name and email address, or mailbox. This is effectively
- the same as piping the --deduplicate=no output to <b>sort</b> <b>|</b>
- <b>uniq</b>, except for the order of results. This is the
- default.
+ the same as piping the <b>--deduplicate=no</b> output to <b>sort</b> <b>|</b>
+ <b>uniq</b>, except for the order of results. This is the de‐
+ fault.
<b>address</b>
- Deduplicate addresses based on the case insensitive
- address part of the mailbox. Of all the variants (with
- different name or case), print the one occurring most
- frequently among the matching messages. If --output=count
- is specified, include all variants in the count.
+ Deduplicate addresses based on the case insensitive ad‐
+ dress part of the mailbox. Of all the variants (with dif‐
+ ferent name or case), print the one occurring most fre‐
+ quently among the matching messages. If <b>--output=count</b> is
+ specified, include all variants in the count.
- <b>--sort=</b>(<b>newest-first</b>|<b>oldest-first</b>)
+ <b>--sort=(newest-first|oldest-first)</b>
This option can be used to present results in either chronologi‐
cal order (<b>oldest-first</b>) or reverse chronological order (<b>new-</b>
<b>est-first</b>).
By default, results will be displayed in reverse chronological
order, (that is, the newest results will be displayed first).
- However, if either --output=count or --deduplicate=address is
+ However, if either <b>--output=count</b> or <b>--deduplicate=address</b> is
specified, this option is ignored and the order of the results
is unspecified.
<b>--exclude=(true|false)</b>
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. This option specifies whether to omit excluded messages
- in the search process.
+ search.exclude_tags that does not appear explicitly in the
+ search terms. This option specifies whether to omit excluded
+ messages in the search process.
The default value, <b>true</b>, prevents excluded messages from match‐
ing the search terms.
<pre>
<a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not‐</a>
<a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-insert-1/'>notmuch-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
- <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>not‐</a>
- <a href='../notmuch-tag-1/'>much-tag</a>(1), <a href='../notmuch-search-1/'>notmuch-search</a>(1)
+ <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <a href='../notmuch-search-1/'>notmuch-search</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>not‐</a>
+ <a href='../notmuch-show-1/'>much-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-tag</a>(1)
</pre>
<h2>AUTHOR</h2>
<h2>COPYRIGHT</h2>
<pre>
- 2009-2018, Carl Worth and many others
+ 2009-2022, Carl Worth and many others
</pre>
-<h2>0.26</h2>
+<h2>0.35</h2>
projects / notmuch-wiki / blobdiff