X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-restore-1.mdwn;h=87869c9b61f8882212e0f7ed8dcd2d636fe44cdb;hb=0b22ed1b4e640539ae8e6f78f1ea88e54426a50d;hp=f6646fc9f2463245a58ca4570cd3325cdd827c59;hpb=01b1bc7553d0b0ebf35ac3016c83240b4151ad59;p=obsolete%2Fnotmuch-wiki diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn index f6646fc..87869c9 100644 --- a/manpages/notmuch-restore-1.mdwn +++ b/manpages/notmuch-restore-1.mdwn @@ -1,58 +1,67 @@

NOTMUCH-RESTORE(1)

NAME

- 
-       notmuch-restore  -  Restores  the tags from the given file (see notmuch
-       dump).
+       notmuch-restore  -  restores  the tags from the given file (see notmuch
+       dump)

SYNOPSIS

- 
-       notmuch restore [--accumulate] [ <filename> ]
+       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.
-
-
-       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 notmuch restore command provides you a way
-       to import all of your tags (or labels as sup calls them).
-
+ Supported options for restore include -
-       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.
-
+ --accumulate -
-       See  notmuch-search-terms(7)  for  details  of the supported syntax for
-       .
-
+ 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. -
-       notmuch restore updates the maildir flags according to tag  changes  if
-       the maildir.synchronize_flags configuration option is enabled. See not-
-       much-config(1) for details.
+           --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 com-
+                   patible with the format of files produced by sup-dump.   So
+                   if you've previously been using sup for mail, then the not-
+                   much 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  whites-
+                   pace  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  for-
+                   mat contains no parentheses, should be accurate.

SEE ALSO

- 
-       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not-
-       much-hooks(5),   notmuch-new(1),  notmuch-reply(1),  notmuch-search(1),
-       notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
+       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
+       much-hooks(5),  notmuch-new(1),  notmuch-reply(1),   notmuch-search(1),
+       notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
-

Notmuch 0.13.2

+

Notmuch 0.15