git.notmuchmail.org Git - notmuch/blob - man/man1/notmuch-tag.1

   1 .TH NOTMUCH-TAG 1 2011-12-04 "Notmuch 0.10.2"
   2 .SH NAME
   3 notmuch-tag \- Add/remove tags for all messages matching the search terms.
   4
   5 .SH SYNOPSIS
   6 .B notmuch tag
   7 .RI  "+<" tag> "|\-<" tag "> [...] [\-\-] <" search-term ">..."
   8
   9 .SH DESCRIPTION
  10
  11 Add/remove tags for all messages matching the search terms.
  12
  13 See \fBnotmuch-search-terms\fR(7)
  14 for details of the supported syntax for <search-terms>.
  15
  16 Tags prefixed by '+' are added while those prefixed by '\-' are
  17 removed. For each message, tag removal is performed before tag
  18 addition.
  19
  20 The beginning of <search-terms> is recognized by the first
  21 argument that begins with neither '+' nor '\-'. Support for
  22 an initial search term beginning with '+' or '\-' is provided
  23 by allowing the user to specify a "\-\-" argument to separate
  24 the tags from the search terms.
  25
  26 .B "notmuch tag"
  27 updates the maildir flags according to tag changes if the
  28 .B "maildir.synchronize_flags"
  29 configuration option is enabled. See \fBnotmuch-config\fR(1) for
  30 details.
  31
  32 .SH SEE ALSO
  33
  34 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
  35 \fBnotmuch-dump\fR(5), \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1),
  36 \fBnotmuch-part\fR(1), \fBnotmuch-reply\fR(1),
  37 \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
  38 \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1)