INSTALLATION  NOTES

1. Untar and gunzip

	Find a suitable place for the package, then:
		gunzip -c TkHolWorkbench.0.3b.tar.gz | tar -xf -

	This will create a directory TkHolWorkbench.0.3b.  Then
		cd TkHolWorkbench.0.3b/

	You will need about 20MB of disk space.  Most of this is taken
	up by a new HOL executable containing several new
	and existing libraries.  See "Run make" below for
	more details.

2.  Auto-configuration.

	TkHolWorkbench  comes  with  a automated configuration
	program  which  will  determine  many  of  your system
	parameters.  This  is  the program "configure", and to
	run    it    just    type:   ./configure   from   your
	TkHolWorkbench directory.

	TkHolWorkbench  now  comes  packaged  with Tk, Tcl and
	Expect,  all  of  which it uses. These packages do not
	need  to  be  built if "configure" finds that they are
	already  installed  on  your  system. "configure" will
	notify  you  if  they are not found, and will tell you
	to run "make expectk" to make these packages.
	
	These  packages  also  do  not need to be made if they
	were   in   existence   from  a  previous  version  of
	TkHolWorkbench.  

	NOTE:  One  person  has reported that they have had to
	use  "gcc"  instead  of  "cc"  to  compile Tk, Tcl and
	Expect.  This  can  be  done  simply  by  setting  the
	environment variable CC to "gcc".
	
3. Adjust configuration parameters

	The    configuration    parameters    determined    by
	"configure"   can   be   altered   using  the  "setup"
	program.  This  is  a  simple  Tk program which allows
	you   to   set  various  parameters  relating  to  the
	installation   of  your  system.  The  parameters  are
	saved   between  executions  of  "setup",  and  indeed
	between   installations   of   different  versions  of
	TkHolWorkbench.

	You  may  not  need  to  run "setup" - auto configuration
        works most things out. You can
	also  run  it  again  at  a  later  date if you should
	discover   a   configuration   parameter   that  needs
	alteration.
	
	To run setup, simply type
		./setup

	NOTE: The ./setup program only gets created after 
	./configure has successfully found an installation of 
	Expect and Tk on your system.  This may mean you have to compile
	Tk and Expect and rerun ./configure before you can use ./setup.

4. Run make

	"make"  must be run from the command line. Simply type:
		make all

	This makes an extended hol90 executable in a location determined
	by ./configure (and possibly modified by you via ./setup).
        This will take quite a while.  The hol90 executable
	comes with preloaded several TkHolWorkbench libraries.
        In addition, the following hol90 libraries are loaded
        by default:
		taut
		arith
		pair
		list
		res_quan
	If you don't like having these libraries loaded, consider
	removing them from the Makefile.  You should also edit
	Makefile.MASTER to permanently reflect this choice - the
	"Makefile" file gets remade everytime you run ./setup or
	./configure).

	You can theoretically run TkHolWorkbench without this
	extended hol90 executable, but you will miss out
	on most of the niftiest features.  Also, I tend not
	to test with a vanilla executable, so it's harder for
	me to guarantee that things will work.
		

5. Test it!

	After making the system, run
		./bin/tkhol -on
	
	After  a  time (which may be quite long - HOL needs to
	start  up),  you  will see a HOL prompt appear and the
	initial window of the interface as well.
