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 Tags prefixed by '+' are added while those prefixed by '\-' are
  14 removed. For each message, tag removal is performed before tag
  15 addition.
  16
  17 The beginning of <search-terms> is recognized by the first
  18 argument that begins with neither '+' nor '\-'. Support for
  19 an initial search term beginning with '+' or '\-' is provided
  20 by allowing the user to specify a "\-\-" argument to separate
  21 the tags from the search terms.
  22
  23 See the
  24 .B "SEARCH SYNTAX"
  25 section below for details of the supported syntax for <search-terms>.
  26 .RE