kaffe.1.0b3.2.README
Mar 10, 1999


file:  	kaffe.1.0b3.2.I.b.tar.gz
desc:  	kaffe 1.0b3 i386-nextstep3 binary package
sum:   	17991  2178
md5sum:	710103600ab60d076f52df8d94ee00a3

file:  	kaffe.1.0b3.2.s.tar.gz
desc:  	kaffe 1.0b3 slightly modified source
sum:   	62444  1788
md5sum:	9a111eddb567b093a42f20a4619e4384

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

OVERVIEW

This is a packaged up copy of a i386-nextstep3 kaffe built from source
(from transvirtual).  I've done a bit of minor editing here and there,
including adding awt support (via X11 interface), provided you have an
X server to display to (like co-Xist, Cub'X, or Xnext)

From kaffe's source README:

                         =======================

                         KAFFE OpenVM 1.0 Beta 3

                         =======================

This is of "Kaffe OpenVM", a complete virtual machine and class library
set which allows the execution of Java code without any code from Javasoft.
It comes with a virtual machine and a set of class libraries including beans,
and the all important AWT graphics system.


INSTALLATION

This is an Installer.app style package, use 
/NextAdmin/Installer.app to install to /usr/local

I've included 3 different Kaffe builds in this package.  
1.  Kaffe_internal: uses dynamic loading + unix-internal threading, 
2.  Kaffe_jthreads: uses dynamic loading + unix-jthreads threading, and 
3.  Kaffe_posix: built without dynamic loading + posix + unix-jthreads.  

Ironically, it appears, in my limited testing, that the posix
version is the most stable, primarily because of it's support for
POSIX-style signal handling (which is totally missing in the other
two).  The default build, here, however, is Kaffe_interal.


look at the symbolic link /usr/local/bin/Kaffe to see or modify which version of Kaffe YOU want to use.


SOURCE NOTES

I put these notes here for those brave souls who would like to
tackle the job of compiling kaffe for yourself.  Be warned, it's
hairy.  And, please, please, don't ask me questions about it.
Everything I know is here, and anything not included here, most
likely, I don't know.  (-;

Here's the steps I took to building kaffe on an OpenStep for Mach
4.2 system.  On such an OS4.2, to build kaffe, you need to have a
modified cc compiler to produce static (ie, NEXTSTEP 3.x) binaries.
Hint: you need the NEXTSTEP 3.x library /lib/libsys_s.a


Required auxilary libraries
libX11	(I used Xnext's)
libjpeg	(I used JPEG.framework)
libgmp	(I used GMP.framework)
libpng	(I used PNG.framework)
libz	(I used Zlib.framework)

1.  setenv CC cc 	# You can't use gcc
2.  configure --with-threads=internal i386-next-nextstep3
3.  make

THEN, modify the linking steps of the kaffe binary (in kaffe/kaffe),
and libnative (in libraries/clib/native) so that they DONT link against
-lm (otherwise you get symbol collision when trying to use dynamic loading).

The resulting kaffe binary does not even come close to passing all
the regression tests, unfortunately.


CHANGELOG

Mar 10, 1999	(1.0b3 pkg #2)
* I think a bonehead packaging mistake on my part broke the 
Kaffe_internal and Kaffe_jthread binaries, rendering all but
Kaffe_posix inoperable.  They really work now.

Mar 2, 1999	(1.0b3 pkg #1)
* First attempt at building from source
* Use Xnext's X11R6 libraries

Oct 16, 1998	(1.0b2 pkg #2)
* Bad libnative.o caused dynamic loading to fail, fixed.

Oct 15, 1998	(1.0b2 pkg #1)
* First attempt
* X support via co-Xist's X11R5 libraries

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.transvirtual.com/
ftp://ftp.transvirtual.com/pub/kaffe/

More kaffe on NEXTSTEP info
http://www.mathi.uni-heidelberg.de/STEPkaffe/