more clarity on the float4/float8 for ST_Envelope

git-svn-id: http://svn.osgeo.org/postgis/trunk@5073 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/reference_accessor.xml b/doc/reference_accessor.xml
index 303f76d423f314bdcb743d639faa4933b3d51a84..1c903efbfe4bcc3d7d104090e66bf10640fd2f85 100644 (file)
--- a/doc/reference_accessor.xml
+++ b/doc/reference_accessor.xml
@@ -293,7 +293,7 @@ SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
          </refsection>
        </refentry>
 
-               <refentry id="ST_Envelope">
+       <refentry id="ST_Envelope">
                  <refnamediv>
                        <refname>ST_Envelope</refname>
 
@@ -314,7 +314,7 @@ SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
                  <refsection>
                        <title>Description</title>
 
-                       <para>Returns the minimum bounding box for the supplied geometry, as a geometry.
+                       <para>Returns the float4 minimum bounding box for the supplied geometry, as a geometry.
                        The polygon is defined by the corner points of the bounding box
                        ((<varname>MINX</varname>, <varname>MINY</varname>),
                        (<varname>MINX</varname>, <varname>MAXY</varname>),
@@ -347,30 +347,51 @@ SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
                <title>Examples</title>
 
                <programlisting>
-       SELECT ST_AsText(ST_Envelope('POINT(1 3)'::geometry));
-        st_astext
-       ------------
-        POINT(1 3)
-       (1 row)
-
-
-       SELECT ST_AsText(ST_Envelope('LINESTRING(0 0, 1 3)'::geometry));
-                          st_astext
-       --------------------------------
-        POLYGON((0 0,0 3,1 3,1 0,0 0))
-       (1 row)
-
-
-       SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000001 1, 1.0000001 0, 0 0))'::geometry));
-                                                         st_astext
-       --------------------------------------------------------------
-        POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
-       (1 row)
-       SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000000001 1, 1.0000000001 0, 0 0))'::geometry));
-                                                         st_astext
-       --------------------------------------------------------------
-        POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
-       (1 row)</programlisting>
+SELECT ST_AsText(ST_Envelope('POINT(1 3)'::geometry));
+ st_astext
+------------
+ POINT(1 3)
+(1 row)
+
+
+SELECT ST_AsText(ST_Envelope('LINESTRING(0 0, 1 3)'::geometry));
+                  st_astext
+--------------------------------
+ POLYGON((0 0,0 3,1 3,1 0,0 0))
+(1 row)
+
+
+SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000001 1, 1.0000001 0, 0 0))'::geometry));
+                                                 st_astext
+--------------------------------------------------------------
+ POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
+(1 row)
+SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000000001 1, 1.0000000001 0, 0 0))'::geometry));
+                                                 st_astext
+--------------------------------------------------------------
+ POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
+(1 row)
+       
+SELECT ST_Box3D(geom), ST_Box2D(geom), ST_AsText(ST_Envelope(geom)) As envelopewkt
+       FROM (SELECT 'POLYGON((0 0, 0 1000012333334.34545678, 1.0000001 1, 1.0000001 0, 0 0))'::geometry As geom) As foo;
+
+box3d
+-----------------------------------------
+BOX3D(0 0 0,1.0000001 1000012333334.35 0)
+
+box2d
+------------------------------------------
+BOX(0 0,1.00000011920929 1000012382208)
+
+envelopewkt
+-------------------------------------------------------------------
+POLYGON((0 0,0 1000012382208,1.00000011920929 1000012382208,1.00000011920929 0,0 0))
+       </programlisting>
+         </refsection>
+         <refsection>
+               <title>See Also</title>
+
+               <para><xref linkend="ST_Box2D" />, <xref linkend="ST_Box3D" /></para>
          </refsection>
        </refentry>