Message-ID: <ff88eb2d42bb5592a692007b18025b6b8c8b7d49.camel@cybertec.at>
Subject: Re: Improve documentation for pg_upgrade, standbys and rsync
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: Robert Haas <robertmhaas@gmail.com>, Stephen Frost <sfrost@snowman.net>
Cc: pgsql-docs@lists.postgresql.org
Date: Wed, 06 Apr 2022 12:35:55 +0200
In-Reply-To: 
 <CA+TgmobJBezsjg1afKK3jQCz75RX_Fankf65os=0Cuh93oFjPQ@mail.gmail.com>
References: <22f129004bb66cd91e1dfd3345a9787f5039f3ae.camel@cybertec.at>
	 <20210519143135.GI20766@tamriel.snowman.net>
	 <c176f23cdde4d4ff0010b5e7a517c1b371500279.camel@cybertec.at>
	 <20210716131744.GA20766@tamriel.snowman.net>
	 <a1a9cf4ebc8c674f4165af376c522f52ab02a3f6.camel@cybertec.at>
	 <20210726191126.GW20766@tamriel.snowman.net>
	 <CA+TgmobJBezsjg1afKK3jQCz75RX_Fankf65os=0Cuh93oFjPQ@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
User-Agent: Evolution 3.40.4 (3.40.4-3.fc34) 
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Archived-At: 
 <https://www.postgresql.org/message-id/ff88eb2d42bb5592a692007b18025b6b8c8b7d49.camel%40cybertec.at>
Precedence: bulk

On Tue, 2022-04-05 at 12:38 -0400, Robert Haas wrote:
> Also, let me express my general terror at the idea of anyone actually
> using this procedure.

I did, and I couldn't get it to work with absolute paths, and using
relative paths seemed to me to be more intuitive anyway, hence the patch.

Originally that was the only change I wanted to make to the documentation,
but you know how it is: as soon as you touch something like this, someone
will (rightly so) prod you and say "while you change this, that other
thing there should also be improved", and the patch gets more
and more invasive.

I agree with the scariness of this, but I prefer to have it in the
documentation anyway; at least as long as we have nothing better (which
is always the enemy of the good).

Yours,
Laurenz Albe