GeoTools @VERSION@
================================
http://geotools.codehaus.org
Thank you for downloading GeoTools @VERSION@.
This release was created on: @DATE@

Geotools is an open source, Java GIS toolkit for developing standards compliant solutions. Its modular architecture allows extra functionality to be easily incorporated.

Geotools aims to support Open Geospatial Consortium and other relevant standards as they are developed. GeoTools code is built using the latest Java tools and environments and will continue to leverage the capabilities of future Java environments and official extensions as and when the technologies are released and have been through the first maintenance cycle (i.e. version 1.x.1).

It is not the intention of the GeoTools 2 project to develop finished products or applications, but it is the intention to interact and support fully other initiatives and projects which would like to use the GeoTools 2 toolkit to create such resources.

The GeoTools project is divided into separate modules, each of which implements a specific requirement. Only a subset of these modules is usually required to build an application based on Geotools2.

For this release the following modules comprise the geotools library:
@REQUIRED@

The following modules comprise the plug-ins and extentions:
@PLUGIN@
graph validation reprojection j2se-demos

These optional jars provide support for specific data formats and additional functionality. For full details see:
http://docs.codehaus.org/display/GEOTOOLS/Feature+List

You can find out more about each of the major modules by going to:
- http//modules.geotools.org (down until DNS problem is resolved, see NOTE)

Each module has its own homepage with full javadoc, test reports and source code.

For more information, and documentation on the geotools library please see our community homepage at:
- http://geotools.codehaus.org

NOTE ==== The details contained in the rest of this file are provided as a quick start reference.

For full details on requirements and build process please see the developers' guide at:
- http://geotools.codehaus.org/Developers+Guide

N.B. Our normal web address is www.geotools.org however our domain host easyspace has broken our DNS entry and are being very slow about fixing it. For now please use the geotools.codehaus.org address.

REQUIREMENTS
============
To use the geotools libraries you will need: Java 1.4.x or higher. The Java Advanced Imaging Libraries (JAI) The Java Advanced Imaging Image I/O Tools

The JAI and the JAI I/O Tools are standard extensions to Java created by SUN. They have versions specific to different platforms so we cannot distribute them as part of the release.

You can obtain the latest versions of both of these from: - http://java.sun.com/products/java-media/jai/current.html

Detailed instructions can be found at: - http://geotools.codehaus.org/Dependencies

ORACLE REQUIREMENTS
===================
In order to use the Oracle module, you need the Oracle JDBC driver from Oracle. Unlike most external libraries used in GeoTools, we cannot redistribute this jar.

However, you can obtain them from the Oracle website, free of charge, after registering: - http://otn.oracle.com/software/tech/java/sqlj_jdbc/content.html

Please see the developers guide for more information.

BUILDING
========
In order to build GeoTools you will need a copy of Maven. Maven is a project management tool from the Apache group. You can obtain a copy of maven from:
- http://maven.apache.org/start/download.html

At the time of writing, the build process was known to work with the Maven 1.0 release.

Once you have maven installed, you can perform a full build by moving to the geotools folder and typing:

maven build

Once again please read the developers guide for more information about maven: - http://geotools.codehaus.org/Using%2BMaven

FUTURE CHANGES
==============
With the 2.0.0 release, only bug fixes will take place on the 2.0.x branch. Most advanced development work taking place on trunk is aimed at the 2.1.x release, download the milestone releases to get new modules and the latest improvements.

GETTING INVOLVED
================
If you are interested in the future development of GeoTools2 then feel free to join the geotools-devel mailing list and join in the weekly IRC sessions.

We welcome contributions of new modules as well as keen developers who want to work on the project as a whole.

For more general queries a gt2-users mailing list is also available.

You can find out more by going to the GeoTools homepage at:
http://geotools.codehaus.org

Note that the homepage is editable, and a great way to contribute while figuring out GeoTools2 is by filling in documentation holes.

Good luck and many thanks for your interest in GeoTools,

The GeoTools2 Project Management Committee