Check out projects

Checking out a project

Before checking out a project, be sure that your development environment is set up for $G.

$G uses CVS for source control and you can read more about it on its official site or on Wikipedia.

After you have your Sandbox set up you can checkout a project. Even if you are working on Windows you should use Linux to perform CVS operations. Many projects will only build on certain platforms.

Project code will either be in the common/ or project/ top level CVS directories. The common/ directory has code that is shared by multiple projects in the project/ directory.

If you wanted to check out the "wrist" project, you would type:

   > cd     /map/gfx0/users/$USER  # Go into your Sandbox.
   > 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 on Linux

Before a project can be built any dependent packages need to be in the import/ directory. The wrist project depends on Blitz.

> cp -R /map/gfx0/tools/linux/import/blitz/  /map/gfx0/users/$USER/import/blitz/

The wrist project is a large project composed of several programs and libraries. It follows the convention of using a Makefile in the top level directory to build the entire project. Each project developer decides how their projects are organized and how they are built. You'll need to look at documentation for a project to determine how to build it.

Continuing the wrist project example from above, you would type:

> cd  /map/gfx0/users/goo/project/wrist
> make  all

Building a Project on Windows

The wrist project does not build on Windows. Instead we'll show how to build a Type "make all" to build a project. Continuing the wrist project example from above, you would type:

   > cd/d  Y:\map\gfx0\users\goo\project\wrist
   > make  all

By convention simple projects that build a single program or library can be built just by typing "make".