[Mailman-Developers] Qmail Doc patch for 2.1

[Edmund Lau]

Qmail people:

This is a documentation patch for the README.QMAIL file.  There's not much
testing here, but Barry would you consider applying it?  I'm cc'ing -users
so they will be brought up to speed on the new 2.1.

-Ed

--- README.QMAIL.old    2002-04-05 13:24:10.000000000 -0800
+++ README.QMAIL        2003-01-07 21:37:58.000000000 -0800
@@ -2,14 +2,6 @@
 Copyright (C) 1998,1999,2000,2001,2002 by the Free Software Foundation,
Inc.
 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA

-MORE INFORMATION
-
-You might be interested in some information that Norbert Bollow has
-written about Mailman and Qmail integration, available here:
-
-    http://mailman.cis.to/qmail-verh/
-
-
 QMAIL ISSUES

 There are some issues that users of the qmail mail transport agent
@@ -115,10 +107,11 @@
 your lists (if for some reason you can/will not have them
 automatically picked up using "contrib/qmail-to-mailman.py"):

+This script is for the Mailman 2.0 series:
 #!/bin/sh
 if [ $# = 1 ]; then
     i=$1
-    echo Making links to $i...
+    echo Making links to $i in the current directory...
     echo "|preline /home/mailman/mail/mailman post $i" > .qmail-$i
     echo "|preline /home/mailman/mail/mailman mailowner $i" >
.qmail-$i-admin
     echo "|preline /home/mailman/mail/mailman mailowner $i" >
.qmail-$i-owner
@@ -126,6 +119,62 @@
     echo "|preline /home/mailman/mail/mailman mailcmd $i" >
.qmail-$i-request
 fi

+This script is for the Mailman 2.1 series:
+#!/bin/sh
+if [ $# = 1 ]; then
+    i=$1
+    echo Making links to $i in the current directory...
+    echo "|preline /home/mailman/mail/mailman post $i" > .qmail-$i
+    echo "|preline /home/mailman/mail/mailman admin $i" > .qmail-$i-admin
+    echo "|preline /home/mailman/mail/mailman bounces $i" > .qmail-$i-bounces
+    # The following line is for VERP
+    # echo "|preline /home/mailman/mail/mailman bounces $i" > .qmail-$i-bounces-default
+    echo "|preline /home/mailman/mail/mailman confirm $i" > .qmail-$i-confirm
+    echo "|preline /home/mailman/mail/mailman join $i" > .qmail-$i-join
+    echo "|preline /home/mailman/mail/mailman leave $i" > .qmail-$i-leave
+    echo "|preline /home/mailman/mail/mailman owner $i" > .qmail-$i-owner
+    echo "|preline /home/mailman/mail/mailman request $i" > .qmail-$i-request
+    echo "|preline /home/mailman/mail/mailman subscribe $i" > .qmail-$i-subscribe
+    echo "|preline /home/mailman/mail/mailman unsubscribe $i" > .qmail-$i-unsubscribe
+fi
+
+INFORMATION ON VERP
+
+You will note in the alias generating script for 2.1 above, there is a
+line for VERP that has been commented out.  If you are interested in VERP
+there are two options.  The first option is to allow Mailman to do the
+VERP formatting.  To activate this, uncomment that line and add the
+following lines to your mm_cfg.py file:
+
+VERP_FORMAT = '%(bounces)s-+%(mailbox)s=%(host)s'
+VERP_REGEXP = r'^(?P<bounces>.*?)-\+(?P<mailbox>[^=]+)=(?P<host>[^@]+)@.*$'
+
+The second option is a patch on SourceForge located at:
+
+http://sourceforge.net/tracker/?func=detail&atid=300103&aid=645513&group_id=103
+
+This patch currently needs more testing and might best be suitable for
+developers or people well familiar with qmail.  Having said that, this
+patch is the more qmail-friendly approach resulting in large performance
+gains.
+
+VIRTUAL MAIL SERVER
+
+As mentioned in the ISSUES area for a virtual mail server, a patch under
+testing is located at:
+
+http://sf.net/tracker/index.php?func=detail&aid=621257&group_id=103&atid=300103
+
+Again, this patch is for people familiar with their qmail installation.
+
+MORE INFORMATION
+
+You might be interested in some information on modifying footers that
+Norbert Bollow has written about Mailman and Qmail integration, available
+here:
+
+    http://mailman.cis.to/qmail-verh/
+


 Local Variables:
 mode: text