From 5fddfda5593d0f8c244f640ae63a17035ade0e3e Mon Sep 17 00:00:00 2001 From: Justin Bronn Date: Wed, 22 Dec 2010 17:43:30 +0000 Subject: Fixed #13788 -- `GEOSGeometry.transform` no longer silently no-ops when GDAL isn't available. Thanks, Rob Coup. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15025 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/contrib/gis/geos.txt | 14 +++++++++++++- docs/ref/contrib/gis/install.txt | 11 ++++++----- 2 files changed, 19 insertions(+), 6 deletions(-) (limited to 'docs/ref') diff --git a/docs/ref/contrib/gis/geos.txt b/docs/ref/contrib/gis/geos.txt index 088ea6cdbe..95ba7e55e3 100644 --- a/docs/ref/contrib/gis/geos.txt +++ b/docs/ref/contrib/gis/geos.txt @@ -523,7 +523,9 @@ corresponding to the SRID of the geometry or ``None``. Requires GDAL. -.. method:: transform(ct, clone=False) +.. method:: GEOSGeometry.transform(ct, clone=False) + +.. versionchanged:: 1.3 Transforms the geometry according to the given coordinate transformation paramter (``ct``), which may be an integer SRID, spatial reference WKT string, @@ -537,6 +539,16 @@ is returned instead. Requires GDAL. +.. note:: + + Prior to 1.3, this method would silently no-op if GDAL was not available. + Now, a :class:`~django.contrib.gis.geos.GEOSException` is raised as + application code relying on this behavior is in error. In addition, + use of this method when the SRID is ``None`` or less than 0 now generates + a warning because a :class:`~django.contrib.gis.geos.GEOSException` will + be raised instead in version 1.5. + + ``Point`` --------- diff --git a/docs/ref/contrib/gis/install.txt b/docs/ref/contrib/gis/install.txt index fa8e34c268..a1485d1b54 100644 --- a/docs/ref/contrib/gis/install.txt +++ b/docs/ref/contrib/gis/install.txt @@ -98,8 +98,9 @@ Program Description Required .. admonition:: Install GDAL While :ref:`gdalbuild` is technically not required, it is *recommended*. - Some features of GeoDjango (including the :ref:`ref-layermapping` and the geographic - admin) depend on its functionality. + Important features of GeoDjango (including the :ref:`ref-layermapping`, + geometry reprojection, and the geographic admin) depend on its + functionality. .. note:: @@ -273,9 +274,9 @@ supports :ref:`GDAL's vector data ` capabilities [#]_. First download the latest GDAL release version and untar the archive:: - $ wget http://download.osgeo.org/gdal/gdal-1.7.2.tar.gz - $ tar xzf gdal-1.7.2.tar.gz - $ cd gdal-1.7.2 + $ wget http://download.osgeo.org/gdal/gdal-1.7.3.tar.gz + $ tar xzf gdal-1.7.3.tar.gz + $ cd gdal-1.7.3 Configure, make and install:: -- cgit v1.3