Taurus JavaVM version 1.1.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~

To use, double-click the !JavaVM icon (or !Run in the !JavaVM directory).  This
will load any modules needed to run JavaVM and setup the paths needed to run
the usual java utilites (java, javac etc).

Class files are normally located in a Classes directory in the top level
directory ($) of your hard drive.  You should copy any classes you wish to run
into here.  If the classes form part of a package then create sub-directories
for each level of the package hierarchy.

If you are using ZIPped or JARed versions of the Java Runtime classes, then you
need to set the environment variable TJVM_HOME to the location of your !JavaVM
directory e.g. if your !JavaVM directory is in $.Programer.Java, then do

    * Set TJVM_HOME=/Programer/Java/!JavaVM
    
Note that this uses Unix style filenames and not the more usual Acorn ones.  If
you want this to happen automatically, edit !JavaVM.!Run by uncommenting and
changing the line that sets TJVM_HOME.

You should also note that for small programs, using classes.zip or rt.jar
directly, instead of uncompressing them first, significantly increases the
execution time as the entire archive must be indexed before execution can
begin.  On larger programs this overhead is comparatively smaller and it is
usually easier to manage things using ZIP or JAR files.

To install classes.zip (any version) or rt.jar (Unix version), you should copy
the archive into the lib directory inside !JavaVM (you will need to shift-click
!JavaVM to open it).

Regardless of how your classes are installed, you will probably need to
increase your wimpslot in order to run JavaVM.  You can do this with:

    * wimpslot -min 3000k

For larger java programs, you may need to increase the wimpslot value even
further.  You may find that some programs require more memory than you have
available, in which case you may need to look at using some kind of virtual
memory solution.

Any questions or bug reports should be mailed to support@tsac.co.uk
