CVS info: $Revision: 1.1 $ $Date: 2003/08/14 11:33:03 $ $State: Exp $ $Locker: $

# README

The whole release shebang is summarized in our Change Log.

As always, the most current information about the Remote Tea Java Library, as well as updates, can be found on the web at the Remote Tea ONC/RPC Home Page.

## Licensing

The Remote Tea Java Library is licensed under the terms of the GNU Library General Public License (LGPL).

Rationale: while the LGPL does not restrict the use of my packages even in commercial applications, I am ensuring this way that modifications to the source code must be given back to the comunity. If you use my packages in commercial applications, you must either include the source code of the Remote Tea ONC/RPC Java Library or provide the source code to your customers on request. The details can be found in the LGPL terms.

## Project Structure

The directory structure is as follows. Due to the transition to the Eclipse IDE and Ant not everything is currently in place and perfect shape.

- `javadoc/`: Remote Tea ONC/RPC documentation
- `src/`: source code of the Remote Tea ONC/RPC Java Library.
  - `src/org/acplt/oncrpc` contains the source code of the various packages.
  - `src/org/acplt/oncrpc/apps` contains applications, in this case only the jrpcgen rpc protocol compiler in the `jrpcgen/` subdirectory.
  - `src/tests` contains test code.
  - `src/tests/org/acplt/oncrpc/jrpcgen` contains an example of how to use the `jrpcgen` rpc protocol compiler. To generate source code from the x-file, run:

          java -jar jrpcgen.jar -p tests.org.acplt.oncrpc.jrpcgen -nobackup demo.x

- `classes/`: will receive the compiled Java bytecode. After running the Ant `build.xml` makefile with target jar, this directory will also contain two jar files called `classes/oncrpc.jar` and `classes/jrpcgen.jar`.

The Remote Tea ONC/RPC Java package is currently being developed and tested using Eclipse on a JDK 1.4.2 (Windows).

Those who like to compile the sources by themselves might want to use either the Eclipse `.project` file or the Ant makefile `build.xml` (this is not really functional yet), both are located in the root directory of this package.

## Who's to blame

The Remote Tea Java Package has been written by Harald Albrecht (harald@plt.rwth-aachen.de).
© 1999, 2003 Chair of Process Control Engineering,
Aachen University of Technology,
52064 Aachen, Germany