Editorialization for the additions to the CREATE TABLE reference page

made as part of the recent INCLUDING CONSTRAINTS patch. The text could
stand further improvement, but this is at least a step in the right
direction.

diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 916f0c8b568e5e1b22f45516267ce5b73a0acd76..0276dc7ad23fba17374b32210556b49d1ebece0f 100644 (file)
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -1,5 +1,5 @@
 
 
@@ -249,19 +249,19 @@ and table_constraint is:
      
       Default expressions for the copied column definitions will only be
       copied if INCLUDING DEFAULTS is specified.  The
-      default behavior is to exclude default expressions, resulting in
-      all columns of the new table having null defaults.
+      default behavior is to exclude default expressions, resulting in the
+      copied columns in the new table having null defaults.
      
      
-      Likewise constraints for the copied column definitions will only be
-      copied if INCLUDING CONSTRAINTS is specified. Note
-      that currently even when INCLUDING CONSTRAINTS is specified
-      only CHECK constraints are copied. Also, no distinction is made between
-      column constraints and table constraints -- when constraints are
-      requested all check constraints are copied.
+      Not-null constraints are always copied to the new table.
+      CHECK constraints will only be copied if
+      INCLUDING CONSTRAINTS is specified; other types of
+      constraints will never be copied. Also, no distinction is made between
+      column constraints and table constraints — when constraints are
+      requested, all check constraints are copied.
      
      
-      Note also that unlike INHERITS<literal> copied columns and
+      Note also that unlike INHERITS</literal>, copied columns and
       constraints are not merged with similarly named columns and constraints.
       If the same name is specified explicitly or in another
       LIKE clause an error is signalled.