]> git.notmuchmail.org Git - notmuch/blobdiff - man/man1/notmuch-tag.1
version: set new version and release date
[notmuch] / man / man1 / notmuch-tag.1
index 48c80fdc4bf9efdb6c6e2b25fe1a132ff1aac485..c8685ea41a5feca8b166f479a814777e37bd2ca5 100644 (file)
@@ -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),