Get rid of extra line breaks in specialty function section (by changing xsl). Move...

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

diff --git a/doc/reference.xml b/doc/reference.xml
index c6c3b6b0e783b1709beda65cf1e98c6c6b9c948b..3408e1cf76189a7530a7ddd5516567d6804a8342 100644 (file)
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -1005,18 +1005,6 @@ GROUP BY gid, field1,field2;
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>ST_Polygonize(geometry set)</term>
-
-          <listitem>
-            <para>Aggregate. Creates a GeometryCollection containing possible
-            polygons formed from the constituent linework of a set of
-            geometries.</para>
-
-            <para>Availability: 1.0.0RC1 - requires GEOS &gt;= 2.1.0.</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>ST_DumpRings(geometry)</term>
 

diff --git a/doc/reference_new.xml b/doc/reference_new.xml
index 94f3ca3625ca1a10d97888ee38443baad672df29..d7b91d91230a9c3bf5abed313c38cf1cef231792 100644 (file)
--- a/doc/reference_new.xml
+++ b/doc/reference_new.xml
@@ -5174,8 +5174,77 @@ FROM country
                        <para><xref linkend="ST_Dimension"/>, <xref linkend="ST_Dump"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Multi"/></para>
                </refsection>
        </refentry>     
+
+       <refentry id="ST_Polygonize">
+               <refnamediv>
+                       <refname>ST_Polygonize</refname>
+                       
+                       <refpurpose>Aggregate. Creates a GeometryCollection containing possible
+            polygons formed from the constituent linework of a set of
+            geometries.</refpurpose>
+               </refnamediv>
+               
+               <refsynopsisdiv>
+               <funcsynopsis>
+                 <funcprototype>
+                       <funcdef>geometry <function>ST_Polygonize</function></funcdef>
+                       <paramdef><type>geometry</type> <parameter>geomfield</parameter></paramdef>
+                 </funcprototype>
+               </funcsynopsis>
+               </refsynopsisdiv>
+               
+               <refsection>
+                       <title>Description</title>
+                       
+                       <para>Creates a GeometryCollection containing possible
+            polygons formed from the constituent linework of a set of
+            geometries.</para>
+
+                       <note>
+                               <para>Geometry Collections are often difficult to deal with with third party tools, so use ST_Polygonize in conjunction with  <xref linkend="ST_Dump" /> to dump the polygons
+                               out into individual polygons.</para>
+                       </note> 
+                       <para>Availability: 1.0.0RC1 - requires GEOS &gt;= 2.1.0.</para>
+               </refsection>
+               
+               <refsection>
+               <title>Examples: Polygonizing single linestrings</title>                
+                <programlisting>
+SELECT ST_AsEWKT(ST_Polygonize(the_geom_4269)) As geomtextrep
+FROM (SELECT the_geom_4269 FROM ma.suffolk_edges ORDER BY tlid LIMIT 45) As foo;
+
+geomtextrep
+-------------------------------------
+ SRID=4269;GEOMETRYCOLLECTION(POLYGON((-71.040878 42.285678,-71.040943 42.2856,-
+71.04096 42.285752,-71.040878 42.285678)),POLYGON((-71.17166 42.353675,-71.17202
+6 42.354044,-71.17239 42.354358,-71.171794 42.354971,-71.170511 42.354855,-71.17
+112 42.354238,-71.17166 42.353675)))
+(1 row)
+
+--Use ST_Dump to dump out the polygonize geoms into individual polygons
+SELECT ST_AsEWKT((ST_Dump(foofoo.polycoll)).geom) As geomtextrep
+FROM (SELECT ST_Polygonize(the_geom_4269) As polycoll
+       FROM (SELECT the_geom_4269 FROM ma.suffolk_edges 
+               ORDER BY tlid LIMIT 45) As foo) As foofoo;
+
+geomtextrep
+------------------------
+ SRID=4269;POLYGON((-71.040878 42.285678,-71.040943 42.2856,-71.04096 42.285752,
+-71.040878 42.285678))
+ SRID=4269;POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 42.354358
+,-71.171794 42.354971,-71.170511 42.354855,-71.17112 42.354238,-71.17166 42.353675))
+(2 rows)               
+
+                         </programlisting>
+               </refsection>
+
+               <refsection>
+                       <title>See Also</title>
+                       <para><xref linkend="ST_Dump" /></para>
+               </refsection>
+       </refentry>     
        
-       <refentry id="ST_Union">
+<refentry id="ST_Union">
   <refnamediv>
        <refname>ST_Union</refname>
        <refpurpose>Returns a geometry that represents the point set union of

diff --git a/doc/xsl/postgis_aggs_mm.xml.xsl b/doc/xsl/postgis_aggs_mm.xml.xsl
index f519116cdcf799930e94b640d853ad88adbf2764..c8c038f636949703791e97a147888a6ad23b58a5 100644 (file)
--- a/doc/xsl/postgis_aggs_mm.xml.xsl
+++ b/doc/xsl/postgis_aggs_mm.xml.xsl
@@ -30,7 +30,7 @@
                                <xsl:for-each select="refsynopsisdiv/funcsynopsis/funcprototype">\r
                                        <xsl:choose>\r
                                                <xsl:when test="contains(paramdef/type,'geometry set')">\r
-                                                        <listitem><para><link linkend="{$refid}"><xsl:value-of select="$refid" /></link> - <xsl:value-of select="$comment" /></para></listitem>\r
+                                                        <listitem><link linkend="{$refid}"><xsl:value-of select="$refid" /></link> - <xsl:value-of select="$comment" /></listitem>\r
                                                </xsl:when>\r
                                        </xsl:choose>\r
                                </xsl:for-each>\r
@@ -57,7 +57,7 @@
                                                        <xsl:for-each select="para">\r
                                                                <xsl:choose>\r
                                                                        <xsl:when test="contains(.,'implements the SQL/MM')">\r
-                                                                               <listitem><para><link linkend="{$refid}"><xsl:value-of select="$refid" /></link> - <xsl:value-of select="$comment" /> <xsl:value-of select="." /></para></listitem>\r
+                                                                               <listitem><link linkend="{$refid}"><xsl:value-of select="$refid" /></link> - <xsl:value-of select="$comment" /> <xsl:value-of select="." /></listitem>\r
                                                                        </xsl:when>\r
                                                                </xsl:choose>\r
                                                        </xsl:for-each>\r