NOTMUCH-RESTORE(1) notmuch NOTMUCH-RESTORE(1)NAMEnotmuch-restore - restores the tags from the given file (see notmuch
dump)
SYNOPSIS
notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)]
[--input=<filename>]
DESCRIPTION
Restores the tags from the given file (see notmuch dump).
The input is read from the given filename, if any, or from stdin.
Supported options for restore include
--accumulate
The union of the existing and new tags is applied, instead of
replacing each message's tags as they are read in from the
dump file.
--format=(sup|batch-tag|auto)
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 notmuch-dump(1).
sup The sup dump file format is specifically chosen to be
compatible with the format of files produced by
sup-dump. So if you've previously been using sup for
mail, then the notmuch restore command provides you a
way to import all of your tags (or labels as sup calls
them).
batch-tag
The batch-tag dump format is intended to more robust
against malformed message-ids and tags containing
whitespace or non-ascii(7) characters. See not‐
much-dump(1) for details on this format.
notmuch restore updates the maildir flags according to
tag changes if the maildir.synchronize_flags configu‐
ration option is enabled. See notmuch-config(1) for
details.
auto 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 format contains no parentheses, should be
accurate.
--input=<filename>
Read input from given file instead of stdin.
GZIPPED INPUT
notmuch restore will detect if the input is compressed in gzip(1) for‐
mat and automatically decompress it while reading. This detection does
not depend on file naming and in particular works for standard input.
SEE ALSOnotmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
much-hooks(5), notmuch-insert(1), notmuch-new(1), notmuch-reply(1),
notmuch-search(1), notmuch-search-terms(7), notmuch-show(1), not‐
much-tag(1)AUTHOR
Carl Worth and many others
COPYRIGHT
2014, Carl Worth and many others
0.20.2 February 18, 2016 NOTMUCH-RESTORE(1)
