From: Regina Obe <lr@pcorp.us>
Date: Wed, 29 Oct 2008 18:32:27 +0000 (+0000)
Subject: Make more pretty section names, move over ST_Accum and provide example.
X-Git-Tag: 1.4.0b1~553
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3a3339e303086dc2397d888f962258784c7b6af1;p=postgis

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 11c78fdce..43863b77e 100644
--- 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 21279e307..e2e72e263 100644
--- 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>