X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=man%2Fman1%2Fnotmuch-tag.1;h=c8685ea41a5feca8b166f479a814777e37bd2ca5;hp=48c80fdc4bf9efdb6c6e2b25fe1a132ff1aac485;hb=80b25792b2fdbb7f495556db360148798e224930;hpb=37be45767fef9348300bb45c82efd474bb01651f diff --git a/man/man1/notmuch-tag.1 b/man/man1/notmuch-tag.1 index 48c80fdc..c8685ea4 100644 --- a/man/man1/notmuch-tag.1 +++ b/man/man1/notmuch-tag.1 @@ -1,10 +1,10 @@ -.TH NOTMUCH-TAG 1 2013-01-07 "Notmuch 0.15" +.TH NOTMUCH-TAG 1 2013-07-28 "Notmuch 0.16" .SH NAME notmuch-tag \- add/remove tags for all messages matching the search terms .SH SYNOPSIS .B notmuch tag -.RI "+<" tag ">|\-<" tag "> [...] [\-\-] <" search-term "> [...]" +.RI [ options "...] +<" tag ">|\-<" tag "> [...] [\-\-] <" search-term "> [...]" .B notmuch tag .RI "--batch" @@ -20,8 +20,8 @@ for details of the supported syntax for .RI < search-term >. Tags prefixed by '+' are added while those prefixed by '\-' are -removed. For each message, tag removal is performed before tag -addition. +removed. For each message, tag changes are applied in the order they +appear on the command line. The beginning of the search terms is recognized by the first argument that begins with neither '+' nor '\-'. Support for @@ -38,6 +38,16 @@ details. Supported options for .B tag include +.RS 4 +.TP 4 +.BR \-\-remove\-all + +Remove all tags from each message matching the search terms before +applying the tag changes appearing on the command line. This means +setting the tags of each message to the tags to be added. If there are +no tags to be added, the messages will have no tags. +.RE + .RS 4 .TP 4 .BR \-\-batch @@ -125,7 +135,8 @@ of the tag .SH SEE ALSO \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1), -\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1), +\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), +\fBnotmuch-insert\fR(1), \fBnotmuch-new\fR(1), \fBnotmuch-reply\fR(1), \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1), \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),