[ZooLib Home] [Documentation]

Getting ZooLib via CVS

CVS is the Concurrent Versions System, the most popular source code management system in use for Open Source software. CVS is provided by SourceForge for projects hosted on it to track changes to their source code.

To use CVS, you will need the client software installed on your system. There are clients for a variety of operating systems, both GUI and command line. You can find information about CVS at http://www.cvshome.org/ and find clients for a variety of operating systems at http://ftp.cvshome.org/

If you are using a Linux system, it is likely that your distribution will offer a package you can install, but most likely this is not included in the default installation.

Browsing CVS via the Web

SourceForge provides a web interface to its CVS repositories. You can check it out at this URL:

http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/zoolib/

Anonymous CVS Access

Anyone may use anonymous cvs to obtain read-only access to the repository. On a Unix system, create a directory to hold all of your ZooLib stuff and then log in:

mkdir ZooLib
cd ZooLib
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/zoolib login

When you are prompted for a password, just press your Enter or Return key; there is no password for anonymous users.

Then you may check out a top-level directory:

cvs -z8 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/zoolib co zoolib

The separate "doc" module has been moved to be underneath "zoolib" so that you can get everything in a single checkout. If you got the doc previously it's probably best to delete it and check everything out afresh.

ZooLib Developer Access

If you are registered as a developer with ZooLib, you may use ssh (Secure Shell) to get write access to CVS. The SourceForge CVS HOWTO (UNIX Platforms) discusses this.

You will need the ssh client installed on your system - there are several such clients available. For Windows users, I suggest you install Cygwin, a POSIX emulation environment for Windows, which comes with both ssh and cvs.

First you will need to tell CVS that it is to use ssh to run remote programs. Set the environment variable CVS_RSH to "ssh"; if you are using bash:

export CVS_RSH=ssh

Then you use the "cvs co" command to get the source. Of course you will want to make a directory where all your ZooLib stuff goes. In the following, replace "loginname" with your sourceforge username:

mkdir ZooLib
cd ZooLib
cvs -d:ext:loginname@cvs.sourceforge.net:/cvsroot/zoolib co zoolib

Where Was the ZooLib Source Code?

Many of you looked here before and found that ZooLib wasn't available from CVS.

ZooLib is now available in SourceForge CVS. To explain, ZooLib CVS was still on a private server for about a year and a half after it was released as open source.

ZooLib was originally developed as a proprietary API for author Andy Green and his consulting clients to use. Up until recently, he and his clients maintained the ZooLib CVS on their own private servers.

They were unable to place it in public CVS right away because some proprietary code was included in the original source tree, and the original developers needed to modify their build systems to handle getting sources from both the old, private CVS, and the new SourceForge CVS.