``--output=(sender|recipients|count)``
Controls which information appears in the output. This option
- can be given multiple times to combine different outputs.
- Omitting this option is equivalent to
- --output=sender --output=recipients.
+ can be given multiple times to combine different outputs.
+ When neither --output=sender nor --output=recipients is
+ given, --output=sender is implied.
- **sender**
+ **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.
+ 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**
+ **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.
+ **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.
+ Note: With this option, addresses are printed only after
+ the whole search is finished. This may take long time.
+
+ ``--deduplicate=(no|mailbox|address)``
+
+ Control the deduplication of results.
+
+ **no**
+ 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.
+
+ **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
By default, results will be displayed in reverse chronological
order, (that is, the newest results will be displayed first).
- This option has no effect when used with --output=count.
+ 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
**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)**
+**notmuch-search(1)**