<?xml version="1.0" encoding="UTF-8"?>
<appendix id="release_notes">
  <title>Appendix</title>
    <subtitle>Release Notes</subtitle>

     <sect1>
      <title>Release 1.3.4</title>
      <para>Release date: 2008/11/24</para>
      <para>This release adds support for GeoJSON output, building
      with PostgreSQL 8.4, improves documentation quality and 
      output aesthetics, adds function-level SQL documentation,
      and improves performance for some spatial predicates
      (point-in-polygon tests).</para>
      <para>Bug fixes include removal of crashers in handling
      circular strings for many functions, some memory leaks
      removed, a linear referencing failure for measures on vertices,
      and more. See the NEWS file for details.</para>
    </sect1>
    
    <sect1>
      <title>Release 1.3.3</title>

      <para>Release date: 2008/04/12</para>

      <para>This release fixes bugs shp2pgsql, adds enhancements to SVG and
      KML support, adds a ST_SimplifyPreserveTopology function, makes the
      build more sensitive to GEOS versions, and fixes a handful of severe but
      rare failure cases.</para>
    </sect1>

    <sect1>
      <title>Release 1.3.2</title>

      <para>Release date: 2007/12/01</para>

      <para>This release fixes bugs in ST_EndPoint() and ST_Envelope, improves
      support for JDBC building and OS/X, and adds better support for GML
      output with ST_AsGML(), including GML3 output.</para>
    </sect1>

    <sect1>
      <title>Release 1.3.1</title>

      <para>Release date: 2007/08/13</para>

      <para>This release fixes some oversights in the previous release around
      version numbering, documentation, and tagging.</para>
    </sect1>

    <sect1>
      <title>Release 1.3.0</title>

      <para>Release date: 2007/08/09</para>

      <para>This release provides performance enhancements to the relational
      functions, adds new relational functions and begins the migration of our
      function names to the SQL-MM convention, using the spatial type (SP)
      prefix.</para>

      <simplesect>
        <title>Added Functionality</title>

        <para>JDBC: Added Hibernate Dialect (thanks to Norman Barker)</para>

        <para>Added ST_Covers and ST_CoveredBy relational functions.
        Description and justification of these functions can be found at
        http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html</para>

        <para>Added ST_DWithin relational function.</para>
      </simplesect>

      <simplesect>
        <title>Performance Enhancements</title>

        <para>Added cached and indexed point-in-polygon short-circuits for the
        functions ST_Contains, ST_Intersects, ST_Within and ST_Disjoint</para>

        <para>Added inline index support for relational functions (except
        ST_Disjoint)</para>
      </simplesect>

      <simplesect>
        <title>Other Changes</title>

        <para>Extended curved geometry support into the geometry accessor and
        some processing functions</para>

        <para>Began migration of functions to the SQL-MM naming convention;
        using a spatial type (ST) prefix.</para>

        <para>Added initial support for PostgreSQL 8.3</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.2.1</title>

      <para>Release date: 2007/01/11</para>

      <para>This release provides bug fixes in PostgreSQL 8.2 support and some
      small performance enhancements.</para>

      <simplesect>
        <title>Changes</title>

        <para>Fixed point-in-polygon shortcut bug in Within().</para>

        <para>Fixed PostgreSQL 8.2 NULL handling for indexes.</para>

        <para>Updated RPM spec files.</para>

        <para>Added short-circuit for Transform() in no-op case.</para>

        <para>JDBC: Fixed JTS handling for multi-dimensional geometries
        (thanks to Thomas Marti for hint and partial patch). Additionally, now
        JavaDoc is compiled and packaged. Fixed classpath problems with GCJ.
        Fixed pgjdbc 8.2 compatibility, losing support for jdk 1.3 and
        older.</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.2.0</title>

      <para>Release date: 2006/12/08</para>

      <para>This release provides type definitions along with
      serialization/deserialization capabilities for SQL-MM defined curved
      geometries, as well as performance enhancements.</para>

      <simplesect>
        <title>Changes</title>

        <para>Added curved geometry type support for
        serialization/deserialization</para>

        <para>Added point-in-polygon shortcircuit to the Contains and Within
        functions to improve performance for these cases.</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.6</title>

      <para>Release date: 2006/11/02</para>

      <para>This is a bugfix release, in particular fixing a critical error
      with GEOS interface in 64bit systems. Includes an updated of the SRS
      parameters and an improvement in reprojections (take Z in
      consideration). Upgrade is <emphasis>encouraged</emphasis>.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later follow the
        <link linkend="soft_upgrade">soft upgrade</link> procedure.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>fixed CAPI change that broke 64-bit platforms</para>

        <para>loader/dumper: fixed regression tests and usage output</para>

        <para>Fixed setSRID() bug in JDBC, thanks to Thomas Marti</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>use Z ordinate in reprojections</para>

        <para>spatial_ref_sys.sql updated to EPSG 6.11.1</para>

        <para>Simplified Version.config infrastructure to use a single pack of
        version variables for everything.</para>

        <para>Include the Version.config in loader/dumper USAGE
        messages</para>

        <para>Replace hand-made, fragile JDBC version parser with
        Properties</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.5</title>

      <para>Release date: 2006/10/13</para>

      <para>This is an bugfix release, including a critical segfault on win32.
      Upgrade is <emphasis>encouraged</emphasis>.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later follow the
        <link linkend="soft_upgrade">soft upgrade</link> procedure.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Fixed MingW link error that was causing pgsql2shp to segfault on
        Win32 when compiled for PostgreSQL 8.2</para>

        <para>fixed nullpointer Exception in Geometry.equals() method in
        Java</para>

        <para>Added EJB3Spatial.odt to fulfill the GPL requirement of
        distributing the "preferred form of modification"</para>

        <para>Removed obsolete synchronization from JDBC Jts code.</para>

        <para>Updated heavily outdated README files for shp2pgsql/pgsql2shp by
        merging them with the manpages.</para>

        <para>Fixed version tag in jdbc code that still said "1.1.3" in the
        "1.1.4" release.</para>
      </simplesect>

      <simplesect>
        <title>New Features</title>

        <para>Added -S option for non-multi geometries to shp2pgsql</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.4</title>

      <para>Release date: 2006/09/27</para>

      <para>This is an bugfix release including some improvements in the Java
      interface. Upgrade is <emphasis>encouraged</emphasis>.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later follow the
        <link linkend="soft_upgrade">soft upgrade</link> procedure.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Fixed support for PostgreSQL 8.2</para>

        <para>Fixed bug in collect() function discarding SRID of input</para>

        <para>Added SRID match check in MakeBox2d and MakeBox3d</para>

        <para>Fixed regress tests to pass with GEOS-3.0.0</para>

        <para>Improved pgsql2shp run concurrency.</para>
      </simplesect>

      <simplesect>
        <title>Java changes</title>

        <para>reworked JTS support to reflect new upstream JTS developers'
        attitude to SRID handling. Simplifies code and drops build depend on
        GNU trove.</para>

        <para>Added EJB2 support generously donated by the "Geodetix s.r.l.
        Company" http://www.geodetix.it/</para>

        <para>Added EJB3 tutorial / examples donated by Norman Barker
        &lt;nbarker@ittvis.com&gt;</para>

        <para>Reorganized java directory layout a little.</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.3</title>

      <para>Release date: 2006/06/30</para>

      <para>This is an bugfix release including also some new functionalities
      (most notably long transaction support) and portability enhancements.
      Upgrade is <emphasis>encouraged</emphasis>.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later follow the
        <link linkend="soft_upgrade">soft upgrade</link> procedure.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes / correctness</title>

        <para>BUGFIX in distance(poly,poly) giving wrong results.</para>

        <para>BUGFIX in pgsql2shp successful return code.</para>

        <para>BUGFIX in shp2pgsql handling of MultiLine WKT.</para>

        <para>BUGFIX in affine() failing to update bounding box.</para>

        <para>WKT parser: forbidden construction of multigeometries with EMPTY
        elements (still supported for GEOMETRYCOLLECTION).</para>
      </simplesect>

      <simplesect>
        <title>New functionalities</title>

        <para>NEW Long Transactions support.</para>

        <para>NEW DumpRings() function.</para>

        <para>NEW AsHEXEWKB(geom, XDR|NDR) function.</para>
      </simplesect>

      <simplesect>
        <title>JDBC changes</title>

        <para>Improved regression tests: MultiPoint and scientific
        ordinates</para>

        <para>Fixed some minor bugs in jdbc code</para>

        <para>Added proper accessor functions for all fields in preparation of
        making those fields private later</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>NEW regress test support for loader/dumper.</para>

        <para>Added --with-proj-libdir and --with-geos-libdir configure
        switches.</para>

        <para>Support for build Tru64 build.</para>

        <para>Use Jade for generating documentation.</para>

        <para>Don't link pgsql2shp to more libs then required.</para>

        <para>Initial support for PostgreSQL 8.2.</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.2</title>

      <para>Release date: 2006/03/30</para>

      <para>This is an bugfix release including some new functions and
      portability enhancements. Upgrade is
      <emphasis>encouraged</emphasis>.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later follow the
        <link linkend="soft_upgrade">soft upgrade</link> procedure.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>BUGFIX in SnapToGrid() computation of output bounding box</para>

        <para>BUGFIX in EnforceRHR()</para>

        <para>jdbc2 SRID handling fixes in JTS code</para>

        <para>Fixed support for 64bit archs</para>
      </simplesect>

      <simplesect>
        <title>New functionalities</title>

        <para>Regress tests can now be run *before* postgis
        installation</para>

        <para>New affine() matrix transformation functions</para>

        <para>New rotate{,X,Y,Z}() function</para>

        <para>Old translating and scaling functions now use affine()
        internally</para>

        <para>Embedded access control in estimated_extent() for builds against
        pgsql &gt;= 8.0.0</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>More portable ./configure script</para>

        <para>Changed ./run_test script to have more sane default
        behaviour</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.1</title>

      <para>Release date: 2006/01/23</para>

      <para>This is an important Bugfix release, upgrade is <emphasis>highly
      recommended</emphasis>. Previous version contained a bug in
      postgis_restore.pl preventing <link linkend="hard_upgrade">hard
      upgrade</link> procedure to complete and a bug in GEOS-2.2+ connector
      preventing GeometryCollection objects to be used in topological
      operations.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later follow the
        <link linkend="soft_upgrade">soft upgrade</link> procedure.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Fixed a premature exit in postgis_restore.pl</para>

        <para>BUGFIX in geometrycollection handling of GEOS-CAPI
        connector</para>

        <para>Solaris 2.7 and MingW support improvements</para>

        <para>BUGFIX in line_locate_point()</para>

        <para>Fixed handling of postgresql paths</para>

        <para>BUGFIX in line_substring()</para>

        <para>Added support for localized cluster in regress tester</para>
      </simplesect>

      <simplesect>
        <title>New functionalities</title>

        <para>New Z and M interpolation in line_substring()</para>

        <para>New Z and M interpolation in line_interpolate_point()</para>

        <para>added NumInteriorRing() alias due to OpenGIS ambiguity</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.1.0</title>

      <para>Release date: 2005/12/21</para>

      <para>This is a Minor release, containing many improvements and new
      things. Most notably: build procedure greatly simplified; transform()
      performance drastically improved; more stable GEOS connectivity (CAPI
      support); lots of new functions; draft topology support.</para>

      <para>It is <emphasis>highly recommended</emphasis> that you upgrade to
      GEOS-2.2.x before installing PostGIS, this will ensure future GEOS
      upgrades won't require a rebuild of the PostGIS library.</para>

      <simplesect>
        <title>Credits</title>

        <para>This release includes code from Mark Cave Ayland for caching of
        proj4 objects. Markus Schaber added many improvements in his JDBC2
        code. Alex Bodnaru helped with PostgreSQL source dependency relief and
        provided Debian specfiles. Michael Fuhr tested new things on Solaris
        arch. David Techer and Gerald Fenoy helped testing GEOS C-API
        connector. Hartmut Tschauner provided code for the azimuth() function.
        Devrim GUNDUZ provided RPM specfiles. Carl Anderson helped with the
        new area building functions. See the <link
        linkend="credits">credits</link> section for more names.</para>
      </simplesect>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later you
        <emphasis>DO NOT</emphasis> need a dump/reload. Simply sourcing the
        new lwpostgis_upgrade.sql script in all your existing databases will
        work. See the <link linkend="soft_upgrade">soft upgrade</link> chapter
        for more information.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>New functions</title>

        <para>scale() and transscale() companion methods to translate()</para>

        <para>line_substring()</para>

        <para>line_locate_point()</para>

        <para>M(point)</para>

        <para>LineMerge(geometry)</para>

        <para>shift_longitude(geometry)</para>

        <para>azimuth(geometry)</para>

        <para>locate_along_measure(geometry, float8)</para>

        <para>locate_between_measures(geometry, float8, float8)</para>

        <para>SnapToGrid by point offset (up to 4d support)</para>

        <para>BuildArea(any_geometry)</para>

        <para>OGC BdPolyFromText(linestring_wkt, srid)</para>

        <para>OGC BdMPolyFromText(linestring_wkt, srid)</para>

        <para>RemovePoint(linestring, offset)</para>

        <para>ReplacePoint(linestring, offset, point)</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Fixed memory leak in polygonize()</para>

        <para>Fixed bug in lwgeom_as_anytype cast functions</para>

        <para>Fixed USE_GEOS, USE_PROJ and USE_STATS elements of
        postgis_version() output to always reflect library state.</para>
      </simplesect>

      <simplesect>
        <title>Function semantic changes</title>

        <para>SnapToGrid doesn't discard higher dimensions</para>

        <para>Changed Z() function to return NULL if requested dimension is
        not available</para>
      </simplesect>

      <simplesect>
        <title>Performance improvements</title>

        <para>Much faster transform() function, caching proj4 objects</para>

        <para>Removed automatic call to fix_geometry_columns() in
        AddGeometryColumns() and update_geometry_stats()</para>
      </simplesect>

      <simplesect>
        <title>JDBC2 works</title>

        <para>Makefile improvements</para>

        <para>JTS support improvements</para>

        <para>Improved regression test system</para>

        <para>Basic consistency check method for geometry collections</para>

        <para>Support for (Hex)(E)wkb</para>

        <para>Autoprobing DriverWrapper for HexWKB / EWKT switching</para>

        <para>fix compile problems in ValueSetter for ancient jdk
        releases.</para>

        <para>fix EWKT constructors to accept SRID=4711; representation</para>

        <para>added preliminary read-only support for java2d geometries</para>
      </simplesect>

      <simplesect>
        <title>Other new things</title>

        <para>Full autoconf-based configuration, with PostgreSQL source
        dependency relief</para>

        <para>GEOS C-API support (2.2.0 and higher)</para>

        <para>Initial support for topology modelling</para>

        <para>Debian and RPM specfiles</para>

        <para>New lwpostgis_upgrade.sql script</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>JTS support improvements</para>

        <para>Stricter mapping between DBF and SQL integer and string
        attributes</para>

        <para>Wider and cleaner regression test suite</para>

        <para>old jdbc code removed from release</para>

        <para>obsoleted direct use of postgis_proc_upgrade.pl</para>

        <para>scripts version unified with release version</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.6</title>

      <para>Release date: 2005/12/06</para>

      <para>Contains a few bug fixes and improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later you
        <emphasis>DO NOT</emphasis> need a dump/reload.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Fixed palloc(0) call in collection deserializer (only gives
        problem with --enable-cassert)</para>

        <para>Fixed bbox cache handling bugs</para>

        <para>Fixed geom_accum(NULL, NULL) segfault</para>

        <para>Fixed segfault in addPoint()</para>

        <para>Fixed short-allocation in lwcollection_clone()</para>

        <para>Fixed bug in segmentize()</para>

        <para>Fixed bbox computation of SnapToGrid output</para>
      </simplesect>

      <simplesect>
        <title>Improvements</title>

        <para>Initial support for postgresql 8.2</para>

        <para>Added missing SRID mismatch checks in GEOS ops</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.5</title>

      <para>Release date: 2005/11/25</para>

      <para>Contains memory-alignment fixes in the library, a segfault fix in
      loader's handling of UTF8 attributes and a few improvements and
      cleanups.</para>

      <note>
        <para>Return code of shp2pgsql changed from previous releases to
        conform to unix standards (return 0 on success).</para>
      </note>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 or later you
        <emphasis>DO NOT</emphasis> need a dump/reload.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>Fixed memory alignment problems</para>

        <para>Fixed computation of null values fraction in analyzer</para>

        <para>Fixed a small bug in the getPoint4d_p() low-level
        function</para>

        <para>Speedup of serializer functions</para>

        <para>Fixed a bug in force_3dm(), force_3dz() and force_4d()</para>
      </simplesect>

      <simplesect>
        <title>Loader changes</title>

        <para>Fixed return code of shp2pgsql</para>

        <para>Fixed back-compatibility issue in loader (load of null
        shapefiles)</para>

        <para>Fixed handling of trailing dots in dbf numerical
        attributes</para>

        <para>Segfault fix in shp2pgsql (utf8 encoding)</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>Schema aware postgis_proc_upgrade.pl, support for pgsql
        7.2+</para>

        <para>New "Reporting Bugs" chapter in manual</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.4</title>

      <para>Release date: 2005/09/09</para>

      <para>Contains important bug fixes and a few improvements. In
      particular, it fixes a memory leak preventing successful build of GiST
      indexes for large spatial tables.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.3 you <emphasis>DO
        NOT</emphasis> need a dump/reload.</para>

        <para>If you are upgrading from a release <emphasis>between 1.0.0RC6
        and 1.0.2</emphasis> (inclusive) and really want a live upgrade read
        the <link linkend="rel_1.0.3_upgrading">upgrade section</link> of the
        1.0.3 release notes chapter.</para>

        <para>Upgrade from any release prior to 1.0.0RC6 requires an <link
        linkend="hard_upgrade">hard upgrade</link>.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Memory leak plugged in GiST indexing</para>

        <para>Segfault fix in transform() handling of proj4 errors</para>

        <para>Fixed some proj4 texts in spatial_ref_sys (missing +proj)</para>

        <para>Loader: fixed string functions usage, reworked NULL objects
        check, fixed segfault on MULTILINESTRING input.</para>

        <para>Fixed bug in MakeLine dimension handling</para>

        <para>Fixed bug in translate() corrupting output bounding box</para>
      </simplesect>

      <simplesect>
        <title>Improvements</title>

        <para>Documentation improvements</para>

        <para>More robust selectivity estimator</para>

        <para>Minor speedup in distance()</para>

        <para>Minor cleanups</para>

        <para>GiST indexing cleanup</para>

        <para>Looser syntax acceptance in box3d parser</para>
      </simplesect>
    </sect1>

    <sect1 id="rel_1.0.3_upgrading">
      <title>Release 1.0.3</title>

      <para>Release date: 2005/08/08</para>

      <para>Contains some bug fixes - <emphasis>including a severe one
      affecting correctness of stored geometries</emphasis> - and a few
      improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>Due to a bug in a bounding box computation routine, the upgrade
        procedure requires special attention, as bounding boxes cached in the
        database could be incorrect.</para>

        <para>An <link linkend="hard_upgrade">hard upgrade</link> procedure
        (dump/reload) will force recomputation of all bounding boxes (not
        included in dumps). This is <emphasis>required</emphasis> if upgrading
        from releases prior to 1.0.0RC6.</para>

        <para>If you are upgrading from versions 1.0.0RC6 or up, this release
        includes a perl script (utils/rebuild_bbox_caches.pl) to force
        recomputation of geometries' bounding boxes and invoke all operations
        required to propagate eventual changes in them (geometry statistics
        update, reindexing). Invoke the script after a make install (run with
        no args for syntax help). Optionally run utils/postgis_proc_upgrade.pl
        to refresh postgis procedures and functions signatures (see <link
        linkend="soft_upgrade">Soft upgrade</link>).</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Severe bugfix in lwgeom's 2d bounding box computation</para>

        <para>Bugfix in WKT (-w) POINT handling in loader</para>

        <para>Bugfix in dumper on 64bit machines</para>

        <para>Bugfix in dumper handling of user-defined queries</para>

        <para>Bugfix in create_undef.pl script</para>
      </simplesect>

      <simplesect>
        <title>Improvements</title>

        <para>Small performance improvement in canonical input function</para>

        <para>Minor cleanups in loader</para>

        <para>Support for multibyte field names in loader</para>

        <para>Improvement in the postgis_restore.pl script</para>

        <para>New rebuild_bbox_caches.pl util script</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.2</title>

      <para>Release date: 2005/07/04</para>

      <para>Contains a few bug fixes and improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.0RC6 or up you
        <emphasis>DO NOT</emphasis> need a dump/reload.</para>

        <para>Upgrading from older releases requires a dump/reload. See the
        <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Bug fixes</title>

        <para>Fault tolerant btree ops</para>

        <para>Memory leak plugged in pg_error</para>

        <para>Rtree index fix</para>

        <para>Cleaner build scripts (avoided mix of CFLAGS and
        CXXFLAGS)</para>
      </simplesect>

      <simplesect>
        <title>Improvements</title>

        <para>New index creation capabilities in loader (-I switch)</para>

        <para>Initial support for postgresql 8.1dev</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.1</title>

      <para>Release date: 2005/05/24</para>

      <para>Contains a few bug fixes and some improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.0RC6 or up you
        <emphasis>DO NOT</emphasis> need a dump/reload.</para>

        <para>Upgrading from older releases requires a dump/reload. See the
        <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX in 3d computation of length_spheroid()</para>

        <para>BUGFIX in join selectivity estimator</para>
      </simplesect>

      <simplesect>
        <title>Other changes/additions</title>

        <para>BUGFIX in shp2pgsql escape functions</para>

        <para>better support for concurrent postgis in multiple schemas</para>

        <para>documentation fixes</para>

        <para>jdbc2: compile with "-target 1.2 -source 1.2" by default</para>

        <para>NEW -k switch for pgsql2shp</para>

        <para>NEW support for custom createdb options in
        postgis_restore.pl</para>

        <para>BUGFIX in pgsql2shp attribute names unicity enforcement</para>

        <para>BUGFIX in Paris projections definitions</para>

        <para>postgis_restore.pl cleanups</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0</title>

      <para>Release date: 2005/04/19</para>

      <para>Final 1.0.0 release. Contains a few bug fixes, some improvements
      in the loader (most notably support for older postgis versions), and
      more docs.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.0RC6 you <emphasis>DO
        NOT</emphasis> need a dump/reload.</para>

        <para>Upgrading from any other precedent release requires a
        dump/reload. See the <link linkend="upgrading">upgrading</link>
        chapter for more informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX in transform() releasing random memory address</para>

        <para>BUGFIX in force_3dm() allocating less memory then
        required</para>

        <para>BUGFIX in join selectivity estimator (defaults, leaks,
        tuplecount, sd)</para>
      </simplesect>

      <simplesect>
        <title>Other changes/additions</title>

        <para>BUGFIX in shp2pgsql escape of values starting with tab or
        single-quote</para>

        <para>NEW manual pages for loader/dumper</para>

        <para>NEW shp2pgsql support for old (HWGEOM) postgis versions</para>

        <para>NEW -p (prepare) flag for shp2pgsql</para>

        <para>NEW manual chapter about OGC compliancy enforcement</para>

        <para>NEW autoconf support for JTS lib</para>

        <para>BUGFIX in estimator testers (support for LWGEOM and schema
        parsing)</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0RC6</title>

      <para>Release date: 2005/03/30</para>

      <para>Sixth release candidate for 1.0.0. Contains a few bug fixes and
      cleanups.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>You need a dump/reload to upgrade from precedent releases. See
        the <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX in multi()</para>

        <para>early return [when noop] from multi()</para>
      </simplesect>

      <simplesect>
        <title>Scripts changes</title>

        <para>dropped {x,y}{min,max}(box2d) functions</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>BUGFIX in postgis_restore.pl scrip</para>

        <para>BUGFIX in dumper's 64bit support</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0RC5</title>

      <para>Release date: 2005/03/25</para>

      <para>Fifth release candidate for 1.0.0. Contains a few bug fixes and a
      improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>If you are upgrading from release 1.0.0RC4 you <emphasis>DO
        NOT</emphasis> need a dump/reload.</para>

        <para>Upgrading from any other precedent release requires a
        dump/reload. See the <link linkend="upgrading">upgrading</link>
        chapter for more informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX (segfaulting) in box3d computation (yes,
        another!).</para>

        <para>BUGFIX (segfaulting) in estimated_extent().</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>Small build scripts and utilities refinements.</para>

        <para>Additional performance tips documented.</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0RC4</title>

      <para>Release date: 2005/03/18</para>

      <para>Fourth release candidate for 1.0.0. Contains bug fixes and a few
      improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>You need a dump/reload to upgrade from precedent releases. See
        the <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX (segfaulting) in geom_accum().</para>

        <para>BUGFIX in 64bit architectures support.</para>

        <para>BUGFIX in box3d computation function with collections.</para>

        <para>NEW subselects support in selectivity estimator.</para>

        <para>Early return from force_collection.</para>

        <para>Consistency check fix in SnapToGrid().</para>

        <para>Box2d output changed back to 15 significant digits.</para>
      </simplesect>

      <simplesect>
        <title>Scripts changes</title>

        <para>NEW distance_sphere() function.</para>

        <para>Changed get_proj4_from_srid implementation to use PL/PGSQL
        instead of SQL.</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>BUGFIX in loader and dumper handling of MultiLine shapes</para>

        <para>BUGFIX in loader, skipping all but first hole of
        polygons.</para>

        <para>jdbc2: code cleanups, Makefile improvements</para>

        <para>FLEX and YACC variables set *after* pgsql Makefile.global is
        included and only if the pgsql *stripped* version evaluates to the
        empty string</para>

        <para>Added already generated parser in release</para>

        <para>Build scripts refinements</para>

        <para>improved version handling, central Version.config</para>

        <para>improvements in postgis_restore.pl</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0RC3</title>

      <para>Release date: 2005/02/24</para>

      <para>Third release candidate for 1.0.0. Contains many bug fixes and
      improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>You need a dump/reload to upgrade from precedent releases. See
        the <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX in transform(): missing SRID, better error
        handling.</para>

        <para>BUGFIX in memory alignment handling</para>

        <para>BUGFIX in force_collection() causing mapserver connector
        failures on simple (single) geometry types.</para>

        <para>BUGFIX in GeometryFromText() missing to add a bbox cache.</para>

        <para>reduced precision of box2d output.</para>

        <para>prefixed DEBUG macros with PGIS_ to avoid clash with pgsql
        one</para>

        <para>plugged a leak in GEOS2POSTGIS converter</para>

        <para>Reduced memory usage by early releasing query-context palloced
        one.</para>
      </simplesect>

      <simplesect>
        <title>Scripts changes</title>

        <para>BUGFIX in 72 index bindings.</para>

        <para>BUGFIX in probe_geometry_columns() to work with PG72 and support
        multiple geometry columns in a single table</para>

        <para>NEW bool::text cast</para>

        <para>Some functions made IMMUTABLE from STABLE, for performance
        improvement.</para>
      </simplesect>

      <simplesect>
        <title>JDBC changes</title>

        <para>jdbc2: small patches, box2d/3d tests, revised docs and
        license.</para>

        <para>jdbc2: bug fix and testcase in for pgjdbc 8.0 type
        autoregistration</para>

        <para>jdbc2: Removed use of jdk1.4 only features to enable build with
        older jdk releases.</para>

        <para>jdbc2: Added support for building against pg72jdbc2.jar</para>

        <para>jdbc2: updated and cleaned makefile</para>

        <para>jdbc2: added BETA support for jts geometry classes</para>

        <para>jdbc2: Skip known-to-fail tests against older PostGIS
        servers.</para>

        <para>jdbc2: Fixed handling of measured geometries in EWKT.</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>new performance tips chapter in manual</para>

        <para>documentation updates: pgsql72 requirement, lwpostgis.sql</para>

        <para>few changes in autoconf</para>

        <para>BUILDDATE extraction made more portable</para>

        <para>fixed spatial_ref_sys.sql to avoid vacuuming the whole
        database.</para>

        <para>spatial_ref_sys: changed Paris entries to match the ones
        distributed with 0.x.</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0RC2</title>

      <para>Release date: 2005/01/26</para>

      <para>Second release candidate for 1.0.0 containing bug fixes and a few
      improvements.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>You need a dump/reload to upgrade from precedent releases. See
        the <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Library changes</title>

        <para>BUGFIX in pointarray box3d computation</para>

        <para>BUGFIX in distance_spheroid definition</para>

        <para>BUGFIX in transform() missing to update bbox cache</para>

        <para>NEW jdbc driver (jdbc2)</para>

        <para>GEOMETRYCOLLECTION(EMPTY) syntax support for backward
        compatibility</para>

        <para>Faster binary outputs</para>

        <para>Stricter OGC WKB/WKT constructors</para>
      </simplesect>

      <simplesect>
        <title>Scripts changes</title>

        <para>More correct STABLE, IMMUTABLE, STRICT uses in
        lwpostgis.sql</para>

        <para>stricter OGC WKB/WKT constructors</para>
      </simplesect>

      <simplesect>
        <title>Other changes</title>

        <para>Faster and more robust loader (both i18n and not)</para>

        <para>Initial autoconf script</para>
      </simplesect>
    </sect1>

    <sect1>
      <title>Release 1.0.0RC1</title>

      <para>Release date: 2005/01/13</para>

      <para>This is the first candidate of a major postgis release, with
      internal storage of postgis types redesigned to be smaller and faster on
      indexed queries.</para>

      <simplesect>
        <title>Upgrading</title>

        <para>You need a dump/reload to upgrade from precedent releases. See
        the <link linkend="upgrading">upgrading</link> chapter for more
        informations.</para>
      </simplesect>

      <simplesect>
        <title>Changes</title>

        <para>Faster canonical input parsing.</para>

        <para>Lossless canonical output.</para>

        <para>EWKB Canonical binary IO with PG&gt;73.</para>

        <para>Support for up to 4d coordinates, providing lossless
        shapefile-&gt;postgis-&gt;shapefile conversion.</para>

        <para>New function: UpdateGeometrySRID(), AsGML(), SnapToGrid(),
        ForceRHR(), estimated_extent(), accum().</para>

        <para>Vertical positioning indexed operators.</para>

        <para>JOIN selectivity function.</para>

        <para>More geometry constructors / editors.</para>

        <para>PostGIS extension API.</para>

        <para>UTF8 support in loader.</para>
      </simplesect>
    </sect1>
</appendix>
