cli: optionally restore message properties from dump file
[notmuch] / doc / man1 / notmuch-restore.rst
index 706f891274b1e41514c1f519613fef5ae4e33514..c681fa2d18bdf4dcd94a07b83a90005907585b84 100644 (file)
@@ -50,7 +50,7 @@ Supported options for **restore** include
             format, this heuristic, based the fact that batch-tag format
             contains no parentheses, should be accurate.
 
-    ``--include=(config|tags)``
+    ``--include=(config|properties|tags)``
 
       Control what kind of metadata is restored.
 
@@ -60,13 +60,20 @@ Supported options for **restore** include
          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.  pair.  Ids, keys and values are
+         hex encoded if needed.
+
        **tags**
 
          Output per-message metadata, namely tags. See *format* above
          for more details.
 
-      The default is to restore both tags and configuration
-      information
+      The default is to restore all available types of data.  The
+      option can be specified multiple times to select some subset.
 
     ``--input=``\ <filename>
         Read input from given file instead of stdin.