1) Compilation requirements
---------------------------

For compiling ARAnyM you will need libSDL, version at least 1.2.9.
You can get it from http://www.libsdl.org/ or from your OS distribution vendor.

If you want to compile source fetched from CVS you also need
automake, libtool and autoconf (http://www.gnu.org/ or your OS vendor).

Supported platforms:

All Debian GNU/Linux platforms

and

x86          BeOS
x86          GNU/Linux
x86          MS Windows + Cygwin
x86          OpenBSD (unmaintained)
PPC          MacOS X
SGI          Irix (unmaintained)
Sun Sparc    Solaris

In progress (in alphabetical order):
m68k         FreeMiNT
x86          FreeBSD
x86          NetBSD


2) Compilation
--------------

  2-1) Unix or Linux
  ------------------
Go to src/Unix folder first.

If you got the source code from CVS then type
./autogen.sh && make

If you have a source snapshot or proper ARAnyM source code release then type
./configure && make

./configure --help shows you all the compile time options.

If everything went OK you got an executable file named "aranym".


  2-2) Microsoft Windows
  ----------------------
Compilation is accomplished using the Cygwin linux-like environment
(http://www.cygwin.com/).

Details are available in tools/build-cygwin.sh.


  2-3) Apple Mac OS X
  -------------------
There are several methods of building ARAnyM for OS X. Details will
be added here.


3) Installation
---------------
You may install ARAnyM on Unix/Linux by typing 'make install' (have root
privileges as default configuration installs to /usr/local/),
or you may run the binary directly by typing ./aranym.

Next step is to obtain the operating system (TOS 4.04 or EmuTOS) and install
a harddrive. More on this in the README file. Easiest is to download
one of the 'afros' disk images (Aranym FRee OS) that contain everything
preinstalled.


4) Troubleshooting
------------------

If you compiled libSDL by yourself and installed to /usr/local/ you might
experience the following problem when running autogen.sh:

aclocal: configure.in: 835: macro `AM_PATH_SDL' not found in library

The fix is relatively easy:

export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"

This helps aclocal to find the .m4 file and everything is fine then.
