X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-address-1.mdwn;h=cefd87b23a7b69d070a20fe1dda1ca6aaa8a4d4c;hb=716bcefd296e3ee39ff65e8ef89e671c9828191d;hp=f3f5fcdab20130ecb484fba6e7a7288abb0e8304;hpb=972d44d9cb20af9363eb251fc6e748912ad0ca32;p=notmuch-wiki diff --git a/manpages/notmuch-address-1.mdwn b/manpages/notmuch-address-1.mdwn index f3f5fcd..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

@@ -110,9 +114,9 @@

SEE ALSO

-       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not‐
-       much-hooks(5),   notmuch-insert(1),  notmuch-new(1),  notmuch-reply(1),
-       notmuch-restore(1),  notmuch-search-terms(7),   notmuch-show(1),   not‐
+       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
+       much-hooks(5),  notmuch-insert(1),  notmuch-new(1),   notmuch-reply(1),
+       notmuch-restore(1),   notmuch-search-terms(7),   notmuch-show(1),  not‐
        much-tag(1), notmuch-search(1)
@@ -123,7 +127,7 @@

COPYRIGHT

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

0.23

+

0.29