[SCM] PostGIS branch master updated. 3.4.0rc1-742-g6adb29e43

[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  6adb29e43b5514be567c4f91b43c635ad9163948 (commit)
      from  826f7c73f81646c87f5d47466d5319368581c0a1 (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 6adb29e43b5514be567c4f91b43c635ad9163948
Author: Martin Davis <mtnclimb at gmail.com>
Date:   Wed Nov 1 13:10:52 2023 -0700

    Improve doc for ST_Point examples

diff --git a/doc/reference_constructor.xml b/doc/reference_constructor.xml
index ba281c5f1..77353a666 100644
--- a/doc/reference_constructor.xml
+++ b/doc/reference_constructor.xml
@@ -700,22 +700,23 @@ FROM provinces p;
 		<title>Examples: Geometry</title>
 
         <programlisting>SELECT ST_Point( -71.104, 42.315);</programlisting>
-        <programlisting>SELECT ST_SetSRID(ST_Point( -71.104, 42.315),4326);</programlisting>
 
-        <para>New in 3.2.0: With SRID specified</para>
+        <para>Creating a point with SRID specified:</para>
 		<programlisting>SELECT ST_Point( -71.104, 42.315, 4326);</programlisting>
+
+        <para>Alternative way of specifying SRID:</para>
+        <programlisting>SELECT ST_SetSRID( ST_Point( -71.104, 42.315), 4326);</programlisting>
 	  </refsection>
 
 	  <refsection>
 		<title>Examples: Geography</title>
-        <para>Pre-PostGIS 3.2 syntax</para>
-        <programlisting>SELECT CAST( ST_SetSRID(ST_Point( -71.104, 42.315), 4326) AS geography);</programlisting>
-        <para>3.2 and on you can include the srid</para>
-		<programlisting>SELECT CAST( ST_Point( -71.104, 42.315, 4326) AS geography);</programlisting>
 
-		<para>PostgreSQL also provides the <varname>::</varname> short-hand for casting</para>
+		<para>Create <link linkend="PostGIS_Geography">geography</link> points using the <varname>::</varname> cast syntax:</para>
 		<programlisting>SELECT ST_Point( -71.104, 42.315, 4326)::geography;</programlisting>
 
+        <para>Pre-PostGIS 3.2 code, using <varname>CAST</varname>:</para>
+        <programlisting>SELECT CAST( ST_SetSRID(ST_Point( -71.104, 42.315), 4326) AS geography);</programlisting>
+
 <para>If the point coordinates are not in a geodetic coordinate system (such as WGS84),
 then they must be reprojected before casting to a geography.
 In this example a point in Pennsylvania State Plane feet (SRID 2273)
@@ -728,7 +729,7 @@ SELECT ST_Transform( ST_Point( 3637510, 3014852, 2273), 4326)::geography;</progr
 	  <refsection>
 		<title>See Also</title>
 
-		<para><xref linkend="PostGIS_Geography"/>, <xref linkend="ST_MakePoint"/>, 
+		<para><xref linkend="ST_MakePoint"/>, 
 			<xref linkend="ST_PointZ"/>, <xref linkend="ST_PointM"/>, <xref linkend="ST_PointZM"/>, 
 			<xref linkend="ST_SetSRID"/>, <xref linkend="ST_Transform"/></para>
 	  </refsection>

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

Summary of changes:
 doc/reference_constructor.xml | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)


hooks/post-receive
-- 
PostGIS