X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;fp=manpages%2Fnotmuch-tag-1.mdwn;h=354ce463352cb9da47f5d6b6b63fb085221cdfe8;hb=29654905e64093a5275f4a554527231072efccb9;hp=f6873a1810e6d97307a75b600d0b70624916129f;hpb=7d54dd0a00b59674569997f8fc4a71590f6dc970;p=notmuch-wiki diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index f6873a1..354ce46 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -35,23 +35,22 @@ 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 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. + --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

@@ -60,21 +59,21 @@ +<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‐ @@ -83,8 +82,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 *
@@ -101,8 +100,8 @@
 
 
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(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),
 

@@ -114,7 +113,7 @@
 
 
COPYRIGHT

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

 
-
0.24

+
0.26