X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-restore-1.mdwn;h=75d8bf1e4b6b8d63d0ea16f56771ff466114d2f4;hb=c53d121cfc5e56594ffa3bb7250e04e2cc30587e;hp=a01cb3845f920c248e04adcd6a9fa46d5d4adc03;hpb=24d033149e3e920d201ef80b91e06e8ba441f416;p=notmuch-wiki diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn index a01cb38..75d8bf1 100644 --- a/manpages/notmuch-restore-1.mdwn +++ b/manpages/notmuch-restore-1.mdwn @@ -8,60 +8,98 @@
- notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)] [ - --input=<filename> ] + notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)] [--inâ + put=<filename>]
- Restores the tags from the given file (see notmuch dump). + Restores the tags from the given file (see notmuch-dump(1)). The input is read from the given filename, if any, or from stdin. 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 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 deâ + tails. + + 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â + ration line starts with "#@ ", followed by a space sepaâ + rated key-value pair. Both key and value are hex encoded + if needed. + + 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. Ids, keys and values + are hex encoded if needed. See notmuch-properties(7) for + more details. + + tags Restore per-message metadata, namely tags. See format + above for more details. + + The default is to restore all available types of data. The opâ + tion can be specified multiple times to select some subset. + + --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. +
+ 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 +
+ 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) +- 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. +
+ Carl Worth and many others-
- 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) + 2009-2022, Carl Worth and many others-