From ab4725475745312608e93fa8aca694d28fab4798 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Mon, 13 Nov 2000 23:57:20 +0000
Subject: [PATCH] Add mention of hostname leading slash handling to all manual
 pages that use -h.

---
 doc/src/sgml/ref/createdb.sgml   |  5 +++--
 doc/src/sgml/ref/createlang.sgml |  5 +++--
 doc/src/sgml/ref/createuser.sgml |  5 +++--
 doc/src/sgml/ref/dropdb.sgml     |  5 +++--
 doc/src/sgml/ref/droplang.sgml   |  5 +++--
 doc/src/sgml/ref/dropuser.sgml   |  5 +++--
 doc/src/sgml/ref/pg_dump.sgml    |  6 +++---
 doc/src/sgml/ref/pg_dumpall.sgml |  6 +++---
 doc/src/sgml/ref/pg_restore.sgml |  4 ++--
 doc/src/sgml/ref/postmaster.sgml | 13 ++++++-------
 doc/src/sgml/ref/psql-ref.sgml   |  6 +++---
 doc/src/sgml/ref/vacuumdb.sgml   |  5 +++--
 12 files changed, 38 insertions(+), 32 deletions(-)

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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.13 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.14 2000/11/13 23:57:19 momjian Exp $
 Postgres documentation
 -->
 
@@ -40,7 +40,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.12 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.13 2000/11/13 23:57:19 momjian Exp $
 Postgres documentation
 -->
 
@@ -85,7 +85,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.12 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.13 2000/11/13 23:57:19 momjian Exp $
 Postgres documentation
 -->
 
@@ -39,7 +39,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.6 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.7 2000/11/13 23:57:19 momjian Exp $
 Postgres documentation
 -->
 
@@ -39,7 +39,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.6 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.7 2000/11/13 23:57:19 momjian Exp $
 Postgres documentation
 -->
 
@@ -85,7 +85,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.7 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.8 2000/11/13 23:57:20 momjian Exp $
 Postgres documentation
 -->
 
@@ -39,7 +39,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.22 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.23 2000/11/13 23:57:20 momjian Exp $
 Postgres documentation
 -->
 
@@ -199,8 +199,8 @@ pg_dump [ -h <replaceable class="parameter">host</replaceable> ]
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	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.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.13 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.14 2000/11/13 23:57:20 momjian Exp $
 Postgres documentation
 -->
 
@@ -143,8 +143,8 @@ pg_dumpall [ -h <replaceable class="parameter">host</replaceable> ] [ -p <replac
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	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.
        </para>
       </listitem>
      </varlistentry>
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 [ <replaceable class="parameter">archive-file</replaceable>  ]
        <para>
 	Specifies the hostname of the machine on which the
 	<application>postmaster</application>
-	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.
        </para>
       </listitem>
      </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.13 2000/11/13 15:18:08 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.14 2000/11/13 23:57:20 momjian Exp $
 Postgres documentation
 -->
 
@@ -132,23 +132,22 @@ postmaster [ -B <replaceable class="parameter">nBuffers</replaceable> ] [ -D <re
 	Specifies the TCP/IP hostname or address
 	on which the <application>postmaster</application>
 	is to listen for connections from frontend applications.  Defaults to
-	the value of the 
-	<envar>PGHOST</envar> 
+	the value of the <envar>PGHOST</envar> 
 	environment variable, or if <envar>PGHOST</envar>
-	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).
        </para>
        <para>
-	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 <application>postmaster</application> 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 <application>postmaster</application> instances are
 	listening must be distinct in the two last octets.
        </para>
        <para>
-	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 <envar>PGPORT</envar>).  And, of course, do
 	not try to use both approaches on one host.
        </para>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.42 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.43 2000/11/13 23:57:20 momjian Exp $
 Postgres documentation
 -->
 
@@ -1322,8 +1322,8 @@ Access permissions for database "test"
       <para>
       Specifies the host name of the machine on which the
       <application>postmaster</application> 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.
       </para>
       </listitem>
     </varlistentry>
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 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.12 2000/11/13 23:37:51 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.13 2000/11/13 23:57:20 momjian Exp $
 Postgres documentation
 -->
 
@@ -119,7 +119,8 @@ Postgres documentation
        <para>
 	Specifies the hostname of the machine on which the 
 	<application>postmaster</application>
-	is running.
+	is running.  If host begins with a slash, it is used 
+	as the path to a unix domain socket.
        </para>
       </listitem>
      </varlistentry>