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

From: Simon Riggs <simon(at)2ndQuadrant(dot)com>
To: Fujii Masao <masao(dot)fujii(at)gmail(dot)com>
Cc: Robert Haas <robertmhaas(at)gmail(dot)com>, Heikki Linnakangas <heikki(dot)linnakangas(at)enterprisedb(dot)com>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter.
Date: 2010-02-24 17:52:06
Message-ID: 1267033926.3752.6544.camel@ebony
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

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

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2010-02-24 18:02:24 pgsql: Allow zero-dimensional (ie, empty) arrays in contrib/ltree
Previous Message Simon Riggs 2010-02-24 17:48:09 Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter.

Browse pgsql-hackers by date

  From Date Subject
Next Message Boszormenyi Zoltan 2010-02-24 17:58:31 Re: NaN/Inf fix for ECPG
Previous Message Simon Riggs 2010-02-24 17:48:09 Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter.