[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0rc1-55-ge797330

[git at osgeo.org]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  e7973308de3df4515c6456880e162040e285ee2b (commit)
      from  253e3930e379f2a2cc6edfa2d1dc1b3177543e71 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e7973308de3df4515c6456880e162040e285ee2b
Author: Martin Davis <mtnclimb at gmail.com>
Date:   Wed Feb 3 22:07:53 2021 -0800

    Add doc ST_PointOnSurface see also ref

diff --git a/doc/reference_processing.xml b/doc/reference_processing.xml
index 58f3747..482d85c 100644
--- a/doc/reference_processing.xml
+++ b/doc/reference_processing.xml
@@ -1757,8 +1757,7 @@ MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),
     <refentry id="ST_PointOnSurface">
       <refnamediv>
         <refname>ST_PointOnSurface</refname>
-
-        <refpurpose>Returns a point guaranteed to lie in a polygon, or on a geometry.</refpurpose>
+        <refpurpose>Computes a point guaranteed to lie in a polygon, or on a geometry.</refpurpose>
       </refnamediv>
 
       <refsynopsisdiv>
@@ -1777,14 +1776,14 @@ MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),
 
         <para>Returns a <varname>POINT</varname> which is guaranteed to lie in the interior of a surface
         (POLYGON, MULTIPOLYGON, and CURVED POLYGON).
-        In PostGIS this function also works on non-surface geometries.
+        In PostGIS this function also works on line and point geometries.
         </para>
 
         <para>&sfs_compliant; s3.2.14.2 // s3.2.18.2</para>
         <para>&sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6.
          The specifications define ST_PointOnSurface for surface geometries only.
          PostGIS extends the function to support all common geometry types.
-         Other databases (Oracle,DB II, ESRI SDE) seem to support this function only for surfaces.
+         Other databases (Oracle, DB2, ArcSDE) seem to support this function only for surfaces.
          SQL Server 2008 supports all common geometry types.</para>
         <para>&Z_support;</para>
       </refsection>
@@ -1796,32 +1795,27 @@ MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),
  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)
 
 SELECT ST_AsEWKT(ST_PointOnSurface(ST_GeomFromEWKT('LINESTRING(0 5 1, 0 0 1, 0 10 2)')));
    st_asewkt
 ----------------
  POINT(0 0 1)
-(1 row)
 </programlisting>
       </refsection>
 
       <refsection>
         <title>See Also</title>
-
-        <para><xref linkend="ST_Centroid" /></para>
+        <para><xref linkend="ST_Centroid" />, <xref linkend="ST_MaximumInscribedCircle" /></para>
       </refsection>
     </refentry>
 

-----------------------------------------------------------------------

Summary of changes:
 doc/reference_processing.xml | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)


hooks/post-receive
-- 
PostGIS