unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
blob 4ae7395bce4d4b2ce1f78ca04d2cb9510e81d658 3865 bytes (raw)
name: doc/man1/notmuch-address.rst 	 # note: path name is non-authoritative(*)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
 
===============
notmuch-address
===============

SYNOPSIS
========

**notmuch** **address** [*option* ...] <*search-term*> ...

DESCRIPTION
===========

Search for messages matching the given search terms, and display the
addresses from them. Duplicate addresses are filtered out.

See **notmuch-search-terms(7)** for details of the supported syntax for
<search-terms>.

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)``

        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, --output=sender is implied.

        **sender**
            Output all addresses from the *From* header.

            Note: Searching for **sender** should be much faster than
            searching for **recipients**, because sender addresses are
            cached directly in the database whereas other addresses
            need to be fetched from message files.

        **recipients**
            Output all addresses from the *To*, *Cc* and *Bcc*
            headers.

        **count**
            Print the count of how many times was the address
            encountered during search.

            Note: With this option, addresses are printed only after
            the whole search is finished. This may take long time.

    ``--deduplicate=(no|mailbox)``

        Control the deduplication of results.

        **none**
            Output all occurences of addresses in the matching
            messages. 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.

    ``--sort=``\ (**newest-first**\ \|\ **oldest-first**)
        This option can be used to present results in either
        chronological order (**oldest-first**) or reverse chronological
        order (**newest-first**).

        By default, results will be displayed in reverse chronological
        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.

EXIT STATUS
===========

This command supports the following special exit status codes

``20``
    The requested format version is too old.

``21``
    The requested format version is too new.

SEE ALSO
========

**notmuch(1)**, **notmuch-config(1)**, **notmuch-count(1)**,
**notmuch-dump(1)**, **notmuch-hooks(5)**, **notmuch-insert(1)**,
**notmuch-new(1)**, **notmuch-reply(1)**, **notmuch-restore(1)**,
**notmuch-search-terms(7)**, **notmuch-show(1)**, **notmuch-tag(1)**,
**notmuch-search(1)**

debug log:

solving 4ae7395bce4d ...
found 4ae7395bce4d in https://yhetil.org/notmuch/ebc6d897c35212c28936158fc0509f8bdbebb48d.1441308761.git.jani@nikula.org/
found 9570095b23c8 in https://yhetil.org/notmuch.git/
preparing index
index prepared:
100644 9570095b23c8437965e88831e2247fa03dcaaea1	doc/man1/notmuch-address.rst

applying [1/1] https://yhetil.org/notmuch/ebc6d897c35212c28936158fc0509f8bdbebb48d.1441308761.git.jani@nikula.org/
diff --git a/doc/man1/notmuch-address.rst b/doc/man1/notmuch-address.rst
index 9570095b23c8..4ae7395bce4d 100644

Checking patch doc/man1/notmuch-address.rst...
Applied patch doc/man1/notmuch-address.rst cleanly.

index at:
100644 4ae7395bce4d4b2ce1f78ca04d2cb9510e81d658	doc/man1/notmuch-address.rst

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).