mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-11-24 20:08:10 +01:00
ff4e81ac57
Add internal hyperlink targets for man pages and cross-reference them using the any role reference. There are a number of alternatives to accomplish this, but this seems like the combination that retains the man page section number and the same boldface style in the man pages. As a bonus, we get sanity checking on the links; for example notmuch-search-terms.rst had a reference to notmuch-properties(1) i.e. the wrong section. The obvious semantic follow-up change would be to only have meaningful "see also" references instead of having them all everywhere.
101 lines
3.3 KiB
ReStructuredText
101 lines
3.3 KiB
ReStructuredText
.. _notmuch-restore(1):
|
|
|
|
===============
|
|
notmuch-restore
|
|
===============
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
**notmuch** **restore** [--accumulate] [--format=(auto|batch-tag|sup)] [--input=<*filename*>]
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
Restores the tags from the given file (see :any:`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 :any:`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 :any:`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 :any:`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 configuration
|
|
line starts with "#@ ", followed by a space separated
|
|
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 :any:`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 option
|
|
can be specified multiple times to select some subset.
|
|
|
|
``--input=``\ <filename>
|
|
Read input from given file instead of stdin.
|
|
|
|
GZIPPED INPUT
|
|
=============
|
|
|
|
\ **notmuch restore** will detect if the input is compressed in
|
|
:manpage:`gzip(1)` format and automatically decompress it while
|
|
reading. This detection does not depend on file naming and in
|
|
particular works for standard input.
|
|
|
|
SEE ALSO
|
|
========
|
|
|
|
:any:`notmuch(1)`,
|
|
:any:`notmuch-config(1)`,
|
|
:any:`notmuch-count(1)`,
|
|
:any:`notmuch-dump(1)`,
|
|
:any:`notmuch-hooks(5)`,
|
|
:any:`notmuch-insert(1)`,
|
|
:any:`notmuch-new(1)`,
|
|
:any:`notmuch-properties(7)`,
|
|
:any:`notmuch-reply(1)`,
|
|
:any:`notmuch-search(1)`,
|
|
:any:`notmuch-search-terms(7)`,
|
|
:any:`notmuch-show(1)`,
|
|
:any:`notmuch-tag(1)`
|