X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=manpages%2Fnotmuch-restore-1.mdwn;h=1d7bdd9decd2f4f60b565dc1593514ec694792db;hp=a01cb3845f920c248e04adcd6a9fa46d5d4adc03;hb=e4734d2e839d916a78d295c76eff880574c327db;hpb=24d033149e3e920d201ef80b91e06e8ba441f416 diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn index a01cb38..1d7bdd9 100644 --- a/manpages/notmuch-restore-1.mdwn +++ b/manpages/notmuch-restore-1.mdwn @@ -8,8 +8,8 @@

SYNOPSIS

-       notmuch  restore   [--accumulate]   [--format=(auto|batch-tag|sup)]   [
-       --input=<filename> ]
+       notmuch    restore    [--accumulate]    [--format=(auto|batch-tag|sup)]
+       [--input=<filename>]

DESCRIPTION

@@ -20,48 +20,67 @@ 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 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. + --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 configu‐ + ration 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. + + --input=<filename> + Read input from given file instead of stdin. + - 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. +

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.
+
- auto +

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)
+
- 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. +

AUTHOR

+
+       Carl Worth and many others
-

SEE ALSO

+

COPYRIGHT

-       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)
+       2014, Carl Worth and many others
-

Notmuch 0.15.2

+

0.20.1