******************** tcl7.5a2+.patch (updated 1/10/96) *********************
*									  *
* Written by:	Jan Nijtmans						  *
*		NICI (Nijmegen Institute of Cognition and Information)	  *
*		email: nijtmans@nici.kun.nl				  *
*		url:   http://www.nici.kun.nl/~nijtmans/		  *
*									  *
***************************************************************************

This patch updated from Tcl 7.5a2 to Tcl 7.5a2+. It should be applied
by running the "patch" program in the top-level directory of a clean
Tcl 7.5a2 release, using the command "patch -p0 <tcl7.5a2+.patch"

Then run "configure", and do "make" in this directory. This creates
all libraries and the Tcl7.5 shell (tclsh). Then do "make install"
(in super-user mode) to install it on your machine for general use.

This patch adds a lot of functionality to the standard distributions
of Tcl7.5a2, such as:

* Shared Libraries. These can be created now for AIX, FreeBSD, HP-UX-9,
  IRIX-5, Linux (ELF only), Motorola R4, NetBSD, OSF/1, Sun (both SunOS-4
  and Solaris) and some more. Also, the configure script and the makefiles
  contain a lot of comments about how to adapt it for your own system,
  if it is not in the above list. For AIX the dynamical loading doesn't
  work yet.

* Standalone Applications. Now an extra function Tcl_InitStandAlone() is
  available that performs the same function as Tcl_Init(). The difference
  is that all the files in /usr/local/lib/tcl7.4/ are now compiled into
  the application. This makes the executable larger (about 7 kbyte), but
  it will run on any machine (of the same architecture). It makes no
  difference any more if Tcl is installed or not, or which version.

* tcl2c. A tiny compiler (only 10 kBytes of source-code, the executable
  is about 17 kByte for Solaris2.4 ) that compiles any well-formed
  tcl-script into C-source code. The resulting output can be compiled
  using any C (K&R, ANSI) or C++  compiler. As an example for how to
  use it, there is a "hello.tcl" script in the distribution. You can
  compile this example by:
	tcl2c hello.tcl -o hello.c -tcl		(create hello.c)
	cc -o hello hello.c libtcl.a -lm	(create hello)
  Or, simply do:
	make hello
  The result is a binary executable that performs the same function as
  the original "hello.tcl" script. It will run as a standalone
  application, excuting your own script that you compiled into it.
  Don't expect any faster operation, because everything is still
  interpreted internally.

* C++ support. tclAppInit.c has been adapted such that it can be compiled
  with any C++ compiler. Try:
	make tclsh++
  This will create a C++ version of tclsh (if you have a C++ compiler).

* Event loop. The event loop from Tk4.1a2 is glued into the Tcl7.5a2 core.
  This means that the commands "after", "fileevent", "update" and
  "tclerror" (replacement for "tkerror") are now available without Tk.
  Documentation and tests for these commands are added too. This addition
  is 100% upwards compatible with Tcl7.5a2. Because all symbols that
  originally started with "Tcl" or "TCL" now start with "Tk" or "TK",
  it doesn't even disturb Tk4.1 (otherwise I wouldn't dare to include
  it in this plus-patch, because most people only are interested in
  the shared library support).

* Installation can be done from sub-directories of ${TOP_DIR} or ${UNIX_DIR}

* Tests are done using shared library tcltest.so

* Added support for some extra mathematical functions: erf(), erfc(),
  gamma(), j0(), j1(), jn(), y0() ,y1() and yn().

CONFIGURE
=========

The configure script has the following additional options:

	configure --disable-load	disallow dynamic loading and load command
	configure --disable-shared	disallow creation of shared library
	configure --enable-static	create tclsh.static
	configure --enable-standalone	create tclsh.standalone
	configure --enable-tcltest	create tcltest
	configure --enable-test		create and run tests

These options can be used combined. They influence which files will
be created when you do "make" or "make all".

MAKE
====
You can make the following extra files:
	make tclsh		Shared version of tclsh (default)
	make tclsh++		C++ version of tclsh
	make tclsh.static	Static version of tclsh
	make tclsh.standalone	Standalone version of tclsh
	make plusplus		the same as make tclsh++
	make static		the same as make tclsh.static
	make standalone		the same as make tclsh.standalone
	make tcltest		Make tclsh and tcltest.so
	make tcltest++		Make tclsh++ and tcltest.so
	make tcltest.static	Make tclsh.static and tcltest.so
	make tcltest.standalone	Make tclsh.standalone and tcltest.so
	make test		Execute tests using tclsh
	make test++		Execute tests using tclsh++
	make test.static	Execute tests using tclsh.static
	make test.standalone	Execute tests using tclsh.standalone
	make hello.c		C-source of hello.tcl
	make hello		binary executable of hello.tcl
	make hello++		binary executable of hello.tcl (using C++)