Remote Tea ONC/RPC Java Library
Author: Harald Albrecht

# 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 the packages even in commercial applications, it is ensured this way that modifications to the source code must be given back to the community. If you use the 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.

## Java compliance

The Remote Tea ONC/RPC Java package is currently being developed using Eclipse Luna, Maven 3.2.3 and Ant 1.9.2. The distribution files are compiled with the Java compiler shipped with the Oracle Java JDK version 1.8.0_74. The packages are compiled with the compiler options source=1.5 and target=1.5 letting the packages backwards compatible with Java 5 runtime environments.

## Project Structure

Remote Tea is organized with respect to its modules:

oncrpc
  The runtime environment for ONC/RPC programs, both client and server side.
jrpcgen
  The source generator for ONC/RPC programs analogous to rpcgen of Sun.
jportmap
  A port mapper implementation required by ONC/RPC programs to register as service and to lookup registered services, respectively.
maven-plugin
  A Maven Plugin providing access to the source generator (jrpcgen) in the Maven life cycle phase generate-sources.
information
  Project information such as the license and the change log.

The corresponding folder structure is as follows:

- `remotetea`: The Ant build file build.xml and the main POM file pom.xml.
- `remotetea/oncrpc`: POM and source code of the ONC/RPC runtime environment, both client and server side.
- `remotetea/jrpcgen`: POM and source code of the ONC/RPC x-file parser and source code generator.
- `remotetea/jportmap`: POM and source code of the ONC/RPC port mapper.
- `remotetea/maven-plugin`: POM and source code of the Maven plugin for the x-file parsing and source code generation within a Maven project.
- `remotetea/information`: POM and information files such as the license and the change log.

The target directories of the Ant build artifacts are as follows:

- `remotetea/classes`: Compiled class files as well as built Jar-files.
- `remotetea/javadoc`: Remote Tea ONC/RPC API documentation.
- `remotetea/dist`: Distribution files of Remote Tea ONC/RPC for Sourceforge.

The target directories of the Maven build artifacts are with respect to the modules `remotetea/<module>/target`.

## Who's to blame

Have a look at the Remote Tea ONC/RPC Wiki to see the list of project members.