[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [gnugo-devel] html regression views
From: |
Marcin Garski |
Subject: |
Re: [gnugo-devel] html regression views |
Date: |
Tue, 18 Oct 2005 23:35:30 +0200 |
User-agent: |
Mozilla Thunderbird 1.0.7-1.1.fc4 (X11/20050929) |
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.
-