Jet3D Project News CVS Log Users Developers Related stuff

If you just want to be up to date with the Jet3D sources, you need not setup the ssh-based CVS client and do all that tricky stuff. Just install WinCVS or the command line CVS client from Cyclic. Then connect to the repository using one of the following procedures:

Accessing the CVS repository (Command Line)

For command line client, issue the command:
cvs -d login
and just hit <Enter> when prompted for password.

Then checkout the module jet
cvs -d co jet

Update your copy of the source daily or subscribe to our announcement mailing list. To update once you've already performed the above procedure, go to the jet directory and type the following:
cvs update -d

Accessing the CVS repository (WinCVS) - by Incarnadine

Once WinCVS is loaded, select the Admin/Preferences menu item and a dialog will appear.  On the General tab, set the CVSROOT to:

Set authentication to:
"passwd" file on the cvs server

Use Version:
CVS 1.10

These are set under the Globals tab:
Checkout read-only,
Use TCP/IP compression,
Dirty files support,
Supply control when adding files.

Click OK once you've verified the settings.  You'll only need to do this once.  Now, login by selecting the Admin/Login menu item.  When prompted for a password, just leave it blank and click OK.

In the status window below you should see that you're now logged in.  You're ready to get the jet module for the first time now.  First, select the directory you want it to retrieve the module to in the explorer pane on the left.  This is where WinCVS will automatically create a directory called jet and put all of the CVS files in it.  Once you've selected the directory, click the Create/Checkout module to selection menu item.

A dialog will appear, type in the module name as jet.  Click OK and then watch the status window to see it downloading the files from the CVS.  Once it completes, you should have a directory called jet under whatever directory you selected before.  This directory contains all of the files from the CVS.

To keep your sources current, all you have to do is select the jet directory in the explorer pane.  Make sure you're logged in.  Then, click the Modify/Update selection menu item.  In the dialog that appears, I would recommend checking the box that says, "Create missing directories that exist in the repository," otherwise you may end up missing new files.

Accessing a Branch - by Incarnadine

Branches are extremely useful.  They allow you to "fork" the code so that you can work on a separate code base from the main trunk.  This allows you to make whatever modifications you want, submit them back to the CVS server, etc. while leaving the main trunk in a stable state.  Other people can access the branch you're working on by simply requesting it using the procedure below.  Once your changes have been well tested, you can automatically merge your changes back into the main trunk.  Here's how to access an existing branch.

Whenever you tell WinCVS to "update" your files, you have to go to the Sticky options tab of the update dialog. Tell it to Retreive rev./ tag/branch and type in the name of the branch you're interested in retrieving. Also, make sure the checkbox that reads, "If no matching revision is found, use the most recent one," is checked, otherwise files that don't exist in the branch will be removed from your local copy.  Click OK.

Once it retrieves your sources, then in the column on the right hand side that says "Tag", you'll see whatever branch your current working copy is using. Files have a blank tag indicate the main trunk.

For example, if you want to request the ActorCollision branch, just tell it to update the jet module, select ActorCollision in the sticky options, verify the checkbox, and then click OK. Then, if you go take a look at any of these files, you should see the ActorCollision tag next to the name:
ExtBox.h/c, Actor.h/c, jeWorld.h/c

[Jet3D Project] [News] [CVS Log] [Users] [Developers] [Related stuff]