The best way to keep up with the latest changes to our project is to download the code from CVS, and keep a constant monitor on the SCM mailing list (shown below). Here are some instructions for getting the code via CVS:
Anonymous CVS access:
This project's CVS repository can be checked out through anonymous (pserver) CVS with the following instruction set. When prompted for a password for anonymous, simply press the Enter key.
Updates from within the module's directory do not need the -d parameter.
Developer CVS access:
Only project developers can access the CVS tree via this method. SSH1 must be installed on your client machine. Substitute <USERNAME> with the proper value. Enter your site password when prompted.
CVS via Fisheye
Fisheye provides links to download CVS HEAD in various archive formats:
Secure CVS for Windows Users
To do development on windows you need to use a native CVS binary with plink for the SSH access and pageant to manage your keys and passphrase - you will also need to use puttygen to generate your keys.
- Create a directory on your machine where you'd like to install the necessary programs. We suggest
C:\program files\cvs. Into this directory, download the latest versions of CVS , Putty , PuttyGen , Plink and Pageant .
- Add the new directory to your classpath. Go to
My Computer > Control Panel > System > Advanced > Environment Variablesto reach the System Variables window.
- In the System Variables window, edit the
PATHvariable. Place your new directory at the front.
- Create a new variable
CVS_RSHand give it the value
- Create your key with puttygen.
- Start pageant and add your key. It is prefrable to create a key with a passphrase for better security. You may add pageant to your start menu if you wish.
Don't Use Cygwin's CVS
Do not use the cygwin build of CVS. If you have cygwin installed make sure your new directory is in the system path before cygwin's bin directory. The cygwin build of CVS does not work with Pageant.
If you create named sessions with Putty, you can then use these names with CVS. For instance, you can make a Putty session called "drools", set it to SSH and give it your preferred login. You can then access it with:
As an alternative to the above, and if you would rather try a more graphical UI for CVS, SmartCVS http://www.smartcvs.com/ supports SSH2, and can generate keys (or import ones). There is both a free foundation and a pay-for version, with varying capabilities.
Working on the Release Candidate Branch
Once we decide on a feature freeze in preparation for release candidates and the release, we branch the CVS repository. The release is always built from latest release-branch. Only high priority bug fixes should be committed to the release-branch. Whenever committing to the release-branch, you must at the same time merge those commits into the head.
What follows are the procedures for common development use-cases. In these use cases, it is assumed that the latest release branch tag is named 'branch-2_0', and its corresponding merge-point tag is named 'mergepoint-2_0'.
(More info on branching and merging)
Create a release-branch
Checkout the branch
Fix a bug in the release-branch
Fix the bug
Commit to the branch, ensuring you have the lastest from the branch and that all tests pass
Prepare a clean check of head
Merge from the branch to the trunk
Finally, move forward the mergepoint tag in the branch
The reason for the mergepoint is to tell cvs not to consider for merging files that have already been merged previously. (This is where subversion shines. But the above is not difficult with CVS.)
If you don't 'move forward' the mergepoint, and there were conflicts resolved during the last merge, you will have to resolve them again.
Release a release-candidate or a full release
The main point here is to be sure that you create the release from the release-branch.
Additional CVS Info
You can learn more about CVS at http://cvsbook.red-bean.com.