This is Austin Kyoto Common Lisp (v. 1.615) for BSD/386 1.0

First, some acknowledgments and license info:
=============================================

Austin Kyoto Common Lisp (AKCL) is a set of unencumbered enhancements
and bug fixes for Kyoto Common Lisp (KCL).  AKCL was developed by Bill
Shelter (among many others) at the University of Texas, Austin.

Kyoto Common Lisp is distributed for free, but requires a license from
SIGLISP to use.  The license data is used to track KCL usage and
update users of changes.  Because the binary AKCL depends on KCL,
please print out the file LICENSE, fill it out, and send a hardcopy
through the postal service to SIGLISP (see LICENSE).  BSDI has special
permission from SIGLISP to distribute KCL sources and a binary AKCL
based on modified KCL sources, but having the code is not the same as
having a license to use it.  Please send the KCL license to SIGLISP if
you use AKCL.  I would like to thank the authors of KCL, Taiichi Yuasa
and Masami Hagiya, for their software and cooperation. 

Several people at Edinburgh University have developed a port of AKCL
to the 386BSD operating system.  These people are Alan W. Black,
Richard Tobin and Jeff Dalton, and their 386bsd.patch is used to build
AKCL for BSD/386.  Files in BSD386.tar.Z are distributed under the
terms of the GNU general public license (See COPYING in the Emacs
source directories) for the benefit of all.

Now for the `how to' stuff:
===========================

There are several files in this directory.  

BSD386.tar.Z   		Files used to port AKCL to BSD/386 
				(includes 386bsd.patch) 
LICENSE			KCL license
README			This file
akcl-1-615.tar.Z        AKCL sources (most recent as of Feb 1993)
cl-shell.tar.Z		Public domain emacs-lisp interface 
example			Embarrassingly small example session
fact.lisp		Embarrassingly small example program
kcl-report.dvi.Z	KCL documentation (use dvips to get .ps file)
kcl.tar.Z		KCL sources  (most recent...1987) 
install-notes		Build instructions
saved_kcl		An executable AKCL (binary)

If you want to use Common Lisp, no compilation is necessary.  Just
execute saved_kcl.  Most people will want to run AKCL inside of GNU
Emacs.  This will require setting a variable in .emacs, as in 

(defvar *cl-program* "/usr/local/bin/saved_kcl"	
    "*Program name for invoking a Common Lisp subshell with run-lisp.")

Naturally, the directory you stick saved_kcl in is up to you and the
line above should reflect that.  

There are a variety of Emacs shells available that make running Common
Lisp easier.  Since development environments are a thing people
become a bit religious about, I won't advocate any of them over the
others.  On the other hand, if you don't know about any of them, you
might try cl-shell written by by Eero Simoncelli of the MIT Media
Laboratory.  I've included it for your convenience.  There is simple
documentation, but if you choose to use it, you'll end up with two
additional entries in your .emacs file similar to

(setq load-path (cons "/usr/ddyer/emacs-shell" load-path))

(autoload 'run-cl "~ddyer/emacs-shell/cl-shell.elc" "" t)

The binary AKCL provided will compile Portable Common Loops (which now
includes the Common Lisp Object System) that is available from
arisia.xerox.com.  However, the resulting binary image is large and
will not run acceptably on an 8 Mb machine.  Therefore, I recommend
that you use 16 Mb or choose not to use CLOS in your code.

AKCL doesn't implement all features of Common Lisp as described in Guy
L. Steele's _Common Lisp, the Language_ (2nd ed), but AKCL + PCL comes
pretty close.  Also, AKCL is distributed with sources for no charge.
As a result, AKCL is widely used.

You may choose to build AKCL from sources (perhaps to make a version
that can use more memory or recurse more deeply before exhausting the
invocation history stack).  I've automated the build process and you
should have no problems.  See the install-notes.  

Enjoy,

Doug

DOUGLAS E. DYER, Capt, USAF                             AFIT/EN/4612
Doctoral Candiate, Computer Engineering/AI Planning     WPAFB, OH 45433
Air Force Institute of Technology, WPAFB OH             (513) 255-9918
========================================================================


