[the GNU General Public License](https://www.gnu.org/licenses/gpl.txt),
either version 3.0 or at your option any later version.
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
<b>--output=(sender|recipients|count|address)</b>
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 <b>--output=sender</b> nor <b>--output=recipients</b> is given, <b>--out-</b>
+ <b>put=sender</b> is implied.
<b>sender</b> Output all addresses from the <u>From</u> header.
Control the deduplication of results.
<b>no</b> Output all occurrences of addresses in the matching mes‐
- sages. This is not applicable with --output=count.
+ sages. This is not applicable with <b>--output=count</b>.
<b>mailbox</b>
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 <b>sort</b> <b>|</b>
+ the same as piping the <b>--deduplicate=no</b> output to <b>sort</b> <b>|</b>
<b>uniq</b>, except for the order of results. This is the
default.
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 <b>--output=count</b>
is specified, include all variants in the count.
<b>--sort=</b>(<b>newest-first</b>|<b>oldest-first</b>)
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
+ However, if either <b>--output=count</b> or <b>--deduplicate=address</b> is
specified, this option is ignored and the order of the results
is unspecified.
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of the supported syntax for
<search-terms>. With no search terms, a dump of all messages in the
- database will be generated. A "--" argument instructs notmuch that the
+ database will be generated. A <b>--</b> argument instructs notmuch that the
remaining arguments are search terms.
Supported options for <b>dump</b> include
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
<b>--decrypt=(false|auto|true)</b>
If <b>true</b>, decrypt any MIME encrypted parts found in the selected con‐
tent (i.e., "multipart/encrypted" parts). Status of the decryption
- will be reported (currently only supported with --format=json and
- --format=sexp), and on successful decryption the multipart/encrypted
+ will be reported (currently only supported with <b>--format=json</b> and
+ <b>--format=sexp</b>), and on successful decryption the multipart/encrypted
part will be replaced by the decrypted content.
If <b>auto</b>, and a session key is already known for the message, then it
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
<b>threads</b>
Output the thread IDs of all threads with any message
- matching the search terms, either one per line (--for‐
- mat=text), separated by null characters (--format=text0),
- as a JSON array (--format=json), or an S-Expression list
- (--format=sexp).
+ matching the search terms, either one per line (<b>--for-</b>
+ <b>mat=text</b>), separated by null characters (<b>--format=text0</b>),
+ as a JSON array (<b>--format=json</b>), or an S-Expression list
+ (<b>--format=sexp</b>).
<b>messages</b>
Output the message IDs of all messages matching the
- search terms, either one per line (--format=text), sepa‐
- rated by null characters (--format=text0), as a JSON
- array (--format=json), or as an S-Expression list (--for‐
- mat=sexp).
+ search terms, either one per line (<b>--format=text</b>), sepa‐
+ rated by null characters (<b>--format=text0</b>), as a JSON
+ array (<b>--format=json</b>), or as an S-Expression list (<b>--for-</b>
+ <b>mat=sexp</b>).
<b>files</b> Output the filenames of all messages matching the search
- terms, either one per line (--format=text), separated by
- null characters (--format=text0), as a JSON array (--for‐
- mat=json), or as an S-Expression list (--format=sexp).
+ terms, either one per line (<b>--format=text</b>), separated by
+ null characters (<b>--format=text0</b>), as a JSON array (<b>--for-</b>
+ <b>mat=json</b>), or as an S-Expression list (<b>--format=sexp</b>).
Note that each message may have multiple filenames asso‐
ciated with it. All of them are included in the output
- (unless limited with the --duplicate=N option). This may
+ (unless limited with the <b>--duplicate=N</b> option). This may
be particularly confusing for <b>folder:</b> or <b>path:</b> searches
in a specified directory, as the messages may have dupli‐
cates in other directories that are included in the out‐
search.
<b>tags</b> Output all tags that appear on any message matching the
- search terms, either one per line (--format=text), sepa‐
- rated by null characters (--format=text0), as a JSON
- array (--format=json), or as an S-Expression list (--for‐
- mat=sexp).
+ search terms, either one per line (<b>--format=text</b>), sepa‐
+ rated by null characters (<b>--format=text0</b>), as a JSON
+ array (<b>--format=json</b>), or as an S-Expression list (<b>--for-</b>
+ <b>mat=sexp</b>).
<b>--sort=</b>(<b>newest-first</b>|<b>oldest-first</b>)
This option can be used to present results in either chronologi‐
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
<pre>
<b>notmuch</b> <b>count</b> [option ...] <<u>search-term</u>> ...
- <b>notmuch</b> <b>dump</b> [--format=(batch-tag|sup)] [--] [--output=<<u>file</u>>] [--]
+ <b>notmuch</b> <b>dump</b> [--gzip] [--format=(batch-tag|sup)] [--output=<<u>file</u>>] [--]
[<<u>search-term</u>> ...]
<b>notmuch</b> <b>reindex</b> [option ...] <<u>search-term</u>> ...
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
is termed "mboxrd" format and described in detail here:
<u>http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html</u>
- <b>raw</b> (default if --part is given)
+ <b>raw</b> (default if <b>--part</b> is given)
Write the raw bytes of the given MIME part of a message
to standard out. For this format, it is an error to spec‐
ify a query that matches more than one message.
<b>--verify</b>
Compute and report the validity of any MIME cryptographic signa‐
- tures found in the selected content (ie. "multipart/signed"
+ tures found in the selected content (e.g., "multipart/signed"
parts). Status of the signature will be reported (currently only
- supported with --format=json and --format=sexp), and the multi‐
+ supported with <b>--format=json</b> and <b>--format=sexp</b>), and the multi‐
part/signed part will be replaced by the signed data.
<b>--decrypt=(false|auto|true|stash)</b>
If <b>true</b>, decrypt any MIME encrypted parts found in the selected
- content (i.e. "multipart/encrypted" parts). Status of the
+ content (e.g., "multipart/encrypted" parts). Status of the
decryption will be reported (currently only supported with
- --format=json and --format=sexp) and on successful decryption
+ <b>--format=json</b> and <b>--format=sexp</b>) and on successful decryption
the multipart/encrypted part will be replaced by the decrypted
content.
excluded message will be marked with the exclude flag (except
when output=mbox when there is nowhere to put the flag).
- If --entire-thread is specified then complete threads are
+ If <b>--entire-thread</b> is specified then complete threads are
returned regardless (with the excluded flag being set when
appropriate) but threads that only match in an excluded message
are not returned when <b>--exclude=true.</b>
<b>--include-html</b>
Include "text/html" parts as part of the output (currently only
- supported with --format=json and --format=sexp). By default,
+ supported with <b>--format=json</b> and <b>--format=sexp</b>). By default,
unless <b>--part=N</b> is used to select a specific part or
<b>--include-html</b> is used to include all "text/html" parts, no part
with content type "text/html" is included in the output.
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>
2009-2018, Carl Worth and many others
</pre>
-<h2>0.27</h2>
+<h2>0.28</h2>