Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter. - Mailing list pgsql-hackers

From Simon Riggs
Subject Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter.
Date
Msg-id 1266967446.3752.4843.camel@ebony
Whole thread Raw
Responses Re: Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter.
Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter.
List pgsql-hackers
On Mon, 2010-02-22 at 11:47 +0000, Heikki Linnakangas wrote:
> Log Message:
> -----------
> Move documentation of all recovery.conf option to a new chapter.
> They used to be scattered between the "backup and restore" and "streaming
> replication" chapters.

It's just taken me 15 minutes to locate the settings for
primary_conninfo to better understand Stefan's recent post.

The commit referred to here is an extremely bad change.

If you intended this to be a heading within the "High Availability"
chapter then I would agree. This is what I thought you had done.

Having Streaming Rep described in HA and then describing the parameters
that make it work in a separate chapter is ridiculous. Plus, wherever
they are, they need cross references between them.

This is the last straw for me. The Streaming Rep docs are now truly
appalling. They were thin before, but tieing them in knots and splitting
them into disconnected pieces is just too much. If I can't find the damn
things, we've gone too far.

SR is a big feature and deserves proper docs.

-- Simon Riggs           www.2ndQuadrant.com



pgsql-hackers by date:

Previous
From: Simon Riggs
Date:
Subject: Re: SR/libpq - outbound interface/ipaddress binding
Next
From: Jeff Davis
Date:
Subject: Re: Issues for named/mixed function notation patch