Compiling Agena
---------------

The sources have been compiled successfully on various GCC compilers (see below). If you use
Windows, you should use MinGW.

It is advised to use GCC 4.4.x in order to get correct results with complex number arithmetic.

With all operating systems, first configure your installation by typing

           'make config'

(without the quotes), which determines the endianness of your system.

Depending on your operating system, now enter one of the following statements
(without the quotes):

Solaris:   'make solaris' (with command line history)
Mac OS X:  'make macosx' (with command line history)
Windows:   'make mingw' (with command line history)
Linux:     'make linux' (with command line history)
Linux:     'make linuxplain' (without command line history)
Nexenta:   'make nexenta' (without command line history)
DOS:       (see chapter below)
OS/2:      (see chapter below)

To compile Agena with command line history on Solaris, Mac OS X, and Linux, you must have
the ncurses and readline packages installed.

For other operating systems see the Makefile.


Installation
------------

Although it is recommended to use the respective installer for your operating system, Agena can
be installed in two steps:

1) Type 'make install' for UNIX based systems. This installs the executable into the /usr/local/bin
   folder.

2) Since Agena uses a lot of functions written in the Agena language itself, also install all the
   files contained in the lib folder of the compressed source file agena-X.Y.Z-src.tar.gz
   - maintaining the subdirectory structure of this lib folder - as follows:

   In Solaris and other UNIX-based systems, create a folder /usr/agena and decompress all the
   subdirectories and files in the compressed lib directory into this new folder.

   In Windows, OS/2, and DOS, create a folder anywhere on your drive and decompress all the
   files in the compressed lib directory into this new folder. Also set the environment variable
   AGENAPATH as described in


Have fun !


Compiling Agena in DOS and OS/2
-------------------------------

Since I do not know how to create `DLLs` with DJGPP or GCC, the plus packages have to be
part of the agena.exe file and thus must be compiled into it with the following procedure:

1.  Make a backup of the Makefile in the src folder.

2a. If you use DOS, rename the 'makefile.dos' file to just 'makefile', overwriting the existing
    Makefile.

2b. If you use OS/2, rename the 'makefile.os2' file to just 'makefile', overwriting the existing
    Makefile.

3.  Run 'make config', followed by 'make dos' in DOS or 'make os2' in OS/2.

At least with Novell DOS 7, you must install CWSDPMI.EXE delivered with the DJPGG edition
of GCC as a TSR program before starting Agena. Novell DOS's command line history in Agena
works correctly on the Agena prompt. In OS/2, attempts to provide a command line history
by using the readline library unfortunately failed.


Compatibility
-------------

Agena compiles and runs successfully on the following operating systems:

Solaris 10 updates 4, 5, 6 for Sparc with GCC 3.4.6
Solaris 10 update 6, 7 and 8 for Sparc with GCC for Sun Systems 4.2.0
Solaris 10 updates 4, 5, 6, 7, and 8 for x86 PCs with GCC 3.4.6
Windows NT 4.0 Workstation SP6a with MinGW and GCC 3.4.5 and GCC 4.4.0 (*)
Windows NT 4.0 Server SP6a with MinGW and GCC 3.4.5 (*)
Windows 2000 SP 4 with MinGW and GCC 3.4.5 and GCC 4.4.0
Windows XP SP3 with MinGW and GCC 3.4.5 and GCC 4.4.0
Windows Vista SP2 with MinGW and GCC 3.4.5
Windows 7 with MinGW and GCC 3.4.5 and GCC 4.4.0
OpenSUSE 10.3 with GCC 4.2.1 and GCC 4.4.3
OpenSUSE 11.2 with GCC 4.4.1 (*)
Linpus Linux Lite v1.0.13E (Fedora 8 based) with GCC 4.1.2
Ubuntu 8.10 with GCC 4.3.2 (*)
Xubuntu 9.10 with GCC 4.4.1 (*)
Nexenta 1.0.1 with GCC 4.0.3 (Nexenta is an OpenSolaris/Debian derivative) (*)
Novell DOS 7.14 with GCC 4.3.2 (DJGPP v2) and GCC 4.4.1
OS/2 Warp 4 (~ 4.5) with GCC 3.3.5, and 3.4.6
Mac OS X i386 10.5 with GCC 4.0.1
Mac OS X PPC 10.5 with GCC 4.0.1
Mac OS X i386 10.6.3 with GCC 4.2.1

Agena compiled with GCC 3.4.6 under Solaris 10 also runs successfully on:
OpenSolaris 2008/11 (*)

Agena compiled with GCC 4.2.1 under OpenSUSE 10.3 also runs successfully on:
Ubuntu 8.04.3 (*)

Agena binaries compiled with DJGPP v2 for DOS ran successfully on:
FreeDOS 1.0 (*)

(*): Run in Sun VirtualBox for Sun Solaris 10 x86 or Windows.


Remarks
-------

(none)