Java 2 (JDK 1.2) for MkLinux, Linux-PMac, and LinuxPPC
Addendum to README.linux for PowerPC users
------------------------------------------------------

Announcing Pre-Release version 1 of Sun's JDK 1.2 (Java 2) for
Linux on PowerPC


This is a *pre-release*  version of JDK 1.2

    - passed all non-interactive JCK tests for compiler, runtime-vm, 
      and runtime lang (the remaining tests have not been run yet).

    - both green (very stable) and native threads (beta at best)

    - green threads is the default. to force either threads type
      use: java -green XXXXXX or java -native XXXXX

    - for glibc 1.99 (DR3, R4, R4.1) (No R5 glibc 2.1 version yet)

    - NO Metrowerks JIT (Just-in-Time) compiler is available *yet*
      (jit interface changed significantly from JDK 1.1.7 to JDK 1.2)

    - This port is statically linked with Motif 2.1.

    - This port was developed under a sepcial Sun's license 
      agreement with Blackdown via Steve Byrne


Please note: 

All of the development and testing was done using Paul Mackerras's 
Linux-PMac 2.2.1 kernel with Gary Thomas's latest glibc 1.99 (1o)
installed over DR3/R4 user space.

The home website is still: http://business.tyler.wm.edu/mklinux

however all official releases (for all versions of Linux) will be 
available from both this site and the Blackdown Organization site.

http://www.blackdown.org/java-linux.html

I hope you enjoy the numerous improvements available in JDK 1.2

Thanks,

Kevin Hendricks

...with a special thanks to the other Blackdown Porting Team members:
Steve Byrne, Juergen Kreileder, Johan Vos, Anand Palaniswamy, 
David Connelly, Karl Asha, Kars de Jong, Scott Hutinger, Michael Sinz, and 
Brad Crochet; and to Kevin Buettner for doing the initial JDK 1.1 porting
work to PowerPC.


Installation
------------

   * you must be running shared libraries for this port to work

   * unset any java enviroment variables you might have previously set
     (remove CLASSPATH, JAVA_HOME, LD_LIBRARY_PATH, etc)

   * unpack this tar archive any place you like (i.e. /usr/local)

   * change your path environment variable to point to the java
     bin directory
         i.e. 
              export PATH=/usr/local/jdk12_pre-v1/bin:$PATH



Known Problems / Bug Reports
----------------------------

If you run into troubles running the JDK, please try upgrading to
the following packages, *before* filing a bug report:

- glibc (1o) (the very latest glibc from Gary Thomas with thread fixes)
- X11R6.3 (1s) (the X11R6.3 (1r) rpms rebuilt with -D_RENTRANT
- Paul's latest 2.2.1 kernel


   * Native threads problems with linuxthreads 0.5 in glibc 1.99 

   * If you get segfaults while launching java, please upgrade
     your glibc to something much more recent (preferably the latest)

   * Report all bugs to http://www.blackdown.org/java-linux.html

With each bug report try to send as much information as possible,  such as:

   *  which version of Linux you are running (MkLinux, Linux-PMac, etc)
   *  which kernel version you are using
   *  whether running green_threads or native threads
   *  what java app/applet was running
   *  where to find that app/applet (url)
   *  environment setup
   *  ldconfig -v, backtrace, error message, etc.

Please remember to read docs, as they sometimes have a way of helping out
with some problems. I know, who reads docs...