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

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