WinCVS Basic Guide
For information on CVS itself, see my CVS
The sspi password protocol is probably the best for use with
Windows since it is more secure than the other protocols (e.g. the
more traditional pserver protocol), and is well-integrated with the
Windows user account system. So, create an environment variable
called CVSROOT and give it the value
If WinCvs can't find your Python installation, click on the
Admin menu, then select the Preferences... option.
Next, select the WinCvs tab. Now, in the Python DLL
entry, type in the relevant path (it's in the
c:\windows\system32\ folder), or use the browse button.
Starting a WinCVS Session
- To start working with WinCVS and the CVS repository, once in
WinCVS, click Admin.
- Click Login.... You'll get a dialog box entitled
Login settings. Here, you can enter the CVSROOT value
mentioned above, or you can force WinCvs to use the environment
variable mentioned above by unticking the checkbox.
- Once you've entered the value of CVSROOT or unticked the
checkbox, click OK.
- Enter your password on the server (if you have selected the
sspi protocol in CVSROOT)
Creating a New Module
- Remove any files and folders that should not go in the
- Right-click on the folder and select Import module and
follow the instructions.
- Quit WinCVS.
- Delete the folder after you have successfully imported it (it
can't be deleted from within WinCVS).
- Re-run WinCVS.
- Right-click the directory that is to contain the
- Select Checkout module...
- Type the name of the directory you just imported.
- If you want to change the name of the directory in which the
module is stored, ensure the Check out into directory
checkbox is checked, and enter the new name into the text
- Add the new module's name to CVS's list of modules thus:
Removing Files from a Module
- Select files to be removed.
- Click the Modify menu.
- Click Remove. Note that this does not actually remove
the files, it merely tells CVS to prepare to remove them.
- Right-click on the directory of the module that contains the
files to remove.
- Click Commit. Note that this still does not actually
erase the files; they remain in the repository, but CVS
marks them as removed. This means CVS won't include these files
in future checkouts.
- You can now delete the removed file(s) from the working
Adding a File to an Existing Module
- Click on the file(s) to add.
- Click the Modify menu.
- Click Add selection. Note that this does not actually
add the file to the repository, but marks it for addition at the
- Click Commit.
- ???? Delete the file.
- ???? Check the file out.
- Note that you don't have to include all the files in your
working copy in the CVS module. This allows you to have temporary
files in the working copy without worrying that they'll be
included into the module whenever you do a commit.
Sending Changed Files to an Existing Module
- Right-click on the directory containing the changed files.
Note that this can be done on a subdirectory of the module or the
module's entire directory tree.
- Click Commit selection...
- Enter a suitable log message.
- Click OK.
Abandoning a Working Copy of a Module
- Click on the module's parent directory in the left hand
- Click on the module in the right hand pane.
- Click the Edit menu.
- Click the Release option.
- Click OK.
- Click Yes.
Obtaining an Existing Module for Development
- Select the directory into which the module is to be created.
Note that the module will be given its own subdirectory within
this directory by WinCVS.
- Click the Remote menu.
- Click the Checkout module... option.
- Enter the module's name in the Module name and path
Content last updated: 2010-01-22