mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-12-28 20:31:43 +01:00
142 lines
3.7 KiB
Groff
142 lines
3.7 KiB
Groff
.TH NOTMUCH-TAG 1 2013-12-30 "Notmuch 0.17"
|
|
.SH NAME
|
|
notmuch-tag \- add/remove tags for all messages matching the search terms
|
|
|
|
.SH SYNOPSIS
|
|
.B notmuch tag
|
|
.RI [ options "...] +<" tag ">|\-<" tag "> [...] [\-\-] <" search-term "> [...]"
|
|
|
|
.B notmuch tag
|
|
.RI "--batch"
|
|
.RI "[ --input=<" filename "> ]"
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
Add/remove tags for all messages matching the search terms.
|
|
|
|
See \fBnotmuch-search-terms\fR(7)
|
|
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 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
|
|
an initial search term beginning with '+' or '\-' is provided
|
|
by allowing the user to specify a "\-\-" argument to separate
|
|
the tags from the search terms.
|
|
|
|
.B "notmuch tag"
|
|
updates the maildir flags according to tag changes if the
|
|
.B "maildir.synchronize_flags"
|
|
configuration option is enabled. See \fBnotmuch-config\fR(1) for
|
|
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
|
|
|
|
Read batch tagging operations from a file (stdin by default). This is more
|
|
efficient than repeated
|
|
.B notmuch tag
|
|
invocations. See
|
|
.B TAG FILE FORMAT
|
|
below for the input format. This option is not compatible with
|
|
specifying tagging on the command line.
|
|
.RE
|
|
|
|
.RS 4
|
|
.TP 4
|
|
.BR "\-\-input=" <filename>
|
|
|
|
Read input from given file, instead of from stdin. Implies
|
|
.BR --batch .
|
|
|
|
.SH TAG FILE FORMAT
|
|
|
|
The input must consist of lines of the format:
|
|
|
|
.RI "+<" tag ">|\-<" tag "> [...] [\-\-] <" query ">"
|
|
|
|
Each line is interpreted similarly to
|
|
.B notmuch tag
|
|
command line arguments. The delimiter is one or more spaces ' '. Any
|
|
characters in
|
|
.RI < tag >
|
|
.B 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>
|
|
.B must
|
|
be hex-encoded as %20. Any characters that are not
|
|
part of
|
|
.RI < tag >
|
|
.B must not
|
|
be hex-encoded.
|
|
|
|
In the future tag:"tag with spaces" style quoting may be supported for
|
|
.RI < tag >
|
|
as well;
|
|
for this reason all double quote characters in
|
|
.RI < tag >
|
|
.B should
|
|
be hex-encoded.
|
|
|
|
The
|
|
.RI < 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
|
|
examples).
|
|
|
|
Leading and trailing space ' ' is ignored. Empty lines and lines
|
|
beginning with '#' are ignored.
|
|
|
|
.SS 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
|
|
of the tag
|
|
.B space in tags
|
|
.
|
|
.RS
|
|
.nf
|
|
+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)"""
|
|
.fi
|
|
.RE
|
|
|
|
.SH SEE ALSO
|
|
|
|
\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\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),
|