Dollarg 2009

Getting Started with $G - January 2009

Setting Environment Variables for your User Account

Edit your ~/.cshrc file and add the lines:

setenv GROOT /map/gfx0
source $GROOT/tools/gfxtools-startup-csh

setenv CVSROOT /map/gfx0/cvsroot

Checking out a project

$G uses CVS for source control and you can read more about it here.

You can work anywhere you choose, but a good location is:

/map/gfx0/users/<your_user_id>

So, for example, if your user id is "foo" and you wanted to check out the "wrist" project, you should type:

/map/gfx0/users/foo
cvs co project/wrist

Building a project

Type "make all" to build a project. Continuing the wrist project example from above, you would type:

cd /map/gfx0/users/foo/project/wrist
make all

Creating a "test" for a project

Testing is helpful to find bugs, detect problems discovered by system upgrades, and to help make sure projects are working on a daily basis.

To add a test to your project, create a "test" target in the Makefile.

For example, to run a test for the wrist project you could type:

cd /map/gfx0/users/foo/project/wrist
make test

Note to doc authors: what if a project wants more than one test?