This directory contains a collection of files related to Tcl and
Tk, all of which are available for anonymous FTP.  Below is a
description of what is in the various files in this directory:

tk4.0b4.tar.Z -		This is the latest experimental release of the
			Tk toolkit (the fourth beta release of Tk 4.0),
			released in June 1995.  It includes the sources
			for the Tk library and the "wish" windowing shell,
			plus reference manual entries and a number of
			demonstration scripts.

tk4.0b4.patch.Z -	Compressed patch file that upgrades from Tk 4.0b3
			to Tk 4.0b4.  See the beginning of the patch file
			for information on how to apply it.

tcl7.4b4.tar.Z -	This is the latest experimental release of the
			Tcl library (the fourth beta release of Tcl 7.4),
			released in June 1995.  It includes the sources
			for the Tcl library and the "tclsh" application,
			plus reference manual entries.

tcl7.4b4.patch.Z -	Compressed patch file that upgrades from Tcl 7.4b3
			to Tcl 7.4b4.  See the beginning of the patch file
			for information on how to apply it.

tk3.6.tar.Z -		This is the most recent stable release of the
			Tk toolkit, released in November 1993.  It includes
			the sources for the Tk library and the "wish"
			windowing shell, plus reference manual entries and
			a number of demonstration scripts.

tk3.6p1.patch -		Patch file that fixes bugs in Tk version 3.6.
			See the beginning of the patch file for information
			about the bugs it fixes and how to apply it.

tcl7.3.tar.Z -		This is the most recent stable release of the
			Tcl library, released in November 1993.  It includes
			the sources for the Tcl library and the "tclsh"
			application, plus reference manual entries.

mx.tar.Z -		Sources and documentation for a mouse-based text
			editor (mx) and terminal emulator (tx) based on
			Tcl.  This is a very old release:  it uses an old
			version of Tcl (which is included) and doesn't
			even use Tk;  it uses an ancient toolkit called
			"Sx".  These tools will eventually be replaced
			with new tools based on Tk and the newest Tcl.

mx-2.5.tar.Z - 		Newer version of mx (see above) that uses the
			standard X selection mechanism rather than the
			homegrown mechanism used by previous versions. 
			Version 2.5 is not backwards compatible with 
			previous versions (you can't cut and paste between
			the two). Still uses sx and an old version of 
			Tcl (both of which are included).

mx-2.5.patch.Z -	Patch file for converting mx 2.4 sources into 2.5.
			Invoke patch in the top-level mx directory
			with the "-p1" switch and an uncompressed version of
			this file, e.g. "patch -p1 < mx-2.5.patch".

engManual.tar.Z -	Compressed tar file for a directory containing
			the Tcl/Tk Engineering Manual, which describes
			the coding and testing conventions used to develop
			Tcl and Tk.  I strongly encourage other Tcl/Tk
			developers to follow these conventions, particularly
			if you want to submit code for possible inclusion
			into official releases.

book.p*.ps.Z -		Compressed Postscript for an early draft of the
			book "Tcl and the Tk Toolkit", which was published
			by Addison-Wesley in April 1994 (ISBN 0-201-63337-X).
			The draft is in four parts, each in a separate file.
			You're probably better off with the published version
			of the book, though;  it has a number of improvements
			and an index.

book.examples.Z -	Compressed file containing ASCII text for nearly all				of the examples from the Tcl book.

tclUsenix90.ps -	Postscript for a paper on Tcl that appeared in the
			Winter 1990 USENIX Conference.

tkUsenix91.ps -		Postscript for a paper on Tk that appeared in the
			Winter 1991 USENIX Conference.

tkF10.ps -		Postscript for Figure 10 of the Tk paper.

tut.tar.Z -		A collection of materials from a full-day tutorial
			on Tcl and Tk.  Includes viewgraphs from four
			one-hour talks.

tclCover.tar.Z -	Winning entries in the Tcl/Tk book cover contest
			(unpacks to about 5 Mbytes).

In addition, there may be older releases of some or all of the above
files;  look for files with earlier release numbers.

Be sure to retrieve files in image mode (type "type image" to FTP)
in order to make sure that you don't lose bits.

Most of these files are compressed tar files;  to get back the
original directory hierarchies, type a command like the following for
each file you retrieved:
		zcat tk3.6.tar.Z | tar xf -
This will create a directory named tk3.6 with all the source files and
documentation for that release.  There will be a README file in the
tk3.6 subdirectory that tells what to do next.

Any file with a .gz extension is a file compressed with gzip, the gnu
portable compression standard.  To get a copy, ftp to prep.ai.mit.edu and 
look in pub/gnu.  For example, to uncompress tc-tcl93.ps.gz, type

    gunzip tc-tcl93.ps.gz

once you've retrieved the file.  This will produce a file named "tc-tcl93.ps".

Each of the releases has a README file in the top-level directory that
describes how to compile the release, where to find documentation, etc.

In addition to the information here, there are many other Tcl/Tk extensions,
scripts, and applications in the Tcl contributed archive, which is
currently located on the machine ftp.aud.alcatel.com in the public
FTP directory /tcl.

Questions or problems with any of these distributions should be directed
to the comp.lang.tcl newsgroup.