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)