Re: [HACKERS] INSTALL/install.sgml file

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, PostgreSQL-documentation <docs(at)postgresql(dot)org>
Subject: Re: [HACKERS] INSTALL/install.sgml file
Date: 2000-06-06 21:58:45
Message-ID: Pine.LNX.4.21.0006062126070.17370-100000@localhost.localdomain
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs 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(at)gmx(dot)net 75262 Uppsala
http://yi.org/peter-e/ Sweden

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2000-06-07 01:36:36 Re: [HACKERS] INSTALL/install.sgml file
Previous Message Gagan 2000-06-06 20:13:09

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2000-06-06 22:07:54 Advisory: configure script has moved
Previous Message Tom Lane 2000-06-06 21:40:47 Re: Odd release numbers for development versions?