[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0alpha1-117-g4e431eb

[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  4e431eb6b4b63ced545d66641236bcac855b8fba (commit)
      from  4d064baf7cf1b61bbf4649af0c8501ec7f286ccf (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 4e431eb6b4b63ced545d66641236bcac855b8fba
Author: Regina Obe <lr at pcorp.us>
Date:   Mon May 11 19:22:17 2020 -0400

    Add note that ST_Point and ST_MakePoint are faster for points as pointed out by God

diff --git a/doc/reference_input.xml b/doc/reference_input.xml
index a275a00..9087f13 100644
--- a/doc/reference_input.xml
+++ b/doc/reference_input.xml
@@ -383,6 +383,43 @@ SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE(
 			<para>&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite.</para>
 			<para>&sqlmm_compliant; SQL-MM 3: 5.1.40</para>
 			<para>&curve_support;</para>
+
+	<refentry id="ST_GeomFromText">
+		  <refnamediv>
+			<refname>ST_GeomFromText</refname>
+			<refpurpose>Return a specified ST_Geometry value from Well-Known Text representation (WKT).</refpurpose>
+		  </refnamediv>
+		  <refsynopsisdiv>
+			<funcsynopsis>
+			  <funcprototype>
+				<funcdef>geometry <function>ST_GeomFromText</function></funcdef>
+				<paramdef><type>text </type> <parameter>WKT</parameter></paramdef>
+			  </funcprototype>
+			  <funcprototype>
+				<funcdef>geometry <function>ST_GeomFromText</function></funcdef>
+				<paramdef><type>text </type> <parameter>WKT</parameter></paramdef>
+				<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>
+			  </funcprototype>
+			</funcsynopsis>
+		  </refsynopsisdiv>
+
+		  <refsection>
+			<title>Description</title>
+
+			<para>Constructs a PostGIS ST_Geometry object from the OGC Well-Known text representation.</para>
+
+			<!-- optionally mention that this function uses indexes if appropriate -->
+			<note>
+				<para>There are two variants of ST_GeomFromText function.  The first takes no SRID and returns a geometry
+					with no defined spatial reference system (SRID=0).  The second takes a SRID as the second argument
+					and returns a geometry that includes this SRID as part of its metadata.
+				</para>
+			</note>
+
+			<para>&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite.</para>
+			<para>&sqlmm_compliant; SQL-MM 3: 5.1.40</para>
+			<para>&curve_support;</para>
+            <note><para>While not OGC-compliant, <xref linkend="ST_MakePoint" /> is faster than ST_GeomFromText and ST_PointFromText. It is also easier to use for numeric coordinate values. <xref linkend="ST_Point" /> is another option similar in speed to <xref linkend="ST_Point" /> and is OGC-compliant, but doesn't support anything but 2D points.</para></note>
 			<warning><para>Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed.  This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards. This should now be
 			    written as ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')</para></warning>
 

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

Summary of changes:
 doc/reference_input.xml | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)


hooks/post-receive
-- 
PostGIS