man: document notmuch tag --remove-all

diff --git a/man/man1/notmuch-tag.1 b/man/man1/notmuch-tag.1
index 0052ca2195e1e9cb38ce74d8733864f6e2dc999a..c7d7a4d344c2f63beb7664c36a87cf013b82a486 100644 (file)
--- a/man/man1/notmuch-tag.1
+++ b/man/man1/notmuch-tag.1
@@ -4,7 +4,7 @@ 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"
@@ -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