Ian Barwick wrote:
> >> Well, that is step #4:
> >>
> >> ? ? ? http://www.postgresql.org/docs/9.0/static/pgupgrade.html
> >> ? ? ? 4.
> >>
> >> ? ? ? Install pg_upgrade
> >>
> >> ? ? ? Install pg_upgrade and pg_upgrade_support in the new PostgreSQL cluster
> >>
> >> Was that not clear enough?
> >
> > I hope my comment didn't sound insulting. ?I really want to know how
> > that doc item can be made clearer.
>
> No insult taken :) .With the benefit of hindsight it's plenty clear;
> the problem was:
>
> a) I was doing this in a hurry (had a small amount of time to kill and
> a dev machine with an older beta on it)
> b) got sidetracked by this thread which appears to describe the same
> problem: http://archives.postgresql.org/pgsql-testers/2010-06/msg00000.php
> and which was popping up pretty high in Google.
Yep, we need to address this.
> Looking over the doc page again, if scanning over it, it's a bit easy
> to misread it as something like "Install pg_upgrade for pg_upgrade
> support in the new PostgreSQL cluster".
The big problem was that the title said "Install pg_upgrade", but the
detail had you installing two things, one of which was pg_upgrade. It
was using pg_upgrade in both a generic sense, and in the
/contrib/pg_upgrade sense, which is bound to confuse, as you said.
I have attached a doc diff I backpatched to 9.0 that includes
pg_upgrade_support in the section title. This should avoid future
confusing. Thanks for your report.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
index 2a806b5..7bc939c 100644
--- a/doc/src/sgml/pgupgrade.sgml
+++ b/doc/src/sgml/pgupgrade.sgml
@@ -199,7 +199,7 @@ gmake prefix=/usr/local/pgsql.new install
</step>
<step>
- <title>Install pg_upgrade</title>
+ <title>Install pg_upgrade and pg_upgrade_support</title>
<para>
Install <application>pg_upgrade</> and