|
|
1.1 root 1: Tcl
2:
3: by John Ousterhout
4: University of California at Berkeley
5:
6: This directory contains the sources for Tcl, an embeddable tool command
7: language. For an introduction to the facilities provided by Tcl, see
8: the paper ``Tcl: An Embeddable Command Language'', in the Proceedings
9: of the 1990 Winter USENIX Conference. A copy of that paper is included
10: in this directory in Postcript form: it's in the file "usenix.ps".
11:
12: This file assumes that you have received a Tcl distribution and are going
13: to use Tcl on a UNIX system; if you're running under Sprite at Berkeley,
14: then some of the notes here may be incorrect.
15:
16: The documentation for Tcl is present in this directory as a set of
17: files with ".man" extensions. The file "Tcl.man" gives an overall
18: description of the Tcl language and facilities, and the other ".man
19: files describe the library procedures that Tcl provides for tools to use.
20: Read the "Tcl" man page first. To print any of the man pages, use a
21: command like
22:
23: ditroff <file>
24:
25: where <page> is the name of the man page you'd like to print. Don't
26: specifiy any macros.
27:
28: Type "make" to generate the Tcl library, and type "make tclTest" to
29: create a simple test program that you can use to try out the Tcl facilities.
30: TclTest is just a main-program sandwich around the Tcl library. It reads
31: standard input until it reaches the end of a line where parentheses and
32: backslashes are balanced, then sends everything it's read to the Tcl
33: interpreter. When the Tcl interpreter returns, tclTest prints the return
34: value or error message. TclTest defines a few other additional commands
35: most notably:
36:
37: echo arg arg ...
38:
39: The "echo" command prints its arguments on standard output, separated by
40: spaces.
41:
42: There is a test suite for Tcl in the subdirectory "tests". Read the
43: README file in that directory for more information on how to use it.
44:
45: The file "changes" describes recent changes that have been made to Tcl.
46: If this isn't your first Tcl release, you should probably look through
47: "changes" to see what's changed. If the major release number has changed,
48: i.e. from 2.x to 3.x, it means that there have been changes that aren't
49: backward-compatible.
50:
51: I can't promise to provide a lot of help to people trying to use Tcl, but
52: I am interested in hearing about bugs or suggestions for improvements.
53: Send them to me at "[email protected]".
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.