Prerequisites
-------------
FreeSG requires an Agar installation that has been compiled with support for
at least one 3D graphics API, such as OpenGL. You can compile Agar from source
or download one of the many precompiled packages at:
http://libagar.org/download.html

Options
-------
- The "ode" physics module requires the Open Dynamics Engine library
  (http://www.ode.org/).
- Support for vertex and fragment programs requires the Nvidia CG toolkit
  (http://developer.nvidia.com/page/cg_main.html)
- Thread safety is available if the installed Agar library has threads
  support (the recommended default).

Installation under Unix
-----------------------
1) Execute the configure script. See `./configure --help' for options.
    $ ./configure

2) Compile the libraries and executables.
    $ make depend all
    # make install

3) Let the developers know of your success/failure. If you happen to run
   into trouble, please set a valid return address so we can respond.
    $ cat config.log | mail -s "compiles fine" compile@freesg.org

Installation under SGI IRIX
---------------------------
Under IRIX, we recommend using gcc3 (or SGI cc) because of gcc 2.95 issues
with varargs. There are .tardist packages for gcc3, SDL and freetype
available from: http://www.nekochan.net/.

Installation under Windows
--------------------------
Under Windows, FreeSG can be compiled under Microsoft Visual Studio, Cygwin
and MSYS. We also provide precompiled DLL and LIB files. See "Platform 
specific notes" section of the FreeSG website at http://freesg.org/docs/
for more information.

Concurrent building
-------------------
Under Unix, it is possible to build FreeSG outside of the source directory.
Developers will generally prefer this method, since it results in a faster
build, does not clutter the source directories with object files and
facilitates testing on multiple machines using network filesystems.

1) Create the build directory. Where available, a memory filesystem is a
   good location to build from.
    $ mkdir w-freesg
    $ cd w-freesg

2) If configure was already executed from the source directory, make sure
   to clean it up or the build will fail:
    $ (cd ~/freesg-sources && make cleandir)

3) Run configure from the source directory with --srcdir.
    $ ~/freesg-sources/configure --srcdir=$HOME/freesg-sources [...]

4) Now build the libraries and executables as you normally would.
    $ make depend && make
    # make install