DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type;
	b=dPfHTIhjzKXmG7N7SslS6g7siBKI/mUTqdMacAV3lzLwfEl+Whn/aRdA0pLi7XJMRV
	KMni+SsqymWmwx/1B0MTS20Yg0znE+lenC/s1snTAAPrpn/45vBCQgATkjkWqPKOAtbu
	3/zANhVMR2BXYPEiQp6cSmziYb2EmBQBcjwOI=
MIME-Version: 1.0
In-Reply-To: <1266967446.3752.4843.camel@ebony>
References: <20100222114730.ADEC37541D0@cvs.postgresql.org>
	<1266967446.3752.4843.camel@ebony>
Date: Wed, 24 Feb 2010 13:58:35 +0900
Message-ID: <3f0b79eb1002232058l5b7fd2adnb202b82461512edd@mail.gmail.com>
Subject: Re: Re: [COMMITTERS] pgsql: Move documentation of all
	recovery.conf option to a new chapter.
From: Fujii Masao <masao.fujii@gmail.com>
To: Simon Riggs <simon@2ndquadrant.com>
Cc: Heikki Linnakangas <heikki@postgresql.org>, pgsql-hackers@postgresql.org
Content-Type: text/plain; charset=ISO-8859-1

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