[postgis-tickets] [SCM] PostGIS branch master updated. 3.3.0rc2-91-g2b7a260de

[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  2b7a260de90529cc776f1f8036eae4b668185aa6 (commit)
      from  6544f76965987c5f5d471195c0d464773704c760 (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 2b7a260de90529cc776f1f8036eae4b668185aa6
Author: Martin Davis <mtnclimb at gmail.com>
Date:   Wed Sep 14 13:58:05 2022 -0700

    Add doc ST_Contains diagrams

diff --git a/doc/html/image_src/Makefile.in b/doc/html/image_src/Makefile.in
index 75a57f388..0cd38c142 100644
--- a/doc/html/image_src/Makefile.in
+++ b/doc/html/image_src/Makefile.in
@@ -61,6 +61,8 @@ IMAGES= \
 	../images/st_contains04.png \
 	../images/st_contains05.png \
 	../images/st_contains06.png \
+	../images/st_contains07.png \
+	../images/st_contains08.png \
 	../images/st_concavehull01.png \
 	../images/st_concavehull02.png \
 	../images/st_convexhull01.png \
diff --git a/doc/html/image_src/st_contains07.wkt b/doc/html/image_src/st_contains07.wkt
new file mode 100644
index 000000000..1287ae2ad
--- /dev/null
+++ b/doc/html/image_src/st_contains07.wkt
@@ -0,0 +1,2 @@
+ArgA;LINESTRING ( 10 190, 60 80, 130 120, 190 10 )
+ArgB;POINT (190 10)
diff --git a/doc/html/image_src/st_contains08.wkt b/doc/html/image_src/st_contains08.wkt
new file mode 100644
index 000000000..a9af22e7e
--- /dev/null
+++ b/doc/html/image_src/st_contains08.wkt
@@ -0,0 +1,2 @@
+ArgA;POLYGON (( 10 130, 50 190, 110 190, 140 150, 150 80, 100 10, 20 40, 10 130 ))
+ArgB;LINESTRING (80 190, 110 190, 140 150, 150 80)
diff --git a/doc/reference_relationship.xml b/doc/reference_relationship.xml
index 06f106c82..db4c35f5b 100644
--- a/doc/reference_relationship.xml
+++ b/doc/reference_relationship.xml
@@ -226,6 +226,37 @@
       </tgroup>
     </informaltable>
 
+    <para>Due to the interior intersection condition <function>ST_Contains</function> returns <varname>FALSE</varname> in the following situations
+     (whereas <function>ST_Covers</function> returns <varname>TRUE</varname>):</para>
+
+    <informaltable>
+      <tgroup cols="2">
+      <tbody>
+        <row>
+        <entry><para><informalfigure>
+          <mediaobject>
+            <imageobject>
+            <imagedata fileref="images/st_contains07.png" />
+            </imageobject>
+
+            <caption><para><varname>LINESTRING</varname> / <varname>POINT</varname></para></caption>
+          </mediaobject>
+          </informalfigure></para></entry>
+
+        <entry><para><informalfigure>
+          <mediaobject>
+            <imageobject>
+            <imagedata fileref="images/st_contains08.png" />
+            </imageobject>
+
+            <caption><para><varname>POLYGON</varname> / <varname>LINESTRING</varname></para></caption>
+          </mediaobject>
+          </informalfigure></para></entry>
+        </row>
+      </tbody>
+      </tgroup>
+    </informaltable>
+
       <programlisting>
 -- A circle within a circle
 SELECT ST_Contains(smallc, bigc) As smallcontainsbig,

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

Summary of changes:
 doc/html/image_src/Makefile.in                     |  2 ++
 .../{st_contains01.wkt => st_contains07.wkt}       |  2 +-
 .../{st_contains06.wkt => st_contains08.wkt}       |  2 +-
 doc/reference_relationship.xml                     | 31 ++++++++++++++++++++++
 4 files changed, 35 insertions(+), 2 deletions(-)
 copy doc/html/image_src/{st_contains01.wkt => st_contains07.wkt} (60%)
 copy doc/html/image_src/{st_contains06.wkt => st_contains08.wkt} (61%)


hooks/post-receive
-- 
PostGIS