Doc: reword text explaining the --maintenance-db option

The previous text was a little clumsy.  Here we improve that.

Author: David Rowley 
Reported-by: Noboru Saito 
Reviewed-by: David G. Johnston 
Discussion: https://postgr.es/m/CAAM3qnJtv5YbjpwDfVOYN2gZ9zGSLFM1UGJgptSXmwfifOZJFQ@mail.gmail.com
Backpatch-through: 13

diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index d3145318b361fb506c2f2a9739ad6309da3c8bb2..0d2051bf6f1880fd445af48bb27934748e7f8d0b 100644 (file)
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -248,9 +248,8 @@ PostgreSQL documentation
       --maintenance-db=dbname
       
        
-        Specifies the name of the database to connect to to discover which
-        databases should be clustered,
-        when -a/--all is used.
+        When the -a/--all is used, connect
+        to this database to gather the list of databases to cluster.
         If not specified, the postgres database will be used,
         or if that does not exist, template1 will be used.
         This can be a connection

diff --git a/doc/src/sgml/ref/reindexdb.sgml b/doc/src/sgml/ref/reindexdb.sgml
index 98c3333228fb9d5bcb8abb0845066c1c83f85501..abcb041179bb9dd37f6e817f0d077b5f609aa1d4 100644 (file)
--- a/doc/src/sgml/ref/reindexdb.sgml
+++ b/doc/src/sgml/ref/reindexdb.sgml
@@ -352,9 +352,8 @@ PostgreSQL documentation
       --maintenance-db=dbname
       
        
-        Specifies the name of the database to connect to to discover which
-        databases should be reindexed,
-        when -a/--all is used.
+        When the -a/--all is used, connect
+        to this database to gather the list of databases to reindex.
         If not specified, the postgres database will be used,
         or if that does not exist, template1 will be used.
         This can be a connection

diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml
index d102f9d48406c18512197989d643db6b9df8920b..b0680a61814cc9930535d78c87a4957dd6719266 100644 (file)
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -560,9 +560,8 @@ PostgreSQL documentation
       --maintenance-db=dbname
       
        
-        Specifies the name of the database to connect to to discover which
-        databases should be vacuumed,
-        when -a/--all is used.
+        When the -a/--all is used, connect
+        to this database to gather the list of databases to vacuum.
         If not specified, the postgres database will be used,
         or if that does not exist, template1 will be used.
         This can be a connection