postgis/doc/release_notes.xml
2010-09-01 05:51:56 +00:00

1561 lines
54 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<appendix id="release_notes">
<title>Appendix</title>
<subtitle>Release Notes</subtitle>
<sect1>
<title>Release 1.5.2</title>
<para>Release date: 2010/09/xx (not yet released)</para>
<para>This is a bug fix release, addressing issues that have been filed since the 1.5.1 release.</para>
<simplesect>
<title>Bug Fixes</title>
<para>Loader: fix handling of empty (0-verticed) geometries in shapefiles. (Sandro Santilli)</para>
<para>#536, Geography ST_Intersects, ST_Covers, ST_CoveredBy and Geometry ST_Equals not using spatial index (Regina Obe, Nicklas Aven)</para>
<para>#573, Improvement to ST_Contains geography (Paul Ramsey)</para>
<para>Loader: Add support for command-q shutdown in Mac GTK build (Paul Ramsey)</para>
<para>#393, Loader: Add temporary patch for large DBF files (Maxime Guillaud, Paul Ramsey)</para>
<para>#507, Fix wrong OGC URN in GeoJSON and GML output (Olivier Courtin)</para>
<para>spatial_ref_sys.sql Add datum conversion for projection SRID 3021 (Paul Ramsey)</para>
<para>Geography - remove crash for case when all geographies are out of the estimate (Paul Ramsey)</para>
<para>#469, Fix for array_aggregation error (Greg Stark, Paul Ramsey)</para>
</simplesect>
</sect1>
<sect1>
<title>Release 1.5.1</title>
<para>Release date: 2010/03/11</para>
<para>This is a bug fix release, addressing issues that have been filed since the 1.4.1 release.</para>
<simplesect>
<title>Bug Fixes</title>
<para>#410, update embedded bbox when applying ST_SetPoint, ST_AddPoint ST_RemovePoint to a linestring (Paul Ramsey)</para>
<para>#411, allow dumping tables with invalid geometries (Sandro Santilli, for Regione Toscana-SIGTA)</para>
<para>#414, include geography_columns view when running upgrade scripts (Paul Ramsey)</para>
<para>#419, allow support for multilinestring in ST_Line_Substring (Paul Ramsey, for Lidwala Consulting Engineers)</para>
<para>#421, fix computed string length in ST_AsGML() (Olivier Courtin)</para>
<para>#441, fix GML generation with heterogeneous collections (Olivier Courtin)</para>
<para>#443, incorrect coordinate reversal in GML 3 generation (Olivier Courtin)</para>
<para>#450, #451, wrong area calculation for geography features that cross the date line (Paul Ramsey)</para>
<para>Ensure support for upcoming 9.0 PgSQL release (Paul Ramsey)</para>
</simplesect>
</sect1>
<sect1>
<title>Release 1.5.0</title>
<para>Release date: 2010/02/04</para>
<para>This release provides support for geographic coordinates (lat/lon) via a new GEOGRAPHY type. Also performance enhancements, new input format support (GML,KML) and general upkeep.</para>
<simplesect>
<title>API Stability</title>
<para>The public API of PostGIS will not change during minor (0.0.X) releases.</para>
<para>The definition of the =~ operator has changed from an exact geometric equality check to a bounding box equality check.</para>
</simplesect>
<simplesect>
<title>Compatibility</title>
<para>GEOS, Proj4, and LibXML2 are now mandatory dependencies</para>
<para>The library versions below are the minimum requirements for PostGIS 1.5</para>
<para>PostgreSQL 8.3 and higher on all platforms</para>
<para>GEOS 3.1 and higher only (GEOS 3.2+ to take advantage of all features)</para>
<para>LibXML2 2.5+ related to new ST_GeomFromGML/KML functionality</para>
<para>Proj4 4.5 and higher only</para>
</simplesect>
<simplesect>
<title>New Features</title>
<para><xref linkend="NewFunctions_1_5"/></para>
<para>Added Hausdorff distance calculations (#209) (Vincent Picavet)</para>
<para>Added parameters argument to ST_Buffer operation to support one-sided buffering and other buffering styles (Sandro Santilli)</para>
<para>Addition of other Distance related visualization and analysis functions (Nicklas Aven)</para>
<itemizedlist>
<listitem><para>ST_ClosestPoint</para></listitem>
<listitem><para>ST_DFullyWithin</para></listitem>
<listitem><para>ST_LongestLine</para></listitem>
<listitem><para>ST_MaxDistance</para></listitem>
<listitem><para>ST_ShortestLine</para></listitem>
</itemizedlist>
<para>ST_DumpPoints (Maxime van Noppen)</para>
<para>KML, GML input via ST_GeomFromGML and ST_GeomFromKML (Olivier Courtin)</para>
<para>Extract homogeneous collection with ST_CollectionExtract (Paul Ramsey)</para>
<para>Add measure values to an existing linestring with ST_AddMeasure (Paul Ramsey)</para>
<para>History table implementation in utils (George Silva)</para>
<para>Geography type and supporting functions</para>
<itemizedlist>
<listitem><para>Spherical algorithms (Dave Skea)</para></listitem>
<listitem><para>Object/index implementation (Paul Ramsey)</para></listitem>
<listitem><para>Selectivity implementation (Mark Cave-Ayland)</para></listitem>
<listitem><para>Serializations to KML, GML and JSON (Olivier Courtin)</para></listitem>
<listitem><para>ST_Area, ST_Distance, ST_DWithin, ST_GeogFromText, ST_GeogFromWKB, ST_Intersects, ST_Covers, ST_Buffer (Paul Ramsey)</para></listitem>
</itemizedlist>
</simplesect>
<simplesect>
<title>Enhancements</title>
<para>Performance improvements to ST_Distance (Nicklas Aven)</para>
<para>Documentation updates and improvements (Regina Obe, Kevin Neufeld)</para>
<para>Testing and quality control (Regina Obe)</para>
<para>PostGIS 1.5 support PostgreSQL 8.5 trunk (Guillaume Lelarge)</para>
<para>Win32 support and improvement of core shp2pgsql-gui (Mark Cave-Ayland)</para>
<para>In place 'make check' support (Paul Ramsey)</para>
</simplesect>
<simplesect>
<title>Bug fixes</title>
<para>http://trac.osgeo.org/postgis/query?status=closed&amp;milestone=postgis+1.5.0&amp;order=priority</para>
</simplesect>
</sect1>
<sect1>
<title>Release 1.4.0</title>
<para>Release date: 2009/07/24</para>
<para>This release provides performance enhancements, improved internal structures and testing, new features, and upgraded documentation.</para>
<simplesect>
<title>API Stability</title>
<para>As of the 1.4 release series, the public API of PostGIS will not change during minor releases.</para>
</simplesect>
<simplesect>
<title>Compatibility</title>
<para>The versions below are the *minimum* requirements for PostGIS 1.4</para>
<para>PostgreSQL 8.2 and higher on all platforms</para>
<para>GEOS 3.0 and higher only</para>
<para>PROJ4 4.5 and higher only</para>
</simplesect>
<simplesect>
<title>New Features</title>
<para>ST_Union() uses high-speed cascaded union when compiled against
GEOS 3.1+ (Paul Ramsey)</para>
<para>ST_ContainsProperly() requires GEOS 3.1+</para>
<para>ST_Intersects(), ST_Contains(), ST_Within() use high-speed cached prepared geometry against GEOS 3.1+ (Paul Ramsey)</para>
<para>Vastly improved documentation and reference manual (Regina Obe &amp; Kevin Neufeld)</para>
<para>Figures and diagram examples in the reference manual (Kevin Neufeld)</para>
<para>ST_IsValidReason() returns readable explanations for validity failures (Paul Ramsey)</para>
<para>ST_GeoHash() returns a geohash.org signature for geometries (Paul Ramsey)</para>
<para>GTK+ multi-platform GUI for shape file loading (Paul Ramsey)</para>
<para>ST_LineCrossingDirection() returns crossing directions (Paul Ramsey)</para>
<para>ST_LocateBetweenElevations() returns sub-string based on Z-ordinate. (Paul Ramsey)</para>
<para>Geometry parser returns explicit error message about location of syntax errors (Mark Cave-Ayland)</para>
<para>ST_AsGeoJSON() return JSON formatted geometry (Olivier Courtin)</para>
<para>Populate_Geometry_Columns() -- automatically add records to geometry_columns for TABLES and VIEWS (Kevin Neufeld)</para>
<para>ST_MinimumBoundingCircle() -- returns the smallest circle polygon that can encompass a geometry (Bruce Rindahl)</para>
</simplesect>
<simplesect>
<title>Enhancements</title>
<para>Core geometry system moved into independent library, liblwgeom. (Mark Cave-Ayland)</para>
<para>New build system uses PostgreSQL "pgxs" build bootstrapper. (Mark Cave-Ayland)</para>
<para>Debugging framework formalized and simplified. (Mark Cave-Ayland)</para>
<para>All build-time #defines generated at configure time and placed in headers for easier cross-platform support (Mark Cave-Ayland)</para>
<para>Logging framework formalized and simplified (Mark Cave-Ayland)</para>
<para>Expanded and more stable support for CIRCULARSTRING, COMPOUNDCURVE and CURVEPOLYGON, better parsing, wider support in functions (Mark Leslie &amp; Mark Cave-Ayland)</para>
<para>Improved support for OpenSolaris builds (Paul Ramsey)</para>
<para>Improved support for MSVC builds (Mateusz Loskot)</para>
<para>Updated KML support (Olivier Courtin)</para>
<para>Unit testing framework for liblwgeom (Paul Ramsey)</para>
<para>New testing framework to comprehensively exercise every PostGIS function (Regine Obe)</para>
<para>Performance improvements to all geometry aggregate functions (Paul Ramsey)</para>
<para>Support for the upcoming PostgreSQL 8.4 (Mark Cave-Ayland, Talha Bin Rizwan)</para>
<para>Shp2pgsql and pgsql2shp re-worked to depend on the common parsing/unparsing code in liblwgeom (Mark Cave-Ayland)</para>
<para>Use of PDF DbLatex to build PDF docs and preliminary instructions for build (Jean David Techer)</para>
<para>Automated User documentation build (PDF and HTML) and Developer Doxygen Documentation (Kevin Neufeld)</para>
<para>Automated build of document images using ImageMagick from WKT geometry text files (Kevin Neufeld)</para>
<para>More attractive CSS for HTML documentation (Dane Springmeyer)</para>
</simplesect>
<simplesect>
<title>Bug fixes</title>
<para>http://trac.osgeo.org/postgis/query?status=closed&amp;milestone=postgis+1.4.0&amp;order=priority</para>
</simplesect>
</sect1>
<sect1>
<title>Release 1.3.6</title>
<para>Release date: 2009/05/04</para>
<para>This release adds support for PostgreSQL 8.4, exporting
prj files from the database with shape data, some crash fixes for shp2pgsql, and several small
bug fixes in the handling of "curve" types, logical error importing dbf only files, improved error handling of AddGeometryColumns.</para>
</sect1>
<sect1>
<title>Release 1.3.5</title>
<para>Release date: 2008/12/15</para>
<para>This release is a bug fix release to address a failure
in ST_Force_Collection and related functions that critically
affects using Mapserver with LINE layers.</para>
</sect1>
<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>