Tcl 7.5 and Tk 4.1 for Windows, Binary Release
Alpha 2 Release

@(#) README 1.3 95/10/04 17:04:09

1. Introduction
--------------- 

This directory contains the binary release of Tcl 7.5 and Tk 4.1 for
Windows.  It was compiled with Borland C++ 4.5 using Win32 API, so
that it will run under Windows NT, Windows 95, and Windows 3.1 (with
Win32s).

If you need to modify the source of Tcl/Tk, you may obtain the source
release of Tcl 7.5 and Tk 4.1 from the same location as the binary
release.

2. Installation
---------------

The binary release is distributed as a self-extracting archive call
win41a2.exe.  The setup program which will prompt you for an
installation directory.  It will create the installation heirarchy
under the specified directory, and install a wish application icon
under the program manager group of your choice.

In order to run Tcl/Tk under Windows 3.1, you will need to install the
latest release of Win32s first.  The Win32s distribution can be found
in the same location as the Tcl/Tk binary and source distributions.
The 1.25 release of Win32s is available along with the binary and
source distributions.  Look for a file called w32s125.exe.  Win32s is
not needed to run under Windows '95 or Windows NT.

3. Documentation
----------------

The best way to get started with Tk is to read one of the introductory
books on Tcl and Tk:
 
    Tcl and the Tk Toolkit, by John Ousterhout,
    Addison-Wesley, 1994, ISBN 0-201-63337-X
 
    Practical Programming in Tcl and Tk, by Brent Welch,
    Prentice-Hall, 1995, ISBN 0-13-182007-9
 
The "doc" subdirectory in this release contains a complete set of
reference manual entries in Windows help format. 

The "lib/tk4.1/demos" directory contains a number of pre-canned
scripts that demonstrate various features of Tk.  The file
"lib/tk4.1/demos" is a script that you can use to invoke many
individual demonstrations of Tk's facilities.

Additional information is available in the source release or from the
Tcl/Tk home page on the Web:

	http://www.sunlabs.com/research/tcl

These Web pages include release udpates, reports on bug fixes and
porting issues, and pointers to many other Tcl/Tk Web pages at other
sites.  Check them out!

4. Known Bugs/Missing Features
------------------------------

This is an alpha release, so there are a number of outstanding bugs:

- The binaries produced by VC++ don't support "exec" under Win32s.
- "exec" of command.com hangs in the kernel under Windows '95.  This
  is actually a bug in '95.  I think I know a workaround, but it isn't
  done yet.
- The library cannot be used by two processes at the same time under
  Win32s.  This is probably fixable, but may take a while.
- "file" command does not handle DOS paths properly.
- Under Win32s, "exec" generates temp files and leaves them lying
  around under some circumstances.
- File events aren't implemented yet (coming soon).
- There is no support for custom cursors/application icons.
- Stippling of arcs isn't implemented yet.
- Alt-key sequences cause conflicts with Windows.  Tk will still see
  them, but the system rings the bell.
- The initial position of toplevel windows is always in the upper left
  corner, unless explicitly specified with "wm geometry".
- The initial size information of a toplevel window is wrong if the
  contents of the window are smaller than the minimum window size
  allowed by Windows.
- Some "wm" functions don't map to Windows and aren't implemented.
- There is no support for the option database yet.
- Under Win32s, you can only start one instance of Wish at a time.
- Traversing the items in a menubar causes the titlebar of the window
  to flash.

There may be more that we don't know about, so be sure to submit bug
reports when you run into problems.  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.


