From 4f0e88ae004d726b13730a0ee255259b177a91d3 Mon Sep 17 00:00:00 2001
From: Antoine Levy-Lambert <antoine@apache.org>
Date: Thu, 10 Aug 2006 17:37:14 +0000
Subject: [PATCH] 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 | 33 ++++++++++++++++++++++++++-------
 xdocs/mail.xml | 32 +++++++++++++++++++++++++-------
 2 files changed, 51 insertions(+), 14 deletions(-)

diff --git a/docs/mail.html b/docs/mail.html
index 26e368d5b..2bdfb395d 100644
--- a/docs/mail.html
+++ b/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>
diff --git a/xdocs/mail.xml b/xdocs/mail.xml
index 7229ba9da..bab9df145 100644
--- a/xdocs/mail.xml
+++ b/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>