diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml
index 5bcb5439386..eb5292cdc41 100644
--- a/doc/src/sgml/ref/createdb.sgml
+++ b/doc/src/sgml/ref/createdb.sgml
@@ -1,5 +1,5 @@
@@ -40,7 +40,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/createlang.sgml b/doc/src/sgml/ref/createlang.sgml
index 87d27442e96..3e8242481f6 100644
--- a/doc/src/sgml/ref/createlang.sgml
+++ b/doc/src/sgml/ref/createlang.sgml
@@ -1,5 +1,5 @@
@@ -85,7 +85,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index 9c7a3a26244..2a735900a54 100644
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -1,5 +1,5 @@
@@ -39,7 +39,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml
index 1eb4c4f46fa..ab57c8c883b 100644
--- a/doc/src/sgml/ref/dropdb.sgml
+++ b/doc/src/sgml/ref/dropdb.sgml
@@ -1,5 +1,5 @@
@@ -39,7 +39,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/droplang.sgml b/doc/src/sgml/ref/droplang.sgml
index 2346a0d32d5..531d9859f70 100644
--- a/doc/src/sgml/ref/droplang.sgml
+++ b/doc/src/sgml/ref/droplang.sgml
@@ -1,5 +1,5 @@
@@ -85,7 +85,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml
index 7f8f7899e59..7b2a2ee9d4f 100644
--- a/doc/src/sgml/ref/dropuser.sgml
+++ b/doc/src/sgml/ref/dropuser.sgml
@@ -1,5 +1,5 @@
@@ -39,7 +39,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 4406ea94f09..1e5c70006da 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1,5 +1,5 @@
@@ -199,8 +199,8 @@ pg_dump [ -h host ]
Specifies the hostname of the machine on which the
postmaster
- is running. Defaults to using a local Unix domain socket
- rather than an IP connection.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index f6999059d1f..a75a0c5e1c4 100644
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -1,5 +1,5 @@
@@ -143,8 +143,8 @@ pg_dumpall [ -h host ] [ -p
Specifies the hostname of the machine on which the
postmaster
- is running. Defaults to using a local Unix domain socket
- rather than an IP connection..
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index dd5f4a1bca7..1af53a47384 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -307,8 +307,8 @@ pg_restore [ archive-file ]
Specifies the hostname of the machine on which the
postmaster
- is running. Defaults to using a local Unix domain socket
- rather than an IP connection.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/postmaster.sgml b/doc/src/sgml/ref/postmaster.sgml
index e8e34c739ff..38f3f8e2107 100644
--- a/doc/src/sgml/ref/postmaster.sgml
+++ b/doc/src/sgml/ref/postmaster.sgml
@@ -1,5 +1,5 @@
@@ -132,23 +132,22 @@ postmaster [ -B nBuffers ] [ -D postmaster
is to listen for connections from frontend applications. Defaults to
- the value of the
- PGHOST
+ the value of the PGHOST
environment variable, or if PGHOST
- is not set, then defaults to "all", meaning listen on all configured addresses
+ is not set, it defaults to listening on all configured addresses
(including localhost).
- If you use a hostname or address other than "all", do not try to run
+ If you use a hostname do not try to run
multiple instances of postmaster on the
same IP address but different ports. Doing so will result in them
attempting (incorrectly) to use the same shared memory segments.
- Also, if you use a hostname other than "all", all of the host's IP addresses
+ Also, if you use a hostname, all of the host's IP addresses
on which postmaster instances are
listening must be distinct in the two last octets.
- If you do use "all" (the default), then each instance must listen on a
+ If you don't use this option, each instance must listen on a
different port (via -p or PGPORT). And, of course, do
not try to use both approaches on one host.
diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 1780fcfcc8b..69075391d6a 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1,5 +1,5 @@
@@ -1322,8 +1322,8 @@ Access permissions for database "test"
Specifies the host name of the machine on which the
postmaster is running.
- Without this option, communication is performed using
- local Unix domain sockets.
+ If host begins with a slash, it is used
+ as the path to a unix domain socket.
diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml
index 28151190a73..69e9888f56f 100644
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -1,5 +1,5 @@
@@ -119,7 +119,8 @@ Postgres documentation
Specifies the hostname of the machine on which the
postmaster
- is running.
+ is running. If host begins with a slash, it is used
+ as the path to a unix domain socket.