                                      TALC
                                      ====

Release 1.5+
Copyright
    Greg Morrisett, Neal Glew, Dave Walker, Steve Zdancewic, Stephanie Weirich,
    Frederick Smith, and Dan Grossman July, August, September 1998, and
    January 1999 all rights reserved.

This software should be considered pre-alpha.

N.B. The distribution should come partially prebuild.  In particular
     the executables will be in the build directory and the tal and tali
     files for the popcorn tests should exist.

Building
========

You need:

1) The TALC sources
2) Ocaml 2.01
3) MASM 6.11
4) Visual C++ (we use the command line C compiler and linker)
5) GNU development tools, we use Cygnus cygwin32 beta 19 both
   user tools and developer tools

Note: Makefiles require GNU make.

Steps:

1) Get ocamlc, ocamllex, ocamlyacc, ml (MASM's assembler), cl (C
   compiler), link, and make into PATH.
2) Run:
     make all runtime scheme_runtime

Sit back, drink a quick cup of coffee and three executables will
magically appear in the build directory.

Notes
-----

1) make depend is flakey, it is known to work for us under the Cygnus GNU make
   utility but known to break under other versions of GNU make.
2) Do make strip only under unix, it will remove ^M characters from
   the source files making them more unix like.  Also run ./stripm
   Makefile.

Running
=======

1) Put the directory talc-1.5/build into PATH.  Also put ml and link
   into PATH if you want object files and executables.
2) Set the environment variable TALCLIB to talc-1.5/runtime.
3) The executables are named talc.exe (for tal file checking),
   popcorn.exe, and scheme.exe.
4) Run <tool> -help to get a listing of command line arguments.
5) To run scheme effectively you need scheme.tali in the current
   directory or in the runtime directory.

Windows 95 Hints
================

My autoexec.bat (for Win95) looks like this:

SET MSVCDir=C:\Progra~1\DEVSTU~1\VC
SET MSDevDir=C:\Progra~1\DEVSTU~1\SHARED~1
SET PATH=d:\talc\build;d:\MASM611\bin;d:\gnu\H-I386~1\bin;%PATH%
SET PATH=%MSDevDir%\BIN;%MSVCDir%\BIN;%MSVCDir%\BIN\WIN95;%PATH%
SET INCLUDE=%MSVCDir%\INCLUDE;%MSVCDir%\MFS\INCLUDE;%MSVCDir%\ATL\INCLUDE
SET LIB=%MSVCDir%\LIB;%MSVCDir%\MFS\LIB
set MAKE_MODE=unix
SET CYGFS=d:/gnu
SET GCC_EXEC_PREFIX=d:\GNU\H-I386~1\lib\gcc-lib\
SET TALCLIB=D:\talc\runtime
