Initial revision

git-svn-id: https://subversion.renater.fr/sympa/trunk@2 05aa8bb8-cd2b-0410-b1d7-8918dfa770ce

INSTALL

+
+Please refer to the documentation for installation
+notes : doc/sympa/node3.html
+
+Create a dedicated user sympa.sympa (and it's home dirrectory
+and run make; make install. (you may have to use Gnu make).
+If usefull, the make will propose you to upgrade some CPAN module.
+In this case you'll need to be root.
+

KNOWNBUGS

+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+Broken S/MIME signature
+[2.x -> 3.0] 
+
+        S/MIME signature is altered by Sympa distribution processus
+        if original message contains base64 attachement. This bug cames
+        with all previous 2.X and 3.X version. The reason is that
+        MIME::parser print method do not restore the original
+        base64 presentation (the number of chars per line is completly
+        free, but the S/MIME check sum of the message of course is
+        depending of that.
+        The solution is to distribute the original message file (except
+        headers) insteed of the Mime::entity dump.  There is a lot of
+        dependence including the case of crypted and signed messages,
+        header/footer attachement.
+
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+Can't delete owner
+[3.0a.x ->3.0]
+
+        When deleting owner or editor, wwsympa return a syntaxe error
+
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+Owners can change their email
+[3.0a.x -> 3.0]
+
+       	Privileged owners can edit their own email address. This is
+        should be impossible because listmaster must be able to control
+        who own lists.
+
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+Improper lang when notify
+[3.0a.x -> 3.0]
+
+        Notificatication of messages to moderate sent to list editor
+        use the lang preference of the message Sender. Of course it should
+        use the editor lang preference.
+
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

LICENSE

+
+
+		SYMPA - Systeme de multipostage automatique
+
+Copyright  1997,1998,1999,2000 Comite Reseau des Universites
+Copyright  1997,1998,1999 Institut Pasteur & Christophe Wolfhugel
+
+
+  You may distribute under the terms of the GNU General
+  Public License Version 2 ( http://www.gnu.org/copyleft/gpl.html).
+
+
+

Makefile

+## User Id and Group for Sympa (your httpd should have the same uid.gid)
+USER	=	sympa
+GROUP	=	sympa
+
+## configuration file
+CONFDIR	=	/etc
+
+##  Perl path
+PERL	=	/usr/bin/perl
+
+## For preparing samples
+HOST		=	`$(PERL) -MSys::Hostname -e "printf '%s', Sys::Hostname::hostname();"`
+COOKIE		=	`$(PERL) -e " print int(rand ( time ))  "`
+PERL_VERSION	=	`$(PERL) -e ' print $$]'`
+
+SYMPA_VERSION	=	'3.0'
+
+#SYMPA_VERSION	=	`pwd | $(PERL) -e 'my @version = split /-/, <STDIN>; printf "%s", $$version[1];'`
+
+## Root directory for Sympa ; use absolute path.
+## Binaries are located under $DIR/bin ; this directory needs to be
+## readable for everyone ; `queue' needs to be executable 
+## You can also set DESTDIR to the place where everything should be
+## installed (usefull for packagers of Sympa)
+DIR	=	/home/sympa
+
+## PID location
+PIDDIR	=	/home/sympa
+
+## Both queue and bouncequeue are lunched by sendmail. If sendmail
+## is configured to used smrsh (check the mailer prog definition), thoses
+## files needs to be installed in /etc/smrsh.  
+MAILERPROGDIR	=	$(DIR)/bin
+
+#RPMTOPDIR	=	`rpm --eval %_topdir`
+RPMTOPDIR	=	/usr/src/redhat
+
+## SYSV init scripts directory
+INITDIR		=	$(DIR)/bin
+
+BINDIR		=	$(DIR)/bin
+
+## Spools directory
+SPOOLDIR	=	$(DIR)/spool
+
+## Directory for installing WWSympa
+WWSBINDIR	=	$(BINDIR)
+
+# Chose your prefered color.
+#
+DARK_COLOR	=	'\#330099'
+LIGHT_COLOR	=	'\#ccccff'
+TEXT_COLOR	=	'\#000000' 
+BG_COLOR	=	'\#ffffff'
+ERROR_COLOR	=	'\#ff6666'
+SELECTED_COLOR	=	'\#3366cc'
+
+## Target directory for installing Icons
+ICONSDIR	=	/home/httpd/icons
+
+## Path to gencat program (creates the .cat catalog file using the .msg)
+GENCAT	= 	/usr/bin/gencat
+
+## Path to OpenSSL
+OPENSSL	=	/usr/local/ssl/bin/openssl
+SSLCERTDIR =	--DIR--/expl/X509-user-certs
+
+SH	=	/bin/sh
+CC	=	gcc
+CFLAGS	=	-g
+
+# Aix4.2 (and some others unix), use gnu make !
+MAKE	=	make
+
+##---------- STOP ---------- STOP ---------- STOP ---------- STOP ----------
+
+CONFIG		=	$(CONFDIR)/sympa.conf
+WWSCONFIG	=	$(CONFDIR)/wwsympa.conf
+ETCBINDIR	=	$(BINDIR)/etc
+NLSDIR		=	$(DIR)/nls
+
+#ifeq ($(shell uname), Linux)
+#	LOG_SOCKET_TYPE="inet"
+#else
+LOG_SOCKET_TYPE	=	"unix"
+#endif
+
+all:	checkcpan sources languages checkperl
+
+rpm: build_rh_rpm build_mdk_rpm
+
+checkperl:
+	@if [ $(PERL_VERSION) = '5.006' ]; then \
+	echo "Perl: $(PERL_VERSION)"; \
+	echo "##################################"; \
+	echo "## You are using Perl version 5.6.0 :"; \
+	echo "## You need to patch your syslog.pm "; \
+	echo "## See http://bugs.perl.org/perlbug.cgi?req=bidmids&bidmids=20000712.003"; \
+	echo "##"; \
+	echo "## If your Perl version is 5.6.0 AND if your system is Solaris :"; \
+	echo "## See also http://bugs.perl.org/perlbug.cgi?req=bidmids&bidmids=20000522.003"; \
+	echo "#############################################################################"; \
+	fi
+
+sources: 
+	@echo "Making src"
+	(cd src && echo "making in src..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' \
+	DIR='${DIR}' BINDIR='${BINDIR}' WWSBINDIR='${WWSBINDIR}' \
+	MAILERPROGDIR='${MAILERPROGDIR}' ETCBINDIR='${ETCBINDIR}' \
+	CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' \
+	USER='${USER}' GROUP='${GROUP}');
+
+doc: 
+	@echo "Making doc"
+	(cd doc && echo "making in doc..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' \
+	DIR='${DIR}' BINDIR='${BINDIR}' WWSBINDIR='${WWSBINDIR}' \
+	MAILERPROGDIR='${MAILERPROGDIR}' ETCBINDIR='${ETCBINDIR}' \
+	CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' \
+	USER='${USER}' GROUP='${GROUP}');
+
+languages:
+	@echo "Making nls"
+	(cd nls && echo "making in nls..." && \
+	$(MAKE) SH='${SH}' PERL='${PERL}' ETCBINDIR='${ETCBINDIR}' \
+	DIR='${DIR}' NLSDIR='${NLSDIR}' BINDIR='${BINDIR}' \
+	USER='${USER}' GROUP='${GROUP}' GENCAT='${GENCAT}');
+
+checkcpan: 
+	@echo "Checking needed CPAN modules ..."
+	$(PERL) ./check_perl_modules.pl
+
+clean:
+	find . \( -name ".#*" -o -name "*~" -o -name ".*~" -o -name "#*#" \) -exec  rm -f {} \;
+	@for i in src nls wwsympa src/etc/sample ;\
+	do \
+	(cd $$i && echo "making clean in $$i..." && \
+	$(MAKE) PERL='${PERL}' clean) || exit 1; \
+	done;
+
+install: installsrc installnls installwws installscript installsample installdir installconfig
+
+installsrc:
+	(cd src && echo "making in src..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' SYMPA_VERSION='${SYMPA_VERSION}' \
+	DIR='${DIR}' BINDIR='${BINDIR}' WWSBINDIR='${WWSBINDIR}' MAILERPROGDIR='${MAILERPROGDIR}' \
+	DESTDIR='${DESTDIR}' DARK_COLOR='${DARK_COLOR}' LIGHT_COLOR='${LIGHT_COLOR}' \
+	TEXT_COLOR='${TEXT_COLOR}' BG_COLOR='${BG_COLOR}' ERROR_COLOR='${ERROR_COLOR}' \
+	CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' ETCBINDIR='${ETCBINDIR}' \
+	USER='${USER}' GROUP='${GROUP}' newinstall) || exit 1;
+
+installnls:
+	(cd nls && echo "making in nls..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' \
+	DIR='${DIR}' NLSDIR='${NLSDIR}' ETCBINDIR='${ETCBINDIR}' \
+	DESTDIR='${DESTDIR}' CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' \
+	USER='${USER}' GROUP='${GROUP}' GENCAT='${GENCAT}' newinstall) || exit 1;
+
+installwws:
+	(cd wwsympa && echo "making in wwsympa..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' \
+	DIR='${DIR}' BINDIR='${BINDIR}' WWSBINDIR='${WWSBINDIR}' MAILERPROGDIR='${MAILERPROGDIR}' \
+	CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' ETCBINDIR='${ETCBINDIR}' \
+	DESTDIR='${DESTDIR}' DARK_COLOR='${DARK_COLOR}' LIGHT_COLOR='${LIGHT_COLOR}' \
+	TEXT_COLOR='${TEXT_COLOR}' BG_COLOR='${BG_COLOR}' \
+	ERROR_COLOR='${ERROR_COLOR}' SELECTED_COLOR='${SELECTED_COLOR}' \
+	USER='${USER}' GROUP='${GROUP}' ICONSDIR='${ICONSDIR}' newinstall) || exit 1;
+
+installsample:
+	(cd src/etc/sample && echo "making in src/etc/sample..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' LOG_SOCKET_TYPE='${LOG_SOCKET_TYPE}' \
+	DESTDIR='${DESTDIR}' DIR='${DIR}' BINDIR='${BINDIR}' WWSBINDIR='${WWSBINDIR}' HOST='${HOST}' \
+	CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' ETCBINDIR='${ETCBINDIR}' MAILERPROGDIR='${MAILERPROGDIR}' \
+	DARK_COLOR='${DARK_COLOR}' LIGHT_COLOR='${LIGHT_COLOR}' COOKIE='${COOKIE}' \
+	OPENSSL='${OPENSSL}' SSLCERTDIR='${SSLCERTDIR}' \
+	SPOOLDIR='${SPOOLDIR}' TEXT_COLOR='${TEXT_COLOR}' BG_COLOR='${BG_COLOR}' ERROR_COLOR='${ERROR_COLOR}' \
+	USER='${USER}' GROUP='${GROUP}' ICONSDIR='${ICONSDIR}' PIDDIR='${PIDDIR}' install) || exit 1;
+
+installscript:
+	(cd src/etc/script && echo "making in src/etc/script..." && \
+	$(MAKE) SH='${SH}' CC='${CC}' CFLAGS='${CFLAGS}' PERL='${PERL}' \
+	DIR='${DIR}' DESTDIR='${DESTDIR}' BINDIR='${BINDIR}' WWSBINDIR='${WWSBINDIR}' HOST='${HOST}' \
+	CONFIG='${CONFIG}' WWSCONFIG='${WWSCONFIG}' ETCBINDIR='${ETCBINDIR}' \
+	MAILERPROGDIR='${MAILERPROGDIR}' \
+	DARK_COLOR='${DARK_COLOR}' LIGHT_COLOR='${LIGHT_COLOR}' COOKIE='${COOKIE}' INITDIR='${INITDIR}' \
+	TEXT_COLOR='${TEXT_COLOR}' BG_COLOR='${BG_COLOR}' ERROR_COLOR='${ERROR_COLOR}' OPENSSL='${OPENSSL}' \
+	USER='${USER}' GROUP='${GROUP}' ICONSDIR='${ICONSDIR}' install) || exit 1;
+
+
+installdir:
+	@if [ ! -f $(DESTDIR)$(CONFDIR)/sympa.conf ] ; then \
+	echo "Installing directories..."; \
+	for dir in expl etc sample ; do \
+		if [ ! -d $(DESTDIR)$(DIR)/$$dir ] ; then \
+			echo "Creating $(DESTDIR)$(DIR)/$$dir"; \
+			mkdir -p $(DESTDIR)$(DIR)/$$dir; \
+			chown $(USER) $(DESTDIR)$(DIR)/$$dir; \
+			chgrp $(GROUP) $(DESTDIR)$(DIR)/$$dir; \
+		fi \
+	done \
+	fi
+	@if [ ! -f $(DESTDIR)$(CONFDIR)/sympa.conf ] ; then \
+	echo "Installing conf directories..."; \
+	for dir in etc/create_list_templates etc/templates etc/wws_templates etc/scenari ; do \
+		if [ ! -d $(DESTDIR)$(DIR)/$$dir ] ; then \
+			echo "Creating $(DESTDIR)$(DIR)/$$dir"; \
+			mkdir -p $(DESTDIR)$(DIR)/$$dir; \
+			chown $(USER) $(DESTDIR)$(DIR)/$$dir; \
+			chgrp $(GROUP) $(DESTDIR)$(DIR)/$$dir; \
+		fi \
+	done \
+	fi
+	@if [ ! -f $(DESTDIR)$(CONFDIR)/sympa.conf ] ; then \
+	echo "Installing spool directories..."; \
+	for dir in $(SPOOLDIR) $(SPOOLDIR)/msg $(SPOOLDIR)/digest $(SPOOLDIR)/moderation \
+	$(SPOOLDIR)/expire $(SPOOLDIR)/auth $(SPOOLDIR)/outgoing $(SPOOLDIR)/tmp ; do \
+		if [ ! -d $(DESTDIR)$$dir ] ; then \
+			echo "Creating $(DESTDIR)$$dir"; \
+			mkdir -p $(DESTDIR)$$dir; \
+			chown $(USER) $(DESTDIR)$$dir; \
+			chgrp $(GROUP) $(DESTDIR)$$dir; \
+			chmod 770 $(DESTDIR)$$dir; \
+		fi \
+	done \
+	fi
+
+installconfig:
+	mkdir -p $(DESTDIR)$(CONFDIR)
+	@for cfile in sympa.conf wwsympa.conf ; do \
+	if [ ! -f $(DESTDIR)$(CONFDIR)/$$cfile ] ; then \
+	echo "Installing sample config file $$cfile..."; \
+	( \
+		cd src/etc/sample/ ; \
+		PERL=$(PERL); export PERL; \
+		UMASK=0600; export UMASK; \
+		DIR=$(DIR); export DIR; \
+		INSTALLDIR=$(CONFDIR); export INSTALLDIR; \
+		DESTDIR=$(DESTDIR); export DESTDIR; \
+		BINDIR=$(BINDIR); export BINDIR; \
+		ETCBINDIR=$(ETCBINDIR); export ETCBINDIR; \
+		CONFIG=$(CONFIG); export CONFIG; \
+		LOG_SOCKET_TYPE=$(LOG_SOCKET_TYPE); export LOG_SOCKET_TYPE; \
+		COOKIE=$(COOKIE); export COOKIE; \
+		HOST=$(HOST); export HOST; \
+		OPENSSL=$(OPENSSL); export OPENSSL ; \
+		SSLCERTDIR=$(SSLCERTDIR); export SSLCERTDIR ; \
+		$(PERL) ../../../subst.pl $$cfile \
+	) ;\
+	chown $(USER) $(DESTDIR)$(CONFDIR)/$$cfile; \
+	chgrp $(GROUP) $(DESTDIR)$(CONFDIR)/$$cfile; \
+	fi \
+	done
+
+build_rh_rpm: clean
+	@echo "Building RedHat RPM in $(RPMTOPDIR) ..."
+	@( \
+		cd src/etc/script/ ; \
+		PERL=$(PERL); export PERL; \
+		UMASK=0600; export UMASK; \
+		INSTALLDIR=$(RPMTOPDIR)/SPECS; export INSTALLDIR; \
+		SUFFIX=''; export SUFFIX; \
+		ZIPEXT='gz'; export ZIPEXT; \
+		APPGROUP='System Environment/Daemons'; export APPGROUP; \
+		HOMEDIR='/home/sympa'; export HOMEDIR; \
+		VERSION=$(SYMPA_VERSION); export VERSION; \
+		$(PERL) ../../../subst.pl sympa.spec \
+	)
+	@( \
+		cd ..; \
+		tar -cvf $(RPMTOPDIR)/SOURCES/sympa-$(SYMPA_VERSION).tar sympa-$(SYMPA_VERSION); \
+		gzip $(RPMTOPDIR)/SOURCES/sympa-$(SYMPA_VERSION).tar; \
+	)
+	rpm -ba $(RPMTOPDIR)/SPECS/sympa.spec
+
+build_mdk_rpm: clean
+	@echo "Building Mandrake RPM in $(RPMTOPDIR) ..."
+	@( \
+		cd src/etc/script/ ; \
+		PERL=$(PERL); export PERL; \
+		UMASK=0600; export UMASK; \
+		INSTALLDIR=$(RPMTOPDIR)/SPECS; export INSTALLDIR; \
+		SUFFIX='mdk'; export SUFFIX; \
+		ZIPEXT='bz2'; export ZIPEXT; \
+		APPGROUP='System/Servers'; export APPGROUP; \
+		HOMEDIR='/var/lib/sympa'; export HOMEDIR; \
+		VERSION=$(SYMPA_VERSION); export VERSION; \
+		$(PERL) ../../../subst.pl sympa.spec \
+	)
+	@( \
+		cd ..; \
+		tar -cvf $(RPMTOPDIR)/SOURCES/sympa-$(SYMPA_VERSION).tar sympa-$(SYMPA_VERSION); \
+		bzip2 $(RPMTOPDIR)/SOURCES/sympa-$(SYMPA_VERSION).tar; \
+	)
+	rpm -ba $(RPMTOPDIR)/SPECS/sympa.spec
+

README

+              SYMPA -- Système de Multi-Postage Automatique
+
+SYMPA is an electronic mailing list manager. It is used to automate list
+management functions such as subscription, moderation and management of 
+archives. SYMPA also manages sending of messages to the lists, and 
+makes it possible to reduce the load on the system. Provided that you 
+have enough memory on your system, Sympa is especially well adapted for big 
+lists. For a list with 20 000 subscribers, it takes 5 minutes to send a
+message to 90% of subscribers, of course considering that the network is 
+available.
+
+Documentation is available under HTML and SGML (source) formats. 
+
+==============================================================================
+
+SYMPA est un gestionnaire de listes électroniques. Il permet d'automatiser
+les fonctions de gestion des listes telles les abonnements, la modération
+et la gestion des archives. SYMPA gère également le renvoi des messages
+adressés aux listes et permet de limiter la charge sur le système. Dans des
+configurations avec suffisamment de mémoire, SYMPA est particulièrement
+adapté aux grandes listes. Avec une liste de 20 000 abonnés, il faut 5 
+minutes pour envoyer un message à 90% des abonnés, lorsque le réseau est 
+disponible bien évidemment.
+
+La documentation est disponible  sous forme HTML. Pour consulter
+la première page veuillez ouvrir la page `doc/HTML/sympa.html' dans votre
+outil de navigation préféré. Le source SGML de la doc est aussi disponible
+pour génération du format imprimable de votre choix.

check_perl_modules.pl

+# check for perl and modules for SYMPA
+#
+# Laurent Ghys (Laurent.Ghys@ircam.fr)
+#
+# Changes
+# 03/08/2000 [O Salaun] arg passed to CPAN::Shell->install() is the module name
+# 02/08/2000 [O Salaun] require CGI 2.52 (Vars())
+# 26/07/2000 [O Salaun] corrected MIME::Tools to MIME::tools
+# 13/07/2000 [L Ghys]   sort %todo to avoid error message with CGI::Fast
+# 10/07/2000 [O Salaun] MIME::tools now require File::Spec
+# 19/06/2000 [O Salaun] require Net::LDAP 0.19
+# 05/06/2000 [O Salaun] Installing required modules
+# 31/05/2000 [O Salaun] Added FCGI & CGI::Fast
+# 12/05/99 [O Salaun] Net-LDAP changed to Netperl-ldap 
+# 20/05/99 [L Ghys]   added stuff for CPAN modules
+
+use CPAN;
+
+## assume version = 1.0 if not specified.
+## 
+%versions = ('perl' => '5.00403',
+             'Net::LDAP' =>, '0.10', 
+	     'perl-ldap' => '0.10',
+	     'Mail::Internet' => '1.32', 
+	     'DBI' => '1.06',
+	     'FCGI' => '0.48',
+	     'MIME::Tools' => '5.209',
+	     'File::Spec' => '0.8',
+	     'CGI' => '2.52');
+
+### key:left "module" used by SYMPA, 
+### right CPAN module.		     
+%req_CPAN = ('DB_File' => 'DB_FILE',
+	     'Locale::Msgcat' => 'Msgcat',
+	     'MD5' => 'MD5',
+	     'Mail::Internet' =>, 'MailTools',
+	     'IO::Scalar' => 'IO-stringy',
+	     'MIME::Tools' => 'MIME-tools',
+	     'MIME::Base64' => 'MIME-Base64',
+	     'CGI' => 'CGI',
+	     'File::Spec' => 'File-Spec');
+
+%opt_CPAN = ('DBI' => 'DBI',
+	     'Net::LDAP' =>   'perl-ldap',
+	     'CGI::Fast' => 'CGI',
+	     'FCGI' => 'FCGI');
+
+### main:
+print "******* Check perl for SYMPA ********\n";
+### REQ perl version
+print "\nChecking for PERL version:\n-----------------------------\n";
+$rpv = $versions{"perl"};
+if ($] ge $versions{"perl"}){
+    print "your version of perl is OK ($]  >= $rpv)\n";
+}else {
+    print "Your version of perl is TOO OLD ($]  < $rpv)\nPlease INSTALL a new one !\n";
+}
+
+print "\nChecking for REQUIRED modules:\n------------------------------------------\n";
+&check_modules('y', %req_CPAN);
+print "\nChecking for OPTIONAL modules:\n------------------------------------------\n";
+&check_modules('n', %opt_CPAN);
+
+print <<EOM;
+******* NOTE *******
+You can retrive all theses modules from any CPAN server
+(for example ftp://ftp.pasteur.fr/pub/computing/CPAN/CPAN.html)
+EOM
+###--------------------------
+# reports modules status
+###--------------------------
+sub check_modules {
+    my($default, %todo) = @_;
+    my($vs, $v, $rv, $status);
+
+    print "perl module          from CPAN       STATUS\n"; 
+    print "-----------          ---------       ------\n";
+
+    foreach $mod (sort keys %todo) {
+	printf ("%-20s %-15s", $mod, $todo{$mod});
+	$status = &test_module($mod);
+	if ($status == 1) {
+	    $vs = "$mod" . "::VERSION";
+	    $v = $$vs;
+	    $rv = $versions{$mod} || "1.0" ;
+	    ### OK: check version
+	    if ($v ge $rv) {
+		printf ("OK (%-6s >= %s)\n", $v, $rv);
+		next;
+	    }else {
+		print "version is too old ($v < $rv).\n";
+                print ">>>>>>> You must update \"$todo{$mod}\" to version \"$versions{$todo{$mod}}\" <<<<<<.\n";
+		&install_module($mod, $default);
+	    }
+	} elsif ($status eq "nofile") {
+	    ### not installed
+	    print "seems to be not available on this system.\n";
+
+	    &install_module($mod, $default);
+
+	} elsif ($status eq "pb_retval") {
+	    ### doesn't return 1;
+	    print "$mod doesn't return 1 (check it).\n";
+	} else {
+	    print "$status";
+	}
+    }
+}
+
+##----------------------
+# Install a CPAN module
+##----------------------
+sub install_module {
+    my ($module, $default) = @_;
+
+    unless ($> == 0) {
+	print "## You need root privileges to install $module module ##\n";
+	    my $t = <STDIN>;
+	    return undef;
+    }
+
+    print "Install module $module ? [$default]";
+    my $answer = <STDIN>; chomp $answer;
+    $answer ||= $default;
+    next unless ($answer =~ /^y$/i);
+    CPAN::Shell->install($module);
+}
+
+###--------------------------
+# test if module is there
+# (from man perlfunc ...)
+###--------------------------
+sub test_module {
+    my($filename) = @_;
+    my($realfilename, $result);
+
+    $filename =~ s/::/\//g;
+    $filename .= ".pm";
+    return 1 if $INC{$filename};
+    
+  ITER: {
+      foreach $prefix (@INC) {
+	  $realfilename = "$prefix/$filename";
+	  if (-f $realfilename) {
+	      $result = do $realfilename;
+	      last ITER;
+	  }
+      }
+      return "nofile";
+  }
+    return "pb_retval" unless $result;
+    return $result;
+}
+### EOF
+
+

doc/.latex2html-init

+$MAX_SPLIT_DEPTH=+3;
+$MAX_LINK_DEPTH=2;
+$SHOW_SECTION_NUMBERS=1;
+$WORDS_IN_NAVIGATION_PANEL_TITLES=6;

doc/Makefile

+#
+# Sympa documentation Makefile
+#
+# Available targets:
+#   - all: generates .ps and .html files
+#   - ps: generates sympa.ps
+#   - html: generates directory sympa/ with *.html files
+#   - clean: removes all files
+#   - distrib: cleans all auxiliary files
+#
+# Needs:
+#   - latex2e
+#   - packages:
+#	epsfig
+#	xspace
+#	makeidx
+#	a4		(optional, edit sympa.tex to remove it)
+#	palatino	(optional, edit sympa.tex to remove it) 
+#	changebar
+#	html		(comes with latex2html)
+#   - dvips
+#   - fig2dev (a fairly recent version comes with transfig 3.2 and later)
+#   - makeindex
+#   - latex2html
+#
+# History
+#   1999/04/13 : pda@prism.uvsq.fr : design of this makefile
+#   1999/04/18 : pda@prism.uvsq.fr : added index generation
+#   1999/06/24 : os@cru.fr         : icons are duplicated with html (-local_icons)
+#
+
+LATEX	= latex
+DVIPS	= dvips
+FIG2DEV	= fig2dev
+LATEX2HTML = latex2html
+MAKEINDEX = makeindex
+
+# encapsulated postcript part of the source
+# EPS	= ls-lR.eps
+# GIF	= ls-lR.gif
+
+.SUFFIXES: .fig .eps
+
+.fig.eps:
+	fig2dev -Lps $*.fig > $*.eps
+
+
+all:	ps html
+
+#
+# PS generation
+#
+
+ps:	sympa.ps
+
+sympa.ps: sympa.dvi
+	$(DVIPS) -f sympa.dvi > sympa.ps
+
+sympa.dvi: sympa.tex $(EPS)
+	cp /dev/null sympa.ind
+	$(LATEX) sympa