jRate for MaRTE OS
                         --------------------

                        Version 0.1 - Jan 2005
                      For MaRTE OS  Version 1.57


This tar file contains the port of jRate to MaRTE OS (architecture
"linux_lib").

jRate (Java Real-Time Extension) is an extension of the GNU GCJ
compiler front-end and runtime system which adds supports for most of
the feature required by the Real-Time Specification for Java (RTSJ).
jRate Home Page:
http://jrate.sourceforge.net/index.html

This is a precompiled distribution of this port containing libraries,
Java classes and gcj compiler. For jRate sources visit jRate Home
Page. For MaRTE OS patch to jRate visit MaRTE OS Home Page
(http://marte.unican.es) or contact Mario Aldea Rivas
(aldeam@unican.es).

To use "jRate for MaRTE OS" with your MaRTE OS (architecture
"linux_lib") do the following:

 - Untar 'jRate_for_MaRTE_X-Y.tgz'. This will create a
   'jRate_for_MaRTE/' directory. (Probably you have already done it,
   since you are reading this README file ;)
   $ tar zxvf jRate_for_MaRTE_X-Y.tgz

 - Edit file 'marte/utils/globals.pl' and set variable $JRATE_PATH to
   the absolute path of that directory:
   $JRATE_PATH = "/.../jRate_for_MaRTE"; 
   (Notice no ending '/').

Now you can make Java applications using command 'mgcj'. 'mgcj' takes
the same options as the GNU compiler 'gcj', for example, to compile a
Java application composed by two classes (main program in ClassOne):

  $ mgcj ClassOne.java ClassTwo.java --main=ClassOne

This will create a executable called 'mprogram'. Just run it as any
other Linux application:

  $ ./mprogram