This directory contains the distribution of jacal1a.  Jacal is a
symbolic mathematics system which runs under Scheme language
implementations.  Scm, a P1178 and R4RS compliant Scheme
implementation is available from the same sources as jacal.

The author can be reached at jaffer@ai.mit.edu or
Aubrey Jaffer, 84 Pleasant St., Wakefield MA 01880.

			       MANIFEST

  `README' is this file.  It contains a MANIFEST, INSTALLATION
	INSTRUCTIONS, and a TROUBLE SHOOTING GUIDE.
  `COPYING' details the LACK OF WARRANTY for jacal and the conditions
	for distributing jacal.
  `ChangeLog' documents changes to the jacal.
  `code.doc' has some documentation on jacal internals.

  `demo' demonstrates batch file use.  "batch(demo);" to use in jacal.
  `manual' has Tex files which tell how to use jacal.
	`cmds.tex' is documentation on commands.
	`relnotes.tex' is a list of some things not consistent between
		jacal and manual.tex.
	`macros.tex' has tex macros for printing manual.tex.
	`manual.tex' running "tex manual.tex" will format both
		commands and release notes.

  `math.scm' is the file you load into scheme in order to run jacal.
  `scl.scm' loads code from SLIB.
  `toploads.scm' contains comments describing the rest of the files.

		      INSTALLATION INSTRUCTIONS

  Scl.scm uses files from SLIB, the scheme library.  If you are
  running jacal in Scheme you will need to install SLIB.  SLIB is
  available from the same sources as jacal.  See README in SLIB for
  how to install SLIB.

Different Scheme implementaions use different filename extensions. You
may need to either link or change to suitable names the source files
so that your Scheme can find them with the command (load "math").
Look through the list below to find the filename extension for your
Scheme.

* scm
    extension is ".scm"

* MIT Scheme 
    HP-UX, Unix: extension is ".scm"

* MacScheme 

* PC Scheme 
    PCSCHEME is a R3RS implementation.  The file sc4-sc3.scm needs to
    be finished in order for JACAL to run.

* T 
    extension is ".scm"

* Chez Scheme 

* Elk 
    extension is ".scm"

* Scheme->C 
    extension is ".scm"

* Gambit
    extension is ".scm"

* SIOD 
    Siod is lacking some of the rev^4 datatypes.  JACAL will not run.

* Pseudoscheme 
    This translates scheme programs to common lisp.

* Scheme84 
    extension is ".scm"

* UMBscheme

* Vincennes Scheme 

* XScheme 

* Fools' Lisp 

			    RUNNING JACAL

To use from Scheme type:
  scheme
  (load "math")

			   COMPILING JACAL

There are some tests which are run at the end of loading "math".  If
these do not give any warnings then you can either try using the
system "type (math)" or compiling it.

It is very worthwhile to compile SLIB files, "types.scm" and "poly.scm".

			TROUBLE SHOOTING GUIDE

Not yet written.
