diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index bc140c35667..431701d2ecf 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -656,10 +656,15 @@ include_dir 'conf.d'
:: allows listening for all IPv6 addresses.
If the list is empty, the server does not listen on any IP interface
at all, in which case only Unix-domain sockets can be used to connect
- to it.
+ to it. If the list is not empty, the server will start if it
+ can listen on at least one TCP/IP address. A warning will be
+ emitted for any TCP/IP address which cannot be opened.
The default value is localhost,
which allows only local TCP/IP loopback
connections to be
- made. While client authentication (
+
+ While client authentication () allows fine-grained control
over who can access the server, listen_addresses
controls which interfaces accept connection attempts, which