aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/func.sgml18
1 files changed, 17 insertions, 1 deletions
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 82081e514fa..a5d81b6fddc 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.205 2004/05/26 18:35:31 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.206 2004/06/02 21:34:49 momjian Exp $
PostgreSQL documentation
-->
@@ -5971,6 +5971,22 @@ SELECT TIMESTAMP 'now';
as an array of two <type>point</> values.
</para>
+ <para>
+ The <function>area</function> function works for the types
+ <type>box</type>, <type>circle</type>, and <type>path</type>.
+ The <function>area</function> function only works on the
+ <type>path</type> data type if the points in the
+ <type>path</type> are non-intersecting. For example, the
+ <type>path</type>
+ <literal>'((0,0),(0,1),(2,1),(2,2),(1,2),(1,0),(0,0))'::PATH</literal>
+ won't work, however, the following visually identical
+ <type>path</type>
+ <literal>'((0,0),(0,1),(1,1),(1,2),(2,2),(2,1),(1,1),(1,0),(0,0))'::PATH</literal>
+ will work. If the concept of an intersecting versus
+ non-intersecting <type>path</type> is confusing, draw both of the
+ above <type>path</type>s side by side on a piece of graph paper.
+ </para>
+
</sect1>