X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;h=354ce463352cb9da47f5d6b6b63fb085221cdfe8;hb=591299b2f4b15f6ef7e8c308ead9c3a30b7c7563;hp=595dc06939da1e1d5b4b94ddfd87a621c98a3232;hpb=59c3b4d66ce19a9dde85e65d5fc5c150e23de209;p=notmuch-wiki diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index 595dc06..354ce46 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -8,9 +8,9 @@

SYNOPSIS

-       notmuch tag [options...] +<tag>|-<tag> [...] [--] <search-term> [...]
+       notmuch tag [options ...] +<tag>|-<tag> [--] <search-term> ...
 
-       notmuch tag --batch [ --input=<filename> ]
+       notmuch tag --batch [--input=<filename>]

DESCRIPTION

@@ -30,30 +30,27 @@ 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 - --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). - 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 messages 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

@@ -62,50 +59,61 @@ +<tag>|-<tag> [...] [--] <query> - 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. + 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. - 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-insert(1),  notmuch-new(1),   notmuch-reply(1),
-       notmuch-restore(1),  notmuch-search(1),  notmuch-search-terms(7),  not-
+       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.17

+

AUTHOR

+
+       Carl Worth and many others
+
+ +

COPYRIGHT

+
+       2009-2018, Carl Worth and many others
+
+ +

0.26