Re: [gnugo-devel] html regression views

[Marcin Garski]

Gunnar Farnebäck wrote:
> > I can update doc/regression.texi to Apache 2 (I don't know English 
> > perfectly so it won't be clear English (-: )
>
>
> If it's only a question of getting the English right, I'm sure that
> can be fixed.

Here you have updated regression.texi file. I've included solutions to 
some problems that I have encountered.
If you want to setup a automatic regression view of GNU Go from CVS you 
will need to do more things that aren't covered in docs, like:
1. Get GNU Go from CVS
2. ./configure && make
3. ./regress.pl -a 1
4. copy html/ directory to place where regress.plx is executed

This could be done by cron and bash script. Probably there is easier way 
to do that.
--
Marcin Garski

--- gnugo-3.7.7-orig/doc/regression.texi        2005-10-18 21:55:11.000000000 
+0200
+++ gnugo-3.7.7/doc/regression.texi     2005-10-18 22:53:29.000000000 +0200
@@ -258,42 +258,61 @@
 
 @subsection Setting up the HTML regression Views
 
-This documentation assumes an apache configured as per Debian's Apache 1.3
-distribution, but it should be fairly close to the config for other
-distributions.
+There are many ways configuring Apache to permit CGI scripts, all of them are
+featured in Apache documentation, which can be found at
address@hidden://httpd.apache.org/docs/2.0/howto/cgi.html}
+
+Below you will find one example. 
+
+This documentation assumes an Apache 2.0 included in Fedora Core distribution,
+but it should be fairly close to the config for other distributions.
 
 First, you will need to configure Apache to run CGI scripts in the directory
-you wish to serve the html views from.  To do this, add the following to
address@hidden/etc/apache/httpd.conf} (or to a user-specific conf file if 
applicable):
+you wish to serve the html views from. In @file{/etc/httpd/conf/httpd.conf}
+there should be a line:
+
address@hidden "/var/www/html"}
+
+Search for a line @code{<Directory "/path/to/directory">}, where 
address@hidden/path/to/directory} is the same as provided in 
@code{DocumentRoot},
+then add @code{ExecCGI} to list of @code{Options}.
+The whole section should look like:
 
 @example
-<Directory /path/to/script/>
-    Options +ExecCGI
+<Directory "/var/www/html">
+...
+    Options ... ExecCGI
+...
 </Directory>
 @end example
 
 This allows CGI scripts to be executed in the directory used by regress.plx.
-Next, you need to tell Apache that @file{.plx} is a CGI script ending.  Your
address@hidden file should contain a section @code{<IfModule mod_mime.c>}.
-Within that section, there may or may not be a line:
+Next, you need to tell Apache that @file{.plx} is a CGI script ending. Your
address@hidden file should contain a line:
 
address@hidden cgi-script ....}
address@hidden cgi-script ...}
 
-If there isn't already, add it; add @file{.plx} to the list of extensions.
+If there isn't already, add it; add @file{.plx} to the list of extensions,
+so line should look like:
 
-You will also need to make sure you have the necessary modules loaded to run
-CGI scripts; mod_cgi and mod_mime should be sufficient.  Your @file{httpd.conf}
-should have the relevant @code{LoadModule} lines; uncomment them if neccessary.
address@hidden cgi-script ... .plx}
 
-Next, you need to put a copy of @file{regress.plx} in the directory that you
-plan to serve the html views from.
+You will also need to make sure you have the necessary modules loaded to run
+CGI scripts; mod_cgi and mod_mime should be sufficient. Your @file{httpd.conf}
+should have the relevant @code{LoadModule cgi_module modules/mod_cgi.so} and
address@hidden mime_module modules/mod_mime.so} lines; uncomment them if
+necessary.
+
+Next, you need to put a copy of @file{regress.plx} in the @code{DocumentRoot}
+directory @code{/var/www/html} or it subdirectories where you plan to serve the
+html views from.
 
-You will also need to install the Perl module GD, available from CPAN or via
address@hidden install libgd-perl} on Debian.
+You will also need to install the Perl module GD
+(@url{http://search.cpan.org/dist/GD/}), available from CPAN.
 
 Finally, run @file{regression/regress.pl} to create the xml data used to
-generate the html views; then, copy the @file{html/} directory to the same
-directory as @file{regress.plx} resides in.
+generate the html views (to do all regression tests run
address@hidden/regress.pl -a 1}); then, copy the @file{html/} directory to
+the same directory as @file{regress.plx} resides in.
 
 At this point, you should have a working copy of the html regression views.
-