X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-restore-1.mdwn;h=75d8bf1e4b6b8d63d0ea16f56771ff466114d2f4;hb=219490b75a85ca18d449168575a0c7538e71612e;hp=98e46d805a37e9d9555c1e23f5511ec0b8f6d060;hpb=dd8c0d25288488dc30b41c04c35bdd552bf04e71;p=notmuch-wiki
diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn
index 98e46d8..75d8bf1 100644
--- a/manpages/notmuch-restore-1.mdwn
+++ b/manpages/notmuch-restore-1.mdwn
@@ -8,84 +8,88 @@
SYNOPSIS
- notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)]
- [--input=<filename>]
+ notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)] [--inâ
+ put=<filename>]
DESCRIPTION
- 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
- 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|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 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 seperâ
- ated key-value pair. Both key and value are hex encoded
+
+ 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.
- tags
- Output per-message metadata, namely tags. See format
+ 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 both tags and configuration informaâ
- tion
+ 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.
+ --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
@@ -95,7 +99,7 @@
COPYRIGHT
- 2009-2016, Carl Worth and many others
+ 2009-2022, Carl Worth and many others
-0.22.1
+0.35