From 37464a0326167ad57e54eb8aab2ae1f553252c39 Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Mon, 18 Jul 2005 22:34:14 +0000
Subject: [PATCH] Fix some bogosities in geometric-function documentation: add
 an entry for circle(polygon), which was missing; remove bogus entry for
 point(lseg, lseg), which does not exist, and the documentation seemed to
 describe lseg_interpt, which we already document as an operator not a
 function.  Also remove entry for box_intersect, which likewise is
 preferentially used via the operator #.

---
 doc/src/sgml/func.sgml | 23 +++++++++--------------
 1 file changed, 9 insertions(+), 14 deletions(-)

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 25e37f80a2..9fd6ed61f8 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.266 2005/07/15 19:02:12 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.267 2005/07/18 22:34:14 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -5886,7 +5886,8 @@ SELECT TIMESTAMP 'now';  -- incorrect for use with DEFAULT
      Note that the <quote>same as</> operator, <literal>~=</>, represents
      the usual notion of equality for the <type>point</type>,
      <type>box</type>, <type>polygon</type>, and <type>circle</type> types.
-     Some of these types also have an <literal>=</> operator, but it compares
+     Some of these types also have an <literal>=</> operator, but
+     <literal>=</> compares
      for equal <emphasis>areas</> only.  The other scalar comparison operators
      (<literal>&lt;=</> and so on) likewise compare areas for these types.
     </para>
@@ -6081,12 +6082,6 @@ SELECT TIMESTAMP 'now';  -- incorrect for use with DEFAULT
         <entry>area</entry>
         <entry><literal>area(box '((0,0),(1,1))')</literal></entry>
        </row>
-       <row>
-        <entry><literal><function>box_intersect</function>(<type>box</>, <type>box</>)</literal></entry>
-        <entry><type>box</type></entry>
-        <entry>intersection box</entry>
-        <entry><literal>box_intersect(box '((0,0),(1,1))',box '((0.5,0.5),(2,2))')</literal></entry>
-       </row>
        <row>
         <entry><literal><function>center</function>(<replaceable>object</>)</literal></entry>
         <entry><type>point</type></entry>
@@ -6215,6 +6210,12 @@ SELECT TIMESTAMP 'now';  -- incorrect for use with DEFAULT
         <entry>center and radius to circle</entry>
         <entry><literal>circle(point '(0,0)', 2.0)</literal></entry>
        </row>
+       <row>
+        <entry><literal><function>circle</function>(<type>polygon</type>)</literal></entry>
+        <entry><type>circle</type></entry>
+        <entry>polygon to circle</entry>
+        <entry><literal>circle(polygon '((0,0),(1,1),(2,0))')</literal></entry>
+       </row>
        <row>
         <entry><literal><function>lseg</function>(<type>box</type>)</literal></entry>
         <entry><type>lseg</type></entry>
@@ -6258,12 +6259,6 @@ SELECT TIMESTAMP 'now';  -- incorrect for use with DEFAULT
         <entry>center of lseg</entry>
         <entry><literal>point(lseg '((-1,0),(1,0))')</literal></entry>
        </row>
-       <row>
-        <entry><literal><function>point</function>(<type>lseg</type>, <type>lseg</type>)</literal></entry>
-        <entry><type>point</type></entry>
-        <entry>intersection</entry>
-        <entry><literal>point(lseg '((-1,0),(1,0))', lseg '((-2,-2),(2,2))')</literal></entry>
-       </row>
        <row>
         <entry><literal><function>point</function>(<type>polygon</type>)</literal></entry>
         <entry><type>point</type></entry>