FlightGear Anonymous CVS instructions

Please follow these instructions to check out a copy of the FlightGear source code and data. This instructions are slanted towards the command line version of CVS.

1. Make a directory to hold everything.

2. Go to the new directory.

3. Check out a copy of the source code.

4. Check out a copy of the data (base package.)

5. Compile the source code.

Note: FlightGear has several prerequisites that must be installed before you can build this source code. If you attack these prerequisites in the order listed below, you should be good. Now, configure and compile the FlightGear source code. Note that the configure script can take many options. Run "./configure --help" to see what they are. Some interesting options to consider are "--prefix=/desired/install/path" and "--with-threads"

6. Test run your freshly built version of fgfs.

The executable is created at /some/path/FlightGear-0.9/source/src/Main/fgfs Run this with the -fg-root= option so it can find the data. You can put this option in your ~/.fgfsrc to save some typing each time you run FlightGear.

7. Keep your local source and data copies up-to-date.

Finally (and this is the good part) if you cd to the /some/path/FlightGear-0.9/source directory (the one that was created with the very first checkout command) and run "cvs update -d -P", your local source tree will be automatically synced with the master repository. The "-d" flag automatically adds any new directories that have been created in the repository, and the "-P" automatically removes any old directories that have been removed from the repository.

Also be aware that the latest CVS source code usually requires the latest CVS data (base package.) You must cvs update both.

If you pulled new source code files you must rebuild FlightGear: CVS is pretty smart, so if you have made local changes that don't conflict with any changes to the master repository, cvs should be able to merge the changes together, even when the changes have been made to the same file. If you have made changes that do conflict with new changes to the master repository, cvs will let you know, and you can go edit the file with conflicts and resolve them.

Tip to save time and bandwidth

If you have limited bandwith or just want to save time, you can add a file called .cvsrc into you home directory. (usually /home/your-username/). Copy the following lines into /home/your-username/.cvsrc.

cvs -z3 -q
diff -up
update -dP
checkout -P
rdiff -u

Curtis L. Olson