X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=doc%2Fman1%2Fnotmuch-dump.rst;h=1e4468e62507b10c7b356a27dd3678714b187e14;hp=94986a86bba5b6dfaee06b42e2160f8917c1eea3;hb=5fb0f5f113e7cb7422fb44bb7abcba2bcadfc0c8;hpb=07dff496304d6dc2e8033a18691b095ed9cd212f diff --git a/doc/man1/notmuch-dump.rst b/doc/man1/notmuch-dump.rst index 94986a86..1e4468e6 100644 --- a/doc/man1/notmuch-dump.rst +++ b/doc/man1/notmuch-dump.rst @@ -71,24 +71,32 @@ Supported options for **dump** include characters. Note also that tags with spaces will not be correctly restored with this format. - ``--include=(config|tags)`` + ``--include=(config|properties|tags)`` Control what kind of metadata is included in the output. **config** - Output configuration data stored in the database. Each line - starts with "#@ ", followed by a space seperated key-value - pair. Both key and value are hex encoded if needed. + 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. + + **properties** + + Output per-message (key,value) metadata. Each line starts + with "#= ", followed by a message id, and a space separated + list of key=value pairs. Ids, keys and values are hex + encoded if needed. **tags** - Output per-message metadata, namely tags. See *format* above - for description of the output. + Output per-message boolean metadata, namely tags. See *format* above + for description of the output. - The default is to include both tags and configuration - information. As of version 2 of the dump format, there is a - header line of the following form + The default is to include all available types of data. The + option can be specified multiple times to select some subset. As + of version 3 of the dump format, there is a header line of the + following form | | #notmuch-dump <*format*>:<*version*> <*included*>