NAME

       notmuch-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 notmuch-dump(1) for  details  on  this
                   format.

                   notmuch   restore   updates   the   maildir   flags   according   to   tag   changes  if  the
                   maildir.synchronize_flags configuration 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.

SEE ALSO

       notmuch(1), notmuch-config(1), notmuch-count(1),  notmuch-dump(1),  notmuch-hooks(5),  notmuch-insert(1),
       notmuch-new(1),  notmuch-reply(1),  notmuch-search(1), notmuch-search-terms(7), notmuch-show(1), notmuch-
       tag(1)

Notmuch 0.17                                       2013-12-30                                 NOTMUCH-RESTORE(1)