Use "TOAST table" in place of the vague, not-used-elsewhere phrase
authorTom Lane
Thu, 13 May 2010 18:54:18 +0000 (18:54 +0000)
committerTom Lane
Thu, 13 May 2010 18:54:18 +0000 (18:54 +0000)
"supplementary storage table".

doc/src/sgml/ref/alter_table.sgml
doc/src/sgml/ref/create_table.sgml

index 16007ef2734389f272d7df80948c08c1453a29d0..f81dd576bd46ca0c01f5a3a2b2cbd89718abbe4c 100644 (file)
@@ -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.
index 064656bbc5d331c25112ed94614b5b40ff5da880..d195c5de68904e535a7063e1178b6697b7007e04 100644 (file)
@@ -1,5 +1,5 @@
 
 
@@ -152,7 +152,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE 
       table is going to be used in complex queries, it is wise to run
       ANALYZE on the temporary table after it is populated.
      
-      
+
      
       Optionally, GLOBAL or LOCAL
       can be written before TEMPORARY or TEMP.
@@ -803,13 +803,15 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE 
     for tables, and for indexes associated with a 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 
       original, which is more efficient than placing it on a different page.
       For a table whose entries are never updated, complete packing is the
       best choice, but in heavily updated tables smaller fillfactors are
-      appropriate.  This parameter cannot be set for the supplementary
-      storage table.
+      appropriate.  This parameter cannot be set for TOAST tables.