
                        Java Cube Reader Library v4.8 README
                        ====================================

Java Cube Reader Library is a native Java library for reading of  a multi-
dimensional performance space consisting of the dimensions (i) performance
metric, (ii) call path, and (iii) system resource. Each dimension can be
represented as a tree, where non-leaf nodes of the tree can be collapsed
or expanded to achieve the desired level of granularity.

The Java Cube Reader Library is optimized for usage in TAU and Android, but
might get used in another tools as well.

Java Cube Reader Library is released as open source under a BSD-style license.
Please see the COPYING file in the package base directory for details.


Installation
============

See the INSTALL file for detailed information about how to configure, build
and install Java Cube Reader Library.

User Documentation
==================

Java Cube Reader Library user documentation for a specific installation is by
default installed into the '$JCUBER_ROOT/share/doc/jcuber' subdirectory.  At
present, however, user documentation is still limited.

 * Java Cube Reader Library Tools Developer Guide
    (CubeToolDevelopmentGuide.pdf | html/index.html):

   The Java Cube Reader Library Tools Developer Guide is currently being
   rewritten and still incomplete. However, it should already contain enough
   information to get you started and avoid the most common pitfalls.

 * Java Cube Reader Library open issues & limitations (OPEN_ISSUES):

   Compendium of known limitations and unimplemented features that may affect
   Java Cube Reader Library usability on various platforms or with certain
   applications, with suggested workarounds where appropriate.  Although issues
   may be uncommon and/or quite technically complex, users are encouraged to
   briefly review this document, particularly if they believe they have
   encountered a problem when using Java Cube Reader Library, prior to contacting
   user support.


Web page & Contact
==================

For further more detailed information on Java Cube Reader Library see the
project webpages at

        http://www.scalasca.org/

For help, reporting bugs, and making comments or suggestions send e-mail to

        scalasca@fz-juelich.de
