GeoTools 2.2.1
    ================================

Thank you for downloading GeoTools 2.2.1.
This release was created on: 12 October 2006

This release contains only a subset of the current GeoTools codebase.
The full GeoTools codebase is made up of over 30 modules; 
Only the modules which are considered to be stable will be included in this
release.

For this release the following modules comprise the geotools library:
api
coverage
main
referencing
render
sample-data
svgsupport

The following modules comprise the plug-ins and extensions:
arcgrid
db2
directory
epsg-access
epsg-hsql
epsg-postgresql
epsg-wkt
geomedia
geotiff
gml
gtopo30
hsql
image
mif
mysql
oraclespatial
postgis
shapefile
tiger
vpf
wfs
wms
brewer
graph
go
openoffice
pickle
shape
shaperenderer
validation
widgets-swing
mappane
property

These optional jars typically provide support for specific data formats or
sources, or provide specific additional functionality.

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

You can find out more about each of the major modules by going to:
- http://maven.geotools.fr/reports/
- http://javadoc.geotools.fr/

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://docs.codehaus.org/display/GEOT/Home

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://docs.codehaus.org/display/GEOTOOLS/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 2.  Maven is a project
management tool from the Apache group.  You can obtain a copy of maven from: 
- http://maven.apache.org/download.html

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

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

mvn install

Once again please read the developers guide for more information about maven:
- http://docs.codehaus.org/display/GEOT/2.5+Using+Maven

GETTING INVOLVED
================
If you are interested in the future development of GeoTools 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 a gt2-users mailing list is also available.

You can find out more about the mailing lists and recent news by going to the
GeoTools homepage at:
- http://www.geotools.org

And by reading the GeoTools guide at:
- http://docs.codehaus.org/display/GEOTOOLS/Home

Good luck and many thanks for your interest in GeoTools,

The GeoTools Community

CHANGELOG
=========
Bug fixes and improvements since Version 2.2.1:

[GEOT-722] - DataUtilities.defaultValue() doesn't call AttributeType.createDefaultValue()
[GEOT-728] - Clean up FIDMapper hierarchy and fix problems
[GEOT-907] - Caching in BufferedAuthorityFactory does not work
[GEOT-920] - SVG Graphic marks not rendered
[GEOT-935] - Deadlock in 2.2.x Referencing
[GEOT-941] - FidFilter sometimes causes NullPointerException in SQLEncoder
[GEOT-945] - AutoIncrementFIDMapper does not support BigInteger Primary Keys
[GEOT-947] - remove final modifier in arcsde dummy api
[GEOT-948] - jdbc1Datastore getConnection method is not thread safe
[GEOT-953] - PostGISAutoIncrementFIDMapper doesn't support non-serial primary keys
[GEOT-957] - Various issues with Rendering (see description for details)
[GEOT-960] - Allow shapefile data store to write down feature types with BigDecimal or BigInteger types (as an extension, every Number subclass)
[GEOT-968] - Postgis fid mapper should not return oid fid mapper without checking database version number
[GEOT-969] - Error occurs when writing a Point geometry.
[GEOT-970] - LiteCoordinateSequence converts 2D to 3D
[GEOT-975] - FeatureListenerManager never frees FeatureSource keys from the map
[GEOT-919] - CRS findMathTransform
[GEOT-958] - Support FID values greater than int
[GEOT-959] - ows layer getSRS should be cached because some layers can have many (Geoserver)
[GEOT-973] - Avoid creating a new coordinate operation factory for each scale computation in RenderUtils
[GEOT-974] - Attach a feature source listener only when needed in MapLayers, clean up when no more needed