
               Tcl/Tk and Tcl-DP For Windows NT (tknt)
             (Version 3.6, Release 5; January 13, 1995)

                 Gordon Chaffee and Lawrence A. Rowe
                    Computer Science Division-EECS
                 University of California at Berkeley
                       Berkeley, CA 94720-1776


This directory contains tknt, a port of Tcl/Tk/Tcl-DP/BLT to Windows NT.
Tknt has been run under Windows NT 3.1, Windows NT 3.5, and in part under
Chicago Beta 2.

This port is based on the 'twin' package, a port of Tcl/Tk to Windows by
Software Research Associates, Inc of Japan.  Small parts of this distribution
were taken from the tkwin package by Ken Kubota of the Mathematical Sciences
Computing Facility at the University of Kentucky.

The package is available from

    mm-ftp.cs.berkeley.edu:/pub/multimedia/winnt/tknt36r5
        tknt36r5_src.tar.gz      -- Source distribution, tarred and gzipped
        tknt36r5_src.zip        -- Source distribution, zipped
        tknt36r5_bin.tar.gz     -- Binary distribution, tarred and gzipped
        tknt36r5_bin.zip        -- Binary distribution, zipped
        tknt36r5_implib.tar.gz  -- Import libraries for DLLs, tarred and
                                   gzipped
        tknt36r5_implib.zip     -- Import libraries for DLLs, zipped

It will also be mirrored at

    ftp.ibp.fr:/pub/tcl/winnt
    

To expand the zipped version:

        pkunzip -d <zipfile>

To expand the gzipped version:

        gunzip -c -f <gzipped_file> | tar xvf -


BACKGROUND
----------------------------------------------------------------------
Tcl stands for the Tool Command Language, a freely distributable,
embeddable scripting language package.

Tk is an freely distributable interface toolkit and widget library
implemented by a collection of new commands added to Tcl.  Information
about Tcl/Tk is available by anonymous ftp from sprite.berkeley.edu
[128.32.150.27].

Tcl-DP is an extension to Tcl that allows distributed programming with
Tcl.  With it, one can make RPC calls to other Tcl-DP RPC servers.  It
makes network programming extremely easy.  It requires TCP/IP.


USING TKNT
----------------------------------------------------------------------
1. The distribution comes in two forms--source and binary.  The binary
   distribution has everything needed to run tknt under Windows NT.  It
   has 7 executables and 6 DLLs as well as the Tcl, Tk, Tcl-DP, and BLT
   libraries.  The distribution installs into usr/local when you decompress
   and unpack the distribution file.  Binaries are in usr/local/bin and
   library files are in usr/local/lib/tk, usr/local/lib/tcl, and 
   usr/local/lib/dp.  If you decompress the package at the / level, the
   system should work as is.  If not, you will need to set four environment
  variables: TCL_LIBRARY, TK_LIBRARY, DP_LIBRARY, and BLT_LIBRARY.

      TCL_LIBRARY=<directory of Tcl library files>
      TK_LIBRARY=<directory of Tk library files>
      DP_LIBRARY=<directory of Tcl-DP library files>
      BLT_LIBRARY=<directory of BLT library files>

   You should also set the HOME environment variable to your home directory.

      HOME=c:/usr/tools

   Use '/' instead of '\' as your separator.

   You will also need to add usr/local/bin to your Path environment variable.

   The source distribution creates the subdirectory tknt36r5.  The source tree
   contains:

        tknt36r5/src                Tcl/Tk/Tcl-DP/BLT C source code.
        tknt36r5/lib                Tcl/Tk/Tcl-DP/BLT Tcl library files.
        tknt36r5/lib/tk/demos       Contains the widget demo.
        tknt36r5/lib/dp/demos       Simple Tcl-DP examples
	tknt36r5/lib/blt/demos      Some BLT demos
        tknt36r5/doc                Man pages and documentation from Tcl.
                                      Tk, and Tcl-DP


2. The files you will find in usr/local/bin are:

   msvcrt20.dll     If running under Windows NT 3.1, you'll need this.
                    Under Windows NT 3.5, it may come with the system.
   tcl73.dll        Tcl DLL
   tk36.dll         Tk DLL
   dp32.dll         Tcl-DP DLL
   dp32lite.dll     Tcl-DP with minimal Tk event loop
   blt17.dll        BLT DLL
   lxlib.dll        Xlib compatability library
   tclsh.exe        Tcl shell--no graphics
   wish.exe         Standard wish
   dpsh.exe         Tcl-DP shell-no graphics
   dpwish.exe       Tcl-DP wish
   bltwish.exe      BLT wish
   bldpwish.exe     Wish including Tcl-DP and the BLT toolkit
   tclspawn.exe     Utilily needed by Tcl to create subprocesses.

   No longer used are:
   dplite.dll

3. To run the widget demo, you can run wish with:

        wish -f /usr/local/lib/tk/demos/widget

   To add the widget demo to the ProgramManager
   Choose [File]-[New]-[ProgramItem] in ProgramManager, and set

        Description:                Tk Widget Demo
        CommandLine:                c:\usr\local\bin\wish -f widget
        WorkingDirectory:           c:\usr\local\lib\tk\demos

   (You will need to have c:\usr\local\bin in the Path environment
    variable).

   Now you can start widget demo by double clicking on the icon.


For information on the differences between tknt and Tk, check the TKNT_DOC
file in the distribution and at the ftp site.

+) Easy to change
   This version includes an X compatability library, so it is relatively
   easy to follow Tk's version up.


COMPILING
----------------------------------------------------------------------
For compiling information, see the BUILD file.


REPORTING PROBLEMS
----------------------------------------------------------------------
To report bugs, bug fixes, and suggested improvements send email to
        
        tknt@plateau.CS.Berkeley.EDU

or post an article to the comp.lang.tcl newsgroup.


NEW IN THIS RELEASE (Release 5)
----------------------------------------------------------------------
-) Removed the 'chdrive' command because you can do the same thing with the
   'cd' command
+) The BLT toolkit is now mainly supported.  The features Still missing from
   it are: rotated text in graphs, drag and drop support, cutbuffer support,
   busy windows, and the bgexec command.
+) 'send' command is now supported.
+) New commands, 'dde_request' and 'dde_execute' for DDE enabled applications.
+) Bug Fixes
   +) Grabbed windows function properly.
   +) Cascaded menus work
   +) Event loop works better
   +) Tcl-DP passes its tests
   +) Specifying fonts works again
+) X fontnames are handled 

For more information on changes, see the CHANGES file in the src directory
or the TKNT_DOC file.


REPORTING PROBLEMS
----------------------------------------------------------------------
To report bugs, bug fixes, and suggested improvements send email to

        tknt@plateau.CS.Berkeley.EDU

or post an article to the comp.lang.tcl newsgroup.
-----------------------------------------------------------------------------


TO LEARN HOW TO USE TCL/TK:
----------------------------------------------------------------------
+) Get John Ousterhout's book on the Tcl and the Tk Toolkit available
   from any fine computer bookstore.


ACKNOWLEDGEMENTS
----------------------------------------------------------------------
This package would not have been possible without the excellent work
done by Toshihiko Haga (haga@sra.co.jp) at Software Research Associates, Inc.,
Ken Kubota (ken@ms.uky.edu) at the University of Kentucky, and
Brian Smith (bsmith@cs.cornell.edu) for his Tcl-DP.  Thanks to all the
people who have given bug fixes and reported problems.

We gratefully thank Fujistu of America, in particular Charles
Brauer, for financial support of this project.  In addition, we 
acknowledge the support of Digital Equipment, Intel, Starlight Networks,
the National Science Foundation (Grant MIP 90-14940), and the State of 
California Micro Program for additional equipment and financial support.
