X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;h=f989972c51cea5ed2211f4c73d2d0565174a3f6e;hb=58425548f54e38f06b7cc6bc8083bc20009c8472;hp=1f0b8ca41dd175e365419e43c8b2621bcaea369e;hpb=0b22ed1b4e640539ae8e6f78f1ea88e54426a50d;p=notmuch-wiki
diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn
index 1f0b8ca..f989972 100644
--- a/manpages/notmuch-tag-1.mdwn
+++ b/manpages/notmuch-tag-1.mdwn
@@ -8,9 +8,9 @@
SYNOPSIS
- notmuch tag +<tag>|-<tag> [...] [--] <search-term> [...]
+ notmuch tag [options ...] +<tag>|-<tag> [--] <search-term> ...
- notmuch tag --batch [ --input=<filename> ]
+ notmuch tag --batch [--input=<filename>]
DESCRIPTION
@@ -30,22 +30,28 @@
specify a "--" argument to separate the tags from the search terms.
notmuch tag updates the maildir flags according to tag changes if the
- maildir.synchronize_flags configuration option is enabled. See notmuch-
- config(1) for details.
+ maildir.synchronize_flags configuration option is enabled. See notâ
+ much-config(1) for details.
Supported options for tag include
- --batch
-
- Read batch tagging operations from a file (stdin by default).
- This is more efficient than repeated notmuch tag invocations.
- See TAG FILE FORMAT below for the input format. This option is
- not compatible with specifying tagging on the command line.
-
- --input=<filename>
-
- Read input from given file, instead of from stdin. Implies
- --batch.
+ --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 mesâ
+ sages will have no tags.
+
+ --batch
+ Read batch tagging operations from a file (stdin by default).
+ This is more efficient than repeated notmuch tag invocations.
+ See TAG FILE FORMAT below for the input format. This option
+ is not compatible with specifying tagging on the command
+ line.
+
+ --input=<filename>
+ Read input from given file, instead of from stdin. Implies
+ --batch.
TAG FILE FORMAT
@@ -54,49 +60,61 @@
+<tag>|-<tag> [...] [--] <query>
- Each line is interpreted similarly to notmuch tag command line argu-
+ 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.
+ 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.
- 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-
+ Leading and trailing space ' ' is ignored. Empty lines and lines beginâ
ning with '#' are ignored.
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)
- +found::it -- tag:foo::bar%
- # ignore this line and the next
-
- +space%20in%20tags -- Two
- # add tag '(tags)', among other stunts.
- +crazy{ +(tags) +&are +#possible -- tag:"space in tags"
- +match*crazy -- tag:crazy{
- +some_tag -- id:"this is ""nauty)"""
+
+ +winner *
+ +foo::bar%25 -- (One and Two) or (One and tag:winner)
+ +found::it -- tag:foo::bar%
+ # ignore this line and the next
+
+ +space%20in%20tags -- Two
+ # add tag '(tags)', among other stunts.
+ +crazy{ +(tags) +&are +#possible\ -- tag:"space in tags"
+ +match*crazy -- tag:crazy{
+ +some_tag -- id:"this is ""nauty)"""
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),
+
+
+AUTHOR
+
+ Carl Worth and many others
+
+
+COPYRIGHT
+
+ 2009-2016, Carl Worth and many others
-Notmuch 0.15
+0.22.1