[SCM] PostGIS branch master updated. 3.6.0rc2-168-g5f1330931
git at osgeo.org
git at osgeo.org
Thu Oct 30 09:48: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 5f13309312fb79142c5d870828e17455c6f8f93d (commit)
from 8c0a1555e2d7d4234419b3ddb6af7ecaeedc2f82 (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 5f13309312fb79142c5d870828e17455c6f8f93d
Author: Darafei Praliaskouski <me at komzpa.net>
Date: Thu Oct 30 20:48:35 2025 +0400
Clarify the scope of several Function Reference categories
Closes #4332
diff --git a/NEWS b/NEWS
index eb5464cde..06b41d6f1 100644
--- a/NEWS
+++ b/NEWS
@@ -18,6 +18,8 @@ xxxx/xx/xx
- #5702, Allow the compiler to detect the parallelism -flto=auto (Darafei Praliaskouski)
- #4798, ST_AsGeoJSON warns about duplicate property keys (Darafei Praliaskouski)
- #5950, Document POSTGIS_REGRESS_DB_OWNER for sandboxed regression roles (Darafei Praliaskouski)
+ - #4332, Clarify the scope of several Function Reference categories (Darafei Praliaskouski)
+
* Bug Fixes *
diff --git a/doc/reference_accessor.xml b/doc/reference_accessor.xml
index b75f26317..4cbcd8f74 100644
--- a/doc/reference_accessor.xml
+++ b/doc/reference_accessor.xml
@@ -1,6 +1,13 @@
<!-- Converted by db4-upgrade version 1.1 -->
<section xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Geometry_Accessors">
- <title>Geometry Accessors</title>
+ <title>Geometry Accessors</title><info>
+ <abstract>
+ <para>These functions expose structural information about an existing geometry
+ without changing it. They provide access to metadata such as geometry
+ type, dimensionality, or coordinate components so that spatial
+ expressions can interrogate complex objects in a controlled way.</para>
+ </abstract>
+ </info>
<refentry xml:id="GeometryType">
<refnamediv>
diff --git a/doc/reference_constructor.xml b/doc/reference_constructor.xml
index e849926c5..324424a7b 100644
--- a/doc/reference_constructor.xml
+++ b/doc/reference_constructor.xml
@@ -1,6 +1,12 @@
<!-- Converted by db4-upgrade version 1.1 -->
<section xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Geometry_Constructors">
- <title>Geometry Constructors</title>
+ <title>Geometry Constructors</title><info>
+ <abstract>
+ <para>These functions instantiate new geometry or geography values. They
+ assemble primitives, coordinate sequences, or existing geometries into
+ well-formed spatial objects that can participate in subsequent analysis.</para>
+ </abstract>
+ </info>
<refentry xml:id="ST_Collect">
<refnamediv>
diff --git a/doc/reference_exception.xml b/doc/reference_exception.xml
index 51c3301b7..79155219a 100644
--- a/doc/reference_exception.xml
+++ b/doc/reference_exception.xml
@@ -1,8 +1,12 @@
<!-- Converted by db4-upgrade version 1.1 -->
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Exceptional_Functions">
- <title>Exceptional Functions</title>
- <para>These functions are rarely used functions that should only be used if your data is corrupted in someway. They are used for troubleshooting corruption
- and also fixing things that should under normal circumstances, never happen.</para>
+ <title>Exceptional Functions</title><info>
+ <abstract>
+ <para>These routines are reserved for diagnosing and repairing data
+ corruption. They provide last-resort maintenance operations that are not
+ required during normal spatial workflows.</para>
+ </abstract>
+ </info>
<refentry xml:id="PostGIS_AddBBox">
<refnamediv>
diff --git a/doc/reference_lrs.xml b/doc/reference_lrs.xml
index 46ceb15ed..570d4daea 100644
--- a/doc/reference_lrs.xml
+++ b/doc/reference_lrs.xml
@@ -1,6 +1,13 @@
<!-- Converted by db4-upgrade version 1.1 -->
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Linear_Referencing">
- <title>Linear Referencing</title>
+ <title>Linear Referencing</title><info>
+ <abstract>
+ <para>These functions measure and locate events along linear features.
+ They support the classic linear referencing workflow of expressing
+ positions as fractions or measures along routes and of projecting
+ those measures back into spatial coordinates.</para>
+ </abstract>
+ </info>
<refentry xml:id="ST_LineInterpolatePoint">
<refnamediv>
diff --git a/doc/reference_operator.xml b/doc/reference_operator.xml
index 00e219685..8f1bf8655 100644
--- a/doc/reference_operator.xml
+++ b/doc/reference_operator.xml
@@ -1,6 +1,15 @@
<!-- Converted by db4-upgrade version 1.1 -->
<section xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Operators">
- <title>Operators</title>
+ <title>Operators</title><info>
+ <abstract>
+ <para>These entries document the spatial operators defined by PostGIS.
+ Operators complement the function catalogue by supplying concise
+ symbolic predicates for bounding-box interactions and spatial
+ relationships. Their semantics follow the same geometric rules as the
+ corresponding functions but are optimised for use in SQL expressions
+ and index-supported filtering.</para>
+ </abstract>
+ </info>
<section xml:id="operators-bbox">
<title>Bounding Box Operators</title>
-----------------------------------------------------------------------
Summary of changes:
NEWS | 2 ++
doc/reference_accessor.xml | 9 ++++++++-
doc/reference_constructor.xml | 8 +++++++-
doc/reference_exception.xml | 10 +++++++---
doc/reference_lrs.xml | 9 ++++++++-
doc/reference_operator.xml | 11 ++++++++++-
6 files changed, 42 insertions(+), 7 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list