Chapter 6. Borges and CVS Integration

1. Starting a New Project on CVS
2. What changes when using CVS
2.1. Commands with Modified Behavior
2.2. New Useful Commands

Borges is designed to integrate flawlessly into a CVS environment. We will detail here the initial procedure to start a new project with CVS support and look in detail how to use this new repository with CVS.

1. Starting a New Project on CVS

The principle is quite straightforward: you create an initial repository, you import it to a CVS server, and voilą! We will detail here the steps up to the point where you add your first document to the project.

First of all you must have a working CVS repository and access to it. If your organization does provide one to you ask for access to it and set the CVSROOT environment variable accordingly. If not it is quite easy to create a local CVS repository, refer to your CVS documentation and set the CVSROOT environment variable.

  1. Create a new project skeleton

    This is the same command as usual, we're here creating a project in ~/my_doc/ with French as default language:

    /usr/share/Borges/bin/configure ~/my_doc/ fr
  2. Import the project skeleton to the CVS repository:

    Borges povides a special wrapper to perform that task:

    cd ~/my_doc/ ; make cvsinit PROJECT=MyNewProject

    You will see all files being added to the CVS. Ones this is done you have to retrieve your own copy of the CVS module MyNewProject that has just been created.

  3. Checkout the new CVS module to start working

    Make sure the CVSROOT variable is properly set. We will checkout our local copy of the New project in ~/cvs/:

    cd ~/cvs/
    cvs checkout MyNewProject
  4. Initialize the new copy

    The last step consists in preparing this working copy so that you can use it as any other Borges project:

    cd MyNewProject

    All is now ready, you can add your first document to the system. Read the next section to learn the changes that occur in Borges working with CVS