[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0alpha2-52-g866293b

[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  866293b52cac266d75368c0f88a01ab4eae63b0a (commit)
      from  e6c9403689953350cc0bec69086fd49ee194f43f (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 866293b52cac266d75368c0f88a01ab4eae63b0a
Author: Darafei Praliaskouski <me at komzpa.net>
Date:   Sat Aug 15 10:21:46 2020 +0300

    Don't use ST_PointInsideCircle if you need indexes, use ST_DWithin instead.
    
    Closes #4741.

diff --git a/NEWS b/NEWS
index 8cd71f0..6b0b05e 100644
--- a/NEWS
+++ b/NEWS
@@ -21,7 +21,8 @@ Only tickets not included in 3.1.0alpha2
            Affects ANALYZE, _ST_PointOutside, postgis_geobbox, ST_CombineBbox(box2d, geometry),
            ST_ClipByBox2D when the geometry is fully inside or outside the bbox and
            ST_BoundingDiagonal.
-
+  - #4741, Don't use ST_PointInsideCircle if you need indexes, use ST_DWithin instead.
+           Documentation adjusted (Darafei Praliaskouski)
 
 * Bug fixes *
   - #4691, Fix segfault during gist index creation with empty geometries (Raúl Marín)
diff --git a/doc/reference_relationship.xml b/doc/reference_relationship.xml
index c415568..160e76c 100644
--- a/doc/reference_relationship.xml
+++ b/doc/reference_relationship.xml
@@ -1339,57 +1339,6 @@ FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 0.5)'), 3)  As a,
 	  </refsection>
 	</refentry>
 
-	<refentry id="ST_PointInsideCircle">
-	  <refnamediv>
-		<refname>ST_PointInsideCircle</refname>
-
-		<refpurpose>Is the point geometry inside the circle defined by center_x, center_y, radius</refpurpose>
-	  </refnamediv>
-
-	  <refsynopsisdiv>
-		<funcsynopsis>
-		  <funcprototype>
-			<funcdef>boolean <function>ST_PointInsideCircle</function></funcdef>
-			<paramdef><type>geometry </type> <parameter>a_point</parameter></paramdef>
-			<paramdef><type>float </type> <parameter>center_x</parameter></paramdef>
-			<paramdef><type>float </type> <parameter>center_y</parameter></paramdef>
-			<paramdef><type>float </type> <parameter>radius</parameter></paramdef>
-		  </funcprototype>
-		</funcsynopsis>
-	  </refsynopsisdiv>
-
-	  <refsection>
-		<title>Description</title>
-
-		<para>The syntax for this functions is
-			ST_PointInsideCircle(<geometry>,<circle_center_x>,<circle_center_y>,<radius>).
-			Returns the true if the geometry is a point and is inside the
-			circle. Returns false otherwise.</para>
-		<note><para>This only works for points as the name suggests</para></note>
-
-		<para>Availability: 1.2</para>
-		<para>Changed: 2.2.0 In prior versions this used to be called ST_Point_Inside_Circle</para>
-	  </refsection>
-
-
-	  <refsection>
-		<title>Examples</title>
-
-		<programlisting>SELECT ST_PointInsideCircle(ST_Point(1,2), 0.5, 2, 3);
- st_pointinsidecircle
-------------------------
- t
-</programlisting>
-	  </refsection>
-
-	  <!-- Optionally add a "See Also" section -->
-	  <refsection>
-		<title>See Also</title>
-
-		<para><xref linkend="ST_DWithin" /></para>
-	  </refsection>
-	</refentry>
-
 	<refentry id="ST_Relate">
 		<refnamediv>
 			<refname>ST_Relate</refname>
@@ -2131,6 +2080,57 @@ SELECT b.tower_id, b.geom
 	  </refsection>
 	</refentry>
 
+	<refentry id="ST_PointInsideCircle">
+	  <refnamediv>
+		<refname>ST_PointInsideCircle</refname>
+
+		<refpurpose>Is the point geometry inside the circle defined by center_x, center_y, radius</refpurpose>
+	  </refnamediv>
+
+	  <refsynopsisdiv>
+		<funcsynopsis>
+		  <funcprototype>
+			<funcdef>boolean <function>ST_PointInsideCircle</function></funcdef>
+			<paramdef><type>geometry </type> <parameter>a_point</parameter></paramdef>
+			<paramdef><type>float </type> <parameter>center_x</parameter></paramdef>
+			<paramdef><type>float </type> <parameter>center_y</parameter></paramdef>
+			<paramdef><type>float </type> <parameter>radius</parameter></paramdef>
+		  </funcprototype>
+		</funcsynopsis>
+	  </refsynopsisdiv>
+
+	  <refsection>
+		<title>Description</title>
+
+		<para>The syntax for this functions is
+			ST_PointInsideCircle(<geometry>,<circle_center_x>,<circle_center_y>,<radius>).
+			Returns the true if the geometry is a point and is inside the
+			circle. Returns false otherwise.</para>
+		<warning><para>Will not use spatial indexes. Use <xref linkend="ST_DWithin" /> instead.</para></warning>
+		<note><para>This only works for points as the name suggests.</para></note>
+
+		<para>Availability: 1.2</para>
+		<para>Changed: 2.2.0 In prior versions this used to be called ST_Point_Inside_Circle</para>
+	  </refsection>
+
+
+	  <refsection>
+		<title>Examples</title>
+
+		<programlisting>SELECT ST_PointInsideCircle(ST_Point(1,2), 0.5, 2, 3);
+ st_pointinsidecircle
+------------------------
+ t
+</programlisting>
+	  </refsection>
+
+	  <!-- Optionally add a "See Also" section -->
+	  <refsection>
+		<title>See Also</title>
+
+		<para><xref linkend="ST_DWithin" /></para>
+	  </refsection>
+	</refentry>
 
     </sect2>
 

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

Summary of changes:
 NEWS                           |   3 +-
 doc/reference_relationship.xml | 102 ++++++++++++++++++++---------------------
 2 files changed, 53 insertions(+), 52 deletions(-)


hooks/post-receive
-- 
PostGIS