NOTMUCH-RESTORE(1)

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

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

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 ALSO

       notmuch(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.18