Prerequisites
-------------
Agar currently requires the SDL (http://www.libsdl.org/). Note: this
requirement will be dropped Agar-1.4, as SDL code will be moved to a
specific module.

Options
-------
- The FreeType library (http://www.freetype.org/) is required for high
  quality font rendering. If compiled without FreeType, Agar will revert
  to a simple bitmap font engine. The bitmap font bundled with Agar only
  includes the ASCII range.

- The GL rendering mode requires OpenGL. Agar can be compiled with runtime
  support for both SDL and OpenGL modes.

- Threads support (--enable-threads) requires a POSIX threads interface
  which conforms to SUSv2 (i.e., recursive mutexes are needed).

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@libagar.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, Agar 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 Agar website at http://libagar.org/docs/
for more information.

Installing only Agar-Core
-------------------------
Some command-line applications and daemons use the object system implemented
in Agar-Core, but don't need graphics capabilities. You can compile Agar-Core
without Agar-GUI and its related dependencies using the "--disable-gui" option
to ./configure, and compile your application using `agar-core-config`.

Concurrent building
-------------------
Under Unix, it is possible to build Agar 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. When available, a memory filesystem is
   a good location to build from.
    $ mkdir w-agar
    $ cd w-agar

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

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