version 3.3.2.2, 2019/03/21 15:22:20 |
version 3.8, 2003/04/27 16:57:39 |
|
|
$FreeBSD$ |
$FreeBSD$ |
|
|
1) To get cvsweb.cgi to work, make sure that you |
1) To get cvsweb.cgi to work, make sure that you have Perl 5.005_03 or |
have Perl 5 installed and a web server which is capable |
newer installed and a web server which is capable of executing CGI |
of executing cgi-scripts. |
scripts. |
|
|
|
The following Perl modules are required. Chances are that some of |
|
these are already installed with your Perl distribution. The oldest |
|
Perl distributions, if any, that already ship with these modules have |
|
been marked below. If your Perl doesn't have some of the modules, |
|
you can get them from CPAN, <http://www.cpan.org/>. Be sure to |
|
install also the prerequisites these modules may have. Note that |
|
this list contains only modules that aren't already part of Perl |
|
5.005_03 and newer. |
|
|
|
|
|
Module name Ships with Perl version |
|
------------------------------------------- |
|
File::Temp 5.8.0 |
|
|
Surprisingly enough, you need to have cvs installed. The recommended |
Surprisingly enough, you need to have cvs installed. The recommended |
version of cvs is 1.11 or newer. Older cvs versions may work with |
version of cvs is 1.11 or newer. Older cvs versions may work with |
more or less quirks, YMMV. |
more or less quirks, YMMV. |
|
|
Currently, you'll also need to have the GNU RCS utilities 'rlog', |
Currently, you'll also need to have the GNU RCS utilities 'rlog', |
'rcsdiff' installed (current version is 5.7). |
'rcsdiff' installed (current version is 5.7). |
|
|
This will change if cvs will be able |
This may change if cvs will be able to serve these functions without |
to serve these functions without having a working directory |
having a working directory [see TODO]. |
[see TODO] |
|
Note that the cvsweb.cgi script needs to have physical |
|
access to the repository (or a copy of it) therefore; |
|
rsh/ssh or pserver access doesn't work yet. |
|
|
|
|
Note that the cvsweb.cgi script needs to have physical access to the |
|
repository (or a copy of it) therefore; rsh, ssh or pserver access |
|
doesn't work yet. |
|
|
|
Install CvsGraph if you want to use it with CVSWeb, and see (6) for |
|
configuration notes. CvsGraph 1.4.0 or newer is required. |
|
|
2) Copy cvsweb.conf to your configuration directory. If |
2) Copy cvsweb.conf to your configuration directory. If |
you've installed Apache, $ServerRoot/conf (or $ServerRoot/etc |
you've installed Apache, $ServerRoot/conf (or $ServerRoot/etc |
with versions >= 1.3.0) makes sense. |
with versions >= 1.3.0) makes sense. |
|
|
point to your configuration file. |
point to your configuration file. |
If your perl binary isn't located in /usr/bin you'll have to edit the |
If your perl binary isn't located in /usr/bin you'll have to edit the |
first line of the script as well. |
first line of the script as well. |
If you want to run cvsweb.cgi on Windows NT, see (6). |
If you want to run cvsweb.cgi on Windows NT, see (8). |
|
|
4) If you do not have the dir.gif, text.gif and back.gif icons, copy |
4) If you do not have the dir.gif, text.gif and back.gif icons, copy |
them somewhere in your $DocumentRoot and edit the %ICONS hash |
them somewhere in your $DocumentRoot and edit the %ICONS hash |
|
|
mini icons in the icons/ directory and change the %ICONS hash in |
mini icons in the icons/ directory and change the %ICONS hash in |
cvsweb.conf. |
cvsweb.conf. |
|
|
5) Have fun! |
5) Copy cvsweb.css from the css/ directory to a web server directory, and |
|
point the $cssurl variable in cvsweb.conf to it. |
|
|
6) If you've Windows NT running, calling of external programs with parameters |
6) CvsGraph <http://www.akhphd.au.dk/~bertho/cvsgraph/> can be used with |
|
this version of CVSWeb. See the $allow_cvsgraph and $cvsgraph_config |
|
configuration variables in cvsweb.conf. cvsweb.cgi will override some |
|
of the settings in the cvsgraph configuration file with command line |
|
options; the following in particular: map_branch_href, map_rev_href and |
|
map_diff_href so you won't have to tweak them for CVSWeb. Note (and |
|
install) also the cvsgraph.png icon in the icons/ directory. |
|
|
|
7) Have fun! |
|
|
|
8) If you've Windows NT running, calling of external programs with parameters |
single quoted doesn't work (search for rcsdiff, rlog in |
single quoted doesn't work (search for rcsdiff, rlog in |
cvsweb.cgi), you've to replace it with double quotes. Thanks to |
cvsweb.cgi), you've to replace it with double quotes. Thanks to |
Nick Brachet for pointing this out. |
Nick Brachet for pointing this out. |
|
|
> will fail on NT because the ' are not recognized. Using " will work |
> will fail on NT because the ' are not recognized. Using " will work |
> though. |
> though. |
|
|
7) If you like you can add descriptions to be shown next to each directory |
9) If you like you can add descriptions to be shown next to each directory |
or module name. These are read from CVSROOT/descriptions. |
or module name. These are read from CVSROOT/descriptions. |
|
|
- Check out a copy of your CVSROOT |
- Check out a copy of your CVSROOT |
Line 107 o View the entries in the web servers error.log |
|
Line 135 o View the entries in the web servers error.log |
|
exception - MSIE claims to understand gzip encoded content but |
exception - MSIE claims to understand gzip encoded content but |
displays garbage .. so MSIE is disabled now. Maybe you find another |
displays garbage .. so MSIE is disabled now. Maybe you find another |
Browser with this problem, then you should disable compression |
Browser with this problem, then you should disable compression |
($allow_compress=0 in cvsweb.conf). |
($allow_compress=0 in cvsweb.conf) and |
|
report it to me (<zeller@think.de>) |