Supported options for <b>address</b> include
- <b>--format=(json|sexp|text|text0)</b>
- Presents the results in either JSON, S-Expressions, newline
- character separated plain-text (default), or null character
- separated 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.
-
- <b>--output=(sender|recipients|count)</b>
+ <b>--format=</b>(<b>json</b>|<b>sexp</b>|<b>text</b>|<b>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.
+
+ <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.
Note: With this option, addresses are printed only after
the whole search is finished. This may take long time.
- <b>--sort=(newest-first|oldest-first)</b>
- This option can be used to present results in either chrono‐
- logical order (<b>oldest-first</b>) or reverse chronological order
- (<b>newest-first</b>).
-
- By default, results will be displayed in reverse chronologi‐
- cal order, (that is, the newest results will be displayed
- first).
-
- This option is not supported with --output=count.
-
- <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.
-
- The default value, <b>true</b>, prevents excluded messages from
- matching the search terms.
-
- <b>false</b> allows excluded messages to match search terms and
- appear in displayed results.
+ <b>address</b>
+ Output only the email addresses instead of the full mail‐
+ boxes with names and email addresses. This option has no
+ effect on the JSON or S-Expression output formats.
+
+ <b>--deduplicate=(no|mailbox|address)</b>
+ Control the deduplication of results.
+
+ <b>no</b> Output all occurrences of addresses in the matching mes‐
+ 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 <b>--deduplicate=no</b> output to <b>sort</b> <b>|</b>
+ <b>uniq</b>, except for the order of results. This is the
+ default.
+
+ <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 <b>--output=count</b>
+ is specified, include all variants in the count.
+
+ <b>--sort=</b>(<b>newest-first</b>|<b>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 <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.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.
+
+ <b>false</b> allows excluded messages to match search terms and appear
+ in displayed results.
</pre>
<h2>EXIT STATUS</h2>
<h2>COPYRIGHT</h2>
<pre>
- 2015, Carl Worth and many others
+ 2009-2019, Carl Worth and many others
</pre>
-<h2>0.20.2</h2>
+<h2>0.29</h2>
projects / notmuch-wiki / blobdiff