some small release fine tunings

ezmlm-web-3.0/CHANGES

@@ -97,9 +97,10 @@ Version 2.3 - 10/06/02005
 * moderator unsubscribe fixed
 
 Version 3.0 - 12/21/02005
-* complete interface is rewritten
+* complete interface is rewritten for enhanced usability
 * fixed insecure writing of webusers data
 * commas are not necessary anymore in webusers file
 * support for MAIL_DOMAIN config setting
 * requires the clearsilver template engine
 * changed directory for safely removed mailinglists
+

ezmlm-web-3.0/INSTALL

@@ -8,7 +8,8 @@ OVERVIEW:
   4 - compile cgi wrapper
   5 - install cgi wrapper
   6 - (optional) configure access control (http authentication)
-  7 - final test
+  7 - css stylesheet file
+  8 - final test
 
 
 ------------------------------------------------------------------------------
@@ -19,17 +20,7 @@ OVERVIEW:
      modules.
 
 	 Additionally (since v3.0) you have to install clearsilver (a templating
-	 engine). You can download it from http://clearsilver.net.
+	 engine). See INSTALL.clearsilver for details.
-	 The following configure options should work well:
-        ./configure --enable-perl \
-                    --disable-python \
-                    --disable-ruby \
-                    --disable-java \
-                    --disable-csharp \
-                    --disable-apache \
-                    --disable-gettext \
-                    --disable-remote-debugger
-
 
 1.   Get ezmlm-web and extract the archive:
 	tar xzf ezmlm-web-3.x.tar.gz
@@ -71,9 +62,9 @@ OVERVIEW:
 
      Finally, copy the ezmlmwebrc file to one of
      the following places:
-	1) /etc/ezmlm
+	1) the home directory of the user that runs ezmlm-web.cgi
-	2) the home directory of the user that runs ezmlm-web.cgi
+	2) the directory, that contains your ezmlm-web.cgi file
-	3) the directory, that contains your ezmlm-web.cgi file
+	3) /etc/ezmlm
 	 (ezmlm-web will look for it in these places in the given order)
 
 
@@ -97,10 +88,6 @@ OVERVIEW:
      access controlled (here I mean both web and user access) by some method
      (eg .htaccess, access.conf for Apache).
 
-     You should also copy the stylesheet file (css/default.css) to a location
-     of your choice. Now you may have to change the "HTML_CSS_FILE" setting
-     in your ezmlmwebrc file.
-
 
 6.   Install some method of securing access to the page. The following
      information is applicable to Apache web servers ... Detailed
@@ -133,14 +120,24 @@ OVERVIEW:
 	AuthUserFile /path/to/passwordfile
 	require valid-user      # or require user username
 
-     Again, see the ApacheWeek article for details.
+	Again, see the ApacheWeek article for details.
 
 
-7.  Test the installation with your favourite web browser. You should be
+7.	You should copy the stylesheet file (css/default.css) to a location
+	of your choice. It has to be accessible by an URL - maybe a place like
+	"/var/www/ezmlm-web.css" could be appropriate.
+	Now you may have to change the "HTML_CSS_FILE" setting in your
+	ezmlmwebrc file. This value is a URL - not the local filename.
+
+
+8.  Test the installation with your favourite web browser. You should be
 	asked for a username and password (supplied in 6.2) and then be presented
 	with a screen entitled "EZ Mailing List Manger". You can then try to
 	create and edit mailing lists ... Have Fun :)
 
+	If you do not see a colorful screen, then you did not set the HTML_CSS_FILE
+	option correctly in ezmlmwebrc. Check it again.
+
 	If anything failes - take a look at the web server's error log
 	(e.g /var/log/apache/error.log).
 

ezmlm-web-3.0/INSTALL.clearsilver

@@ -0,0 +1,34 @@
+Short notes on how to install clearsilver for perl:
+(you should read it, as step 4 is quite unusual)
+
+1) download & untar
+	http://clearsilver.net
+
+
+2) configure
+
+The following configure options should be sufficient:
+   ./configure --enable-perl \
+               --disable-python \
+               --disable-ruby \
+               --disable-java \
+               --disable-csharp \
+               --disable-apache \
+               --disable-gettext \
+               --disable-remote-debugger
+
+3) make
+
+
+4) the tricky part :)
+
+As the installation directory of clearsilver-perl is configured incorrectly,
+you should replace the existing SITEPREFIX line in perl/Makefile with the following:
+	SITEPREFIX = $(PREFIX)
+(without the leading white space)
+
+
+5) make install
+
+
+6) done

ezmlm-web-3.0/README

@@ -97,7 +97,7 @@ This version of ezmlm-web requires the following;
 
 * qmail v1.03
 * ezmlm v0.53 (or ezmlm-idx v0.40)
-* clearsilver v0.9.14 (only perl support is necessary)
+* clearsilver v0.10.2 (only perl support is necessary)
 * Perl v5.004 and the following modules;
   + Mail::Ezmlm v0.03 
   + Mail::Address v1.15
@@ -224,9 +224,9 @@ the same effect in a cleaner way.
 VII. Language Portablity
 =========================
 One of the great new features of version 2.0 is that it is essentially
-language independant (okay, not quite, but is 99% of the way there). Most of
+language independant. All of the fixed strings, help, etc is defined in the
-the fixed strings, help, etc is defined in the files of lang directory.
+files of lang directory. Of course you can change them or create a new
-Of course you can change them or create a new translation.
+translation.
 
 The language can be selected in ezmlmwebrc with the "HTML_LANGUAGE" option.
 

ezmlm-web-3.0/UPGRADING

@@ -12,9 +12,9 @@ UPGRADING ezmlm-web 2.3 to ezmlm-web 3.0
 
 4) maybe you want to define "MAIL_DOMAIN" in your ezmlmwebrc
 
-5) search order for ezmlmwebrc changed
+5) the search order for ezmlmwebrc has changed
-from	HOME->SYSTEM->CGI_DIR
+from	HOME -> SYSTEM -> CGI_DIR
-to	HOME->CGI_DIR->SYSTEM
+to	HOME -> CGI_DIR -> SYSTEM
 
 ------------------------------------------------------------------------------
 

ezmlm-web-3.0/ezmlmwebrc

@@ -25,7 +25,7 @@ $LANGUAGE_DIR = "/usr/local/share/ezmlm-web/lang";
 $TEMPLATE_DIR = "/usr/local/share/ezmlm-web/template";
 
 # Safe list deletion? 
-# 0 = move list to .list and the .qmails to deleted.qmail/. Recoverable :)
+# 0 = move list to $LIST_DIR/_deleted_lists -> recoverable :)
 # 1 = allow user to delete list completely. No backup, therefore no recovery.
 $UNSAFE_RM = 0;
 
@@ -55,7 +55,8 @@ $DEFAULT_OPTIONS = 'aBDFGHiJkLMNOpQRSTUWx';
 $HTML_TITLE = "ezmlm-web - a mailinglists' administration interface";
 
 # Optional: use a cascading style sheet (css)
-$HTML_CSS_FILE = "css/default.css";
+# this is a URL - you have to copy the css file to the right location before
+$HTML_CSS_FILE = "/ezmlm-web.css";
 
 # choose a language (en|de)
 $HTML_LANGUAGE = 'en';