Limit pg_upgrade authentication advice to always-secure techniques.

~/.pgpass is a sound choice everywhere, and "peer" authentication is
safe on every platform it supports.  Cease to recommend "trust"
authentication, the safety of which is deeply configuration-specific.
Back-patch to 9.0, where pg_upgrade was introduced.

doc/src/sgml/pgupgrade.sgml

@@ -288,10 +288,9 @@ make prefix=/usr/local/pgsql.new install
     <title>Adjust authentication</title>
 
     <para>
-     <command>pg_upgrade</> will connect to the old and new servers several times,
+     <command>pg_upgrade</> will connect to the old and new servers several
-     so you might want to set authentication to <literal>trust</>
+     times, so you might want to set authentication to <literal>peer</>
-     or <literal>peer</> in <filename>pg_hba.conf</>, or if using
+     in <filename>pg_hba.conf</> or use a <filename>~/.pgpass</> file
-     <literal>md5</> authentication, use a <filename>~/.pgpass</> file
      (see <xref linkend="libpq-pgpass">).
     </para>
    </step>
@@ -406,10 +405,9 @@ pg_upgrade.exe
     <title>Restore <filename>pg_hba.conf</></title>
 
     <para>
-     If you modified <filename>pg_hba.conf</> to use <literal>trust</>,
+     If you modified <filename>pg_hba.conf</>, restore its original settings.
-     restore its original authentication settings.  It might also be
+     It might also be necessary to adjust other configuration files in the new
-     necessary to adjust other configurations files in the new cluster to
+     cluster to match the old cluster, e.g. <filename>postgresql.conf</>.
-     match the old cluster, e.g. <filename>postgresql.conf</>.
     </para>
    </step>