From 505d9be3e66362ab52cadc5f9236a56cc4725ed0 Mon Sep 17 00:00:00 2001
From: Neil Conway <neilc@samurai.com>
Date: Thu, 23 Sep 2004 03:43:57 +0000
Subject: [PATCH] Update CREATE TABLE AS docs to reflect the fact that CREATE
 TABLE AS was added to the SQL:2003 standard.

---
 doc/src/sgml/ref/create_table_as.sgml | 35 ++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 6 deletions(-)

diff --git a/doc/src/sgml/ref/create_table_as.sgml b/doc/src/sgml/ref/create_table_as.sgml
index 6c7566781b..2e0115e87d 100644
--- a/doc/src/sgml/ref/create_table_as.sgml
+++ b/doc/src/sgml/ref/create_table_as.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.23 2004/08/24 00:06:51 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.24 2004/09/23 03:43:57 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -166,11 +166,34 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable>table_name
   <title>Compatibility</title>
 
   <para>
-   This command is modeled after an <productname>Oracle</productname>
-   feature.  There is no command with equivalent functionality in
-   the SQL standard.  However, a combination of <literal>CREATE
-   TABLE</literal> and <literal>INSERT ... SELECT</literal> can
-   accomplish the same thing with little more effort.
+   <command>CREATE TABLE AS</command> is specified by the SQL2003
+   standard. There are some small differences between the definition
+   of the command in SQL2003 and its implementation in
+   <productname>PostgreSQL</>:
+
+   <itemizedlist spacing="compact">
+    <listitem>
+     <para>
+      The standard requires parentheses around the subquery clause; in
+      <productname>PostgreSQL</productname>, these parentheses are
+      optional.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      The standard defines an <literal>ON COMMIT</literal> clause;
+      this is not currently implemented by <productname>PostgreSQL</>.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      The standard defines a <literal>WITH DATA</literal> clause;
+      this is not currently implemented by <productname>PostgreSQL</>.
+     </para>
+    </listitem>
+   </itemizedlist>
   </para>
  </refsect1>