[Savannah-cvs] administration/docs/hacking_savannah hacking_sa...

[Sylvain Beucler]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Sylvain Beucler <address@hidden>        05/03/31 20:46:17

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        Continued section about Mailman.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/administration/administration/docs/hacking_savannah/hacking_savannah.texi.diff?tr1=1.101&tr2=1.102&r1=text&r2=text

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.101 
administration/docs/hacking_savannah/hacking_savannah.texi:1.102
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.101    Sat Mar 
26 10:22:14 2005
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Thu Mar 31 
20:46:16 2005
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.101 2005/03/26 10:22:14 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.102 2005/03/31 20:46:16 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -2126,7 +2126,14 @@
 @end example
 
 
-Time to install mailman: @code{apt-get install mailman}.
+Time to install Mailman. The mailman installation used by Savannah is
+not Debian stable's. It among other handles mail duplicates (eg
+To:listname+Cc:you while you are a list member - what a relief!).
+
+So we won't go through the usual @command{apt-get} way, but I'll
+document it in a first step, so as to get acquainted with Mailman.
+
+So first, @code{apt-get install mailman}.
 
 The mailman Apache configuration is automatically done. Check
 @url{http://localhost/cgi-bin/mailman/listinfo}. We'll customize it a bit 
anyway:
@@ -2135,16 +2142,111 @@
 cat <<EOF > /etc/apache/mailman.conf
 ScriptAlias /mailman/ /usr/lib/mailman/cgi-bin/
 Alias /pipermail/ /var/lib/mailman/archives/public/
+EOF
address@hidden example
+
+The package does not automatically install the Exim configuration
+though. We'll need to get information from
address@hidden/usr/share/doc/mailman/README.Debian}.
+
+We'll copy a few icons in a directory publicly accessible (you can
+remove the local doc/ access along the way in your @file{httpd.conf}).
+
address@hidden
+install -m 644 /usr/share/doc/mailman/images/* /usr/share/apache/icons/
address@hidden example
+
+Then edit your @file{/etc/mailman/mm_cfg.py}:
address@hidden
+IMAGE_LOGOS       = '/icons/'
address@hidden example
+
+The following is inspired from
address@hidden/usr/share/doc/mailman/README.EXIM.gz}.
+
+Add some mailman-related aliases:
address@hidden
+cat <<EOF >>/etc/aliases
+
+# Mailman admin
+mailman: postmaster
+mailman-request: postmaster
+mailman-admin: postmaster
+EOF
 @end example
 
-The package does not
-automatically install the Exim configuration though. We'll need to get
-information from
+On to the @file{exim.conf}. That configuration file is split into
+several sections each ended by @samp{end}, and in a precise order.
+
+In the first section about general configuration, add:
address@hidden
+# Install directory:
+MAILMAN_ROOT=/var/lib/mailman
+# Program to pipe mail to:
+MAILMAN_WRAPPER=MAILMAN_ROOT/mail/wrapper
+# Debian defaults:
+MAILMAN_UID=list
+MAILMAN_GID=daemon
address@hidden example
+
+In the next one about transport, append:
address@hidden
+ml_transport:
+  driver = pipe
+  command = MAILMAN_WRAPPER post address@hidden:address@hidden
+  current_directory = MAILMAN_ROOT
+  home_directory = MAILMAN_ROOT
+  user = MAILMAN_UID
+  group = MAILMAN_GID
+
+ml_request_transport:
+  driver = pipe
+  command = MAILMAN_WRAPPER mailcmd address@hidden:address@hidden
+  current_directory = MAILMAN_ROOT
+  home_directory = MAILMAN_ROOT
+  user = MAILMAN_UID
+  group = MAILMAN_GID
+
+ml_admin_transport:
+  driver = pipe
+  command = MAILMAN_WRAPPER mailowner address@hidden:address@hidden
+  current_directory = MAILMAN_ROOT
+  home_directory = MAILMAN_ROOT
+  user = MAILMAN_UID
+  group = MAILMAN_GID
address@hidden example
+
+And in the directors section, append:
address@hidden
+ml_admin_director:
+  domains=lists.gnu, lists.nongnu
+  driver = smartuser
+  suffix = -admin
+  require_files = MAILMAN_ROOT/lists/address@hidden:address@hidden/config.db
+  transport = ml_admin_transport
+
+ml_request_director:
+  domains=lists.gnu, lists.nongnu
+  driver = smartuser
+  suffix = -request
+  require_files = MAILMAN_ROOT/lists/address@hidden:address@hidden/config.db
+  transport = ml_request_transport
+
+ml_director:
+  domains=lists.gnu, lists.nongnu
+  driver = smartuser
+  require_files = MAILMAN_ROOT/lists/address@hidden:address@hidden/config.db
+  transport = ml_transport
address@hidden example
+
+TODO: check whether 'domains' is working. Add -bounces processing. Add
+multiple domain Savannah-style (allows a list to be available at
+multiple domains).
+
 
 @node Some Savannah tasks, Frequent support requests, Mailing lists 
administration, Top
 @chapter Some Savannah tasks
 
-
 @menu
 * Adding a Frequently Asked Question::  
 * Manually setting up commit e-mail notification::