]> git.notmuchmail.org Git - notmuch/blobdiff - man/man1/notmuch-dump.1
notmuch-dump: remove deprecated positional argument for output file
[notmuch] / man / man1 / notmuch-dump.1
index 71925b054214badcb2b8993923a81b120efb17b1..5d1e197258acf60a1a4a9125c87b7035011075ec 100644 (file)
@@ -1,25 +1,18 @@
-.TH NOTMUCH-DUMP 1 2011-12-04 "Notmuch 0.10.2"
+.TH NOTMUCH-DUMP 1 2012-06-01 "Notmuch 0.13.2"
 .SH NAME
-notmuch-dump \- Creates a plain-text dump of the tags of each message.
+notmuch-dump \- creates a plain-text dump of the tags of each message
 
 .SH SYNOPSIS
 
 .B "notmuch dump"
-.RI "[ <" filename "> ] [--]"
+.RI "[ --output=<" filename "> ] [--]"
 .RI "[ <" search-term ">...]"
 
-.B "notmuch restore"
-.RB [ "--accumulate" ]
-.RI "[ <" filename "> ]"
-
 .SH DESCRIPTION
 
-.SS DUMP
-
 Dump tags for messages matching the given search terms.
 
-Output is to the given filename, if any, or to stdout.  Note that
-using the filename argument is deprecated.
+Output is to the given filename, if any, or to stdout.
 
 These tags are the only data in the notmuch database that can't be
 recreated from the messages themselves.  The output of notmuch dump is
@@ -30,26 +23,14 @@ With no search terms, a dump of all messages in the database will be
 generated.  A "--" argument instructs notmuch that the
 remaining arguments are search terms.
 
-.SS RESTORE
-
-Restores the tags from the given file (see
-.BR "notmuch dump" ")."
+See \fBnotmuch-search-terms\fR(7)
+for details of the supported syntax for <search-terms>.
 
-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.
 .RE
+.SH SEE ALSO
 
-See the
-.B "SEARCH SYNTAX"
-section below for details of the supported syntax for <search-terms>.
-.RE
+\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
+\fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1), \fBnotmuch-reply\fR(1),
+\fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
+\fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
+\fBnotmuch-tag\fR(1)