aboutsummaryrefslogtreecommitdiff
path: root/man/man1/notmuch-restore.1
diff options
context:
space:
mode:
authorJameson Graef Rollins <jrollins@finestructure.net>2011-12-26 22:36:32 -0800
committerDavid Bremner <bremner@debian.org>2011-12-31 15:16:32 -0400
commitf079f5f931e40eb57abd93c5d0d6de515f48eafd (patch)
tree2322b65e68ac005194b052b250980b40a7aeec8e /man/man1/notmuch-restore.1
parent77b8d70600193cf9e4d84a4281de6da0d5224c3b (diff)
break up dump and restore man pages.
These functions are enough different in their behavior that it's not really worth it to combine them. They overlap in the format of the dump file, but we can have a separate page that describes the dump format, and either reference it or include it. This also keeps things nice and clean with one page per command.
Diffstat (limited to 'man/man1/notmuch-restore.1')
-rw-r--r--[l---------]man/man1/notmuch-restore.140
1 files changed, 39 insertions, 1 deletions
diff --git a/man/man1/notmuch-restore.1 b/man/man1/notmuch-restore.1
index b7a4d1b..2191df0 120000..100644
--- a/man/man1/notmuch-restore.1
+++ b/man/man1/notmuch-restore.1
@@ -1 +1,39 @@
-notmuch-dump.1 \ No newline at end of file
+.TH NOTMUCH-RESTORE 1 2011-12-04 "Notmuch 0.10.2"
+.SH NAME
+notmuch-restore \- Restores the tags from the given file (see notmuch dump).
+
+.SH SYNOPSIS
+
+.B "notmuch restore"
+.RB [ "--accumulate" ]
+.RI "[ <" filename "> ]"
+
+.SH DESCRIPTION
+
+Restores the tags from the given file (see
+.BR "notmuch dump" ")."
+
+The input is read from the given filename, if any, or from stdin.
+
+Note: The 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
+.B "notmuch restore"
+command provides you a way to import all of your tags (or labels as
+sup calls them).
+
+The --accumulate switch causes the union of the existing and new tags to be
+applied, instead of replacing each message's tags as they are read in from the
+dump file.
+
+See \fBnotmuch-search-terms\fR(7)
+for details of the supported syntax for <search-terms>.
+
+.RE
+.SH SEE ALSO
+
+\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
+\fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1), \fBnotmuch-part\fR(1),
+\fBnotmuch-reply\fR(1), \fBnotmuch-dump\fR(1),
+\fBnotmuch-search\fR(1), \fBnotmuch-search-terms\fR(7),
+\fBnotmuch-show\fR(1), \fBnotmuch-tag\fR(1)