diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index 16007ef273..f81dd576bd 100644
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -1,5 +1,5 @@
@@ -200,7 +200,8 @@ ALTER TABLE name
This form sets the storage mode for a column. This controls whether this
- column is held inline or in a supplementary table, and whether the data
+ column is held inline or in a secondary TOAST> table, and
+ whether the data
should be compressed or not. PLAIN must be used
for fixed-length values such as integer and is
inline, uncompressed. MAIN is for inline,
@@ -208,9 +209,9 @@ ALTER TABLE name
uncompressed data, and EXTENDED is for external,
compressed data. EXTENDED is the default for most
data types that support non-PLAIN storage.
- Use of EXTERNAL will
- make substring operations on text and bytea
- columns faster, at the penalty of increased storage space. Note that
+ Use of EXTERNAL will make substring operations on
+ very large text and bytea values run faster,
+ at the penalty of increased storage space. Note that
SET STORAGE> doesn't itself change anything in the table,
it just sets the strategy to be pursued during future table updates.
See for more information.
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 064656bbc5..d195c5de68 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -1,5 +1,5 @@
@@ -152,7 +152,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE UNIQUE,
PRIMARY KEY, or EXCLUDE> constraint.
Storage parameters for
- indexes are documented in . The storage parameters currently
+ indexes are documented in .
+ The storage parameters currently
available for tables are listed below. For each parameter, unless noted,
- there is an additional, identically named parameter, prefixed with
- toast. which can be used to control the behavior of the
- supplementary storage table, if any; see .
- Note that the supplementary storage table inherits the
- autovacuum values from its parent table, if there are
+ there is an additional parameter with the same name prefixed with
+ toast., which can be used to control the behavior of the
+ table's secondary TOAST> table, if any
+ (see for more information about TOAST).
+ Note that the TOAST table inherits the
+ autovacuum_* values from its parent table, if there are
no toast.autovacuum_* settings set.
@@ -828,8 +830,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE