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

$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

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.

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

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?