Put in ST_Intersection proto for geography

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

diff --git a/doc/reference.xml b/doc/reference.xml
index 1836ee95061b7e4783cbcb23e09d2d8bf7120122..cec6eace66c24cec90a360cc9309c3de02c3cec2 100644 (file)
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -12220,7 +12220,7 @@ SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc,
                        <refnamediv>
                                <refname>ST_Buffer</refname>
 
-                               <refpurpose>For geometry: Returns a geometry that represents all points whose distance
+                               <refpurpose>(T) For geometry: Returns a geometry that represents all points whose distance
                        from this Geometry is less than or equal to distance. Calculations
                        are in the Spatial Reference System of this Geometry. For geography: Uses a planar transform wrapper.  Introduced in 1.5 support for
                        different end cap and mitre settings to control shape. buffer_style options: quad_segs=#,endcap=round|flat|square,join=round|mitre|bevel,mitre_limit=#.#
@@ -12267,7 +12267,7 @@ SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc,
                        are in the Spatial Reference System of the geometry. Introduced in 1.5 support for
                        different end cap and mitre settings to control shape.</para>
                                <note><para>Geography: For geography this is really a thin wrapper around the geometry implementation. It first determines the best SRID that
-                                       fits the bounding box of the geography object (favoring UTM and falling back on mercator in worst case scenario) and then buffers in that planar spatial ref and retransforms back to WGS84 geography.</para></note>
+                                       fits the bounding box of the geography object (favoring UTM, polar stereographic and falling back on mercator in worst case scenario) and then buffers in that planar spatial ref and retransforms back to WGS84 geography.</para></note>
                        <para><inlinegraphic fileref="images/warning.png" />
                        For geography this may not behave as expected if object is sufficiently large that it falls between two UTM zones or crosses the dateline</para>
                                <para>Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings
@@ -13235,7 +13235,8 @@ SELECT ST_AsEWKT(geom) As the_geom, path
                <refnamediv>
                        <refname>ST_Intersection</refname>
 
-                       <refpurpose>Returns a geometry that represents the shared portion of geomA and geomB
+                       <refpurpose>(T) Returns a geometry that represents the shared portion of geomA and geomB.  The geography implementation
+                                       does a transform to geometry to do the intersection and then transform back to WGS84.
                        </refpurpose>
                </refnamediv>
                <refsynopsisdiv>
@@ -13251,6 +13252,17 @@ SELECT ST_AsEWKT(geom) As the_geom, path
                                                <parameter>geomB</parameter>
                                        </paramdef>
                                </funcprototype>
+                               <funcprototype>
+                                       <funcdef>geography <function>ST_Intersection</function></funcdef>
+                                       <paramdef>
+                                               <type>geography</type>
+                                               <parameter>geogA</parameter>
+                                       </paramdef>
+                                       <paramdef>
+                                               <type>geography</type>
+                                               <parameter>geogB</parameter>
+                                       </paramdef>
+                               </funcprototype>
                        </funcsynopsis>
                </refsynopsisdiv>
                <refsection>
@@ -13266,11 +13278,16 @@ SELECT ST_AsEWKT(geom) As the_geom, path
                        <para>ST_Intersection in conjunction with ST_Intersects is very useful for clipping geometries such as in bounding box, buffer, region
                                queries where you only want to return that portion of a geometry that sits in a country or region of interest.</para>
 
+                               
+                       <note><para>Geography: For geography this is really a thin wrapper around the geometry implementation. It first determines the best SRID that
+                                       fits the bounding box of the geography object (favoring UTM, polar stereographic and falling back on mercator in worst case scenario) and then buffers in that planar spatial ref and retransforms back to WGS84 geography.</para></note>
                  <important>
                        <para>Do not call with a <varname>GEOMETRYCOLLECTION</varname> as an argument</para>
                  </important>
 
                  <para>Performed by the GEOS module</para>
+                 
+                 <para>Availability: 1.5 support for geography data type was introduced.</para>
 
 
                        <para>