CVS Checkout

You can use CVS to check out your own copies of project source code files if you are a member of this project with CVS login access. CVS is an open source version control for keeping track of all modifications to project source code files. You can choose either a command-line CVS client or WinCvs with a Windows interface. What you can do with source files depends upon your role in this project. (Roles?)

Command-line CVS checkout instructions

(Skip to WinCvs checkout instructions)

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:username@projectname.domain.net:/cvs login

   (Substitute in your login for username, and the project name and associated domain, of course.)

   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:username@projectname.domain.net:/cvs checkout [projectname]

   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.

When you are ready to contribute your work into the project's CVS repository, you must commit each file you have modified into the project repository. But before you do that, you should set up an SSH tunnel for security purposes.

• More about SSH tunneling
• More about basic CVS commands and principles

WinCvs checkout instructions

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. Launch WinCvs and select Cvs Admin - Preferences. Enter the CVSroot:

   :pserver:username@[projectname].[domain].net:/cvs

   Click OK.

2. If this 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're working in more than one.)
3. In WinCvs, select Cvs Admin - Login and enter your cvs password.
4. Click on the left window in the program and select a folder. Then select Cvs Admin - Checkout Module. Select the project folder you created earlier.
5. Enter project module name and click OK. You should see a scrolling list of filenames as these are created in your folder(s).
6. Repeat the module creation process for each additional cvs module you wish to check out.