From: Bruce Momjian <bruce@momjian.us>
Date: Fri, 12 Aug 2022 14:59:00 +0000 (-0400)
Subject: doc:  clarify CREATE TABLE AS ... IF NOT EXISTS
X-Git-Tag: REL_12_13~94
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4e32fb1631dc6a7e0bb21b2e4ac77299231c2745;p=thirdparty%2Fpostgresql.git

doc:  clarify CREATE TABLE AS ... IF NOT EXISTS

Mention that the table is not modified if it already exists.

Reported-by: frank_limpert@yahoo.com

Discussion: https://postgr.es/m/164441177106.9677.5991676148704507229@wrigleys.postgresql.org

Backpatch-through: 10
---

diff --git a/doc/src/sgml/ref/create_table_as.sgml b/doc/src/sgml/ref/create_table_as.sgml
index 56d06838f16..5361412df02 100644
--- a/doc/src/sgml/ref/create_table_as.sgml
+++ b/doc/src/sgml/ref/create_table_as.sgml
@@ -95,9 +95,8 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI
     <term><literal>IF NOT EXISTS</literal></term>
     <listitem>
      <para>
-      Do not throw an error if a relation with the same name already exists.
-      A notice is issued in this case. Refer to <xref linkend="sql-createtable"/>
-      for details.
+      Do not throw an error if a relation with the same name already
+      exists; simply issue a notice and leave the table unmodified.
      </para>
     </listitem>
    </varlistentry>