
                       Building a GENESIS Distribution
                                July 1st, 1990

You must be running X11R3 or X11R4 on a Sun or DECstation.   Other platforms
may be capable of running GENESIS, but the software has not been tested outside
of the Sun and DEC environments.   Suns should be running OS 4.0 or greater,
DECstations should be running Ultrix 3.1.   No guarentees on platforms or
operating systems outside of these parameters!


All of this code must live in the directory /usr/genesis.   Thus, this file is
/usr/genesis/src/README.   A symbolic link from /usr/genesis to anywhere on 
a machine that has enough disk space to contain this distribution may be 
created if /usr is tight on space.  However,  /usr/genesis MUST point to the 
directory above this file.

To build the distribution follow the instructions below.   

REQUIRED MODIFICATIONS:

Edit the Makefile in THIS directory and set the following parameters.  It 
is critical that these parameters are set correctly for a clean compile and
install to occur:

	MACHINE=	{sun3,sun4,i386,mips}
			Specify i386 for sun 386is
			Specify sun3 for sun 3s
			Specify sun4 for sun 4s & SPARCstations
			Specify mips for DECstation 2100, 3100 and 5000s
	XVERSION=	{X11R3,X11R4}
			Specify one of X11R3 or X11R4.  DECstations are X11R3
	

SPECIAL NOTES if using X11R3:

	If X11R3 is specified, REMOVE the library line for "libXext.a".  
	This is an X11R4 library not present on X11R3 machines.

SPECIAL NOTES for DECstation 2100, 3100 and 5000's:

	If compiling on a DEC machine *COMMENT IN* the line:

	DEC_HACK= -G 0

	This line allows the DEC compiler to handle the larger data 
	structures in the XODUS libraries.

BUILDING THE DISTIBUTIONS:

	From this directory (/usr/genesis/src) type:

		make clean
		make > & ! make.out &


	This will take between 10 to 30 minutes, depending on machine
	type.   The compile process can be viewed by typing:

		tail -f make.out 	[ hit ^C to exit the tail ]

INSTALLATION:
	
	After a clean build the distribution can be installed by 
	typing:

		make install

	This will copy all important files and binaries to /usr/genesis
	and it's subdirectories.

TESTING THE DISTRIBUTION:

	After a successful 'make install' the distribution can be tested
	by cd'ing to /usr/genesis/Scripts/{MultiCell, neurokit, squid or
	orient_tut} and following the directions found in the README files
	found in those directories.   Make sure that you've added "/usr/genesis"
	to your path before running any of the demos!

