
	Installation of MTtcl

Version 0.8

Installing MTtcl involves building the tcl and tcl_thread directories
and installing the files into designated locations.  The man directory
contains man pages which should be installed with make install-man.

WARNING
-------
MTtcl installs files which may have the same name as files in your
existing Tcl install.  This was done because the MT-sturdy shell and
library are a straight substitute for tclsh and libtcl.a.  See below
for a complete list of installed files.


Install for the impatient
-------------------------
Starting from the MTtcl0.8 directory;

	cd MTtcl0.8
	cd tcl
	sh configure
	cd ../tcl_thread
	vi Makefile
	cd ..
	make

The default install directory is /usr/local;

	make install
	make install-man


Step-by-step install
--------------------
Since MTtcl is verified to run in only one configuration, very little
customization should be needed.  The most important items are the install
directories.  These are set with the prefix and exec_prefix make variables.

1. cd MTtcl0.8
	There are three directories; tcl/ contains MT-sturdy Tcl,
	tcl_thread/ contains Tcl threads, and man/ contain man pages
	for Tcl threads.

2. cd tcl
	This is the Tcl 7.3 source code with modifications made for
	use with threaded programs.  Build and installation is virtually
	identical to the original.

3. sh configure
	Running the configure script will build the Makefile.
	The prefix and exec_prefix variables can be set by configure.
	See the top of the script for instructions.

4. cd ../tcl_thread
	This is the Tcl threads source code.

5. vi Makefile
	Follow instructions in the Makefile.  The important items to
	set are the install directory and the location of the Tk and X11
	packages.  Read the comments and chose dynamic or static linking.

6. cd ..
   make
	Both directories will be built, but not installed.

7. make install
	Both directories will be installed.  See below for exactly
	what's installed.

8. vi Makefile
	Set the prefix variable to the desired location for man pages.

9. make install-man
	The man pages are coped.


Installables
------------

tcl/			MT-sturdy stuff
	tclsh		An MT-sturdy Tcl shell
	libtcl.a	Library of .o files
	libtcl.so.7	Library of position independent code (shared library)
	libtcl.sa	??
	tcl.h		Tcl header file (no changes from Tcl 7.3)

tcl_thread/		Tcl threads stuff
	mttclsh		An MT-sturdy Tcl shell with threads commands
	mtwish		An MT-sturdy Tk shell (wish) with threads commands
	libtcl_thread.a		Library of .o files
	libtcl_thread.so.1	A Shells loadable library of threads commands
	libtcl_thread.sa	??
	libtk_thread.a		Library of .o files, plus Tk support
	libtk_thread.so.1	A Shells loadable library of threads commands
				suitable for use with mtdwish (should you
				create one).
	libtk_thread.sa		??
	tcl_thread.h		Header file for Tcl threads

man/			Man pages for Tcl threads
	cond.n
	mutex.n
	rwlock.n
	sema.n
	share.n
	thread.n

