Clarify the default partition's role

Reviewed by Tom Lane and Amit Langote
Discussion: https://postgr.es/m/20190806222735[email protected]

diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index a2c7adecf1d32d70f15b37c709d4f0f0df89a8f9..7cadd1a6aedff77e48f8d46b13138ecfd155531e 100644 (file)
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -397,8 +397,7 @@ WITH ( MODULUS numeric_literal, REM
       Creates the table as a partition of the specified
       parent table. The table can be created either as a partition for specific
       values using FOR VALUES or as a default partition
-      using DEFAULT.  This option is not available for
-      hash-partitioned tables.
+      using DEFAULT.
      
 
      
@@ -488,16 +487,15 @@ WITH ( MODULUS numeric_literal, REM
 
      
       If DEFAULT is specified, the table will be
-      created as a default partition of the parent table. The parent can
-      either be a list or range partitioned table. A partition key value
+      created as the default partition of the parent table.  This option
+      is not available for hash-partitioned tables.  A partition key value
       not fitting into any other partition of the given parent will be
-      routed to the default partition. There can be only one default
-      partition for a given parent table.
+      routed to the default partition.
      
 
      
       When a table has an existing DEFAULT partition and
-      a new partition is added to it, the existing default partition must
+      a new partition is added to it, the default partition must
       be scanned to verify that it does not contain any rows which properly
       belong in the new partition.  If the default partition contains a
       large number of rows, this may be slow.  The scan will be skipped if