kaffe-0.7.1.README
Jan 1997

The archive (most likely) will be located at
ftp://ftp.next.peak.org/pub/next/apps/internet/www/java

kaffe-0.7.1.I.b.tar.gz:
   Contains Installer.app package of kaffe binary and support files.


OVERVIEW

kaffe serves as both a java compiler and java interpreter for stand-alone
java applications.  Included is (some) support for graphical java 
appliations via a couple of freely available alternative awt libraries: 
biss_awt and sawt.  Included is Sun's classes.zip, 
sawt (JavaClasses - sawt.zip, CLibrary - libkaffe_sawt-0.4.2.a), 
biss-awt (JavaClasses - biss.zip, CLibrary - libkaffe_bissawt-0.86.a)

Don't ask me about either awt, why it doesn't seem to work, or how to use 
them.  I don't know. (-;  Read the provided documentation, or contact the
authors of the particular library with your inquiries on these matters.


INSTALLATION

Just install using Installer.app into /usr/local, and you're done. 
If you install elsewhere, you'll have to modify the scripts in
/usr/local/bin to point to the proper location. 

Note that there are two different awt libaries included here with kaffe:
biss_awt and sawt.  I've included scripts bin/java.biss and bin/java.sawt
that will envoke the java interpreter with the proper settings to use the
appropriate awt library.  I would recommend that you create a link to or
copy one of these to the name bin/java to use as the default.

I've included two versions of the biss-linked kaffe binary, as the biss
documentation claims there is a bug in kaffev0.7 that causes biss to not
function properly.  The biss developers provided a patch: wait.patch that
fixes the problem, but it is against kaffev0.61.  So... I've included 
binaries for both v0.71 and v0.61.  You pick which to use.  In my limited
testing, I haven't been able to discern a difference.

The Quad FAT libraries (in lib/kaffe) of sawt and biss-awt are provided 
for posterity only, as kaffe does not use them directly.


From the README: (this version does JIT)

KAFFE v0.7.1 - A JIT and interpreting virtual machine to run Java(tm)* code
===========================================================================

This is Kaffe, a virtual machine design to execute Java bytecode.
This machine can be configured in two modes.  In one mode it operates as
a pure bytecode interpreter (not unlike Javasoft's machine); in the second
mode if performs "just-in-time" code conversion from the abstract code to
the host machine's native code.  This will ultimately allow execution of
Java code at the same speed as standard compiled code but while maintaining
the advantages and flexibility of code independence.

What is BISS-AWT
----------------

The BISS-AWT java framework is a framework of about 150 Java classes for
building graphical applications with state-of-the-art user interfaces.
Instead of following the "OS-native" look-and-feel (like Suns java.awt),
it implements its own "Java-native" look-and-feel. The framework can be
extended without the need to write native libraries. It has nice things
like pop-up menus, notebooks, hierarchical Lists etc. without the need for a
JDK 1.1 compliant native lib.

Sawt-0.4.2
==========
Included in this binary is Awt support via sawt-0.4.2.  I used the Xnext
X11R6 libraries to provide X support.  Here's the info
from the sawt README about this:

This is simple awt. It is supposed to be a replacement for Unix/X of the
java.awt.peer classes from the JDK-1.0.2 from Sun.

The particularity of this implementation is that I have tried to
write the most I can do in the Java language itself, leaving the smallest
part, that is build directly in C over the Xlib (no Motif or any toolkit).



CREDITS

Rex Dieter <rdieter@math.unl.edu>
Computer System Manager 
Universtity of Nebraska-Lincoln  
Department of Mathematics and Statistics 
http://www.math.unl.edu/~rdieter

kaffe home page: 
http://www.soi.city.ac.uk/~tim/kaffe/

biss_awt Information:
http://www.biss-net.com/biss-awt.html

sawt home page:
http://slhp1.epfl.ch/sawt.html

