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

On Wed, Feb 24, 2010 at 8:24 AM, Simon Riggs <simon@2ndquadrant.com> wrote:
> 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.

We would need to expose recovery configuration parameters as
indexterm, as well as GUC.

> 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.

Yeah, we need to improve the SR document. So I began modifying it
in my git repository.
   * git://git.postgresql.org/git/users/fujii/postgres.git   * branch: replication-doc

Regards,

-- 
Fujii Masao
NIPPON TELEGRAPH AND TELEPHONE CORPORATION
NTT Open Source Software Center