From 1d81c093db81f63727436c736d9d27b7bedb4b66 Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Sat, 3 Feb 2018 10:19:57 -0500
Subject: [PATCH] doc: Clarify psql --list documentation a bit more

---
 doc/src/sgml/ref/psql-ref.sgml | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 7ea7edc3d1..6f9b30b673 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -283,11 +283,17 @@ EOF
       <listitem>
       <para>
       List all available databases, then exit. Other non-connection
-      options are ignored. If an explicit database name is not
-      found the <literal>postgres</literal> database, not the user's,
-      will be targeted for connection. This is similar to the meta-command
+      options are ignored. This is similar to the meta-command
       <command>\list</command>.
       </para>
+
+      <para>
+      When this option is used, <application>psql</application> will connect
+      to the database <literal>postgres</literal>, unless a different database
+      is named on the command line (option <option>-d</option> or non-option
+      argument, possibly via a service entry, but not via an environment
+      variable).
+      </para>
       </listitem>
     </varlistentry>
 
-- 
2.39.5