
		TkWin version 0.3 -- Tk for Windows

This is version 0.3 of TkWin, a version of Tcl/Tk/TclTCP for use under
Microsoft Windows version 3.1.

This port is based on an earlier port by Peter Sprenger of Tcl6.7.  It includes
most of the functionality of Tcl 7.4 and Tk 4.0 in the form of a Windows 3.1
dynamic linked library and an interpreter (wish) front-end.  In addition, it
includes support for tcp connections from the TclTCP package; in this case,
the only parts which have been tested are the client side connect, send, and
close routines.  Although there are numerous limitations, the most important
one is that the .dll is set up to handle a single application at a time;
this is because the .dll heap is shared amongst all applications using it.

Installation: See the INSTALL file for details on how to build
	and install the software.  This release requires that you
	have a Winsock compatible winsock.dll in your PATH (in the windows
	or windows system directory.)  The .DLL need not be properly
	installed, nor do you need to have an ethernet card or the
	a packet driver installed, unless you want to use the tcp command.


Usage:  Wish invoked without arguments or with a -c flag will come up
	with a console window from which tk commands can be run
	interactively.  The -tcp option allows you to use the tclTCP
	tcp command. 

Additional Commands:
	Two additional commands winexec and win have been added for
	convenience sake when working in a Windows environment.
	1. winexec path [param..]
	   This allows one to spawn off a job using the Windows WinExec call.
	   The return value is the instance handle of the new process.  The
	   usual exec call is used for non-Windows programs.
	2. win hostname
	   returns the hostname as it comes from the gethostname winsock call.
	3. win kill instno
	   Sends WM_QUIT message to the process identified by the instance
	   handle instno
	4. win print path
	   Arranges for the text file at path to be printed on the default
	   printer using the standard Windows print dialog box.
	5. win print time
	   Returns the time of day in the standard ctime format.
	6. wm eventlog on/off
	   Trivial event logger into \tmp\log.

Documentation:  Use the standard Tcl, Tk, and TclTCP manual pages.
	Not everything works, but one hopes to have this somewhat
	documented in a later release.

Some Known Limitations:
	Only one instance of wish is allowed to run at a time.
	No cursors other than the basic Windows arrow cursor,
	Colors are approximated from the existing palette.
	Fonts are handled in a simplistic manner.
	There is a problem with packing into siblings.
	The only icon allowed is the default Application icon.
	The after command and `win hostname' only work with the -tcp option.

Distribution:
	The Tcl/Tk port is free software.  It can be distributed, copied, or
	modified, under very liberal conditions.  But there is NO WARRANTY. 
	See the copyright notices on the files for more information.

	One version of the binary distribution includes example programs
	which are covered by the GNU General Public License, version 2.  
	This can also be distributed freely, but only under the conditions
	of this license.  See the file COPYING for more information.

	All software is provided with NO WARRANTY.

Contact: Ken Kubota, Mathematical Sciences Computing Facility,
	 University of Kentucky, Lexington, KY 40506 USA,
	 e-mail: ken@ms.uky.edu    tel: (606)2571389 
