WinCvs Guide

Initial Setup

The first thing that you need to do is to create a directory that will store all of modules that you will be checking out of the cvs repository. I created a directory called "sandbox" on the root of my c: drive. Name it whatever you want, but no spaces though or you will be hurting later...

Install WinCvs

First Download WinCvs from this page, and choose the "[Download Installer]" link from whatever is in the "Latest Recommended Release" section.

Once downloaded, you need to install it now. So unzip the archive you downloaded, and then double-click on the "wincvs_setup.exe" executable. This will install both WinCvs and also CVSNT which is required for WinCvs to work. Follow the steps to the wizard now... Take all of the defaults -- don't need anything special. You can do the same for the CVSNT wizard -- take the defaults.

Configure WinCvs

Now that you have WinCvs installed, go ahead and open it up. If you get a warning that Python is not installed, don't worry about it. Go to the "Admin" -> "Preferences" file menu option. On the "CVS" tab, browse for the directory you created in the initial setup section. In my case it was "c:\sandbox". Hit "OK". Next goto the "Admin" -> "Login" file menu option. Enter this for the CVSROOT field:

:sserver:YOURCVSUSERNAME@nnn.nnn.nnn.nnn:2401:/cvsroot

and then hit "OK". Enter your password when it prompts you. When you have logged in successfully you should see the following in the console:

***** CVS exited normally with code 0 *****

Now click on the toolbar button right to the right of the dropdown. Choose your directory you created in the initial setup section.

Checkout Modules

You are now ready to start checking out modules from the cvsnt repository located on the server. For checking out modules, I generally like to create a local directory for the module release you are working on, and then actually checkout the module into that directory. Something like this before you actually do the checkout:

c:\sandbox\WORKFLOW_1_0

This way you can have more than one release checked out at a time. See versioning standards for the release naming conventions.

Checkout Resources Module

This is the only module that we will not be creating actual releases for (just a central repository for us to store shared documents), so you don't need to create the extra directory for this one if you don't want to. Right-click on your root directory in WinCvs and choose "Checkout Module". Enter these fields:

Module name and path on the server: resources

CVSROOT: :sserver:YOURCVSUSERNAME@nnn.nnn.nnn.nnn:2401:/cvsroot

Now hit "OK" and the module will de downloaded locally to your machine. This initial download may take a little while, so wait it out. It will only be bad on this first download...

Once its done, you need to update the module to be whatever release you are working on. To get a better understanding of the release naming conventions, see versioning standards. Now right-click on the "workflow" directory in WinCvs (which should now have a checkbox icon on the folder indicating it is versioned) and choose "Update". In the "Update settings" tab, check the "Create missing directories that exist in the repository" checkbox. In the "Update options" tab, check the "By revision/tag/branch" checkbox and select "wf10x" from the dropdown. Hit the "OK" button and you should be good to go.