jRate

File Release Notes and Changelog

Release Name: 0.3.8.2beta-3.3.3

Notes:
                jRate The GCJ Real-Time Java Extension


  1. General
  2. Supported Platforms
  3. Installation
  4. Contact Us
  5. Licensing



[1. General]

jRate is a Real-Time Java library implementation meant to be used
together with GCJ (see http://gcc.gnu.org/java). For more information
on jRate, its design and its performance refer to the documentation
online at:  http://jrate.sourceforge.net

For user-visible changes, refer to the NEWS file in the distribution.


[2. Supported Platforms]

Right now the only platforms on which jRate intentionally works are:

      - Linux/x86 (Red Hat 9, FC2, Debian/unstable, others...)
      - TimeSys RTLinux/x86 (http://www.timesys.com)
      - Linux/ppc (Gentoo, others...)
      - TimeSys Linux BSP/ppc

jRate may work on other platforms as well, but has not been tested.


[3. Installation]

Please refer to the INSTALL file in the jRate distribution for
configuration, build, and installation help.


[4. Contact Us]

For any questions, suggestions, or to contribute to the jRate project,
please contact the jRate development team at
<jrate-devel@lists.sourceforge.net>.


[5. Licensing]

jRate open-source licensing terms and conditions are reported in the
LICENSING file contained in the jRate installation directory.


Changes:
=======================================================================
GOTCHAS IN THIS BETA RELEASE.  The RealtimeThread periodic release
code has been completely overhauled, as has the AsyncEventHandler
implementation.  These portions of jRate now are more close to the
RTSJ, with preemptive deadline miss handling and cost overrun handling
implemented.  It is possible that thread releases don't work correctly
on some platforms or in some situations; it hasn't been thoroughly
tested yet.  RealtimeThread.waitForNextPeriod() still needs work and
may not return a correct result.  NOTE ALSO that the
waitForNextPeriod() method IS NOW STATIC in accordance with the spec.
(This change should be source-compatible so long as calls were only
previously made to the *current* RealtimeThread's waitForNextPeriod()
method.)  Multiple deadline misses/cost overruns on a periodic thread
may not be handled correctly yet.  The AsyncEventHandler API is now
closer to the spec but will break existing application code that uses
it.  The javax.realtime.ThreadedAsyncEventHandler class no longer
exists (it was never in the spec, and the functionality it provided is
the same as the new AsyncEventHandler implementation), and
AsyncEventHandler is no longer abstract.

Further, the demos build process is under construction.  You may
experience errors in the jRate demos directory when doing a make
install, particularly if you're building jRate as a cross compiler.
For now, you can disregard such errors; the demos are the last thing
to be built/installed, so you should have a working jRate even if the
demos bomb out.  The demos can still be built manually by calling
jRate-gcj with the right parameters.
=======================================================================
PLEASE NOTE that because this version of jRate uses GCC 3.3.3 (which you unpack
into its directory tree), you need to use GCC 3.x (not 4.x) to kick off the build
process.  You do this by setting the CC environment variable to your GCC 3.x
compiler when you configure jRate.
=======================================================================
User-visible changes from 0.3.8.1beta-3.3.3 to 0.3.8.2beta-3.3.3:

* Fix configure script for what looks like a bug in bash 3.1.x.  Also
  some minor documentation and build/dist process fixes.  There are no
  behavioral changes to jRate in this release.