[SCM] PostGIS branch master updated. 3.6.0rc2-140-g60c6bb4fe

git at osgeo.org git at osgeo.org
Fri Oct 17 10:07:51 PDT 2025


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  60c6bb4fe2a6a3256ba5daaa6ded1a4c5ebe0e5f (commit)
      from  8a5acc9a1b5945db2d50f7126479e74eb2b6eb71 (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 60c6bb4fe2a6a3256ba5daaa6ded1a4c5ebe0e5f
Author: Paul Ramsey <pramsey at cleverelephant.ca>
Date:   Fri Oct 17 10:07:44 2025 -0700

    Note the default values for keepcollapsed in ST_MakeValid, closes #6006

diff --git a/doc/reference_validation.xml b/doc/reference_validation.xml
index ed94bb362..d824a504b 100644
--- a/doc/reference_validation.xml
+++ b/doc/reference_validation.xml
@@ -351,22 +351,35 @@ SELECT ST_IsValidReason('LINESTRING(220227 150406,2220227 150407,222020 150410)'
 
     <itemizedlist>
     <listitem>
-        <para>"linework" is the original algorithm, and builds valid geometries
+        <para>"linework" is the default algorithm, and builds valid geometries
         by first extracting all lines, noding that linework together, then building
-        a value output from the linework.</para>
+        a value output from the linework. The requirement that no vertices are
+        lost can generate complex collections as outputs.</para>
     </listitem>
     <listitem>
         <para>"structure" is an algorithm that distinguishes between
         interior and exterior rings, building new geometry by unioning
-        exterior rings, and then differencing all interior rings.</para>
+        exterior rings, and then differencing all interior rings. The results
+        tend to be more intuitive, where collapsed lines are discarded in
+        the output.</para>
     </listitem>
     </itemizedlist>
 
     <para>The "keepcollapsed" key is only valid for the "structure" algorithm,
-    and takes a value of "true" or "false". When set to "false",
-    geometry components that collapse to a lower dimensionality,
-    for example a one-point linestring would be dropped.
-    </para>
+    and takes a value of "true" or "false".</para>
+
+    <itemizedlist>
+    <listitem>
+        <para>Keep collapsed of "false" is the default, and means that
+        geometry components that collapse to a lower dimensionality,
+        for example a one-point linestring will be dropped.</para>
+    </listitem>
+    <listitem>
+        <para>Keep collapsed of "true" means
+        geometry components that collapse to a lower dimensionality
+        will be retained.</para>
+    </listitem>
+    </itemizedlist>
 
     <para>Performed by the GEOS module.</para>
 

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

Summary of changes:
 doc/reference_validation.xml | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)


hooks/post-receive
-- 
PostGIS


More information about the postgis-tickets mailing list