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