Table of Contents
There are two ways to get the VR Juggler source code:
Get the source directly from the CVS repository.
Download a snapshot of the source code as a TAR file from the “Download” page.
Both methods are described in this section, though the second is mostly self-explanatory.
Before you can use CVS to get the source code, you must be sure that CVS itself is set up properly on your system. Depending on your platform, CVS may be available in several different forms. The most common version is the original command-line interface. If CVS is not available on your system, you can get the source from CVShome.org. This version is available for all platforms including Win32. For graphical interfaces, you can choose from the following:
MacCVS/WinCVS: Afreely available front-end for CVS available from WinCvs.org
jCVS: A CVS client written in Java available from jCVS.org
tkCVS: A Tcl/Tk-based interface to CVS available from Two BarleyCorns
Once you have CVS running in some form, you are ready to download the source from the VR Juggler repository, hosted at SourceForge. The instructions given here are from the CVS section VR Juggler project page and are subject to change if the SourceForge policies change. Note that there are two sets of directions on that page: one for anonymous access and one for developers with commit access. Each of those is discussed in the following subsections.
Anonymous CVS access is for those who want the latest source code but do not have commit access. This would include developers who are working on patches they wish to submit for addition to the source base. As of this writing, the following are the basic instructions for anonymous CVS access:
“Log in” to the SourceForge CVS server. This step only has to be done the first time you access the repository. Afterwards, the login setting is saved in your $HOME/.cvspass file.
% cvs -d:pserver:anonymous@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler login
Check out a copy of the current VR Juggler source tree:If what you really want is the VR Juggler 1.0 release branch instead of the developmental main branch, use the following command:
% cvs -d:pserver:anonymous@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler checkout juggler
(The string RELENG_1_0 is the name of the branch in the CVS repository containing the VR Juggler 1.0 release code. “RELENG” means “release engineering”.)
% cvs -d:pserver:anonymous@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler checkout -r RELENG_1_0 juggler_1.0
Once you have the source checked out, you can use CVS as you normally would keeping in mind that you have read-only access to the repository when using anonymous access.
You may find it useful to retain the CVSROOT value rather than always giving the -d option on the command line. Setting the $CVSROOT environment variable does just that. Defining an alias such as cvsjuggler that sets the environment variable is the recommended method.
For those developers with commit access, the steps are slightly different. You must have some version of SSH1 installed to access the repository as a developer. This is required by SourceForge, and we (the VR Juggler Team) have no control over this. The steps then to get a read/write copy of the VR Juggler source tree are as follows:
Set the environment variable $CVS_RSH to use ssh(1).
% CVS_RSH = ssh
(Note that this is using the shell-independent environment variable syntax defined in the Getting Started Guide.) It is recommended that you set this environment variable in your shell's configuration appropriate configuration file or as part of an alias that configures your environment to work with the VR Juggler CVS repository.
Check out the source using your SourceForge login name.
% cvs -dlogin_name@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler checkout juggler
Be sure to use the appropriate branch name.
Note that there is no login step in this case. Your SourceForge password is required for all CVS commands.
After this point, you can access the CVS repository as though it is a normal, local repository. As with the anonymous CVS access, you can set the $CVSROOT environment variable to the value given with the -d option above. For further information about using SSH with SourceForge, please refer to the appropriate SSH ocumentation and to SourceForge's documentation.
As a developer, you will probably need access to the latest VR Juggler source and therefore should be getting it from the CVS repository. In some cases, however, it may be helpful to get a snapshot of the code in an archived format. The download page on the VR Juggler website has a section listing source code snapshots. Here, you can get a compressed tar file containing the official source code for a particular release of VR Juggler. These snapshots are not for developmental purposes and will not give you access to the CVS repository.