X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=manpages%2Fnotmuch-restore-1.mdwn;h=1b22757c80d7d5e9608b9d8a4c8190415fe8100b;hp=c0f17827ed33c6422bd8417c8a7bbfa5b5871356;hb=29654905e64093a5275f4a554527231072efccb9;hpb=7d54dd0a00b59674569997f8fc4a71590f6dc970 diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn index c0f1782..1b22757 100644 --- a/manpages/notmuch-restore-1.mdwn +++ b/manpages/notmuch-restore-1.mdwn @@ -20,78 +20,76 @@ 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 - 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. - - --include=(config|properties|tags) + --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 white‐ + space 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 configura‐ + tion 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. + + --include=(config|properties|tags) Control what kind of metadata is restored. - config - Restore configuration data to the database. Each configu‐ + + config Restore configuration data to the database. Each configu‐ ration line starts with "#@ ", followed by a space sepa‐ rated key-value pair. Both key and value are hex encoded if needed. - properties - Output per-message (key,value) metadata. Each line + properties + Restore per-message (key,value) metadata. Each line starts with "#= ", followed by a message id, and a space - separated list of key=value pairs. pair. Ids, keys and - values are hex encoded if needed. + separated list of key=value pairs. Ids, keys and values + are hex encoded if needed. See notmuch-properties(7) for + more details. - tags - Output per-message metadata, namely tags. See format + tags Restore per-message metadata, namely tags. See format above for more details. - The default is to restore all available types of data. The + The default is to restore all available types of data. The option can be specified multiple times to select some subset. - --input=<filename> - Read input from given file instead of stdin. + --input=<filename> + Read input from given file instead of stdin.

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

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)
+       notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not‐
+       much-hooks(5),   notmuch-insert(1),   notmuch-new(1),   notmuch-proper‐
+       ties(7),  notmuch-reply(1), notmuch-search(1), notmuch-search-terms(7),
+       notmuch-show(1), notmuch-tag(1)

AUTHOR

@@ -101,7 +99,7 @@

COPYRIGHT

-       2009-2017, Carl Worth and many others
+       2009-2018, Carl Worth and many others
-

0.24

+

0.26