notmuch reply: Add (incomplete) reply command

Reviewed-by: Carl Worth <cworth@cworth.org>

Keith wrote all the code here against notmuch before notmuch.c was
split up into multiple files. So I've pushed the code around in
various ways to match the new code structure, but have generally tried
to avoid making any changes to the behavior of the code.

I did fix one bug---a missing call to g_mime_stream_file_set_owner in
show_part which would cause "notmuch show" to go off into the weeds
when trying to show multiple messages, (since the first stream would
fclose stdout).

1 files changed, 19 insertions, 0 deletions

diff --git a/notmuch.1 b/notmuch.1
index 75820710..6c3d10fd 100644
--- a/notmuch.1
+++ b/notmuch.1
@@ -167,6 +167,25 @@ operators, but will have to be protected from interpretation by the
 shell, (such as by putting quotation marks around any parenthesized
 expression).
 .TP
+.BR reply " <search-term>..."
+
+Constructs a reply template for a set of messages.
+
+See the documentation of
+.B search
+for deatils of the supported syntax of search terms.
+
+To make replying to email easier,
+.B notmuch reply
+takes an existing set of messages and constructs a suitable mail
+template, taking From: and To: messages and using those for the new
+To: address; copying Cc: addresses, building a suitable new subject
+including Re: at the front, adding the old message IDs to the
+References list and setting the In-Reply-To: field correctly.
+
+The resulting message template is output to stdout.
+
+.TP
 .BR show " <search-term>..."
 
 Shows all messages matching the search terms.