This directory contains a release of the Oaklisp system.

Oaklisp is (C) Copyright 1986,7,8 Kevin Lang and Barak Pearlmutter.
In the Freeware tradition, permission is explicitly granted for anyone
to use and copy this software, provided that neither it nor any
derived work is sold.  All other rights reserved.

Enhancements, bug reports, and bug fixes should be mailed to
Barak.Pearlmutter@CS.CMU.EDU for those with appropriate access to the
Internet, or

	Barak Pearlmutter
	Department of Computer Science
	Carnegie-Mellon University
	Pittsburgh, PA  15213

for others.



The contents of this directory are as follows:

Makefile; type "make install" to get things set up.

src/	contains C source to make the emulator.  If Oaklisp won't
	boot, you may need to edit the file config.h to reflect your
	machine, although it tries to adapt itself to various
	environments.  In particular, make sure it gets BIG_ENDIAN and
	UNSIGNED_CHARS set correctly.

	If you're have CMU make, just cd to fast/ and "make emulator".
	If you have a System-V style make that recognizes VPATH, add
	the line "VPATH = ../src" to the beginning of fast/makefile,
	cd to fast/ and "make emulator".  If your make does not use
	VPATH, cd to fast/ and type "cp ../src/{Makefile,*.[ch]} ."
	and then do a "make emulator".

bin/	contains some shell scripts and a symbolic link to the
	emulator executable.  Either put this directory in your search
	path or make links from some directory on your search path to
	the scripts oaklisp, oakliszt, and scheme.

mac/	contains all the Oaklisp source files needed to build a world,
	compiled Oaklisp sources for the compiler and scheme
	compatibility package, and a warm booted runnable world for
	either a bigendian or a littleendian machine, depending on
	where the release was made.  If the wrong kind of world is in
	this directory for your machine, "make correct_endian_world"
	to build a new one, starting from the original endian-portable
	file oaklisp.cold.

linker/	contains the world builder tool, which is written in T.
	Someday someone will get around to porting the tool to
	Oaklisp.  T is distributed by the Free Software Foundation of
	Cambridge Mass.


The command to run Oaklisp is "oaklisp".  The command to run Oaklisp
with an R3RS compatibility package loaded is "scheme".  The command to
compile an Oaklisp source file is "oakliszt".  For instance, to
compile foo.oak, producing foo.oa, one types "oakliszt foo".

To use these scripts, you should setenv OAKPATH to the directory this
file is in, with no trailing slash, or change the default location by
editing them.

Some of the Makefiles in this collection use CMU CS specific features.
If you can't figure out what's going on, try just ignoring and
deleting the weird stuff.

An Oaklisp Language Manual is available as a CMU CS tech report.
