home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / NEXTSTEP / developer / languages / java / kaffe.0.9.0.README < prev   
Encoding:
Text File  |  1997-05-23  |  3.9 KB  |  122 lines
  1. kaffe.0.9.0.README
  2. May 16 1997
  3.  
  4. The archive (most likely) will be located at
  5. ftp://ftp.next.peak.org/pub/next/apps/internet/www/java
  6.  
  7. md5sum:
  8. aaa9e65f8610b8be2f5fda70328d7e2b  kaffe.0.9.0.I.b.tar.gz
  9.  
  10. kaffe-0.9.0.I.b.tar.gz:
  11.    Contains Installer.app package of kaffe binary and support files.
  12.  
  13. NOTE:  Dynamic loading in v0.9.0 doesn't work (again).  (-;
  14. Fortunately, static linking DOES work.  This build of kaffe was
  15. built with the --enable-staticlib option.
  16.  
  17. I compiled for only the i386 nextstep platform.
  18.  
  19. OVERVIEW
  20.  
  21. kaffe serves as both a java compiler and java interpreter for stand-alone
  22. java applications.  Included is (some) support for graphical java 
  23. appliations (X11) via a freely available alternative awt library,  
  24. biss_awt (v0.87).  Included is Sun's classes.zip and biss_awt's biss.zip.
  25.  
  26.  
  27. INSTALLATION
  28.  
  29. This is NOT an Installer.app style package, it's just a gzipped
  30. tar file.  Do the following:
  31.  
  32. cd /usr/local    (or where else you want to install it)
  33. gnutar czvf /PathToArchive/kaffe.0.9.0.I.b.tar.gz
  34.  
  35. Then read the included README's and documentation in
  36. src/kaffe-0.9.0/ENVIRONMENT.  
  37. In particular, you'll need to set the environment variables KAFFEHOME 
  38. and CLASSPATH to point to the location of the java class
  39. libraries.  For example, if you installed this package into /usr/local,
  40. then the correct settings (in csh) would be
  41. setenv KAFFEHOME    /usr/local/share/kaffe
  42. setenv CLASSPATH    .:/${KAFFEHOME}/classes.zip:     \
  43.             {KAFFEHOME}/biss.zip:        \
  44.             {KAFFEHOME}
  45. (The \'s mean to continue onto the next line.  Normally, there shouldn't
  46. be any spaces between the entries in CLASSPATH.  I did it here because the
  47. one line would've been hard to read.).
  48.  
  49.  
  50. From the README: (this version does JIT)
  51.  
  52. KAFFE v0.9.0 - A JIT and interpreting virtual machine to run Java(tm)* code
  53. ===========================================================================
  54.  
  55.                 *** Kaffe is now JDK 1.1.1 compliant ***
  56.  
  57. This is Kaffe, a virtual machine design to execute Java bytecode.
  58. This machine can be configured in two modes.  In one mode it operates as
  59. a pure bytecode interpreter (not unlike Javasoft's machine); in the second
  60. mode if performs "just-in-time" code conversion from the abstract code to
  61. the host machine's native code.  This will ultimately allow execution of
  62. Java code at the same speed as standard compiled code but while maintaining
  63. the advantages and flexibility of code independence.
  64.  
  65. What's new
  66. ==========
  67.  
  68.  * Kaffe is now JDK 1.1.1 compliant !
  69.  
  70.    This is the first released based on this new Java standard and things
  71.    are not yet complete (esp. in the native libraries).  Please report
  72.    bugs and send fixes.
  73.  
  74.  * Garbage collector now integrated with memory manager.
  75.  
  76.  * Lots of bug fixes (see Changelog)
  77.  
  78.  
  79. What is BISS-AWT, v0.87
  80. ----------------
  81.  
  82. The BISS-AWT java framework is a framework of about 150 Java classes for
  83. building graphical applications with state-of-the-art user interfaces.
  84. Instead of following the "OS-native" look-and-feel (like Suns java.awt),
  85. it implements its own "Java-native" look-and-feel. The framework can be
  86. extended without the need to write native libraries. It has nice things
  87. like pop-up menus, notebooks, hierarchical Lists etc. without the need 
  88. for a JDK 1.1 compliant native lib.
  89.  
  90.  
  91. NOTES
  92. Building kaffe yourself
  93.  
  94. Here are the steps I followed to build this version of kaffe:
  95. 1.  setenv CC 'cc -traditional-cpp'
  96. This is required if you have gcc installed on your system.  The 
  97. dynamic-library version of kaffe will build only with NeXT's cc.
  98. 3.  make
  99. 4.  make install
  100.  
  101. You MAY need an implementation of the strdup library function to
  102. link for the kaffe binary.
  103.  
  104. CREDITS
  105.  
  106. Package Creation
  107. Rex Dieter <rdieter@math.unl.edu>
  108. Computer System Manager 
  109. Universtity of Nebraska-Lincoln  
  110. Department of Mathematics and Statistics 
  111. http://www.math.unl.edu/~rdieter/
  112.  
  113. kaffe: 
  114. http://www.kaffe.org/
  115.  
  116. biss_awt:
  117. http://www.biss-net.com/biss-awt.html
  118.  
  119. sawt: (Another alternative AWT)
  120. http://slhp1.epfl.ch/sawt.html
  121.  
  122.