From: Kevin Neufeld <kneufeld.ca@gmail.com>
Date: Tue, 29 Jul 2008 05:43:57 +0000 (+0000)
Subject: moved over st_pointonsurface and provided examples.
X-Git-Tag: 1.4.0b1~810
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7f2bfada706205d64576ddafb3e63065b4bb6ed9;p=postgis

moved over st_pointonsurface and provided examples.

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

diff --git a/doc/reference.xml b/doc/reference.xml
index dc253e4af..eac52cb57 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -189,18 +189,6 @@
           </listitem>
         </varlistentry>
 
-        <varlistentry>
-          <term>ST_PointOnSurface(geometry)</term>
-
-          <listitem>
-            <para>Return a Point guaranteed to lie on the surface</para>
-
-            <para>Implemented using GEOS</para>
-
-            <para>OGC SPEC 3.2.14.2 and 3.2.18.2 -</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>ST_Boundary(geometry)</term>
 
@@ -2047,7 +2035,7 @@ WHERE n*100.00/length &lt; 1;
           </listitem>
         </varlistentry>
 
-        <varlistentry>
+        <varlistentry id="ST_Point_Inside_Circle">
           <term>ST_point_inside_circle(geometry, float, float, float)</term>
 
           <listitem>
@@ -2618,17 +2606,6 @@ WHERE n*100.00/length &lt; 1;
         </listitem>
       </varlistentry>
 
-      <varlistentry id="ST_PointOnSurface">
-        <term>ST_PointOnSurface</term>
-
-        <listitem>
-          <para>Return an ST_Point value guaranteed to spatially intersect the
-          ST_Surface or ST_MultiSurface value.</para>
-
-          <para>SQL-MM 3: 8.1.5, 9.5.6</para>
-        </listitem>
-      </varlistentry>
-
       <varlistentry>
         <term>ST_PolyFromText</term>
 
diff --git a/doc/reference_new.xml b/doc/reference_new.xml
index 3734b35fb..6a2d63118 100644
--- a/doc/reference_new.xml
+++ b/doc/reference_new.xml
@@ -2870,6 +2870,73 @@ SELECT ST_OrderingEquals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 10)')),
 	  </refsection>
 	  
 	</refentry>
+    <refentry id="ST_PointOnSurface">
+      <refnamediv>
+        <refname>ST_PointOnSurface</refname>
+
+        <refpurpose>Returns a <varname>POINT</varname> guaranteed to lie on the surface.</refpurpose>
+      </refnamediv>
+
+      <refsynopsisdiv>
+        <funcsynopsis>
+          <funcprototype>
+            <funcdef>boolean <function>ST_PointOnSurface</function></funcdef>
+
+            <paramdef><type>geometry </type>
+            <parameter>g1</parameter></paramdef>
+          </funcprototype>
+        </funcsynopsis>
+      </refsynopsisdiv>
+
+      <refsection>
+        <title>Description</title>
+
+        <para>Returns a <varname>POINT</varname> guaranteed to intersect a surface.</para>
+
+        <para><inlinemediaobject>
+            <imageobject>
+              <imagedata fileref="images/check.png" />
+            </imageobject>
+          </inlinemediaobject> This method implements the <ulink
+        url="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple
+        Features Implementation Specification for SQL: 3.2.14.2, 3.2.18.2</ulink></para>
+
+        <para><inlinemediaobject>
+            <imageobject>
+              <imagedata fileref="images/check.png" />
+            </imageobject>
+          </inlinemediaobject> This method implements the SQL/MM
+        specification: SQL-MM 3: 8.1.5, 9.5.6</para>
+      </refsection>
+
+      <refsection>
+        <title>Examples</title>
+        
+        <programlisting>SELECT ST_AsText(ST_PointOnSurface('POINT(0 5)'::geometry));
+ st_astext  
+------------
+ POINT(0 5)
+(1 row)
+
+SELECT ST_AsText(ST_PointOnSurface('LINESTRING(0 5, 0 10)'::geometry));
+ st_astext  
+------------
+ POINT(0 5)
+(1 row)
+
+SELECT ST_AsText(ST_PointOnSurface('POLYGON((0 0, 0 5, 5 5, 5 0, 0 0))'::geometry));
+   st_astext    
+----------------
+ POINT(2.5 2.5)
+(1 row)</programlisting>
+      </refsection>
+
+      <refsection>
+        <title>See Also</title>
+
+        <para><xref linkend="ST_Centroid" />, <xref linkend="ST_Point_Inside_Circle" /></para>
+      </refsection>
+    </refentry>
 	
     <refentry id="ST_Within">
       <refnamediv>