git.notmuchmail.org Git - notmuch/blob - notmuch-reply.1

   1 .TH NOTMUCH-REPLY 1 2011-12-04 "Notmuch 0.10.2"
   2 .SH NAME
   3 notmuch-reply \- Constructs a reply template for a set of messages.
   4
   5 .SH SYNOPSIS
   6
   7 .B notmuch reply
   8 .RI "[" options "...] <" search-term ">..."
   9
  10 .SH DESCRIPTION
  11
  12 Constructs a reply template for a set of messages.
  13
  14 To make replying to email easier,
  15 .B notmuch reply
  16 takes an existing set of messages and constructs a suitable mail
  17 template. The Reply-to header (if any, otherwise From:) is used for
  18 the To: address. Vales from the To: and Cc: headers are copied, but
  19 not including any of the current user's email addresses (as configured
  20 in primary_mail or other_email in the .notmuch\-config file) in the
  21 recipient list
  22
  23 It also builds a suitable new subject, including Re: at the front (if
  24 not already present), and adding the message IDs of the messages being
  25 replied to to the References list and setting the In\-Reply\-To: field
  26 correctly.
  27
  28 Finally, the original contents of the emails are quoted by prefixing
  29 each line with '> ' and included in the body.
  30
  31 The resulting message template is output to stdout.
  32
  33 Supported options for
  34 .B reply
  35 include
  36 .RS
  37 .TP 4
  38 .BR \-\-format= ( default | headers\-only )
  39 .RS
  40 .TP 4
  41 .BR default
  42 Includes subject and quoted message body.
  43 .TP
  44 .BR headers\-only
  45 Only produces In\-Reply\-To, References, To, Cc, and Bcc headers.
  46 .RE
  47
  48 See the
  49 .B "SEARCH SYNTAX"
  50 section below for details of the supported syntax for <search-terms>.
  51
  52 Note: It is most common to use
  53 .B "notmuch reply"
  54 with a search string matching a single message, (such as
  55 id:<message-id>), but it can be useful to reply to several messages at
  56 once. For example, when a series of patches are sent in a single
  57 thread, replying to the entire thread allows for the reply to comment
  58 on issue found in multiple patches.
  59 .RE
  60 .RE