CVS Integration

Applies to Collaborator 14.5, last modified on April 18, 2024

Collaborator seamlessly integrates with the CVS version control system. This section provides a general overview of integration preferences, ways to review files controlled by CVS, and so on.

About Integration

Using the built-in Collaborator CVS integration, you can quickly upload various files to the Collaborator server to create a review directly from the desktop client of your choice. The types of files you can upload include:

  • CVS-controlled files.
  • Arbitrary CVS diffs.
  • CVS labels.
  • CVS dates.

CVS integration uses CVS client applications that are already installed on the client computer. That is, integration supports all protocols, authentication settings, proxies, and other configuration specifics.

Supported Versions

To enable the integration via GUI Client and Command-Line Client, you need a CVS command line client (cvs.exe) that will communicate with the server. We support these versions:

  • v1.11.1 and later.
  • v1.11.0 and before, only ccollab addcvsdiffs is supported.
  • CvsNT (Windows-only).

In Eclipse Plug-in, the Eclipse CVS plugin is built-in to communicate with the CVS server. It does not require any CVS client to be installed.

Ways of Integration

You can enable the integration between Collaborator and CVS for GUI Client, Command-Line Client, or Eclipse.

GUI Client

To enable the integration:

  1. Start GUI Client.

  2. Click Add to create a new SCM configuration.

  3. In the subsequent SCM Configuration dialog, specify the local source code location. Then, select CVS in the SCM drop-down list.

  4. Several options will become available. These are specifically tailored to configure CVS integration.

    Option Description
    CVS Executable A full path referring the CVS command line client (cvs.exe).
    CVS Root A connection string for the CVS repository (cvsroot).
    CVS SCM Configuration
  5. Once ready, click Validate to make sure the integration is operational.

After that, a new configuration for CVS will appear on the main screen of the GUI Client.

Select it, then click on the corresponding button depending on what you want to do next:

Buttons for CVS files uploading
  • Add Changes – Upload modified files in a CVS checkout to the Collaborator server to create a review.

    Add Changes
  • Add CVS Diffs – Upload arbitrary diffs to a review.

    Add CVS Diffs

    On the Labels tab, you can upload diffs between two labels.

    Upload the difference between two Labels

    On the Dates tab, you can upload diffs between two dates.

Command-Line Client

In the Command-Line Client, you can create a review for changes you have applied locally to files controlled by CVS – before uploading these to the version control repository. You can also upload arbitrary CVS diffs if needed.

The addchanges command will upload local changes to files controlled by CVS before they are checked into version control. For example, the following command creates a new review and adds all changes in the current directory and below, plus the foo.txt file:

ccollab addchanges new . foo.txt

In most cases, the Command-Line Client can automatically detect your CVS configuration. Try testing your configuration to verify the configuration is detected correctly.

If the Command-Line Client is unable to detect your CVS configuration or you want to override the detected settings, you can manually specify CVS settings using global options.

To manually configure the Command-Line Client to use CVS, execute the following command:

CVS-specific Options

Option

Description

--cvs-exe <value>

Full path to the "cvs" command-line client.

--cvsroot <value>

Connection to the CVS repository.

Eclipse Plug-in

Eclipse Plug-in has a built-in integration with the Eclipse CVS team plugin. With this, you can upload locally modified files to a review directly from the plugin.

To learn more, please see Add to Review Wizard.

Technical Details and Limitations

Collaborator does not guarantee that Diff Viewer will display correct comparison results for the following cases:

  • If you add several diffs (non atomic changelists) to the same review.

See Also

SCM Configuration
ccollab set
Source Control Integrations

Highlight search results