From ae77543e08264a0f3e07bc6f56e5f13379229cae Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Wed, 9 Dec 2009 05:12:14 +0000
Subject: [PATCH] correct output type of ST_Extent and flag change happening in
 1.4 from box2d to box3d_extent.  Also ref to ST_Extent3D to deal with 3d
 geometries.

git-svn-id: http://svn.osgeo.org/postgis/branches/1.4@4993 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/reference.xml | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/reference.xml b/doc/reference.xml
index d20eaebe8..45e2a7bea 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -14464,7 +14464,7 @@ SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' As bo
 	  <refsynopsisdiv>
 		<funcsynopsis>
 		  <funcprototype>
-			<funcdef>box2d <function>ST_Extent</function></funcdef>
+			<funcdef>box3d_extent <function>ST_Extent</function></funcdef>
 			<paramdef><type>geometry set</type> <parameter>geomfield</parameter></paramdef>
 		  </funcprototype>
 		</funcsynopsis>
@@ -14484,7 +14484,11 @@ SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' As bo
 		</note>
 
 		<note>
-		  <para>Bounding boxes of all geometries are currently 2-d even if they are 3-dimensional geometries.</para>
+		  <para>ST_Extent will return boxes with only an x and y component even with (x,y,z) coordinate geometries.  To maintain x,y,z use ST_Extent3D instead.</para>
+		</note>
+		
+		<note>
+		  <para>Availability: 1.4.0 As of 1.4.0 now returns a box3d_extent instead of box2d object.</para>
 		</note>
 
 	  </refsection>
@@ -14524,7 +14528,7 @@ SELECT ST_SetSRID(ST_Extent(the_geom),2249) as bextent FROM sometable;
 
 	  <refsection>
 		<title>See Also</title>
-		<para><xref linkend="ST_AsEWKT" />, <xref linkend="ST_SetSRID" />, <xref linkend="ST_SRID" /></para>
+		<para><xref linkend="ST_AsEWKT" />, <xref linkend="ST_Extent3D" />, <xref linkend="ST_SetSRID" />, <xref linkend="ST_SRID" /></para>
 	  </refsection>
 	</refentry>
 
-- 
2.49.0