========================================================================
INSTALL  INSTALL  INSTALL  INSTALL  INSTALL  INSTALL  INSTALL  INSTALL  
========================================================================

These are GENERIC instructions:

1) Unpack the distribution in a temporary directory.

You need the Free Software Foundation's GNU compression utility ``gzip'',
if the package was compressed with `gzip' and has the '.gz' or has `.tgz'
file suffix.

You would uncompress the package like so:

    > gzip -dc <package>.tar.gz | tar xvf -


You require the block sorting file compression utility ``bzip2'', if the
package was compressed with `bzip2' and has the suffix '.bz2'.

    > bzip2 -dc <package>.tar.bz2 | tar xvf -


2) Edit the `Makefile' and change the line where the `PREFIX' variable is
defined to point to a directory where you want the final software will be
installed.

3) Build the software with the command.

    > make all

Make all the java archives are also build

    > make all-jars

Install the software with the command.

    > make install


You can now run the application with the following command:

    > Humanoid

You can now run the BBC Microcomputer like enhanced Sound test harness
with the following command:

    > GuiTestSound


The game also as Java Applet simply copy the `humanoid.html' and
`humanoid.jar' to your webservers root directory or place locally in a
directory on your hard drive. You be able to open the HTML with Netscape
Navigator 4.51 or better and start the game without problem. I believe the
game will work Internet Explorer 4 or better, but I have not tested this.
You will definitely need a web browser that supports JDK 1.1.4 or better
for the software to run. All the image files are stored in the
`humanoid.jar' and the software correctly retrieves these as application
resources whether the JAR is compressed or not.


The default install directory is `/usr/local' (the <PREFIX> ) which results
in the following after successful installation:

    programs:			/usr/local/bin		
    properties & libraries:	/usr/local/lib
    jar archives:		/usr/local/lib/classes
    GIF/JPEG images files:	/usr/local/images
    audio player files:		/usr/local/audio
    rich text documents:	/usr/local/docs
    miscellany files:		/usr/local/etc


Of course these will be different if the `PREFIX' is changed in the
Makefile. The location where the different parts of the software package
following directories are defined by same name variable in the Makefile:


`BINDIR' : the binary executables directory and is defined as ${PREFIX}/bin	

`LIBDIR' : the library directory, where properties and resource bundle
files are also installed which defined as `${PREFIX}/lib'

`CLASSES_DIR' : java archive file and other zlib compressed files which is
defined ${LIBDIR}/classes.

`IMAGES_DIR' : the GIF/JPEG image files directory normally defined as
${PREFIX}/images.

`AUDIO_DIR' : the audio sound playing files directory normally defined as
${PREFIX}/audio.


4) After installation you are ready to try out the software.



TESTING
=========

To run the `Humanoid' application simply enter on UNIX systems:

    % java -classpath humanoid.jar:$CLASSPATH xenon.humanoid.Humanoid

To run the `Humanoid' application simply enter on Windows NT systems:

    % java -classpath "humanoid.jar;%CLASSPATH%" xenon.humanoid.Humanoid



BOOKS
======

"The Winners' Book of Video Games"
written by Craig Kubey
published by Star paperback division of W.H. Allen & Co Ltd, 1982
Isbn 0-352-31205-X



Enjoy `Humanoid'



;;; Emacs File Variables
;;; ------------------------------------------------------------
;;; Local Variables: ***
;;; mode:Indented-Text ***
;;; fill-column:75 ***
;;; End: ***
