git.cworth.org Git - notmuch-wiki/blob - manpages/notmuch-tag-1.mdwn

   1 <h1>NOTMUCH-TAG(1)</h1>
   2
   3 <h2>NAME</h2>
   4
   5 <pre>
   6        notmuch-tag  -  Add/remove  tags  for  all messages matching the search
   7        terms.
   8 </pre>
   9
  10 <h2>SYNOPSIS</h2>
  11
  12 <pre>
  13        <b>notmuch</b> <b>tag</b> +<<u>tag></u>|-<<u>tag</u>> [...] [--] <<u>search-term</u>>...
  14 </pre>
  15
  16 <h2>DESCRIPTION</h2>
  17
  18 <pre>
  19        Add/remove tags for all messages matching the search terms.
  20 </pre>
  21
  22 <pre>
  23        See <b>notmuch-search-terms</b>(7) for details of  the  supported  syntax  for
  24        <search-terms>.
  25 </pre>
  26
  27 <pre>
  28        Tags prefixed by '+' are added while those prefixed by '-' are removed.
  29        For each message, tag removal is performed before tag addition.
  30 </pre>
  31
  32 <pre>
  33        The beginning of <search-terms> is recognized  by  the  first  argument
  34        that  begins  with  neither  '+' nor '-'. Support for an initial search
  35        term beginning with '+' or '-' is provided  by  allowing  the  user  to
  36        specify a "--" argument to separate the tags from the search terms.
  37 </pre>
  38
  39 <pre>
  40        <b>notmuch</b>  <b>tag</b>  updates the maildir flags according to tag changes if the
  41        <b>maildir.synchronize</b>_<b>flags</b> configuration option is enabled. See <b>notmuch-</b>
  42        <b>config</b>(1) for details.
  43 </pre>
  44
  45 <h2>SEE ALSO</h2>
  46
  47 <pre>
  48        <b>notmuch</b>(1),  <b>notmuch-config</b>(1), <b>notmuch-count</b>(1), <b>notmuch-dump</b>(1), <b>not-</b>
  49        <b>much-hooks</b>(5),  <b>notmuch-new</b>(1),  <b>notmuch-reply</b>(1),  <b>notmuch-restore</b>(1),
  50        <b>notmuch-search</b>(1), <b>notmuch-search-terms</b>(7), <b>notmuch-show</b>(1),
  51 </pre>
  52
  53 <h1>Notmuch 0.13.2</h1>