Make more pretty section names, move over ST_Accum and provide example.

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

diff --git a/doc/reference.xml b/doc/reference.xml
index 11c78fdce01e0926dac5be072835592ebeec380e..43863b77ef2028ca75b0945b11a61b2e14e2b1fa 100644 (file)
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -654,14 +654,6 @@
             <para>Returns the requested maxima of a bounding box.</para>
           </listitem>
         </varlistentry>
-
-        <varlistentry id="ST_Accum">
-          <term>ST_Accum(geometry set)</term>
-
-          <listitem>
-            <para>Aggregate. Constructs an array of geometries.</para>
-          </listitem>
-        </varlistentry>
       </variablelist>
     </sect2>
 

diff --git a/doc/reference_new.xml b/doc/reference_new.xml
index 21279e307b9fa7d768010008ead3c702a9f59a72..e2e72e2637bbbbbc7eb18d030d82954fa989be79 100644 (file)
--- a/doc/reference_new.xml
+++ b/doc/reference_new.xml
@@ -4872,7 +4872,7 @@ CREATE INDEX idx_the_geom_26986_parcels
        
   </sect1>
 
-  <sect1>
+  <sect1 id="Geometry_Outputs">
       <title>Geometry Outputs</title>
                  <refentry id="ST_AsBinary">
                  <refnamediv>
@@ -5489,7 +5489,7 @@ F000000000000000000000000000000000000000000000000');
   </sect1>
   
   
-  <sect1>
+  <sect1 id="Spatial_Relationships_Measurements">
        <title>Spatial Relationships and Measurements</title>
        <refentry id="ST_Area">
                <refnamediv>
@@ -7841,7 +7841,7 @@ FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,
     </refentry>
   </sect1>
   
-       <sect1>
+       <sect1 id="Geometry_Processing">
                <title>Geometry Processing Functions</title>
                <refentry id="ST_Buffer">
                        <refnamediv>
@@ -9469,8 +9469,70 @@ SELECT ST_AsEWKT((ST_Dump(the_geom)).geom)
       <para> </para>
   </sect1>
   
-  <sect1>
+  <sect1 id="Miscellaneous_Functions">
     <title>Misc</title>
+
+       <refentry id="ST_Accum">
+         <refnamediv>
+           <refname>ST_Accum</refname>
+       
+           <refpurpose>Aggregate. Constructs an array of geometries.</refpurpose>
+         </refnamediv>
+       
+         <refsynopsisdiv>
+           <funcsynopsis>
+             <funcprototype>
+               <funcdef>geometry[] <function>ST_Accum</function></funcdef>
+               <paramdef><type>geometry set</type> <parameter>geomfield</parameter></paramdef>
+             </funcprototype>
+           </funcsynopsis>
+         </refsynopsisdiv>
+       
+         <refsection>
+           <title>Description</title>
+       
+           <para>Aggregate. Constructs an array of geometries.</para>
+       
+               <!-- Optionally mention 3d support -->
+           <para><inlinemediaobject>
+               <imageobject>
+                 <imagedata fileref="images/check.png" />
+               </imageobject>
+             </inlinemediaobject> This function supports 3d and will not drop the z-index.</para>
+         </refsection>
+         
+       
+         <refsection>
+           <title>Examples</title>
+       
+           <programlisting>SELECT (ST_Accum(the_geom)) As all_em, ST_AsText((ST_Accum(the_geom))[1]) As grabone, 
+(ST_Accum(the_geom))[2:4] as grab_rest
+                       FROM (SELECT ST_MakePoint(a*CAST(random()*10 As integer), a*CAST(random()*10 As integer), a*CAST(random()*10 As integer)) As the_geom
+                               FROM generate_series(1,4) a) As foo;
+
+all_em|grabone   | grab_rest
+
+-------------------------------------------------------------------------------+
+
+ {0101000080000000000000144000000000000024400000000000001040:
+ 0101000080000000000
+00018400000000000002C400000000000003040:
+0101000080000000000000354000000000000038400000000000001840:
+010100008000000000000040400000000000003C400000000000003040} |
+ POINT(5 10) | {010100008000000000000018400000000000002C400000000000003040:
+ 0101000080000000000000354000000000000038400000000000001840:
+ 010100008000000000000040400000000000003C400000000000003040}
+(1 row)
+               </programlisting>
+         </refsection>
+       
+         <!-- Optionally add a "See Also" section -->
+         <refsection>
+           <title>See Also</title>
+       
+           <para><xref linkend="ST_Collect" /></para>
+         </refsection>
+       </refentry>
        <refentry id="ST_Expand">
       <refnamediv>
         <refname>ST_Expand</refname>