X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-address-1.mdwn;h=cefd87b23a7b69d070a20fe1dda1ca6aaa8a4d4c;hb=716bcefd296e3ee39ff65e8ef89e671c9828191d;hp=4346373a772a8edc6d2e0547c985e1975c595a6f;hpb=971fc82cc6d07e9b058d4ade139d9d2145cb5a3f;p=notmuch-wiki diff --git a/manpages/notmuch-address-1.mdwn b/manpages/notmuch-address-1.mdwn index 4346373..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,28 +53,54 @@ Note: With this option, addresses are printed only after the whole search is finished. This may take long time. - --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). - - 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. - - --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. - - The default value, true, prevents excluded messages from - matching the search terms. - - false allows excluded messages to match search terms and - appear in displayed results. + 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 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 | + uniq, except for the order of results. This is the + default. + + address + 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. + + --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 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. + + --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 match‐ + ing the search terms. + + false allows excluded messages to match search terms and appear + in displayed results.

EXIT STATUS

@@ -101,7 +127,7 @@

COPYRIGHT

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

0.20.2

+

0.29