docs: Update news, man page, and online help for restore --accumulate

As a side effect, reformat the NEWs entry for notmuch dump for
consistency with the notmuch restore NEWS submitted by Thomas
Schwinge.
This commit is contained in:
David Bremner 2011-10-21 19:09:49 -03:00
parent 903fe63986
commit 3ae8ac6ace
3 changed files with 25 additions and 8 deletions

13
NEWS
View file

@ -1,7 +1,16 @@
Notmuch 0.10 (2011-xx-xx) Notmuch 0.10 (2011-xx-xx)
=========================
notmuch dump changes New command-line features
-------------------- -------------------------
Add "notmuch restore --accumulate" option
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.
Add search terms to "notmuch dump"
The dump command now takes an optional search term much like notmuch The dump command now takes an optional search term much like notmuch
search/show/tag. The output file argument of dump is deprecated in search/show/tag. The output file argument of dump is deprecated in

View file

@ -480,7 +480,7 @@ section below for details of the supported syntax for <search-terms>.
.RE .RE
.TP .TP
.BR restore " <filename>" .BR restore " [--accumulate] [<filename>]"
Restores the tags from the given file (see Restores the tags from the given file (see
.BR "notmuch dump" ")." .BR "notmuch dump" ")."
@ -493,6 +493,10 @@ So if you've previously been using sup for mail, then the
.B "notmuch restore" .B "notmuch restore"
command provides you a way to import all of your tags (or labels as command provides you a way to import all of your tags (or labels as
sup calls them). sup calls them).
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.
.RE .RE
The The

View file

@ -393,13 +393,17 @@ static command_t commands[] = {
"\tSee \"notmuch help search-terms\" for the search-term syntax.\n" "\tSee \"notmuch help search-terms\" for the search-term syntax.\n"
}, },
{ "restore", notmuch_restore_command, { "restore", notmuch_restore_command,
"<filename>", "[--accumulate] [<filename>]",
"Restore the tags from the given dump file (see 'dump').", "Restore the tags from the given dump file (see 'dump').",
"\tInput is read from the given filename, if any, or from stdin.\n"
"\tNote: The dump file format is specifically chosen to be\n" "\tNote: The dump file format is specifically chosen to be\n"
"\tcompatible with the format of files produced by sup-dump.\n" "\tcompatible with the format of files produced by sup-dump.\n"
"\tSo if you've previously been using sup for mail, then the\n" "\tSo if you've previously been using sup for mail, then the\n"
"\t\"notmuch restore\" command provides you a way to import\n" "\t\"notmuch restore\" command provides you a way to import\n"
"\tall of your tags (or labels as sup calls them)." }, "\tall of your tags (or labels as sup calls them).\n"
"\tThe --accumulate switch causes the union of the existing and new\n"
"\ttags to be applied, instead of replacing each message's tags as\n"
"\tthey are read in from the dump file."},
{ "config", notmuch_config_command, { "config", notmuch_config_command,
"[get|set] <section>.<item> [value ...]", "[get|set] <section>.<item> [value ...]",
"Get or set settings in the notmuch configuration file.", "Get or set settings in the notmuch configuration file.",