Welcome to the Geotools introductory demonstration application.

This Geotools module, demo/introduction, includes a simple graphical application 
which introduces the Geotools library by using many of its sub-systems. The code 
of the demonstration application is written to be easily legible and includes 
extensive comments in order to serve as an introduction for new programmers 
wishing to understand Geotools.

The functionality of the demonstration application is limited. The application 
opens a graphical user interface window which contains a column of buttons on 
the left hand side. The buttons can be clicked in sequence to perform a sequence
of commands each of which illustrates the use of part of the Geotools library.

The demonstration application can be run either
    * from a binary distribution which contains the entire library as JAR files 
    * from a source distribution which has subsequently been compiled
    * from a subversion repository checkout which has been complied
with the former being the easiest. To run the demonstration application, the 
user first needs a 1.4 or later Java Runtime Environment (JRE) into which both 
the JAI and Java Image IO extensions have been installed. The PATH variable must 
include the directory containing the java binary 'java'. The demonstration 
application can then be run with the command:

  java -jar gt2-demo-introduction-2.3.0.jar

for a binary distribution where the command is run in the directory containing 
all of the Java archive (JAR) files. Alternatively, in a compiled source or 
subversion directory, the demonstration application can be run with the same 
command after changing into the target/ directory which is created during the 
  mvn install
step of compilation. Note that the version number given in this example, '2.3.0,' 
might be different depending on the actual version of the Geotools library
which is being used. 


Known issues in the 2.3.0 release:
  * Buttons are not all the same size
  * Text area does not scroll as new text is added
  * Countries.sld looks for a font that does not necessarily exist
  * The projection causes certain geometries to disappear.
  * Lots of routines are missing; some buttons do nothing.

License:
This code is placed in the public domain. Note that this is different from the 
Geotools library code itself which is licensed under the terms of the "Lesser 
General Public License (LGPL).

Enjoy.

Adrian Custer
Friday, 18 August 2006
Brussels, Belgium