5
scott.stanton@scriptics.com
7
RCS: @(#) $Id: README,v 1.8 1999/02/09 03:46:27 stanton Exp $
12
This is the directory where you configure and compile the Windows
13
version of Tk. This directory also contains source files for Tk
14
that are specific to Microsoft Windows. The rest of this file
15
contains information specific to the Windows version of Tk.
20
Tk 8.0 for Windows is distributed in binary form in addition to the
21
common source release. The binary distribution is a self-extracting
22
archive with a built-in installation script.
24
Look for the binary release in the same location as the source release
25
(ftp.scriptics.com:/pub/tcl/tcl8_0 or any of the mirror sites). For
26
most users, the binary release will be much easier to install and use.
27
You only need the source release if you plan to modify the core of
28
Tcl, or if you need to compile with a different compiler. With the
29
addition of the dynamic loading interface, it is no longer necessary
30
to have the source distribution in order to build and use extensions.
35
In order to compile Tk for Windows, you need the following items:
37
Tcl 8.0 Source Distribution (plus any patches)
38
Tk 8.0 Source Distribution (plus any patches)
40
The latest Win32 SDK header files
42
Borland C++ 4.5 or later (32-bit compiler)
44
Visual C++ 2.x or later
46
In practice, 8.0.5 was built with Visual C++ 5.0
48
In the "win" subdirectory of the source release, you will find two
49
files called "makefile.bc" and "makefile.vc". These are the makefiles
50
for the Borland and Visual C++ compilers respectively. You should
51
copy the appropriate one to "makefile" and update the paths at the top
52
of the file to reflect your system configuration. Now you can use
53
"make" (or "nmake" for VC++) to build the tk libraries and the wish
56
In order to use the binaries generated by these makefiles, you will
57
need to place the Tk script library files someplace where Tk can
58
find them. Tk looks in one of two places for the library files:
60
1) The environment variable "TK_LIBRARY".
62
2) In the lib\tk8.0 directory under the Tcl installation directory
63
as specified in the registry:
65
HKEY_LOCAL_MACHINE\SOFTWARE\Scriptics\Tcl\8.0
68
2) Relative to the directory containing the current .exe.
69
Tk will look for a directory "..\lib\tk8.0" relative to the
70
directory containing the currently running .exe.
72
Note that in order to run wish80.exe, you must ensure that tcl80.dll,
73
tclpip80.dll, and tk80.dll are on your path, in the system directory,
74
or in the directory containing wish80.exe.
79
The Windows version of Tk does not pass many of the tests in the test
80
suite. This is primarily due to dependencies in the test suite on the
81
size of particular X fonts, and other X related features as well as
82
problems with "exec". We will be working to develop a more general
83
test suite for Tk under Windows, but for now, you will not be able to
84
pass many of the tests.
89
Here is the current list of known bugs/missing features for the
90
Windows beta version of Tk:
92
- There is no support for custom cursors/application icons. The core
93
set of X cursors is supported, although you cannot change their color.
94
- Stippling of arcs isn't implemented yet.
95
- Some "wm" functions don't map to Windows and aren't implemented;
96
others should map, but just aren't implemented. The worst offenders
97
are the icon manipulation routines.
98
- Color management on some displays doesn't work properly resulting in
99
Tk switching to monochrome mode.
100
- Tk seems to fail to draw anything on some Matrox Millenium cards.
101
- Printing does not work for images (e.g. GIF) on a canvas.
102
- Tk_dialog appears in the upper left corner. This is a symptom of a
103
larger problem with "wm geometry" when applied to unmapped or
105
- Some keys don't work on international keyboards.
106
- PPM images are using the wrong translation mode for writing to
107
files, resulting in CR/LF terminated PPM files.
108
- Tk crashes if the display depth changes while it is running. Tk
109
also doesn't consistently track changes in the system colors.
111
If you have comments or bug reports for the Windows version of Tk,
112
please direct them to:
116
or post them to the newsgroup comp.lang.tcl.