summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Rowley <drowley@postgresql.org>2025-04-22 14:58:09 +1200
committerDavid Rowley <drowley@postgresql.org>2025-04-22 14:58:09 +1200
commitc5ba351864d683597af70877f041b51c3a7154e0 (patch)
tree4daf3b49d336614cb35541edc12f24ec9e68535c
parent4399d1055627fe5ffaba47cf6ad6d07af3905e16 (diff)
Doc: reword text explaining the --maintenance-db option
The previous text was a little clumsy. Here we improve that. Author: David Rowley <dgrowleyml@gmail.com> Reported-by: Noboru Saito <noborusai@gmail.com> Reviewed-by: David G. Johnston <david.g.johnston@gmail.com> Discussion: https://postgr.es/m/CAAM3qnJtv5YbjpwDfVOYN2gZ9zGSLFM1UGJgptSXmwfifOZJFQ@mail.gmail.com Backpatch-through: 13
-rw-r--r--doc/src/sgml/ref/clusterdb.sgml5
-rw-r--r--doc/src/sgml/ref/reindexdb.sgml5
-rw-r--r--doc/src/sgml/ref/vacuumdb.sgml5
3 files changed, 6 insertions, 9 deletions
diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index c838b22c440..b81bc2dc48e 100644
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -249,9 +249,8 @@ PostgreSQL documentation
<term><option>--maintenance-db=<replaceable class="parameter">dbname</replaceable></option></term>
<listitem>
<para>
- Specifies the name of the database to connect to to discover which
- databases should be clustered,
- when <option>-a</option>/<option>--all</option> is used.
+ When the <option>-a</option>/<option>--all</option> is used, connect
+ to this database to gather the list of databases to cluster.
If not specified, the <literal>postgres</literal> database will be used,
or if that does not exist, <literal>template1</literal> will be used.
This can be a <link linkend="libpq-connstring">connection
diff --git a/doc/src/sgml/ref/reindexdb.sgml b/doc/src/sgml/ref/reindexdb.sgml
index dd1c9e52743..309951e46ff 100644
--- a/doc/src/sgml/ref/reindexdb.sgml
+++ b/doc/src/sgml/ref/reindexdb.sgml
@@ -351,9 +351,8 @@ PostgreSQL documentation
<term><option>--maintenance-db=<replaceable class="parameter">dbname</replaceable></option></term>
<listitem>
<para>
- Specifies the name of the database to connect to to discover which
- databases should be reindexed,
- when <option>-a</option>/<option>--all</option> is used.
+ When the <option>-a</option>/<option>--all</option> is used, connect
+ to this database to gather the list of databases to reindex.
If not specified, the <literal>postgres</literal> database will be used,
or if that does not exist, <literal>template1</literal> will be used.
This can be a <link linkend="libpq-connstring">connection
diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml
index 61c2e7d2373..62c05ecab20 100644
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -444,9 +444,8 @@ PostgreSQL documentation
<term><option>--maintenance-db=<replaceable class="parameter">dbname</replaceable></option></term>
<listitem>
<para>
- Specifies the name of the database to connect to to discover which
- databases should be vacuumed,
- when <option>-a</option>/<option>--all</option> is used.
+ When the <option>-a</option>/<option>--all</option> is used, connect
+ to this database to gather the list of databases to vacuum.
If not specified, the <literal>postgres</literal> database will be used,
or if that does not exist, <literal>template1</literal> will be used.
This can be a <link linkend="libpq-connstring">connection