$Id:$

REQUIREMENTS

The cvslog module is meant to work in conjunction with other modules.

This documentation assumes that you will be using cvslog along with these

additional moudles:

INSTALLATION

Follow the standard installation procedures for the cvslog, project and

project_issue modules.

CONFIGURATION

CVS Server Config

All of the following configuration steps take place on the server that hosts

your CVS repository, not necessarily on the server hosting your Drupal site.

CVS integration requires the xcvs scripts that are distributed with

cvslog. However, these scripts should not be run from within your website's

document path.

Determine the directory from which these scripts will run (we'll use /opt/xcvs)

and do the following:

You can also simply copy the xcvs directory distributed with cvslog into /opt.

Create links to the xcvs scripts in the directory named 'CVSROOT' within

your CVS server's CVS root directory.

Configure CVS to run the xcvs scripts when files are checked in. You will

need to edit three files in CVSROOT/

DO NOT edit these files directly Instead, you will need to check out

your repository's CVSROOT module and edit the checked out files. To checkout

CVSROOT, set your $CVSROOT appropriately and do 'cvs co CVSROOT'.

From within your checked out CVSROOT directory, you will need to edit three different files.

1) Edit commitinfo adding the following to the end of the file:

ALL $CVSROOT/CVSROOT/xcvs-commitinfo.php $CVSROOT/CVSROOT/xcvs-config.php $USER %r/%p %s

2) Edit taginfo adding the following to the end of the file:

ALL ALL $CVSROOT/CVSROOT/xcvs-taginfo.php $CVSROOT/CVSROOT/xcvs-config.php $USER %t %b %o %p %{sv}

3) Edit loginfo adding the following to the end of the file:

ALL $CVSROOT/CVSROOT/xcvs-loginfo.php $CVSROOT/CVSROOT/xcvs-config.php $USER %1{sVv}

Lastly, commit your changes:

Create a Drupal repository configuration

1) Go to admin/project/cvs-repositories and select 'Add Repository'

2) Complete the form according to the instructions and submit.

3) Determine the ID of the repository you just created. If this is the first

repository created, the ID should be 1.

Final configuration of xcvs

Edit /opt/xcvs/xcvs-db.php. You will need to configure database connectivity

to your Drupal site as well as the ID of the repository you just created.

Map Drupal users to CVS users.

Go to admin/project/cvs-accounts and select 'Import'.

Copy the contents of your CVS passwd file here (it can be found in the

CVSROOT directory in the actual CVS Root directory on the CVS server) and

submit the form.

Project set up

Create a new project node at node/add/project-project.

Under the 'CVS Integration' section, select the CVS repository that you just

configured and the path to the project related files in the CVS repository.