X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-address-1.mdwn;h=cefd87b23a7b69d070a20fe1dda1ca6aaa8a4d4c;hb=716bcefd296e3ee39ff65e8ef89e671c9828191d;hp=bf40293ea23836f9d2c48ef9b95ada7265e2c237;hpb=463553b46f63067f5b25a6115f116d88f02d50ec;p=notmuch-wiki diff --git a/manpages/notmuch-address-1.mdwn b/manpages/notmuch-address-1.mdwn index bf40293..cefd87b 100644 --- a/manpages/notmuch-address-1.mdwn +++ b/manpages/notmuch-address-1.mdwn @@ -20,22 +20,22 @@ Supported options for address include - --format=(json|sexp|text|text0) - Presents the results in either JSON, S-Expressions, newline - character separated plain-text (default), or null character - separated plain-text (compatible with xargs(1) -0 option - where available). - - --format-version=N - Use the specified structured output format version. This is - intended for programs that invoke notmuch(1) internally. If - omitted, the latest supported version will be used. - - --output=(sender|recipients|count) + --format=(json|sexp|text|text0) + Presents the results in either JSON, S-Expressions, newline + character separated plain-text (default), or null character sep‐ + arated plain-text (compatible with xargs(1) -0 option where + available). + + --format-version=N + Use the specified structured output format version. This is + intended for programs that invoke notmuch(1) internally. If + omitted, the latest supported version will be used. + + --output=(sender|recipients|count|address) 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 --output=sender nor --output=recipients is given, --out- + put=sender is implied. sender Output all addresses from the From header. @@ -53,16 +53,21 @@ Note: With this option, addresses are printed only after the whole search is finished. This may take long time. - --deduplicate=(no|mailbox|address) + address + 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. + + --deduplicate=(no|mailbox|address) Control the deduplication of results. - no Output all occurences of addresses in the matching mes‐ - sages. This is not applicable with --output=count. + no Output all occurrences of addresses in the matching mes‐ + sages. This is not applicable with --output=count. mailbox 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 sort | + the same as piping the --deduplicate=no output to sort | uniq, except for the order of results. This is the default. @@ -70,33 +75,32 @@ 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 + frequently among the matching messages. If --output=count is specified, include all variants in the count. - --sort=(newest-first|oldest-first) - This option can be used to present results in either chrono‐ - logical order (oldest-first) or reverse chronological order - (newest-first). + --sort=(newest-first|oldest-first) + This option can be used to present results in either chronologi‐ + cal order (oldest-first) or reverse chronological order (new- + est-first). - By default, results will be displayed in reverse chronologi‐ - cal order, (that is, the newest results will be displayed - first). + 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 - specified, this option is ignored and the order of the - results is unspecified. + However, if either --output=count or --deduplicate=address is + specified, this option is ignored and the order of the results + is unspecified. - --exclude=(true|false) - 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. + --exclude=(true|false) + 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, true, prevents excluded messages from - matching the search terms. + The default value, true, prevents excluded messages from match‐ + ing the search terms. - false allows excluded messages to match search terms and - appear in displayed results. + false allows excluded messages to match search terms and appear + in displayed results.

EXIT STATUS

@@ -123,7 +127,7 @@

COPYRIGHT

-       2009-2016, Carl Worth and many others
+       2009-2019, Carl Worth and many others
-

0.22

+

0.29