Re: INSTALL/install.sgml file - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: INSTALL/install.sgml file
Date
Msg-id Pine.LNX.4.21.0006062126070.17370-100000@localhost.localdomain
Whole thread Raw
In response to Re: INSTALL/install.sgml file  (Bruce Momjian <pgman@candle.pha.pa.us>)
Responses Re: INSTALL/install.sgml file
List pgsql-hackers
Bruce Momjian writes:

> > This step and step 11 should also mention pg_upgrade as a possible
> > alternative to doing a full reload.  (But encourage people to make
> > the backup anyway ;-).)
>
> I got that into step 5:
>
>       Rather than using pg_dumpall, pg_upgrade can often be used.

I think the installation instructions should say "If you are upgrading
from an existing installation, read the Administrator's Guide for backing
and restoring your data." The said guide contains a chapter discussing
these issues in detail (or at least it contains a chapter on it and we
should add some detail :). This sort of thing can't be replaced by three
sentences.

Just the other day I griped about the fact that the installation
instructions are in fact a chapter of the administrator's guide, which
breaks the internal and external organization and the flow of information
of both the installation instructions and the administrator's guide.

Can anyone see that concern?

--
Peter Eisentraut                  Sernanders väg 10:115
peter_e@gmx.net                   75262 Uppsala
http://yi.org/peter-e/            Sweden


pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Odd release numbers for development versions?
Next
From: Peter Eisentraut
Date:
Subject: Advisory: configure script has moved