=================================================================== RCS file: /cvs/cvsweb/INSTALL,v retrieving revision 3.7 retrieving revision 3.10 diff -u -p -r3.7 -r3.10 --- cvsweb/INSTALL 2002/11/24 18:03:21 3.7 +++ cvsweb/INSTALL 2003/07/19 23:02:29 3.10 @@ -4,7 +4,7 @@ $FreeBSD$ newer installed and a web server which is capable of executing CGI scripts. - The following Perl modules are required. Chances are that some of + CVSweb uses the following Perl modules. 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, @@ -14,9 +14,10 @@ $FreeBSD$ 5.005_03 and newer. - Module name Ships with Perl version - ------------------------------------------- - File::Temp 5.8.0 + Module name Ships with Perl version + -------------------------------------------------------- + File::Temp 5.8.0 required + MIME::Types N/A optional Surprisingly enough, you need to have cvs installed. The recommended version of cvs is 1.11 or newer. Older cvs versions may work with @@ -33,8 +34,11 @@ $FreeBSD$ doesn't work yet. Install CvsGraph if you want to use it with CVSWeb, and see (6) for - configuration notes. This has been tested with CvsGraph 1.3.0. + configuration notes. CvsGraph 1.4.0 or newer is required. + Install GNU Enscript if you want syntax highlighting, and see (7) for + more info. You'll need version 1.6.2 or newer. + 2) Copy cvsweb.conf to your configuration directory. If you've installed Apache, $ServerRoot/conf (or $ServerRoot/etc with versions >= 1.3.0) makes sense. @@ -48,7 +52,7 @@ $FreeBSD$ point to your configuration file. If your perl binary isn't located in /usr/bin you'll have to edit the first line of the script as well. - If you want to run cvsweb.cgi on Windows NT, see (8). + If you want to run cvsweb.cgi on Windows NT, see (9). 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 @@ -70,9 +74,14 @@ $FreeBSD$ 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! +7) GNU Enscript can be used for syntax + highlighting. To enable it, copy lang_cvsweb.st from the enscript/ dir + to your Enscript "hl" directory (eg. /usr/share/enscript/hl/) and enable + $allow_enscript in cvsweb.conf. -8) If you've Windows NT running, calling of external programs with parameters +8) Have fun! + +9) If you've Windows NT running, calling of external programs with parameters single quoted doesn't work (search for rcsdiff, rlog in cvsweb.cgi), you've to replace it with double quotes. Thanks to Nick Brachet for pointing this out. @@ -85,7 +94,7 @@ $FreeBSD$ > will fail on NT because the ' are not recognized. Using " will work > though. -9) If you like you can add descriptions to be shown next to each directory +10) If you like you can add descriptions to be shown next to each directory or module name. These are read from CVSROOT/descriptions. - Check out a copy of your CVSROOT