eb23925b2389d7f0398c68e1ef55d586deca7847
[notmuch] / man / man1 / 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