new trunk taken from 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
 
 
 ------------------------------------------------------------------------------
@@ -18,9 +19,11 @@ OVERVIEW:
      ezmlm-web! The file README contains the complete list of necessary
      modules.
 
+	 Additionally (since v3.0) you have to install clearsilver (a templating
+	 engine). See INSTALL.clearsilver for details.
 
 1.   Get ezmlm-web and extract the archive:
-	tar xzf ezmlm-web-2.x.tar.gz
+	tar xzf ezmlm-web-3.x.tar.gz
 
 
 2.   Copy ezmlm-web.cgi to some publically readable directory. It does not
@@ -53,12 +56,16 @@ OVERVIEW:
      		mkdir -p /usr/local/share/ezmlm-web
 		cp -r lang /usr/local/share/ezmlm-web
      You can change this default location in the ezmlmwebrc file.
+	 Do the same with the template directory (e.g copy it
+	 to /usr/local/share/ezmlm-web/template). Then you also have to
+	 set the appropriate location in the ezmlmwebrc file.
 
      Finally, copy the ezmlmwebrc file to one of
      the following places:
-	- /etc/ezmlm
-	- the home directory of the user that runs ezmlm-web.cgi
-	- the directory, that contains your ezmlm-web.cgi file
+	1) the home directory of the user that runs ezmlm-web.cgi
+	2) 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)
 
 
 4.   Edit the index.c file and change the path to the path of your copy
@@ -81,15 +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.
-
-     Optional: it would be nice if you could download the small picture
-     whose URL you can find in the ezmlmwebrc file as "HELP_ICON_URL".
-     Then you should change this URL.
-     This helps to reduce the load on our server.
-
 
 6.   Install some method of securing access to the page. The following
      information is applicable to Apache web servers ... Detailed
@@ -122,15 +120,30 @@ 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 through the web. 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 :)
+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).
 
 
 If you have any problems, then you can:
 - take a look at https://systemausfall.org/toolforge/ezmlm-web
 - send me an email: ezmlm-web@sumpfralle.de
+- subscribe to the mailinglist: ezmlm-web-subscribe@lists.systemausfall.org
+- report a bug at https://systemausfall.org/trac/ezmlm-web