X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-address-1.mdwn;h=30d8ceca5a9b4851d7742af7669b7b05593a23cc;hb=219490b75a85ca18d449168575a0c7538e71612e;hp=b252205bbecd38ec0fcbc9cdfc275fd4f39dedc2;hpb=e4734d2e839d916a78d295c76eff880574c327db;p=notmuch-wiki diff --git a/manpages/notmuch-address-1.mdwn b/manpages/notmuch-address-1.mdwn index b252205..30d8cec 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 in‐ + tended for programs that invoke notmuch(1) internally. If omit‐ + ted, 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 de‐ + fault. + + address + 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 --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

@@ -90,8 +116,8 @@ 
        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)
+       notmuch-restore(1),  notmuch-search(1),  notmuch-search-terms(7),  not‐
+       much-show(1), notmuch-tag(1)

AUTHOR

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

COPYRIGHT

-       2014, Carl Worth and many others
+       2009-2022, Carl Worth and many others
-

0.20.1

+

0.35