unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
blob debc50502275e316a18aea4eff1f30ceea80613d 2826 bytes (raw)
name: man/man1/notmuch-reply.1 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
.TH NOTMUCH-REPLY 1 2012-02-29 "Notmuch 0.12~rc1"
.SH NAME
notmuch-reply \- Constructs a reply template for a set of messages.

.SH SYNOPSIS

.B notmuch reply
.RI "[" options "...] <" search-term ">..."

.SH DESCRIPTION

Constructs a reply template for a set of messages.

To make replying to email easier,
.B notmuch reply
takes an existing set of messages and constructs a suitable mail
template. The Reply-to: header (if any, otherwise From:) is used for
the To: address. Unless
.BR \-\-reply-to=sender
is specified, values from the To: and Cc: headers are copied, but not
including any of the current user's email addresses (as configured in
primary_mail or other_email in the .notmuch\-config file) in the
recipient list.

It also builds a suitable new subject, including Re: at the front (if
not already present), and adding the message IDs of the messages being
replied to to the References list and setting the In\-Reply\-To: field
correctly.

Finally, the original contents of the emails are quoted by prefixing
each line with '> ' and included in the body.

The resulting message template is output to stdout.

Supported options for
.B reply
include
.RS
.TP 4
.BR \-\-format= ( default | json | headers\-only )
.RS
.TP 4
.BR default
Includes subject and quoted message body.
.TP
.BR json
Produces JSON output containing headers for a reply message and the
contents of the original message. This output can be used by a client
to create a reply message intelligently.
.TP
.BR headers\-only
Only produces In\-Reply\-To, References, To, Cc, and Bcc headers.
.RE
.RE
.RS
.TP 4
.BR \-\-reply\-to= ( all | sender )
.RS
.TP 4
.BR all " (default)"
Replies to all addresses.
.TP 4
.BR sender
Replies only to the sender. If replying to user's own message
(Reply-to: or From: header is one of the user's configured email
addresses), try To:, Cc:, and Bcc: headers in this order, and copy
values from the first that contains something other than only the
user's addresses.
.RE
.RE

See \fBnotmuch-search-terms\fR(7)
for details of the supported syntax for <search-terms>.

Note: It is most common to use
.B "notmuch reply"
with a search string matching a single message, (such as
id:<message-id>), but it can be useful to reply to several messages at
once. For example, when a series of patches are sent in a single
thread, replying to the entire thread allows for the reply to comment
on issues found in multiple patches. The default format supports
replying to multiple messages at once, but the JSON format does not.
.RE
.RE

.SH SEE ALSO

\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
\fBnotmuch-dump\fR(5), \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1),
\fBnotmuch-part\fR(1), \fBnotmuch-restore\fR(1),
\fBnotmuch-search\fR(1), \fBnotmuch-search-terms\fR(7),
\fBnotmuch-show\fR(1), \fBnotmuch-tag\fR(1)

debug log:

solving debc505 ...
found debc505 in https://yhetil.org/notmuch/1331699416-30775-7-git-send-email-awg+notmuch@xvx.ca/ ||
	https://yhetil.org/notmuch/1331525142-30539-7-git-send-email-awg+notmuch@xvx.ca/
found 7ed7f0f in https://yhetil.org/notmuch.git/
preparing index
index prepared:
100644 7ed7f0f0f77534c432468f9f91e09e1dec0c68a2	man/man1/notmuch-reply.1

applying [1/1] https://yhetil.org/notmuch/1331699416-30775-7-git-send-email-awg+notmuch@xvx.ca/
diff --git a/man/man1/notmuch-reply.1 b/man/man1/notmuch-reply.1
index 7ed7f0f..debc505 100644

Checking patch man/man1/notmuch-reply.1...
Applied patch man/man1/notmuch-reply.1 cleanly.

skipping https://yhetil.org/notmuch/1331525142-30539-7-git-send-email-awg+notmuch@xvx.ca/ for debc505
index at:
100644 debc50502275e316a18aea4eff1f30ceea80613d	man/man1/notmuch-reply.1

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).