ftp.nice.ch/pub/next/developer/languages/java/kaffe.0.9.0.README

This is the README for kaffe.1.0b2.2.I.b.tar.gz [Download] [Browse] [Up]

kaffe.0.9.0.README
May 16 1997

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

md5sum:
aaa9e65f8610b8be2f5fda70328d7e2b  kaffe.0.9.0.I.b.tar.gz

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

NOTE:  Dynamic loading in v0.9.0 doesn't work (again).  (-;
Fortunately, static linking DOES work.  This build of kaffe was
built with the --enable-staticlib option.

I compiled for only the i386 nextstep platform.

OVERVIEW

kaffe serves as both a java compiler and java interpreter for stand-alone
java applications.  Included is (some) support for graphical java 
appliations (X11) via a freely available alternative awt library,  
biss_awt (v0.87).  Included is Sun's classes.zip and biss_awt's biss.zip.


INSTALLATION

This is NOT an Installer.app style package, it's just a gzipped
tar file.  Do the following:

cd /usr/local	(or where else you want to install it)
gnutar czvf /PathToArchive/kaffe.0.9.0.I.b.tar.gz

Then read the included README's and documentation in
src/kaffe-0.9.0/ENVIRONMENT.  
In particular, you'll need to set the environment variables KAFFEHOME 
and CLASSPATH to point to the location of the java class
libraries.  For example, if you installed this package into /usr/local,
then the correct settings (in csh) would be
setenv KAFFEHOME	/usr/local/share/kaffe
setenv CLASSPATH	.:/${KAFFEHOME}/classes.zip: 	\
			{KAFFEHOME}/biss.zip:		\
			{KAFFEHOME}
(The \'s mean to continue onto the next line.  Normally, there shouldn't
be any spaces between the entries in CLASSPATH.  I did it here because the
one line would've been hard to read.).


From the README: (this version does JIT)

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

                *** Kaffe is now JDK 1.1.1 compliant ***

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's new
==========

 * Kaffe is now JDK 1.1.1 compliant !

   This is the first released based on this new Java standard and things
   are not yet complete (esp. in the native libraries).  Please report
   bugs and send fixes.

 * Garbage collector now integrated with memory manager.

 * Lots of bug fixes (see Changelog)


What is BISS-AWT, v0.87
----------------

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.


NOTES
Building kaffe yourself

Here are the steps I followed to build this version of kaffe:
1.  setenv CC 'cc -traditional-cpp'
This is required if you have gcc installed on your system.  The 
dynamic-library version of kaffe will build only with NeXT's cc.
3.  make
4.  make install

You MAY need an implementation of the strdup library function to
link for the kaffe binary.

CREDITS

Package Creation
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: 
http://www.kaffe.org/

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

sawt: (Another alternative AWT)
http://slhp1.epfl.ch/sawt.html

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.