
	RLaB Installation Guidelines

	This file leads the reader through a sample rlab installation,
	from scratch. In creating these directions, there are certain
	assumptions made:

	(a) You are installing rlab on a computer running a Unix, or a
	Unix-like Operating System.

	(b) You do not have root privileges.

	(c) You do not have a Fortran compiler.

	(d) You are patient enough to read this file, and other README
	files for supporting programs along the way. I can install
	rlab, completely from scratch, in about 90 minutes (depends
	alot on how fast the computer is). It will take most people
	longer.

	1.) Get all the necessary files:

	   -----------------------------------------------------------------
		rlab-1.20a.tar.gz	(or whatever the latest is)
		rlap-2.0tar
		rfft-1.2.tar	
		rnlib-1.1.tar
	   -----------------------------------------------------------------
		f2c			The latest f2c from: 
					 netlib.att.com:/netlib/f2c
		plplot4p99i.tar.gz	(optional, but recommended)
					 dino.ph.utexas.edu
		gdb-4.14.tar.gz		(recommended for the readline library)
					 prep.ai.mit.edu:pub/gnu
		tcl3.7.tar.gz		(recommended for plplot)
		tk3.6.tar.gz		(recommended for plplot)
	   -----------------------------------------------------------------

	The first group of files comprise the rlab distribution. They
	are packaged separately, since the numerical libraries don't
	need updating often.

	The second group of files are not necessary (except maybe
	f2c), but using them makes a better rlab. Plplot provides nice
	interactive plotting capabilities. The GDB distribution
	contains the readline library which provides command line
	editing. Tcl/TK provide a nice output device (tk) for Plplot
	graphics under X-windows.

	2) First you must decide where to install it all. For this
	article, it is assumed that you do not have root privilege,
	and are installing rlab on your account: /home/me is your home
	directory, and you want to install everything in
	/home/me/local. You will build everything in /home/me/build.

	It is recommended that you build the supporting libraries
	first: 

	2a) Build f2c. Actually you don't need f2c, just the one (or
	two) libraries. The two libraries are libF77.a and libI77.a
	(although some folks combine them into one library called
	libf2c.a).

	2b) Build the supporting numerical libraries (LAPACK, BLAS,
	FFTPACK, RANLIB). This is really simple. Uncompress, untar
	each numerical library in the build directory. Change to each
	directory, and type:

		./configure --prefix="$HOME/local"
		make install

	These libraries are in C, and should compile on most any
	machine. You should end up with the library installed in
	/home/me/local/lib. Each directory has its own README.

	2c) Build Tcl and TK libraries. After uncompressing,
	untarring, this usually takes a:

		./configure --prefix="$HOME/local"
		make
		make install

	If you do not understand or use xauth-style security when you
	run X, then turn on the -DNO_SECURITY flag in the TK Makefile.

	2d) Build the Plplot library. Again, unpack, and, in the
	plplot main directory run:

		./configure --prefix="$HOME/local/plplot" \
		--with-double --disable-f77

	Use `--with-gcc' if you have it.

	2e) Build the GNU Readline library. Unpack the gdb
	distribution. From the main gdb directory run:

		./configure --prefix="$HOME/local"

	The `cd readline' and:

		make

	This should create libreadline.a. Copy this file to
	/home/me/local/lib, and run ranlib on it if necessary.

	3) At this point /home/me/local/lib should be full of
	libraries:

     296 -rw-r--r--   1 rlab    dyn  299924 Apr 28 16:01 libCblas.a
      76 -rw-r--r--   1 rlab    dyn   75148 Apr 28 15:55 libCfftpack.a
    1072 -rw-r--r--   1 rlab    dyn 1096738 Apr 28 16:36 libClapack.a
      84 -rw-r--r--   1 rlab    dyn   82736 Apr 28 15:58 libCranlib.a
     156 -rw-r--r--   1 rlab    dyn  156734 Apr 28 16:04 libF77.a
     204 -rw-r--r--   1 rlab    dyn  206614 Apr 28 16:09 libI77.a
       4 -rw-r--r--   1 rlab    dyn    2806 Apr 28 16:45 libfl.a
     252 -rw-r--r--   1 rlab    dyn  257289 Apr 28 16:47 libreadline.a
     276 -rw-r--r--   1 rlab    dyn  279702 Apr 28 12:57 libtcl.a
     712 -rw-r--r--   1 rlab    dyn  728627 Apr 28 13:00 libtk.a
       4 drwxr-xr-x   2 rlab    dyn     512 Apr 28 12:57 tcl/
       4 drwxr-xr-x   3 rlab    dyn     512 Apr 28 13:00 tk/

	Something like the above... Now you are ready to build
	rlab. The reason you built the libraries first, is that rlab's
	configure script looks at the system to see what
	features/libraries are there. If important items are missing
	when configure is run, then the automatically generated
	Makefile will not be correct.

	Again, run rlab's configure like:

		./configure --prefix="$HOME/local" \
		--with-LIBS="$HOME/local/lib" \
		--with-PLIBS="$HOME/local/plplot"

	This should generate a Makefile, and a config.h. Now you are
	ready to run make:

		make
		make Test
		make install

	Should do it.

	4) If you have gotten this far, congratulations. If you have
	some unresolved problems/questions at this point, you should
	read the file INSTALL; this may answer some questions. Also
	the file PROBLEMS, tries to address some of the more common
	installation headaches.

	Finally, if you are still having some trouble, the send mail
	to: ians@eskimo.com
