Add a note about unsubscribe from the mailinglist.

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

docs/mail.html

@@ -185,6 +185,32 @@
           <li><a href="http://ant.apache.org/mail/">Full mbox archives of all lists</a></li>
           <li><a href="http://marc.theaimsgroup.com/">Mailing list Archives</a></li>
         </ul>
+                                <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>.
+      But <a href="http://marc.theaimsgroup.com/?l=ant-user&amp;m=115020655600019&amp;w=2">several times</a>
+      there were problems with unsubscribing from a mailinglist. The problem is that you use another
+      email adress for unsubscribing than for subscribing and ezmlm could not find that adress for
+      deleting from the list. So you have to find out, to which concrete email adress ezmlm is sending
+      the mail. This is visible in the email headers (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-<i>12345-Jan.Materne=me.acme.com</i>@ant.apache.org
+      ...
+      </pre>
+      As you can see, you'll get the help information with each mail, too.
+      But more important is the <i>Return-Path</i>. If you change "return" into "unsubscribe" and you send 
+      an  email to that adress (<tt>user-unsubscribe-12345-Jan.Materne=me.acme.com@ant.apache.org</tt>) 
+      this  will unsubscribe you. 
+      </p>
                                       <h4 class="subsection">
         <a name="User List"></a>
         User List

xdocs/mail.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
-   Copyright 2002-2004 The Apache Software Foundation
+   Copyright 2002-2004, 2006 The Apache Software Foundation
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
@@ -44,6 +44,35 @@
           <li><a href="http://marc.theaimsgroup.com/">Mailing list Archives</a></li>
         </ul>
 
+
+      <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>.
+      But <a href="http://marc.theaimsgroup.com/?l=ant-user&amp;m=115020655600019&amp;w=2">several times</a>
+      there were problems with unsubscribing from a mailinglist. The problem is that you use another
+      email adress for unsubscribing than for subscribing and ezmlm could not find that adress for
+      deleting from the list. So you have to find out, to which concrete email adress ezmlm is sending
+      the mail. This is visible in the email headers (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-<i>12345-Jan.Materne=me.acme.com</i>@ant.apache.org
+      ...
+      </pre>
+      As you can see, you'll get the help information with each mail, too.
+      But more important is the <i>Return-Path</i>. If you change "return" into "unsubscribe" and you send 
+      an  email to that adress (<tt>user-unsubscribe-12345-Jan.Materne=me.acme.com@ant.apache.org</tt>) 
+      this  will unsubscribe you. 
+      </p>
+
+
       <subsection name="User List">
         <p>
           <b>High Traffic</b>
@@ -79,4 +108,4 @@
     </section>
 
   </body>
-</document>
+</document>