doc/reply: Clarify how reply-to header is handled
authorMichal Sojka <sojkam1@fel.cvut.cz>
Tue, 29 Dec 2015 21:55:40 +0000 (22:55 +0100)
committerDavid Bremner <david@tethera.net>
Mon, 14 Mar 2016 23:34:17 +0000 (20:34 -0300)
Current documentation and comments in the code do not correspond to
the actual code and tests in the test suite ("Un-munging Reply-To" in
T230-reply-to-sender.sh). Fix it.

doc/man1/notmuch-reply.rst
notmuch-reply.c

index cfbd4ea8dd190cc3d72370b7b01f151bd56a3ca9..d73f8f1c4ffd03da5889f1cbf9f17c48e5591c9b 100644 (file)
@@ -13,8 +13,10 @@ DESCRIPTION
 Constructs a reply template for a set of messages.
 
 To make replying to email easier, **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
+set of messages and constructs a suitable mail template. Its To:
+address is set according to the original email in this way: if the
+Reply-to: header is present and different from any To:/Cc: address it
+is used, otherwise From: header is used. Unless
 ``--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
index 6df54fc992bb39b2f61e115b83f53555e05c00a0..3c6d685cbd6054c68a0281e696e747c8045aff57 100644 (file)
@@ -332,7 +332,7 @@ add_recipients_from_message (GMimeMessage *reply,
      * field and use the From header. This ensures the original sender
      * will get the reply even if not subscribed to the list. Note
      * that the address in the Reply-To header will always appear in
-     * the reply.
+     * the reply if reply_all is true.
      */
     if (reply_to_header_is_redundant (message)) {
        reply_to_map[0].header = "from";