version 3.1, 2000/07/19 21:59:47 |
version 3.3, 2002/04/05 11:12:41 |
|
|
|
$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 installed and a webserver which is capable |
have Perl 5 installed and a webserver which is capable |
to execute cgi-scripts. |
to execute cgi-scripts. |
|
|
first line of the script as well. |
first line of the script as well. |
If you want to let cvsweb.cgi run on WinNT running see (7). |
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 |
4) If you do not have the dir.gif, text.gif and back.gif-icons, copy |
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 |
|
them somewhere in your $DocumentRoot and edit the %ICONS-Hashtable |
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 |
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. |
Apache installed .. the're located in the default icons-directory. |
|
|
miniicons in the icons-directory and change the %ICONS-Hashtable in |
miniicons in the icons-directory and change the %ICONS-Hashtable in |
cvsweb.conf. |
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 |
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 to point this out. |
Nick Brachet to point 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. |
|
|
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. |
or module name. These are read from CVSROOT/descriptions. |
|
|
- Check out a copy of your CVSROOT |
- Check out a copy of your CVSROOT |
|
|
- edit descriptions. Add one line for each directory that you would like |
- edit descriptions. Add one line for each directory that you would like |
to have a comment for. You can have HTML in the descriptions. |
to have a comment for. You can have HTML in the descriptions. |
These lines are relative from the $CVSROOT. Example: |
These lines are relative from the $CVSROOT. Example: |
JVote/ An application to assist with <A HREF="http://www.irtc.org/">IRTC</A> voting |
JVote An application to assist with <A HREF="http://www.irtc.org/">IRTC</A> voting |
JVote/images/ Store the images for JVote |
JVote/images Store the images for JVote |
JVote/tools/ Scripts to startup JVote |
JVote/tools Scripts to startup JVote |
- cvs add descriptions |
- cvs add descriptions |
- cvs commit |
- cvs commit |
- Set $use_descriptions to 1 in cvsweb.conf. |
- Set $use_descriptions to 1 in cvsweb.conf. |