X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-dump-1.mdwn;h=2caf27821bb15e33cbb14a4da082049faa0b0cdb;hb=6562766d20047abcb3bab0d88a1e5849baaae76d;hp=7a94088fe3d6165306101d4da990efaa5ad136db;hpb=0add150ffd941ea7ed64a9116929aaf2daa927a5;p=notmuch-wiki diff --git a/manpages/notmuch-dump-1.mdwn b/manpages/notmuch-dump-1.mdwn index 7a94088..2caf278 100644 --- a/manpages/notmuch-dump-1.mdwn +++ b/manpages/notmuch-dump-1.mdwn @@ -22,24 +22,19 @@ therefore the only critical thing to backup (and much more friendly to incremental backup than the native database files.) - --gzip - - Compress the output in a format compatible with gzip(1). + --gzip Compress the output in a format compatible with gzip(1). --format=(sup|batch-tag) - Notmuch restore supports two plain text dump formats, both with one message-id per line, followed by a list of tags. batch-tag - The default batch-tag dump format is intended to more robust against malformed message-ids and tags containing whitespace or non-ascii(7) characters. Each line has the form - - +<encoded-tag> +<encoded-tag> ... -- id:<quoted-mes- - sage-id> + +<encoded-tag> +<encoded-tag> ... -- id:<quoted-mes‐ + sage-id> Tags are hex-encoded by replacing every byte not matching the regex [A-Za-z0-9@=.,_+-] with %nn where nn is the two @@ -49,38 +44,35 @@ with a double quote, it must be enclosed in double quotes and double quotes inside the ID must be doubled. The astute reader will notice this is a special case of the - batch input format for notmuch-tag(1); note that the sin- + batch input format for notmuch-tag(1); note that the sin‐ gle message-id query is mandatory for notmuch-restore(1). - sup - - The sup dump file format is specifically chosen to be + 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 + notmuch restore command provides you a way to import all of your tags (or labels as sup calls them). Each line has the following form - - <message-id> ( <tag> ... ) + <message-id> ( <tag> ... ) with zero or more tags are separated by spaces. Note that - (malformed) message-ids may contain arbitrary non-null - characters. Note also that tags with spaces will not be + (malformed) message-ids may contain arbitrary non-null + characters. Note also that tags with spaces will not be correctly restored with this format. - With no search terms, a dump of all messages in the database - will be generated. A "--" argument instructs notmuch that the + With no search terms, a dump of all messages in the database + will be generated. A "--" argument instructs notmuch that the remaining arguments are search terms. - See notmuch-search-terms(7) for details of the supported syntax + See notmuch-search-terms(7) for details of the supported syntax for <search-terms>.

SEE ALSO

-       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-hooks(5), not-
-       much-insert(1), notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
-       notmuch-search(1),   notmuch-search-terms(7),   notmuch-show(1),   not-
+       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-hooks(5), not‐
+       much-insert(1),  notmuch-new(1),  notmuch-reply(1), notmuch-restore(1),
+       notmuch-search(1),   notmuch-search-terms(7),   notmuch-show(1),   not‐
        much-tag(1)
@@ -94,4 +86,4 @@ 2014, Carl Worth and many others -

0.18

+

0.18.1