- <b>notmuch</b> <b>restore</b> updates the maildir flags according to tag changes if
- the <b>maildir.synchronize</b>_<b>flags</b> configuration option is enabled. See <a href='../notmuch-config-1/'>not-</a>
- <a href='../notmuch-config-1/'>much-config</a>(1) for details.
+ <b>--format=(sup|batch-tag|auto)</b>
+
+ Notmuch restore supports two plain text dump formats, with each
+ line specifying a message-id and a set of tags. For details of
+ the actual formats, see <a href='../notmuch-dump-1/'>notmuch-dump</a>(1).
+
+ <b>sup</b> The <b>sup</b> dump file format is specifically chosen to be com-
+ patible with the format of files produced by sup-dump. So
+ if you've previously been using sup for mail, then the <b>not-</b>
+ <b>much</b> <b>restore</b> command provides you a way to import all of
+ your tags (or labels as sup calls them).
+
+ <b>batch-tag</b>
+
+ The <b>batch-tag</b> dump format is intended to more robust
+ against malformed message-ids and tags containing whites-
+ pace or non-<b>ascii</b>(7) characters. See <a href='../notmuch-dump-1/'>notmuch-dump</a>(1) for
+ details on this format.
+
+ <b>notmuch</b> <b>restore</b> updates the maildir flags according to tag
+ changes if the <b>maildir.synchronize</b>_<b>flags</b> configuration
+ option is enabled. See <a href='../notmuch-config-1/'>notmuch-config</a>(1) for details.
+
+ <b>auto</b>
+
+ This option (the default) tries to guess the format from
+ the input. For correctly formed input in either supported
+ format, this heuristic, based the fact that batch-tag for-
+ mat contains no parentheses, should be accurate.