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.

Getting the CVS software:

You must have a recent version of cvs installed on your system in order for any of this to work. Cyclic Software supports and maintains CVS. CVS continues to be a free, open-source product. Cyclic makes a living by selling support. Cygwin and most modern linux distributions offer an installable cvs package that should work great.

1. Make a directory to hold everything.

cd /some/path
mkdir FlightGear-0.9

2. Go to the new directory.

cd /some/path/FlightGear-0.9

3. Check out a copy of the source code.

cvs -d :pserver:[email protected]:/var/cvs/FlightGear-0.9 login
CVS passwd: guest

cvs -d :pserver:[email protected]:/var/cvs/FlightGear-0.9 co source

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

cvs -d :pserver:[email protected]:/var/cvs/FlightGear-0.9 login
CVS passwd: guest

cvs -d :pserver:[email protected]:/var/cvs/FlightGear-0.9 co data

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.

Glut. Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the glut and glut-devel packages.
Zlib. Most distributions install the basic zlib libraries by default, but not the development portions. If you don't have zlib.h, you probably need to install the zlib-devel package for your distribution.
Plib - portability libraries and scene graph.
Metakit. A suitable version of MetaKit is included in the SimGear/src-libs/ subdirectory. If your distribution doesn't provide a Metakit (and Metakit-devel) package, you will have to build and install it before you can compile SimGear.
SimGear - Simulation support libraries. If you are building FlightGear from CVS, you need the CVS version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.

Now, configure and compile the FlightGear source code.

cd /some/path/FlightGear-0.9/source
./autogen.sh
./configure
make

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.

cd /some/path/FlightGear-0.9/source/src/Main/
./fgfs --fg-root=/some/path/FlightGear-0.9

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.

cd /some/path/FlightGear-0.9/source
cvs update -d -P
cd /some/path/FlightGear-0.9/data
cvs update -d -P

If you pulled new source code files you must rebuild FlightGear:

cd /some/path/FlightGear-0.9/source
make

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