X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;h=595dc06939da1e1d5b4b94ddfd87a621c98a3232;hb=59c3b4d66ce19a9dde85e65d5fc5c150e23de209;hp=1f0b8ca41dd175e365419e43c8b2621bcaea369e;hpb=0b22ed1b4e640539ae8e6f78f1ea88e54426a50d;p=notmuch-wiki
diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn
index 1f0b8ca..595dc06 100644
--- a/manpages/notmuch-tag-1.mdwn
+++ b/manpages/notmuch-tag-1.mdwn
@@ -8,7 +8,7 @@
SYNOPSIS
- notmuch tag +<tag>|-<tag> [...] [--] <search-term> [...]
+ notmuch tag [options...] +<tag>|-<tag> [...] [--] <search-term> [...]
notmuch tag --batch [ --input=<filename> ]
@@ -35,6 +35,14 @@
Supported options for tag include
+ --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.
+
--batch
Read batch tagging operations from a file (stdin by default).
@@ -54,21 +62,21 @@
+<tag>|-<tag> [...] [--] <query>
- Each line is interpreted similarly to notmuch tag command line argu-
- ments. The delimiter is one or more spaces ' '. Any characters in <tag>
- may be hex-encoded with %NN where NN is the hexadecimal value of the
- character. To hex-encode a character with a multi-byte UTF-8 encoding,
- hex-encode each byte. Any spaces in <tag> must be hex-encoded as %20.
- Any characters that are not part of <tag> must not be hex-encoded.
+ Each line is interpreted similarly to notmuch tag command line
+ arguments. The delimiter is one or more spaces ' '. Any characters in
+ <tag> may be hex-encoded with %NN where NN is the hexadecimal value of
+ the character. To hex-encode a character with a multi-byte UTF-8 encod-
+ ing, hex-encode each byte. Any spaces in <tag> must be hex-encoded as
+ %20. Any characters that are not part of <tag> must not be hex-encoded.
- In the future tag:"tag with spaces" style quoting may be supported for
- <tag> as well; for this reason all double quote characters in <tag>
+ In the future tag:"tag with spaces" style quoting may be supported for
+ <tag> as well; for this reason all double quote characters in <tag>
should be hex-encoded.
- The <query> should be quoted using Xapian boolean term quoting rules:
- if a term contains whitespace or a close paren or starts with a double
- quote, it must be enclosed in double quotes (not including any prefix)
- and double quotes inside the term must be doubled (see below for exam-
+ The <query> should be quoted using Xapian boolean term quoting rules:
+ if a term contains whitespace or a close paren or starts with a double
+ quote, it must be enclosed in double quotes (not including any prefix)
+ and double quotes inside the term must be doubled (see below for exam-
ples).
Leading and trailing space ' ' is ignored. Empty lines and lines begin-
@@ -77,8 +85,8 @@
EXAMPLE
- The following shows a valid input to batch tagging. Note that only the
- isolated '*' acts as a wildcard. Also note the two different quotings
+ The following shows a valid input to batch tagging. Note that only the
+ isolated '*' acts as a wildcard. Also note the two different quotings
of the tag space in tags
+winner *
+foo::bar%25 -- (One and Two) or (One and tag:winner)
@@ -94,9 +102,10 @@
SEE ALSO
- notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
- much-hooks(5), notmuch-new(1), notmuch-reply(1), notmuch-restore(1),
- notmuch-search(1), notmuch-search-terms(7), notmuch-show(1),
+ notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
+ much-hooks(5), notmuch-insert(1), notmuch-new(1), notmuch-reply(1),
+ notmuch-restore(1), notmuch-search(1), notmuch-search-terms(7), not-
+ much-show(1),
-Notmuch 0.15
+Notmuch 0.17