=================================================================== RCS file: /cvs/cvsweb/INSTALL,v retrieving revision 3.1 retrieving revision 3.3 diff -u -p -r3.1 -r3.3 --- cvsweb/INSTALL 2000/07/19 21:59:47 3.1 +++ cvsweb/INSTALL 2002/04/05 11:12:41 3.3 @@ -1,3 +1,5 @@ +$FreeBSD$ + 1) To get cvsweb.cgi to work, make sure that you have Perl 5 installed and a webserver which is capable to execute cgi-scripts. @@ -27,19 +29,7 @@ first line of the script as well. If you want to let cvsweb.cgi run on WinNT running see (7). -4) If you want to have CVS-annotate support, make sure the process - running cvsweb.cgi (the webserver, usually running as 'httpd' or - 'nobody') has write permission to CVSROOT/history (if it exists) and - any directory within your repository to place the lockfiles of the - called cvs-process. I prefer adding the httpd-user to the cvs-group - (but: adding 'nobody' to this group may not be a good idea for - security reasons). Make sure, the cvs-binary is in your PATH. - Note: cvs 1.10 and later supports the LockDir option, allowing you - to move the lock files to a separate directory. With this option - cvsweb does not need any write permission to the CVS repository - directories. - -5) 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-Hashtable in cvsweb.conf. You won't need to do this if you have a stock Apache installed .. the're located in the default icons-directory. @@ -48,9 +38,9 @@ miniicons in the icons-directory and change the %ICONS-Hashtable in cvsweb.conf. -6) have fun +5) have fun -7) If you've Windows NT running, calling of external programs with parameters +6) 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 to point this out. @@ -63,7 +53,7 @@ > will fail on NT because the ' are not recognized. Using " will work > though. -8) If you like you can add descriptions to be shown next to each directory +7) 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 @@ -72,9 +62,9 @@ - edit descriptions. Add one line for each directory that you would like to have a comment for. You can have HTML in the descriptions. These lines are relative from the $CVSROOT. Example: - JVote/ An application to assist with IRTC voting - JVote/images/ Store the images for JVote - JVote/tools/ Scripts to startup JVote + JVote An application to assist with IRTC voting + JVote/images Store the images for JVote + JVote/tools Scripts to startup JVote - cvs add descriptions - cvs commit - Set $use_descriptions to 1 in cvsweb.conf.