********************
** USING THE TOOL **
********************

The tool is invoked in the following way:

ada2java -P<full GNAT projectoath > [-b <base java binding package]
 [-o <full directory output for Ada glue>]
 [-c <full directlry output for Java classes>]
 [renamings.ads]
 package1.ads package2.ads .. packagen.ads
 
The GNAT project file has to be a flat project (sources from withed projects
won't work - I still have to figure how to make this work with the asis tools)

The base java binding package is used to provide a base package for all the
generated Java classes.

The Ada glue is a set of ads / adb files that will need to be compiled into
the native library (described below).

The output directory of Java classes is will need to be in the CLASSPATH of
the Java application that is going to use this binding. It works as a root
Java class path.

The renamings.ads, if any, has to be placed in front of all the bound 
packages. It contains a sequence of ada renaming declarations. When binding an
entity, instead of using the entity name, the generator will use the one 
renamed in this file if present. This helps to fix name clashes.

******************************
** USING THE GENERATED CODE **
******************************

The first thing needed is to compile the Ada code into a dynamic library. That
is to say, the closure of the bound code + the generated Ada glue. The Ada 
glue depends on the ada2java project installed in the lib/gnat directory
of the javatools distribution. So what's needed is to create a SAL project 
containing the sources of the bound code + the glue, and use it to compile the
library. 

[AI - this project file could be generated automatically]

Then, on the Java code, this library needs to be loaded. Right now, it has to
be done manually, by adding a System.loadLibrary ("library_basename") in the
java code.

[AI - this could be loaded automatically by the generated Java]

Before running the Java code depending on this, you need to have the CLASSPATH
set both to the generated Java code, and some predefinied Java classes on which
rely this code and wich are accessible from the binary package under
include/java.

