Skip to content

CVS client setup

start:

Access the source code repository for this project in one of the following ways:

OpenOffice.org uses anoncvs and cvs. Anoncvs is for public examination of the cvs repository and is freely accessible. You cannot commit files checked out via anoncvs, however. For that, you must have the appropriate permission and use our cvs repository via an SSH tunnel. See below for more information.

Before you can do an anoncvs checkout, you must set the cvsroot to indicate where the CVS repository for this project is located.

  1. The command to set cvsroot and login is:

    cvs -d :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs login

    Then you can check out a working copy with:

    cvs -d :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs checkout [project name]

    If this is the only project you working on, you only need to set the cvsroot once. Thereafter when you log in to this domain, the cvs repository for this project is assumed. If you are working multiple projects, however, you must specify the cvsroot each time you log in to ensure that the cvs repository you are accessing is the right one.

  2. To check out the project source repository an individual module (if you don't need the entire repository), type:

    cvs -d :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs checkout [projectname]/[modulename]

    This command should result in a scrolling list of files being added to the local directory you specified on your machine. Now you are ready to use your file editor to work with individual files and make changes.

    If you wish to contribute to the project's cvs repository, you must have "cvs-commit" permissions as a project member and checkout the source using an SSH tunnel with your correct OpenOffice.org userid, use:

    <user>@localhost instead of anoncvs@anoncvs.services.openoffice.org.

Note: Before you can commit modified files into the project repository, you must set up an SSH tunnel for security purposes. See our SSH2 Guide for further details.

WinCvs client

To use WinCvs to check out your own set of source code files, you must first set up the correct CVS root using the following steps.

  1. If this is your first CVS checkout, create a folder in Windows Explorer to hold all of your CVS project folders. Then create a subfolder for this project. (You may even want to create separate subfolders for each module if you are working on more than one.)

  2. Launch WinCvs and select Admin - Login. Enter the CVSROOT:

    :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs

    Click OK. Enter password.

  3. Click on the left window in the program and select a folder. Then select Create - Checkout Module. Select the project folder you created earlier.

  4. Enter the project module name and click OK. You should see a scrolling list of filenames as these are created in your folder(s).

  5. Repeat the module creation process for each additional CVS module you wish to check out.

WinCvs how-to guide for this site

TortoiseCVS client

TortoiseCVS is a Windows Explorer shell extension, generally accessed via the right-click context menu on Explorer windows (including your Desktop).

  1. If this is your first CVS checkout, create a folder in Windows Explorer to hold all of your CVS project folders.

  2. Use Windows Explorer to navigate to the folder which contains (or will contain) your checked-out CVS modules.

  3. Select File - CVS Checkout.... The Checkout Module dialog box will appear. (You may also access this dialog by selecting CVS Checkout... from the context menu presented when you right-click on your Explorer window's background.)

  4. In the Module tab, enter the CVSROOT:

    :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs

    Also, enter the Module:

    www/[modulename]

    Click OK. Enter password.

  5. Repeat the module creation process for each additional CVS module you wish to check out.

Command-line CVS client

Before you can do a CVS checkout, you must set the CVSROOT to indicate where the CVS repository for this project is located.

  1. The command to set CVSROOT and login is:

    cvs -d :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs login

    User "guest" has an empty password.

    Then you can check out a working copy with:

    cvs -d :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs checkout www

    If this is the only project you are working on, you only need to set the CVSROOT once. Thereafter when you log in to this domain, the CVS repository for this project is assumed. If you are working on multiple projects, however, you must specify the CVSROOT each time you log in to ensure that the CVS repository you are accessing is the right one.

  2. To check out the project source repository in an individual module (if you don't need the entire repository), type:

    cvs -d :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs checkout www/[modulename]

    This command should result in a scrolling list of files being added to the local directory you specified on your machine. Now you are ready to use your file editor to work with individual files and make changes.

If you wish to contribute to the project's CVS repository, you must have "write" permissions as a project member. Note: If your site requires an SSH tunnel for security purposes, you will need to set one up before you can commit modified files into the project repository.

More about SSH tunneling

CVS how-to guide for this site