summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorJustin Bronn <jbronn@gmail.com>2010-12-22 17:43:30 +0000
committerJustin Bronn <jbronn@gmail.com>2010-12-22 17:43:30 +0000
commit5fddfda5593d0f8c244f640ae63a17035ade0e3e (patch)
tree9e11eee1f3dfeed767ccc07db07c700a2d796195 /docs/ref
parentdf4cb60004db5cbbe402233138f2f0c804a46f15 (diff)
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
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/contrib/gis/geos.txt14
-rw-r--r--docs/ref/contrib/gis/install.txt11
2 files changed, 19 insertions, 6 deletions
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 <ref-gdal>` 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::