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

On Wed, 2010-02-24 at 18:59 +0900, Fujii Masao wrote:
> On Wed, Feb 24, 2010 at 5:11 PM, Robert Haas <robertmhaas(at)gmail(dot)com> wrote:
> > Looking at it, I think I do agree that this shouldn't be a whole
> > chapter by itself. It's not nearly as high-level a concept as the
> > chapters that surround it. But I do think it's good to list all the
> > recovery.conf settings in one central place. The server config
> > chapter looks like the best fit to me on first glance, but I wonder
> > what others think?
>
> Umm... how about the following layout (just merge the server config and
> the recovery config)? Since the way to specify a parameter is different
> from postgresql.conf and recovery.conf, the section "Server Parameters"
> would be required in both.
>
> 18. Server Configuration
> 18.1. Server Parameters
> 18.1.1. Setting Parameters
> 18.1.2. File Locations
> 18.1.3. Connections and Authentication
> <snip>
> 18.1.16. Short Options
> 18.2. Recovery Parameters
> 18.2.1. Setting Parameters
> 18.2.2. Archive Recovery
> 18.2.3. Recovery Target
> 18.2.4. Standby Server

That would be OK too, but you'd need to add lots and lots of links to
ensure that each mention of the parameter goes to the definition.

--
Simon Riggs www.2ndQuadrant.com