From: Kevin McCarthy <kevin@8t8.us>
Date: Mon, 30 Apr 2018 23:17:52 +0000 (-0700)
Subject: Add more explanation of known vs subscribed lists to manual.
X-Git-Tag: neomutt-20180512~13^2~3
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=dfd7bb5e4e4f5874e9ecbba8db470e2aeb87f8f3;p=neomutt

Add more explanation of known vs subscribed lists to manual.

Mention in both the "Mailing Lists" and "Handling Mailing Lists"
sections the difference between known and subscribed mailing lists.

Note that the Mail-Followup-To header is generated if any of the
recipients are known mailing lists.  If any of those are subscribed
mailing lists, the sender's address will not be in the header.  If all
of them are known (but not subscribed), the sender's address will be
added to the header.
---

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index bfff7166d..d22b6a305 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -5105,10 +5105,13 @@ unignore posted-to:
         specifying the list address via the <command>lists</command> command
         (except the group feature). Once you have done this, the
         <link linkend="list-reply"><literal>&lt;list-reply&gt;</literal></link>
-        function will work for all known lists. Additionally, when you send
-        a message to a subscribed list, NeoMutt will add a Mail-Followup-To
-        header to tell other users' mail user agents not to send copies of
-        replies to your personal address.
+        function will work for all known lists. Additionally, when you send a
+        message to a known list and <link linkend="followup-to">$followup_to</link>
+        is set, Mutt will add a Mail-Followup-To header.  For unsubscribed
+        lists, this will include your personal address, ensuring you receive a
+        copy of replies.  For subscribed mailing lists, the header will not,
+        telling other users' mail user agents not to send copies of replies to
+        your personal address.
       </para>
       <note>
         <para>
@@ -8539,15 +8542,17 @@ roessler@does-not-exist.org        Thomas Roessler mutt pgp
       <para>
         NeoMutt also supports the <literal>Mail-Followup-To</literal> header.
         When you send a message to a list of recipients which includes one or
-        several subscribed mailing lists, and if the
+        several known mailing lists, and if the
         <link linkend="followup-to">$followup_to</link> option is set, NeoMutt
-        will generate a Mail-Followup-To header which contains all the
-        recipients to whom you send this message, but not your address. This
-        indicates that group-replies or list-replies (also known as
+        will generate a Mail-Followup-To header.  If any of the recipients are
+        subscribed mailing lists, this header will contain all the recipients
+        to whom you send this message, but not your address. This indicates
+        that group-replies or list-replies (also known as
         <quote>followups</quote>) to this message should only be sent to the
-        original recipients of the message, and not separately to you – you'll
+        original recipients of the message, and not separately to you - you'll
         receive your copy through one of the mailing lists you are subscribed
-        to.
+        to.  If none of the recipients are subscribed mailing lists, the header
+        will also contain your address, ensuring you receive a copy of replies.
       </para>
       <para>
         Conversely, when group-replying or list-replying to a message which has