Created a new 'Geometry Editors' section.

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

diff --git a/doc/postgis.xml b/doc/postgis.xml
index fb4235b2603e58c6ac9ef8d1dfaab21fe976c218..b7b5969257e422fde97dfe7847cbf6497c034b9c 100644 (file)
--- a/doc/postgis.xml
+++ b/doc/postgis.xml
@@ -3791,6 +3791,144 @@ FROM geometry_table;</literallayout>
          </variablelist>
       </sect2>
 
+      <sect2>
+       <title>Geometry Editors</title>
+         <variablelist>
+
+        <varlistentry>
+          <term>addBBOX(geometry)</term>
+          <listitem>
+            <para>Add bounding box to the geometry. This would make bounding
+           box based queries faster, but will increase the size of the
+           geometry.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>dropBBOX(geometry)</term>
+          <listitem>
+            <para>Drop the bounding box cache from the geometry.
+           This reduces geometry size, but makes bounding-box based
+           queries slower.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>force_collection(geometry)</term>
+
+          <listitem>
+            <para>Converts the geometry into a GEOMETRYCOLLECTION. This is
+            useful for simplifying the WKB representation.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="force_2d">
+          <term>force_2d(geometry)</term>
+
+          <listitem>
+            <para>Forces the geometries into a "2-dimensional mode" so that
+            all output representations will only have the X and Y coordinates.
+            This is useful for force OGC-compliant output (since OGC only
+            specifies 2-D geometries).</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="force_3dz">
+          <term>force_3dz(geometry)</term>
+          <term>force_3d(geometry)</term>
+
+          <listitem>
+            <para>Forces the geometries into XYZ mode.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="force_3dm">
+          <term>force_3dm(geometry)</term>
+
+          <listitem>
+            <para>Forces the geometries into XYM mode.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="force_4d">
+          <term>force_4d(geometry)</term>
+
+          <listitem>
+            <para>Forces the geometries into XYZM mode.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>multi(geometry)</term>
+
+          <listitem>
+            <para>Returns the geometry as a MULTI* geometry. If the geometry
+            is already a MULTI*, it is returned unchanged.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>transform(geometry,integer)</term>
+
+          <listitem>
+            <para>Returns a new geometry with its coordinates transformed to
+            the SRID referenced by the integer parameter. The destination SRID
+            must exist in the <varname>SPATIAL_REF_SYS</varname> table.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>translate(geometry,float8,float8,float8)</term>
+
+          <listitem>
+            <para>Translates the geometry to a new location using the numeric
+            parameters as offsets. Ie: translate(geom,X,Y,Z).</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>Reverse(geometry)</term>
+          <listitem>
+            <para>Returns the geometry with vertex order reversed.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>ForceRHR(geometry)</term>
+          <listitem>
+            <para>Force polygons of the collection to obey Right-Hand-Rule.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>simplify(geometry, tolerance)</term>
+
+          <listitem>
+            <para>Returns a "simplified" version of the given geometry using
+            the Douglas-Peuker algorithm. Will actually do something only with
+            (multi)lines and (multi)polygons but you can safely call it with
+            any kind of geometry. Since simplification occurs on a
+            object-by-object basis you can also feed a GeometryCollection to
+            this function. Note that returned geometry might loose its
+            simplicity (see isSimple)</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>segmentize(geometry, maxlength)</term>
+
+          <listitem>
+            <para>Return a modified [multi]polygon having no ring segment
+            longer then the given distance. Interpolated points will have Z
+            and M values (if needed) set to 0. Distance computation is
+            performed in 2d only.</para>
+          </listitem>
+        </varlistentry>
+
+
+         </variablelist>
+      </sect2>
+
       <sect2>
        <title>Misc</title>
          <variablelist>
@@ -3886,69 +4024,6 @@ FROM geometry_table;</literallayout>
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>addBBOX(geometry)</term>
-          <listitem>
-            <para>Add bounding box to the geometry. This would make bounding
-           box based queries faster, but will increase the size of the
-           geometry.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>dropBBOX(geometry)</term>
-          <listitem>
-            <para>Drop the bounding box cache from the geometry.
-           This reduces geometry size, but makes bounding-box based
-           queries slower.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>force_collection(geometry)</term>
-
-          <listitem>
-            <para>Converts the geometry into a GEOMETRYCOLLECTION. This is
-            useful for simplifying the WKB representation.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="force_2d">
-          <term>force_2d(geometry)</term>
-
-          <listitem>
-            <para>Forces the geometries into a "2-dimensional mode" so that
-            all output representations will only have the X and Y coordinates.
-            This is useful for force OGC-compliant output (since OGC only
-            specifies 2-D geometries).</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="force_3dz">
-          <term>force_3dz(geometry)</term>
-          <term>force_3d(geometry)</term>
-
-          <listitem>
-            <para>Forces the geometries into XYZ mode.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="force_3dm">
-          <term>force_3dm(geometry)</term>
-
-          <listitem>
-            <para>Forces the geometries into XYM mode.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="force_4d">
-          <term>force_4d(geometry)</term>
-
-          <listitem>
-            <para>Forces the geometries into XYZM mode.</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry id="zmflag">
           <term>zmflag(geometry)</term>
 
@@ -3979,15 +4054,6 @@ FROM geometry_table;</literallayout>
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>multi(geometry)</term>
-
-          <listitem>
-            <para>Returns the geometry as a MULTI* geometry. If the geometry
-            is already a MULTI*, it is returned unchanged.</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>nrings(geometry)</term>
 
@@ -4034,25 +4100,6 @@ FROM geometry_table;</literallayout>
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>transform(geometry,integer)</term>
-
-          <listitem>
-            <para>Returns a new geometry with its coordinates transformed to
-            the SRID referenced by the integer parameter. The destination SRID
-            must exist in the <varname>SPATIAL_REF_SYS</varname> table.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>translate(geometry,float8,float8,float8)</term>
-
-          <listitem>
-            <para>Translates the geometry to a new location using the numeric
-            parameters as offsets. Ie: translate(geom,X,Y,Z).</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>xmin(box3d) ymin(box3d) zmin(box3d)</term>
 
@@ -4069,34 +4116,6 @@ FROM geometry_table;</literallayout>
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>Reverse(geometry)</term>
-          <listitem>
-            <para>Returns the geometry with vertex order reversed.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>ForceRHR(geometry)</term>
-          <listitem>
-            <para>Force polygons of the collection to obey Right-Hand-Rule.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>simplify(geometry, tolerance)</term>
-
-          <listitem>
-            <para>Returns a "simplified" version of the given geometry using
-            the Douglas-Peuker algorithm. Will actually do something only with
-            (multi)lines and (multi)polygons but you can safely call it with
-            any kind of geometry. Since simplification occurs on a
-            object-by-object basis you can also feed a GeometryCollection to
-            this function. Note that returned geometry might loose its
-            simplicity (see isSimple)</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>line_interpolate_point(geometry, proportion)</term>
 
@@ -4107,17 +4126,6 @@ FROM geometry_table;</literallayout>
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>segmentize(geometry, maxlength)</term>
-
-          <listitem>
-            <para>Return a modified [multi]polygon having no ring segment
-            longer then the given distance. Interpolated points will have Z
-            and M values (if needed) set to 0. Distance computation is
-            performed in 2d only.</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>AsSVG(geometry, [rel], [precision])</term>