reintroduced a blurb about the mail headers, explaining how the return-path header helps find out which email address is subscribed.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@430452 13f79535-47bb-0310-9956-ffa450edef68

docs/mail.html

@@ -188,13 +188,6 @@
                                 <p>To subscribe to a mailinglist use the links below. In your first email you will get some
       information about working with the list manager <a href="http://www.ezmlm.org/">EZMLM</a>.</p>
                                       <h4 class="subsection">
-        <a name="How to unsubscribe your old email address"></a>
-        How to unsubscribe your old email address
-      </h4>
-                        <p> To stop subscription for the address john@host.domain , send an email to <pre>dev-unsubscribe-john=host.domain@ant.apache.org</pre>
-          or to  <pre>user-unsubscribe-john=host.domain@ant.apache.org</pre>.
-        </p>
-                                                          <h4 class="subsection">
         <a name="User List"></a>
         User List
       </h4>
@@ -227,6 +220,32 @@
         build tool meet and discuss issues, code changes/additions,
         etc. Subscribers to this list get notices of each and every
         code change, build results, testing notices, etc.</p>
+                                                          <h4 class="subsection">
+        <a name="How to unsubscribe your old email address"></a>
+        How to unsubscribe your old email address
+      </h4>
+                        <p>
+        First, find out the particular email adress to which ezmlm is sending.
+        The email headers are visible in Microsoft Outlook via the messages menu
+        "View | Options".
+        <pre>
+        Microsoft Mail Internet Headers Version 2.0
+        ...
+        List-Unsubscribe: &lt;mailto:user-unsubscribe@ant.apache.org&gt;
+        List-Help: &lt;mailto:user-help@ant.apache.org&gt;
+        List-Post: &lt;mailto:user@ant.apache.org&gt;
+        List-Id: "Ant Users List" &lt;user.ant.apache.org&gt;
+        Reply-To: "Ant Users List" &lt;user@ant.apache.org&gt;
+        Delivered-To: mailing list user@ant.apache.org
+        ...
+        Return-Path: user-return-12345-<i>john=host.domain</i>@ant.apache.org
+        ...
+        </pre>
+        The <i>Return-Path</i> header contains the email address which is subscribed. 
+        </p>
+                                <p> To stop subscription for the address john@host.domain , send an email to <pre>dev-unsubscribe-john=host.domain@ant.apache.org</pre>
+          or to  <pre>user-unsubscribe-john=host.domain@ant.apache.org</pre>.
+        </p>
                                     
     </div>
   </div>

xdocs/mail.xml

@@ -48,13 +48,6 @@
       <p>To subscribe to a mailinglist use the links below. In your first email you will get some
       information about working with the list manager <a href="http://www.ezmlm.org/">EZMLM</a>.</p>
 
-      <subsection name="How to unsubscribe your old email address">
-        <p> To stop subscription for the address john@host.domain , send an email to <pre>dev-unsubscribe-john=host.domain@ant.apache.org</pre>
-          or to  <pre>user-unsubscribe-john=host.domain@ant.apache.org</pre>.
-        </p>  
-      </subsection>
-
-
       <subsection name="User List">
         <p>
           <b>High Traffic</b>
@@ -87,6 +80,31 @@
         etc. Subscribers to this list get notices of each and every
         code change, build results, testing notices, etc.</p>
       </subsection>
+
+      <subsection name="How to unsubscribe your old email address">
+        <p>
+        First, find out the particular email adress to which ezmlm is sending.
+        The email headers are visible in Microsoft Outlook via the messages menu
+        "View | Options".
+        <pre>
+        Microsoft Mail Internet Headers Version 2.0
+        ...
+        List-Unsubscribe: &lt;mailto:user-unsubscribe@ant.apache.org&gt;
+        List-Help: &lt;mailto:user-help@ant.apache.org&gt;
+        List-Post: &lt;mailto:user@ant.apache.org&gt;
+        List-Id: "Ant Users List" &lt;user.ant.apache.org&gt;
+        Reply-To: "Ant Users List" &lt;user@ant.apache.org&gt;
+        Delivered-To: mailing list user@ant.apache.org
+        ...
+        Return-Path: user-return-12345-<i>john=host.domain</i>@ant.apache.org
+        ...
+        </pre>
+        The <i>Return-Path</i> header contains the email address which is subscribed. 
+        </p>      
+        <p> To stop subscription for the address john@host.domain , send an email to <pre>dev-unsubscribe-john=host.domain@ant.apache.org</pre>
+          or to  <pre>user-unsubscribe-john=host.domain@ant.apache.org</pre>.
+        </p>  
+      </subsection>
     </section>
 
   </body>