Install/Unix
From Agar
Contents |
Installing Agar on Unix Platforms
Prerequisites
As of version 1.4.0, Agar has no dependencies.
Optional
- The SDL library is needed if you want to use the sdlfb and sdlgl drivers.
- The FreeType library is recommended for high quality font rendering. If compiled without FreeType, Agar will revert to a minimal bitmap-style "font engine".
- OpenGL rendering requires an OpenGL library (recommended).
- Threads support (--enable-threads) requires a POSIX threads interface with support for recursive mutexes.
Compiling and installing Agar
Execute the configure script located at the top of Agar's source tree. See ./configure --help for a list of available compile-time options:
$ ./configure
Then compile and install the libraries and executables:
$ make depend all # make install
Feel free to e-mail the developers your test results (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/.
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.
The process for concurrent building is as follows.
Create the build directory. When available, a memory filesystem is a good location to build from.
$ mkdir w-agar $ cd w-agar
Run configure from the source directory with the --srcdir argument specifying the location of the source tree:
$ ~/agar-sources/configure --srcdir=$HOME/agar-sources [...]
Now go ahead and build the libraries and executables as you normally would:
$ make depend && make # make install
More details on Agar's build system are available from the BSDbuild Homepage.
