Source Control

The $G tree is not intended for users to write to directly, and future IT plans for our group include enforcing this restriction. Instead, we use the revision control system CVS as an interface to the directory structure in $G. CVS keeps track of changes to every file, allows concurrent editing of source code by multiple people, and provides an easy means for copying source trees to new locations.

Ordinarily, the first steps of development for your own software project happens somewhere in your homedir. This doesn't allow other people to work with your code, though, so once it's nontrivial you should add it to $G:

1. Go to the directory that has your source in it.
2. Delete or move away anything you don't want to go into CVS. If you already have something compiled, do make clean to get rid of the object files---you don't want to put them in CVS. In general, just leave the Makefile and the source files.
   • Note: even though non-source files are sometimes necessary for builds of complex projects, data and config files don't belong in $G/src! Carefully consider whether non-source files belong in the $G/src; they most likely do not and belong in $G/lib (or $G/data for example data on which your program runs) instead.
3. If you have any binary files, like images that you want to go in CVS, move them out of this directory temporarily. We will add them later because CVS requires non-text files to be added with a special flag. Once again, keep in mind that most binary files are program resources and belong in $G/lib instead.
4. Run the following command, replacing <projectname> with the name you want your project to have---that will become a new directory under $G/src:

   gfxprojinit <projectname> .

   • Note the period at the end of that command. It might be hard to see, but it is important.
   • It's worth knowing, for those familiar with CVS, that gfxprojinit is essentially a fancy wrapper around cvs import. Please be sure to use gfxprojinit anyway, as it maintains important metadata and may do even more in the future.
5. If you had some extra files you wanted to add to CVS like build components, config files, program resources, or example data, you now want to check them into the relevant directories, which will be among $G/src/<projectname>, $G/lib/<projectname>, and $G/doc/<projectname>. For each relevant directory, which we'll call $X, do the following:
   1. Create $X, import it into CVS, then delete it and check it back out.
   2. Copy each appropriate file into $X, and for each one run the command:

      cvs add -kb <filename>

   3. After adding all the files, run:

      cvs commit -m "<commit message>"

6. Your project should have been automatically added to the $G/src directory on the filesystem you are on now. To get it in the $G/src directory somewhere else, like at the Cave, run this command from within $G/src:

   cvs update -d <projectname>

   You may also need to use the same command in $G/lib and $G/doc.