X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;h=ca9a9a76909593adf7787859485910de463e4131;hb=760f12a345a43a282e9286fb2018741c0a59fbc8;hp=1e5fa16baa6174dd6a7eeabb3707029dba908b51;hpb=01b1bc7553d0b0ebf35ac3016c83240b4151ad59;p=notmuch-wiki diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index 1e5fa16..ca9a9a7 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -1,53 +1,120 @@
- 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 [options ...] +<tag>|-<tag> [--] <search-term> ... + + notmuch tag --batch [--input=<filename>]
Add/remove tags for all messages matching the search terms. + + See notmuch-search-terms(7) for details of the supported syntax for + <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. + + notmuch tag updates the maildir flags according to tag changes if the + 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 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.+
- See notmuch-search-terms(7) for details of the supported syntax for -+. + 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.
- Tags prefixed by '+' are added while those prefixed by '-' are removed. - For each message, tag removal is performed before tag addition. + 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)"""+
- The beginning of+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. + 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 tag updates the maildir flags according to tag changes if the - maildir.synchronize_flags configuration option is enabled. See notmuch- - config(1) for details. + Carl Worth and many others-
- 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), + 2009-2016, Carl Worth and many others-