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 #.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 25e37f80a20168a59e1a05aedba1365f961615ed..9fd6ed61f8eb3ddebd543d5d68f3fb786183cfe8 100644 (file)
--- 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>