Document that pg_upgrade requires PGHOST be set for any pre-9.1 servers

with a socket directory mismatch with the new server.

Backpatch to 9.2.

diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
index 9e43f3ce133ef6b29de12694bfa92bce3a1d0dac..301222c55d22e71971c43c95cb2ea332552456b7 100644 (file)
--- a/doc/src/sgml/pgupgrade.sgml
+++ b/doc/src/sgml/pgupgrade.sgml
@@ -520,11 +520,10 @@ psql --username postgres --file script.sql postgres
   </para>
 
   <para>
-   If doing <option>--check</> with a running old server of a pre-9.1 version,
-   and the old server is using a Unix-domain socket directory that is
-   different from the default built into the new <productname>PostgreSQL</>
-   installation, set <envar>PGHOST</> to point to the socket location of the
-   old server.  (This is not relevant on Windows.)
+   If using a pre-9.1 old server that is using a non-default Unix-domain
+   socket directory or a default that differs from the default of the
+   new cluster, set <envar>PGHOST</> to point to the old server's socket
+   location.  (This is not relevant on Windows.)
   </para>
 
   <para>