INSTALL

This version of DsTool uses the Tcl/Tk libraries and should run
on a variety of Unix workstations under X11.
It was developed on SGI Irix5 and Sun Sparcstations.  It has also
been compiled under linux.

The Makefiles are setup to allow for installation on a network
with a variety of architectures.


REQUIREMENTS
============

Tcl/Tk: DsTool was developed using Tcl 7.4 and Tk 4.0.


OBTAINING SRC BIN
=================



INSTALLATION INSTRUCTIONS
=========================

1) Uncompress and unpack dstool, using e.g.:

	gnutar -xvzf dstool_tk.tar.Z     or
	uncompress dstool_tk.tar.Z;tar -xvf dstool_tk.tar

2) Set DSTOOL environment variable to the dstool distribution directory
   (the one contianing this file)

	setenv DSTOOL $PWD

3) Set the ARCH environment variable to something architecture dependent.
   For example:

	setenv ARCH sun4	or
	setenv ARCH iris	or
	setenv ARCH solaris     or
	setenv ARCH linux

4) Examine the Makefile components in $DSTOOL/config
   Makefile.defs contains most of the definitions.
   Make sure that a file exists called Makedefs.$ARCH, even if it is empty.

   Entries in Makefile.defs are replaced on an architecture by
   architecture basis by editing the file Makedefs.$ARCH.
   Entries in the Makefile.defs and Makedefs.$ARCH are replaced by
   entries in the site.def file.

   If you wish to use solaris cc, uncomment the appropriate lines of 
   site.def.
	


COMPILATION INSTRUCTIONS
========================

5) Make everything:

	make World

6) Note that libraries are built and copied into $DSTOOL/lib/$ARCH
   and the executable is built into $DSTOOL/bin/$ARCH

7) To build on a different architecture, simply (on that machine)
   set a new ARCH environment variable and issue the commands:

	make clean
	make all

8) The shell script $DSTOOL/bin/dstool_tk will attempt to start the
various executables.  It either uses of tries to set appropriate values
of DSTOOL and ARCH to find an executable to run.  This file may need to
be modified and can be installed someplace like /usr/local/bin.

If the environment variable MY_DSTOOL is set then the script tries
to start a user's customized version of DsTool which has been modified
to provide additional dynamical systems and/or computational modules.
For more details on this see the file $DSTOOL/my_dstool/README.


RUN TIME
========

The executable will be $DSTOOL/bin/$ARCH/dstool_tk
This is usually invoked through the script $DSTOOL/bin/dstool_tk
which may also be installed someplace like /usr/local/bin.

At runtime, the executable needs access to the directories:
(These are architecture independent)

	$DSTOOL/oogl
	$DSTOOL/help
	$DSTOOL/src/models
	$DSTOOL/tcl

The script $DSTOOL/bin/dstool_tk should be edited and installed someplace
like /usr/local/bin so that on each machine the correct binary is found
and executed.

