[SCM] PostGIS branch master updated. 3.4.0rc1-804-gaced4c24a
git at osgeo.org
git at osgeo.org
Mon Nov 27 12:46:05 PST 2023
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 aced4c24a2560606c168fc13cac9499ffe1e3341 (commit)
from f485280a35df55a4799bf4a8a540a4730c5449b9 (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 aced4c24a2560606c168fc13cac9499ffe1e3341
Author: Martin Davis <mtnclimb at gmail.com>
Date: Mon Nov 27 12:46:03 2023 -0800
Add doc links, order functions alphabetically
diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index 92fd5a124..7ad891404 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -805,55 +805,6 @@ SELECT ST_AsEWKT(ST_Force4D('MULTILINESTRINGM((0 0 1,0 5 2,5 0 3,0 0 4),(1 1 1,
</refsection>
</refentry>
- <refentry xml:id="ST_ForcePolygonCCW">
- <refnamediv>
- <refname>
- ST_ForcePolygonCCW
- </refname>
- <refpurpose>
- Orients all exterior rings counter-clockwise and all interior rings clockwise.
- </refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>
- geometry
- <function>ST_ForcePolygonCCW</function>
- </funcdef>
- <paramdef>
- <type>geometry</type>
- <parameter>geom</parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>
- Forces (Multi)Polygons to use a counter-clockwise orientation for
- their exterior ring, and a clockwise orientation for their interior
- rings. Non-polygonal geometries are returned unchanged.
- </para>
-
- <para role="availability" conformance="2.4.0">Availability: 2.4.0</para>
- <para>&Z_support;</para>
- <para>&M_support;</para>
- </refsection>
-
- <refsection>
- <title>See Also</title>
- <para>
- <xref linkend="ST_ForcePolygonCW"/>,
- <xref linkend="ST_IsPolygonCCW"/>,
- <xref linkend="ST_IsPolygonCW"/>
- </para>
- </refsection>
- </refentry>
-
<refentry xml:id="ST_Force_Collection">
<refnamediv>
<refname>ST_ForceCollection</refname>
@@ -936,6 +887,109 @@ GEOMETRYCOLLECTION(
</refsection>
</refentry>
+
+ <refentry xml:id="ST_ForceCurve">
+ <refnamediv>
+ <refname>ST_ForceCurve</refname>
+
+ <refpurpose>Upcast a geometry into its curved type, if applicable.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry
+ <function>ST_ForceCurve</function></funcdef>
+ <paramdef><type>geometry</type> <parameter>g</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>
+ Turns a geometry into its curved representation, if applicable:
+ lines become compoundcurves, multilines become multicurves
+ polygons become curvepolygons multipolygons become multisurfaces. If the geometry input is already a curved representation returns back same as input.
+ </para>
+
+ <para role="availability" conformance="2.2.0">Availability: 2.2.0</para>
+ <para>&Z_support;</para>
+ <!-- Optionally mention Circular String Support -->
+ <para>&curve_support;</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT ST_AsText(
+ ST_ForceCurve(
+ 'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 2))'::geometry
+ )
+);
+ st_astext
+----------------------------------------------------------------------
+ CURVEPOLYGON Z ((0 0 2,5 0 2,0 5 2,0 0 2),(1 1 2,1 3 2,3 1 2,1 1 2))
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="ST_LineToCurve"/></para>
+ </refsection>
+ </refentry>
+
+ <refentry xml:id="ST_ForcePolygonCCW">
+ <refnamediv>
+ <refname>
+ ST_ForcePolygonCCW
+ </refname>
+ <refpurpose>
+ Orients all exterior rings counter-clockwise and all interior rings clockwise.
+ </refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>
+ geometry
+ <function>ST_ForcePolygonCCW</function>
+ </funcdef>
+ <paramdef>
+ <type>geometry</type>
+ <parameter>geom</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>
+ Forces (Multi)Polygons to use a counter-clockwise orientation for
+ their exterior ring, and a clockwise orientation for their interior
+ rings. Non-polygonal geometries are returned unchanged.
+ </para>
+
+ <para role="availability" conformance="2.4.0">Availability: 2.4.0</para>
+ <para>&Z_support;</para>
+ <para>&M_support;</para>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+ <para>
+ <xref linkend="ST_ForcePolygonCW"/>,
+ <xref linkend="ST_IsPolygonCCW"/>,
+ <xref linkend="ST_IsPolygonCW"/>
+ </para>
+ </refsection>
+ </refentry>
+
<refentry xml:id="ST_ForcePolygonCW">
<refnamediv>
<refname>
@@ -1083,58 +1137,55 @@ GEOMETRYCOLLECTION(
</refsection>
</refentry>
- <refentry xml:id="ST_ForceCurve">
- <refnamediv>
- <refname>ST_ForceCurve</refname>
+ <refentry xml:id="ST_LineExtend">
+ <refnamediv>
+ <refname>ST_LineExtend</refname>
- <refpurpose>Upcast a geometry into its curved type, if applicable.</refpurpose>
- </refnamediv>
+ <refpurpose>Returns a line extended forwards and backwards by specified distances.</refpurpose>
+ </refnamediv>
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>geometry
- <function>ST_ForceCurve</function></funcdef>
- <paramdef><type>geometry</type> <parameter>g</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry <function>ST_LineExtend</function></funcdef>
+ <paramdef><type>geometry </type>
+ <parameter>line</parameter></paramdef>
+ <paramdef><type>float </type>
+ <parameter>distance_forward</parameter></paramdef>
+ <paramdef choice="opt"><type>float</type> <parameter>distance_backward=0.0</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
- <refsection>
- <title>Description</title>
+ <refsection>
+ <title>Description</title>
- <para>
- Turns a geometry into its curved representation, if applicable:
- lines become compoundcurves, multilines become multicurves
- polygons become curvepolygons multipolygons become multisurfaces. If the geometry input is already a curved representation returns back same as input.
- </para>
+ <para>Returns a line extended forwards and backwards by adding new start (and end) points at the given distance(s).
+ A distance of zero does not add a point.
+ Only non-negative distances are allowed.
+ The direction(s) of the added point(s) is determined by the first (and last) two distinct points of the line.
+ Duplicate points are ignored.
+ </para>
- <para role="availability" conformance="2.2.0">Availability: 2.2.0</para>
- <para>&Z_support;</para>
- <!-- Optionally mention Circular String Support -->
- <para>&curve_support;</para>
- </refsection>
+ <para role="availability" conformance="3.4.0">Availability: 3.4.0</para>
- <refsection>
- <title>Examples</title>
+ </refsection>
- <programlisting>SELECT ST_AsText(
- ST_ForceCurve(
- 'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 2))'::geometry
- )
-);
- st_astext
-----------------------------------------------------------------------
- CURVEPOLYGON Z ((0 0 2,5 0 2,0 5 2,0 0 2),(1 1 2,1 3 2,3 1 2,1 1 2))
-(1 row)</programlisting>
- </refsection>
+ <refsection>
+ <title>Example: Extends a line 5 units forward and 6 units backward</title>
- <refsection>
- <title>See Also</title>
+<programlisting>
+SELECT ST_AsText(ST_LineExtend('LINESTRING(0 0, 0 10)'::geometry, 5, 6));
+--------------------------------------------
+LINESTRING(0 -6,0 0,0 10,0 15)
+</programlisting>
+ </refsection>
- <para><xref linkend="ST_LineToCurve"/></para>
- </refsection>
- </refentry>
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="ST_LineSubstring"/>, <xref linkend="ST_LocateAlong"/>, <xref linkend="ST_Project"/></para>
+ </refsection>
+ </refentry>
<refentry xml:id="ST_LineToCurve">
<refnamediv>
@@ -1200,7 +1251,6 @@ FROM (SELECT ST_Translate(ST_Force3D(ST_Boundary(ST_Buffer(ST_Point(1,3), 2,2)))
<!-- Optionally add a "See Also" section -->
<refsection>
<title>See Also</title>
-
<para><xref linkend="ST_CurveToLine"/></para>
</refsection>
</refentry>
@@ -1245,75 +1295,6 @@ SELECT ST_AsText(ST_Multi('POLYGON ((10 30, 30 30, 30 10, 10 10, 10 30))'));
</refsection>
</refentry>
- <refentry xml:id="ST_LineExtend">
- <refnamediv>
- <refname>ST_LineExtend</refname>
-
- <refpurpose>Returns a line extended forwards and backwards by specified distance(s).</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>geometry <function>ST_LineExtend</function></funcdef>
- <paramdef><type>geometry </type>
- <parameter>line</parameter></paramdef>
- <paramdef><type>float </type>
- <parameter>distance_forward</parameter></paramdef>
- <paramdef choice="opt"><type>float</type> <parameter>distance_backward=0.0</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns a line extended forwards and backwards by adding new start (and end) points at the given distance(s).
- A distance of zero does not add a point.
- Only non-negative distances are allowed.
- The direction(s) of the added point(s) is determined by the first (and last) two distinct points of the line.
- Duplicate points are ignored.
- </para>
-
- <para role="availability" conformance="3.4.0">Availability: 3.4.0</para>
-
- </refsection>
-
- <refsection>
- <title>Example: Extends a line 5 units forward and 6 units backward</title>
-
-<programlisting>
-SELECT ST_AsText(ST_LineExtend('LINESTRING(0 0, 0 10)'::geometry, 5, 6));
---------------------------------------------
-LINESTRING(0 -6,0 0,0 10,0 15)
-</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="ST_LocateAlong"/>, <xref linkend="ST_Project"/></para>
- </refsection>
- </refentry>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<refentry xml:id="ST_Normalize">
diff --git a/doc/reference_lrs.xml b/doc/reference_lrs.xml
index ac33725c5..46ceb15ed 100644
--- a/doc/reference_lrs.xml
+++ b/doc/reference_lrs.xml
@@ -478,7 +478,7 @@ geom_sub | LINESTRING(-102.530462 36.819064,-86.817324 39.585927)
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_Length"/>, <xref linkend="ST_LineInterpolatePoint"/>, <xref linkend="ST_LineMerge"/></para>
+ <para><xref linkend="ST_Length"/>, <xref linkend="ST_LineExtend"/>, <xref linkend="ST_LineInterpolatePoint"/>, <xref linkend="ST_LineMerge"/></para>
</refsection>
</refentry>
-----------------------------------------------------------------------
Summary of changes:
doc/reference_editor.xml | 305 ++++++++++++++++++++++-------------------------
doc/reference_lrs.xml | 2 +-
2 files changed, 144 insertions(+), 163 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list