X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=manpages%2Fnotmuch-tag-1.mdwn;h=45df3e89b27f5fc8fec6df6062772526efdb64d9;hp=5685a39843d8a1320ffcc1dad1abb311fe50911f;hb=e4734d2e839d916a78d295c76eff880574c327db;hpb=c63cba0c3c8f17697612a900fe41a308b878cd23 diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index 5685a39..45df3e8 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -30,31 +30,28 @@ 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- + 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. + --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.

TAG FILE FORMAT

@@ -63,7 +60,7 @@ +<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, @@ -77,10 +74,10 @@ 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- + 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. @@ -90,23 +87,23 @@ 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 + +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)""" + +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-
+       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-restore(1),  notmuch-search(1),  notmuch-search-terms(7),  not‐
        much-show(1),
@@ -120,4 +117,4 @@ 2014, Carl Worth and many others -

0.18

+

0.20.1