X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;h=cb0df554c33d2ed74c30e8d53a86d7c5826f6070;hb=56a7ce71e3b208ca556bf0318c407e2156ab25d0;hp=a7c52bc797a61349902e978003d5d92688151422;hpb=e9e606f333685696ecc9979b8813b0838b9e969e;p=obsolete%2Fnotmuch-wiki diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index a7c52bc..cb0df55 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -2,13 +2,15 @@
- notmuch-tag - Add/remove tags for all messages matching the search - terms. + notmuch-tag - add/remove tags for all messages matching the search + terms
- notmuch tag +<tag>|-<tag> [...] [--] <search-term>... + notmuch tag +<tag>|-<tag> [...] [--] <search-term> [...] + + notmuch tag --batch [ --input=<filename> ]
+ The input must consist of lines of the format: + + +<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. + + 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- + ples). + + Leading and trailing space ' ' is ignored. Empty lines and lines begin- + ning with '#' are ignored. ++ +
+ 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)"""
- notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not- + 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),-