Improvements to the SGML docs for TRUNCATE and CLUSTER.

diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml
index acb2468f7ba5d667406c9445a51dc7bcbd9dfc05..c181019b255000975615a2e9b3c521aec236fe08 100644 (file)
--- a/doc/src/sgml/ref/cluster.sgml
+++ b/doc/src/sgml/ref/cluster.sgml
@@ -1,5 +1,5 @@
 
 
@@ -45,7 +45,7 @@ CLUSTER
    not clustered.  That is, no attempt is made to store new or
    updated rows according to their index order.  (If one wishes, one can
    periodically recluster by issuing the command again.  Also, setting
-   the table's FILLFACTOR storage parameter to less than 100% can aid
+   the table's FILLFACTOR storage parameter to less than 100% can aid
    in preserving cluster ordering during updates, since updated rows
    are preferentially kept on the same page.)
   

diff --git a/doc/src/sgml/ref/truncate.sgml b/doc/src/sgml/ref/truncate.sgml
index 271d16af03e5082d590fb1c9d5ef9bb561093a49..3dca068b457f553d53f1a0e6cb21d04e5371a228 100644 (file)
--- a/doc/src/sgml/ref/truncate.sgml
+++ b/doc/src/sgml/ref/truncate.sgml
@@ -1,5 +1,5 @@
 
 
@@ -31,9 +31,9 @@ TRUNCATE [ TABLE ] name [, ...] [ C
    TRUNCATE quickly removes all rows from a set of
    tables. It has the same effect as an unqualified
    DELETE on each table, but since it does not actually
-   scan the tables it is faster; furthermore it reclaims disk space
-   immediately, rather than requiring a subsequent vacuum operation.
-   This is most useful on large tables.
+   scan the tables it is faster. Furthermore, it reclaims disk space
+   immediately, rather than requiring a subsequent VACUUM
+   operation. This is most useful on large tables.
   
  
   
@@ -86,35 +86,38 @@ TRUNCATE [ TABLE ] name [, ...] [ C
    in the same command.  Checking validity in such cases would require table
    scans, and the whole point is not to do one.  The CASCADE
    option can be used to automatically include all dependent tables —
-   but be very careful when using this option, else you might lose data you
+   but be very careful when using this option, or else you might lose data you
    did not intend to!
   
 
   
-   TRUNCATE will not run any user-defined ON
-   DELETE triggers that might exist for the tables.
+   TRUNCATE will not run any ON DELETE
+   triggers that might exist for the tables.
   
 
-  
-   TRUNCATE is not MVCC-safe (see 
-   for general information about MVCC).  After truncation, the table
-   will appear empty to all concurrent transactions, even if they are
-   using a snapshot taken before the truncation occurred.  This will
-   only be an issue for a transaction that did not touch the table
-   before the truncation started — any transaction that has done
-   so would hold at least ACCESS SHARE lock,
-   which would block
-   TRUNCATE until that transaction completes.  So
-   truncation will not cause any apparent inconsistency in the table
-   contents for successive queries on the same table, but it could
-   cause visible inconsistency between the contents of the
-   truncated table and other tables.
-  
-
-  
-   TRUNCATE is transaction-safe, however: the truncation
-   will roll back if the surrounding transaction does not commit.
-  
+  
+   
+    TRUNCATE is not MVCC-safe (see 
+     for general information about MVCC).  After truncation, the table
+     will appear empty to all concurrent transactions, even if they
+     are using a snapshot taken before the truncation occurred.  This
+     will only be an issue for a transaction that did not access the
+     truncated table before the truncation happened — any
+     transaction that has done so would hold at least an
+     ACCESS SHARE lock, which would block
+     TRUNCATE until that transaction completes.  So
+     truncation will not cause any apparent inconsistency in the table
+     contents for successive queries on the same table, but it could
+     cause visible inconsistency between the contents of the truncated
+     table and other tables in the database.
+   
+
+   
+    TRUNCATE is transaction-safe, however: the truncation
+    will be safely rolled back if the surrounding transaction does not
+    commit.
+   
+  
  
 
  
@@ -124,13 +127,13 @@ TRUNCATE [ TABLE ] name [, ...] [ C
    Truncate the tables bigtable and fattable:
 
 
-TRUNCATE TABLE bigtable, fattable;
+TRUNCATE bigtable, fattable;
 
   
 
   
    Truncate the table othertable, and cascade to any tables
-   that are referencing othertable via foreign-key
+   that reference othertable via foreign-key
    constraints: