TclBlend
SCCS: @(#) README.tclblend 1.3 97/10/21 17:52:09

How To Install TclBlend (Binary Release Only):
----------------------------------------------

(a) The TclBlend functionality is provided in the pagkage "java". 
    After running the TclBlend installation program, you can load the
    "java" package by issuing the following commands in your Tcl script:

    set env(CLASSPATH) {C:\Program Files\Tcl\lib\tclblend1.0\tclblend.zip;C:\jdk1.1.4\lib\classes.zip}
    package require java

    Note that you have to include both the tclblend.zip and JDK
    classes.zip files in the CLASSPATH. Otherwise you'd get an error
    when you try to use the java::* commands.

(b) At this point you can play with the Jacl commands. Start
    tclsh80.exe and type:

	set x [java::new java.awt.Frame]
	$x setSize 200 200
	$x show

How To Compile And Install TclBlend (Source Release Only):
----------------------------------------------------------
This is the directory where you compile, test and install the Windows
version of TclBlend.

The rest of this file contains instructions on how to do this. The
release should compile and run either "out of the box" or with trivial
changes on the makefile.vc. To compile for Unix, see the README file
in the directory ../unix.

The TclBlend build process is based on a Visual C++ style makefile
(makefile.vc). You must have the Visuall C++ nmake.exe program to use
makefile.vc.

You also need to install the Tcl8.0 binary installation on your
machine. You can download Tcl 8.0 from

	ftp://ftp.sunlabs.com/pub/tcl/tcl80.exe.

(a) Check for the definitions on the top of the makefile.vc. Modify
    the settings, when necessary, to reflect the setup of the Java
    development tools at your site.

(b) Type "nmake -f makefile.vc tclblend.zip" in the Command Prompt window.
    This will create both the DLL and ZIP files needed by the TclBlend
    package.

(c) At this point you can play with TclBlend by starting tclsh80.exe
    in this directory and type

	set env(CLASSPATH) {.\tclblend.zip;C:\jdk1.1.4\lib\classes.zip}
	load ./tclblend.dll Java

Test suite
----------

There is a relatively complete test suite for TclBlend in the
subdirectory "tests". To use it just type "nmake -f makefile.vc test"
in this directory. You should then see a printout of the test files
processed. If any errors occur, you'll see a much more substantial
printout for each error.  See the README file in the "tests" directory
for more information on the test suite.

