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=notmuch-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 - Restores the tags from the given file (see notmuch - dump). + notmuch-restore - restores the tags from the given file (see notmuch + dump)
- notmuch restore [--accumulate] [ <filename> ] + notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)] [ + --input=<filename> ]
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.
- 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)-