This is a Java regression testsuite using DejaGNU as the framework,
and with additions from Petter Reinholdtsen <pere@td.org.uit.no>.  It
is maintained as part of Japhar, the Hungry Programmers Java VM,
<URL:http://www.hungry.com/products/japhar/>.

This testsuite can be copied freely.  If you make new tests or other
improvments, please send us a copy of your changes on
japhar@hungry.com.

To use the testsuite you will need the DejaGNU distribution to get 
'runtest'.  It can be found at <URL:ftp://ftp.cygnus.com/pub/dejagnu/>.

To actually run the tests, cd to the 'testsuite' directory and do
'make check'.

How to run the tests for this DejaGNU Java testsuite:

 - Your classpath should be empty.  The needed directory is added by 
   java.exp.  Methods in libruntime and libnative add classes.jar 
   automatically.  
   To unset your CLASSPATH in the 'bash' shell, use 'unset CLASSPATH'.
   It has been shown that if your CLASSPATH includes the usual classes.zip
   from javasoft the tests will fail.

 - By default, japhar expects Sun's javac to be in your path, but you
   may override this default and specify your own javac using
   the option 'JAVAC=/full/path/to/javac'.  For example:
   'gmake check JAVAC=javac-kaffe'

 - From the testsuite directory run 'make check'.

How to make new tests for this DejaGNU Java testsuite:

 - Decide which subdir to place the test.  If you want your own
   subdir, copy java.lang/execute.exp into the new subdir.
   The subdir must start with "java." to be tested automatically along
   with all the others.

 - Make new Java class with its own main.  The filename and the
   classname must match.  It _MUST_ print "PASSED: " if the
   test went OK, and "FAILED: " if it didn't.

   The simplest test looks like this:

     public class SimpleTest {
	public static void main(String args[])
	{
		System.out.println("PASSED: All ok.");
	}
     }

