- With no search terms, a dump of all messages in the database
- will be generated. A "--" argument instructs notmuch that the
- remaining arguments are search terms.
+ <b>--include=(config|properties|tags)</b>
+
+ Control what kind of metadata is included in the output.
+ <b>config</b>
+ Output configuration data stored in the database. Each line
+ starts with "#@ ", followed by a space separated key-value
+ pair. Both key and value are hex encoded if needed.
+
+ <b>properties</b>
+ Output per-message (key,value) metadata. Each line starts
+ with "#= ", followed by a message id, and a space separated
+ list of key=value pairs. pair. Ids, keys and values are hex
+ encoded if needed.
+
+ <b>tags</b>
+ Output per-message boolean metadata, namely tags. See <u>format</u>
+ above for description of the output.
+
+ The default is to include all available types of data. The
+ option can be specified multiple times to select some subset. As
+ of version 2 of the dump format, there is a header line of the
+ following form
+
+ #notmuch-dump <<u>format</u>>:<<u>version</u>> <<u>included</u>>
+
+ where <<u>included</u>> is a comma separated list of the above options.