git.notmuchmail.org Git - notmuch/blob - man/man1/notmuch-restore.1

   1 .TH NOTMUCH-RESTORE 1 2012-06-01 "Notmuch 0.13.2"
   2 .SH NAME
   3 notmuch-restore \- restores the tags from the given file (see notmuch dump)
   4
   5 .SH SYNOPSIS
   6
   7 .B "notmuch restore"
   8 .RB [ "--accumulate" ]
   9 .RI "[ <" filename "> ]"
  10
  11 .SH DESCRIPTION
  12
  13 Restores the tags from the given file (see
  14 .BR "notmuch dump" ")."
  15
  16 The input is read from the given filename, if any, or from stdin.
  17
  18 Note: The dump file format is specifically chosen to be
  19 compatible with the format of files produced by sup-dump.
  20 So if you've previously been using sup for mail, then the
  21 .B "notmuch restore"
  22 command provides you a way to import all of your tags (or labels as
  23 sup calls them).
  24
  25 The --accumulate switch causes the union of the existing and new tags to be
  26 applied, instead of replacing each message's tags as they are read in from the
  27 dump file.
  28
  29 See \fBnotmuch-search-terms\fR(7)
  30 for details of the supported syntax for <search-terms>.
  31
  32 .B "notmuch restore"
  33 updates the maildir flags according to tag changes if the
  34 .B "maildir.synchronize_flags"
  35 configuration option is enabled. See \fBnotmuch-config\fR(1) for
  36 details.
  37
  38 .RE
  39 .SH SEE ALSO
  40
  41 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
  42 \fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1),
  43 \fBnotmuch-reply\fR(1), \fBnotmuch-search\fR(1),
  44 \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
  45 \fBnotmuch-tag\fR(1)