Documentation improvements.

diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index b650ce24e45f2e10a63c8a1d9f54f42dbf18682c..114fbaafa3858ff2891086a096686ac6c3bebcc5 100644 (file)
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -1,5 +1,5 @@
 
 
@@ -19,7 +19,7 @@ PostgreSQL documentation
   
    clusterdb
    connection-options
-   --table | -t 'table 
+   --table | -t table 
    dbname
    
    clusterdb
@@ -33,8 +33,11 @@ PostgreSQL documentation
   Description
 
   
-   clusterdb is a utility for clustering tables inside a
-   PostgreSQL database.
+   clusterdb is a utility for re-clustering tables
+   in a PostgreSQL database.  It finds table(s)
+   that have previously been clustered, and clusters them again on the same
+   index that was last used.  Tables that have never been clustered are not
+   touched.
   
 
   
@@ -52,8 +55,9 @@ PostgreSQL documentation
 
   
   clusterdb will need to connect several times to the
-  PostgreSQL server, asking for the password each
-  time. It will probably be very convenient to have a PGPASSWORDFILE in that case.
+  PostgreSQL server.  If you are using password
+  authentication, it will ask for the password each time. It will probably be
+  very convenient to have a PGPASSWORDFILE in that case.