| 1 |
------------------------------------------------------------------------------ |
| 2 |
|
| 3 |
ATOM-4 |
| 4 |
|
| 5 |
by |
| 6 |
H. S. Teoh |
| 7 |
|
| 8 |
Dec 2002 |
| 9 |
|
| 10 |
------------------------------------------------------------------------------ |
| 11 |
|
| 12 |
|
| 13 |
INSTALLATION INSTRUCTIONS |
| 14 |
|
| 15 |
|
| 16 |
I. REQUIREMENTS |
| 17 |
|
| 18 |
Software Requirements: |
| 19 |
POSIX-compliant system (currently tested under Linux 2.4) |
| 20 |
Ncurses (other curses-based libraries may work, but they have not |
| 21 |
been tested) |
| 22 |
X11R6 (currently tested under XFree86) |
| 23 |
|
| 24 |
Build Requirements: |
| 25 |
Cons 2.2.0 or greater |
| 26 |
Perl 5.005 or greater (basically, requirement of Cons) |
| 27 |
GCC 2.95 or greater (currently tested with GCC 3.2. Other C++ |
| 28 |
compilers may work, but they have not been tested) |
| 29 |
X11R6 development libraries (including libXpm) |
| 30 |
prog/lib libraries (should be included in the same archive you got |
| 31 |
Atom-4 from) |
| 32 |
|
| 33 |
|
| 34 |
II. BUILDING AND INSTALLATION |
| 35 |
|
| 36 |
You will probably need to build the prog/lib library first. To do that, |
| 37 |
simply cd to the root directory of the prob/lib source tree and type |
| 38 |
cons . |
| 39 |
|
| 40 |
To build Atom-4, simply type |
| 41 |
cons . |
| 42 |
|
| 43 |
from the root directory of this source tree, and Cons should take care of the |
| 44 |
rest. The resulting binary will expect to find its data files in the data/ |
| 45 |
subdirectory in the source tree, however; for installation purposes you may |
| 46 |
need to configure the build process as necessary. |
| 47 |
|
| 48 |
The Construct script can be configured using the following arguments: |
| 49 |
|
| 50 |
BINDIR=$dir Where to install Atom-4 binaries |
| 51 |
COMPILER=$binary Compiler to use (default: g++) |
| 52 |
DATADIR=$dir Where data files should be installed |
| 53 |
MANDIR=$dir Directory to store manpages |
| 54 |
REALDATADIR=$dir Where Atom-4 should look for data files (default |
| 55 |
is $DATADIR; this option is mainly for packaging |
| 56 |
builds where the build-time dir is different from |
| 57 |
the run-time dir) |
| 58 |
PROGLIBPATH=$dir Path to prog/lib libraries (default: #../lib) |
| 59 |
X11LIBPATH=$dir Where to find X11 libraries (default: /usr/X11R6/lib) |
| 60 |
DEBUG=1 Build with debugging symbols |
| 61 |
|
| 62 |
These arguments are passed to Cons during the build. For example, to build |
| 63 |
and install the Atom-4 binary into /usr/games, and the data files into |
| 64 |
/usr/share/games/atom4, you would run: |
| 65 |
cons . BINDIR=/usr/games DATADIR=/usr/share/games/atom4 |
| 66 |
|
| 67 |
Currently, the Construct script does not auto-detect X11 libraries and such; |
| 68 |
you will have to specify this explicitly using X11LIBPATH=... if your X11 |
| 69 |
libraries are not in /usr/X11R6/lib. |
| 70 |
|