db464d8070f3cee1d0d8ebdd1b2a83ff4df70bbe
[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 .RE
48
49 See \fBnotmuch-search-terms\fR(7)
50 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
61
62 .SH SEE ALSO
63
64 \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
65 \fBnotmuch-dump\fR(5), \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1),
66 \fBnotmuch-part\fR(1), \fBnotmuch-restore\fR(1),
67 \fBnotmuch-search\fR(1), \fBnotmuch-search-terms\fR(7),
68 \fBnotmuch-show\fR(1), \fBnotmuch-tag\fR(1)