InstructionsInstructionsInstructionsInstructionsInstructionsInstructions

			Zeno Source Distribution
			========================

Here's a BRIEF outline of how to install Zeno on a Mac under OS 10.4.11.
With trivial modifications, Zeno can also be installed under Linux or
Unix; instructions will be made available as details are worked out.

This process could no doubt be automated, and I would appreciate any
suggestions on ways to simplify the installation procedure.  However,
this works...


1.  A C compiler is necessary to install and use Zeno.  If you've not
already done so, install the C compiler from the OS X Install disk.


2.  Select a directory in which to install Zeno.  For simplicity, I'll
assume in the following that you are using your home directory, and
abbreviate it as "~".  In this directory, extract the Zeno archive:

	tar -xvf zeno.VER.tar.gz

where VER is the three-digit version number of the archive.  This will
place the entire distribution tree in directory "~/zeno".


3.  Change to "~/zeno/src/lib/nrec" and install the necessary Numerical
Recipes in C files (nrutil.h, nrutil.c, beschb.c, bessik.c, chebev.c,
eigsrt.c, gammln.c, gammp.c, golden.c, jacobi.c).  These files cannot be
distributed with Zeno due to copyright restrictions; you will need to
obtain them yourself.

NOTE ADDED [22 Oct, 2008]: current versions of nrutil.h & nrutil.c have
definitions for "vector" and "matrix" which conflict with those in
Zeno's vectdefs.h; I believe this can be fixed by replacing "vector" and
"matrix" by "fvector" and "fmatrix" wherever they appear in the
Numerical Recipes code (restoring the naming convention Numerical
Recipes was using when Zeno was developed).


4.  Change to "~/zeno/lib" and create the following link:

	ln -s /System/Library/Frameworks/GLUT.framework/GLUT libglut.a

This is a kludge which enables Zeno to use the OS X version of OpenGL
and GLUT; at present the only program which uses these libraries is
snapview.  If you know a more elegant way to accomplish this, please let
me know!


5.  Assuming you're using bash (the GNU Bourne-Again SHell), edit
"~/.bash_profile" and insert the following lines:

	export ZENOPATH="/Users/<yourname>/zeno"
	export CC="cc"
	export CCFLAGS="-DMACOSX -I$ZENOPATH/inc"
	export LDFLAGS="-L$ZENOPATH/lib"
	export SAFE_SELECT="true"

Here, "<yourname>" is your user name; this assumes (as per step #2) that
you decided to install zeno under your home directory.  If you installed
it elsewhere, modify the ZENOPATH as appropriate.  You will probably also
want to add $ZENOPATH/bin to your search PATH.  Once you've made these
changes, start a new window or execute "source ~/.bash_profile" so they
will be in effect for the next step...


6.  Finally, change to "~/zeno" and build the system:

	make -f Zeno install_all >& zenomake.log

This takes about 18 seconds on a 2.4 GHz iMac; your mileage may vary.
Currently, the last line in zenomake.log shows several versions of
sphcode being moved to the zeno bin directory; if the build got that far
then presumably everything is OK!


If you have problems or questions, please email me at the address
below.  

Joshua Barnes <barnes@ifa.hawaii.edu>

						12 July 2008
						Kyoto, Japan

InstructionsInstructionsInstructionsInstructionsInstructionsInstructions