From: Bruce Momjian <bruce@momjian.us>
Date: Sat, 25 Jan 2014 19:32:48 +0000 (-0500)
Subject: docs: mention CREATE TABLE LIKE linkage using INCLUDING DEFAULTS
X-Git-Tag: REL9_4_BETA1~622
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e2989fcab6150da5b4296eb1481284ad2825892e;p=thirdparty%2Fpostgresql.git

docs: mention CREATE TABLE LIKE linkage using INCLUDING DEFAULTS

Mention that CREATE TABLE LIKE INCLUDING DEFAULTS creates a link between
the original and new tables if a default function modifies the database,
like nextval().
---

diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index a422edd2313..e0b8a4ecaf6 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -329,7 +329,10 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI
      </para>
      <para>
       Default expressions for the copied column definitions will only be
-      copied if <literal>INCLUDING DEFAULTS</literal> is specified.  The
+      copied if <literal>INCLUDING DEFAULTS</literal> is specified. 
+      Defaults that call database-modification functions, like
+      <function>nextval</>, create a linkage between the original and
+      new tables.  The
       default behavior is to exclude default expressions, resulting in the
       copied columns in the new table having null defaults.
      </para>