106 lines
3.6 KiB
Plaintext
106 lines
3.6 KiB
Plaintext
|
Tcl 7.6 for Windows
|
||
|
|
|
||
|
|
by Scott Stanton
|
||
|
|
Sun Microsystems Laboratories
|
||
|
|
scott.stanton@eng.sun.com
|
||
|
|
|
||
|
|
SCCS: @(#) README 1.18 96/10/15 18:35:40
|
||
|
|
|
||
|
|
1. Introduction
|
||
|
|
---------------
|
||
|
|
|
||
|
|
This is the directory where you configure and compile the Windows
|
||
|
|
version of Tcl. This directory also contains source files for Tcl
|
||
|
|
that are specific to Microsoft Windows. The rest of this file
|
||
|
|
contains information specific to the Windows version of Tcl.
|
||
|
|
|
||
|
|
2. Distribution notes
|
||
|
|
---------------------
|
||
|
|
|
||
|
|
Tcl 7.6 for Windows is distributed in binary form in addition to the
|
||
|
|
common source release. The binary distribution is a self-extracting
|
||
|
|
archive with a built-in installation script.
|
||
|
|
|
||
|
|
Look for the binary release in the same location as the source release
|
||
|
|
(ftp.smli.com:/pub/tcl or any of the mirror sites). For most users,
|
||
|
|
the binary release will be much easier to install and use. You only
|
||
|
|
need the source release if you plan to modify the core of Tcl, or if
|
||
|
|
you need to compile with a different compiler. With the addition of
|
||
|
|
the dynamic loading interface, it is no longer necessary to have the
|
||
|
|
source distribution in order to build and use extensions.
|
||
|
|
|
||
|
|
3. Compiling Tcl
|
||
|
|
----------------
|
||
|
|
|
||
|
|
In order to compile Tcl for Windows, you need the following items:
|
||
|
|
|
||
|
|
Tcl 7.6 Source Distribution (plus any patches)
|
||
|
|
|
||
|
|
Borland C++ 4.52/5.0 (both 16-bit and 32-bit compilers)
|
||
|
|
or
|
||
|
|
Visual C++ 2.x/4.x
|
||
|
|
Visual C++ 1.5 (to build tcl1676.dll for Win32s support of exec)
|
||
|
|
|
||
|
|
In the "win" subdirectory of the source release, you will find two
|
||
|
|
files called "makefile.bc" and "makefile.vc". These are the makefiles
|
||
|
|
for the Borland and Visual C++ compilers respectively. You should
|
||
|
|
copy the appropriate one to "makefile" and update the paths at the
|
||
|
|
top of the file to reflect your system configuration. Now you can use
|
||
|
|
"make" (or "nmake" for VC++) to build the tcl libraries and the tclsh
|
||
|
|
executable.
|
||
|
|
|
||
|
|
In order to use the binaries generated by these makefiles, you will
|
||
|
|
need to place the Tcl script library files someplace where Tcl can
|
||
|
|
find them. Tcl looks in one of three places for the library files:
|
||
|
|
|
||
|
|
1) The path specified in the environment variable "TCL_LIBRARY".
|
||
|
|
|
||
|
|
2) In the lib\tcl7.6 directory under the installation directory
|
||
|
|
as specified in the registry:
|
||
|
|
|
||
|
|
For Windows NT & 95:
|
||
|
|
HKEY_LOCAL_MACHINE\SOFTWARE\Sun\Tcl\7.6
|
||
|
|
Value Name is "Root"
|
||
|
|
|
||
|
|
For Win32s:
|
||
|
|
HKEY_CLASSES_ROOT\SOFTWARE\Sun\Tcl\7.6\
|
||
|
|
|
||
|
|
3) Relative to the directory containing the current .exe.
|
||
|
|
Tcl will look for a directory "..\lib\tcl7.6" relative to the
|
||
|
|
directory containing the currently running .exe.
|
||
|
|
|
||
|
|
Note that in order to run tclsh76.exe, you must ensure that tcl76.dll
|
||
|
|
and tclpip76.dll (plus tcl1676.dll under Win32s) are on your path, in
|
||
|
|
the system directory, or in the directory containing tclsh76.exe.
|
||
|
|
|
||
|
|
4. Test suite
|
||
|
|
-------------
|
||
|
|
|
||
|
|
This distribution contains an extensive test suite for Tcl. Some of
|
||
|
|
the tests are timing dependent and will fail from time to time. If a
|
||
|
|
test is failing consistently, please send us a bug report with as much
|
||
|
|
detail as you can manage.
|
||
|
|
|
||
|
|
In order to run the test suite, you build the "test" target using the
|
||
|
|
appropriate makefile for your compiler.
|
||
|
|
|
||
|
|
|
||
|
|
5. Known Bugs
|
||
|
|
-------------
|
||
|
|
|
||
|
|
Here is the current list of known bugs/missing features for the
|
||
|
|
Windows beta version of Tcl:
|
||
|
|
|
||
|
|
- Non-blocking connect for sockets does not work yet.
|
||
|
|
- File events only work on sockets.
|
||
|
|
- The library cannot be used by two processes at the same time under
|
||
|
|
Win32s (i.e. Tcl still isn't thread-safe).
|
||
|
|
|
||
|
|
If you have comments or bug reports for the Windows version of Tcl,
|
||
|
|
please direct them to:
|
||
|
|
|
||
|
|
Scott Stanton
|
||
|
|
scott.stanton@eng.sun.com
|
||
|
|
|
||
|
|
or post them to the newsgroup comp.lang.tcl.
|