Jacl
RCS: @(#) $Id: README.jacl,v 1.2 1999/05/10 03:20:35 dejong Exp $

This is the directory where you configure, compile, test, and install 
Windows versions of Jacl.

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 a Win95, Win98, or WinNT system. To compile for a UNIX
system, see the README file in the directory ../unix.

How To Compile And Install Jacl
------------------------------------------------------

(1) Check for patches as described in ../README.

(2) Open makefile.vc in a text editor and set the variables
    at the top of the file to the locations of your Jacl distro,
    your Java install, and your MS dev tools.

(3) Type "nmake -f makefile.vc". This will build two library
    files called jacl.jar and tcljava.jar. The jacl.jar library
    file stores the class files that are only used by jacl.
    The tcljava.jar library file stores the class files
    that are shared between jacl and tclblend.

(4) If the make fails then you'll have to personalize makefile.vc
    for your site or possibly modify the distribution in other ways.
    If you need to modify makefile.vc, there are comments at the
    beginning of it that describe the things you might want to
    change and how to change them.

(5) After the make finishes you can quickly test out Jacl by typing
    "nmake -f makefile.vc shell" which will drop you into a running
    Jacl shell where you can type in commands. You can also run the
    regression tests for Jacl by typing "nmake -f makefile.vc test".

(6) When you are ready to install jacl type "nmake -f makefile.vc install"
    to install the jacl.jar and tcljava.jar libraries on your system.
    The location where the files are installed depends on how you
    set up the variables at the top of makefile.vc.

Test suite:
-----------

There is a relatively complete test suite for all of the Tcl core 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.

