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 except under the $G directory. At Brown ample disk space has been allocated here for students:

   /map/gfx0/users/$USER

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

   > mkdir  /map/gfx0/users/goo
   > cd     /map/gfx0/users/goo
   > cvs  co  project/wrist        # Creates:  /map/gfx0/users/goo/project/wrist/...

Please do not waste space and retain only the files you need. When you are done with your account please be sure to delete it.

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?