-A- Retrieving Tcl and Tk

From: -XI- Where can I get these packages?


>From: ouster@cs.Berkeley.EDU (John Ousterhout)
>Newsgroups: comp.lang.tcl
>Subject: Obtaining Tcl/Tk sources

For people new to the Tcl/Tk community, here is information on how
to obtain Tcl and Tk sources.  The information below describes what
I distribute; other information is available from other machines
also, such as ftp.aud.alcatel.com.

The sources and documentation for the Tcl command
language library, for the Tk toolkit, and for a few Tcl-based
applications, are in the public FTP area on ftp.cs.berkeley.edu.
All of these files are in the "tcl" subdirectory of the FTP area.
Here is a catalog of what's available.  Most of the files are
compressed tar files ("xxx.tar.Z").  There is some overlap
between the contents of the various packages.


tk3.6.tar.Z -         	This is the latest and most stable release of the
                        Tk toolkit, released in November 1993 (patch level
                        206).  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.Z -       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 latest and most stable release of the
                        Tcl library, released in November 1993 (patch level
                        106).  It includes the sources for the Tcl library
                        and the "tclsh" application, plus reference manual
                        entries.

tclX7.3b.tar.Z -        Extended Tcl (or NeoSoft Tcl), created by Mark
                        Diekhans and Karl Lehenbauer, which adds a number
                        of useful facilities to the base Tcl release.
                        Among the things in Extended Tcl are a Tcl shell,
                        many new commands for things like UNIX kernel
                        call access, keyed lists, and time conversion, and an
                        on-line help facility.  This package works with Tcl
                        versions 7.3 or later and Tk versions 3.6 or later.

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
			home-grown 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).

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.p1.ps.Z            This part describes the Tcl language and how to write
			scripts in it.  About 130 pages in length.

book.p2.ps.Z            This part of the book describes how to write
			Tcl scripts for Tk.  About 125 pages in length.

book.p3.ps.Z            This part of the book describes how to write Tcl
			applications in C, using the Tcl library procedure.
			64 pages in length.

book.p4.ps.Z            This part of the book describes how to write new
			widgets and geometry managers in C, using the Tk
			library procedures.  About 70 pages in length.

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 five one-hour
			talks plus a sample widget.

tc-tcl93.ps.gz -        PostScript formatted copy of Tcl Compiler paper
                        presented at the Tcl'93 Workshop.

tc-tcl93.tex.gz -       LaTeX source for the Tcl Compiler paper presented
                        at the Tcl'93 Workshop.


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


To retrieve any or all of these packages, use anonymous FTP to
ftp.cs.berkeley.edu (Internet address 128.32.149.78).  Use user
"anonymous"; when asked for a password, type your email address.  Then
retrieve the relevant file(s) with the commands like the following:
		type image (try "type binary" if this command is rejected)
		cd tcl
		get tk3.6.tar.Z

Be sure to retrieve files in image mode (type "type image" to FTP)
in order to make sure that you end up with an uncorrupted file.

Any file with a .Z extension is a compressed file, which means you must
use the "uncompress" program to get back a normal file.  For example, for
the file tk3.6.tar.Z, you should type

	uncompress tk3.6.tar.Z

once you've retrieved the file.  This will produce a file named "tk3.6.tar".
Then you will need to use tar to extract the members.  Typically one
would use a command such as:

	tar xv tk3.6.tar

to extract the pieces.

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.

Questions or problems about any of these distributions should be directed
to <URL:mailto:John.Ousterhout@eng.sun.com> (John Ousterhout).