1 <h1>NOTMUCH-RESTORE(1)</h1>
5 notmuch-restore - restores the tags from the given file (see notmuch
11 <b>notmuch</b> <b>restore</b> [<b>--accumulate</b>] [<b>--format=(auto|batch-tag|sup)</b>] [
12 --input=<<u>filename</u>> ]
17 Restores the tags from the given file (see <b>notmuch</b> <b>dump</b>).
19 The input is read from the given filename, if any, or from stdin.
21 Supported options for <b>restore</b> include
25 The union of the existing and new tags is applied, instead of
26 replacing each message's tags as they are read in from the dump
29 <b>--format=(sup|batch-tag|auto)</b>
31 Notmuch restore supports two plain text dump formats, with each
32 line specifying a message-id and a set of tags. For details of
33 the actual formats, see <a href='../notmuch-dump-1/'>notmuch-dump</a>(1).
35 <b>sup</b> The <b>sup</b> dump file format is specifically chosen to be com-
36 patible with the format of files produced by sup-dump. So
37 if you've previously been using sup for mail, then the <b>not-</b>
38 <b>much</b> <b>restore</b> command provides you a way to import all of
39 your tags (or labels as sup calls them).
43 The <b>batch-tag</b> dump format is intended to more robust
44 against malformed message-ids and tags containing whites-
45 pace or non-<b>ascii</b>(7) characters. See <a href='../notmuch-dump-1/'>notmuch-dump</a>(1) for
46 details on this format.
48 <b>notmuch</b> <b>restore</b> updates the maildir flags according to tag
49 changes if the <b>maildir.synchronize</b>_<b>flags</b> configuration
50 option is enabled. See <a href='../notmuch-config-1/'>notmuch-config</a>(1) for details.
54 This option (the default) tries to guess the format from
55 the input. For correctly formed input in either supported
56 format, this heuristic, based the fact that batch-tag for-
57 mat contains no parentheses, should be accurate.
62 <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
63 <a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-insert-1/'>notmuch-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
64 <a href='../notmuch-search-1/'>notmuch-search</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-</a>
65 <a href='../notmuch-tag-1/'>tag</a>(1)