Metrowerks JIT for JDK-1.1.6 (linux PPC port)

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

    1)	Place libmwjit-981013.so and libmwjit-981013_g.so in the following
        location:

		$JAVA_HOME/lib/ppc/green_threads/

	where $JAVA_HOME is the place where your JDK-1.1.6
	distribution lives.

    2)	Set the JAVA_COMPILER environment variable to 'mwjit-981013'.
        Under bash and other Bourne shell variants, this is done via

		export JAVA_COMPILER=mwjit-981013

	Under csh, tcsh, and other csh variants, this is accomplished
	via

		setenv JAVA_COMPILER mwjit-981013

	If you plan on using the JIT all the time, you may want to
	put this into one of your startup files (.login, .profile, etc.).


Running
-------

    If installation went properly, the JIT should run the next time
    you start the JDK.  In order to check to see if it is operating,
    run CaffeineMark or some other benchmark to see if the scores
    for your particular platform improved.

Disabling the JIT
-----------------

    If you want to disable the JIT, merely disable the JAVA_COMPILER
    environment variable.  In bash and other Bourne shell variants, this is
    accomplished via
    	
    	unset JAVA_COMPILER

    With csh, tcsh, and the other csh variants, use the following command
    instead:

    	unsetenv JAVA_COMPILER

    It is not necessary to remove the JIT shared library files from
    the installation location.


Reporting bugs
--------------
    
    Please send all bug reports to:
             Kevin Hendricks <kbhend@dogwood.tyler.wm.edu>

    This port was done under the Metrowerks Non-Commercial Source
    License (see http://www/.metrowerks.com).

    Please include as much information as you can including:

	1)  The nature of the bug (crash, incorrect behavior) and
	    whether it's repeatable or not.
	2)  Whether the bug also occurs with the JIT disabled.
    	3)  Which applet or application you were running.
	4)  The version of the JIT you were running.  (Simply reporting
	    the value of $JAVA_COMPILER should be sufficient if you
	    followed the instructions above.)
	5)  The version of the JDK that you were running.
	6)  The version of linux you are running (e.g, Mklinux DR3,
	    or linux-pmac 2.1.24 (and the build date), etc.)
	7)  Information about the hardware you were running on.

    I would also like to hear about performance problems of any sort.


Acknowledgements
----------------

    Very special "Thanks" go to Kevin Buettner and Michael Farrar (the 
authors of much of this JIT) and their employer, Metrowerks Corp., 
for releasing the source code to the JIT under a non-commercial license 
and allowing the binaries to be distributed for free.  Without them, 
this JIT would simply not be available on Linux for PowerPC!




