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

2010-02-24 Thread Heikki Linnakangas
Simon Riggs wrote: > Which is why, in the next paragraph, I proposed a way forwards... Oh, sorry. > There are 3 use cases: PITR, file-based replication and streaming > replication. Having 3 separate sections would be less confusing since it > would allow focused examples. A final section could be

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

2010-02-24 Thread Simon Riggs
On Wed, 2010-02-24 at 20:20 +0200, Heikki Linnakangas wrote: > Simon Riggs wrote: > > A new section inside the HA chapter would be useful, so this is on the > > same level as "Streaming Replication". So just drop everything down one > > level. > > The problem with that is that the recovery.conf op

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

2010-02-24 Thread Robert Haas
On Wed, Feb 24, 2010 at 1:20 PM, Heikki Linnakangas wrote: > Simon Riggs wrote: >> A new section inside the HA chapter would be useful, so this is on the >> same level as "Streaming Replication". So just drop everything down one >> level. > > The problem with that is that the recovery.conf options

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

2010-02-24 Thread Heikki Linnakangas
Simon Riggs wrote: > A new section inside the HA chapter would be useful, so this is on the > same level as "Streaming Replication". So just drop everything down one > level. The problem with that is that the recovery.conf options are also relevant to plain-old recovery from an archive. And PITR.

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

2010-02-24 Thread Simon Riggs
On Wed, 2010-02-24 at 18:59 +0900, Fujii Masao wrote: > On Wed, Feb 24, 2010 at 5:11 PM, Robert Haas 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'

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

2010-02-24 Thread Simon Riggs
On Wed, 2010-02-24 at 19:30 +0200, Heikki Linnakangas wrote: > Simon Riggs wrote: > > Major change is necessary here; this change in particular is regrettably > > a very bad one. Please reconsider and make substantial improvements. > > Any suggestions? A new section inside the HA chapter would be

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

2010-02-24 Thread Heikki Linnakangas
Simon Riggs wrote: > Major change is necessary here; this change in particular is regrettably > a very bad one. Please reconsider and make substantial improvements. Any suggestions? Berkus suggested adding a new page to collect together reference documentation of all the configuration files: htt

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

2010-02-24 Thread Fujii Masao
On Wed, Feb 24, 2010 at 5:11 PM, Robert Haas 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

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

2010-02-24 Thread Simon Riggs
On Wed, 2010-02-24 at 07:31 +, Simon Riggs wrote: > Please revert the change to create a new chapter. I will downgrade my request from a "revert" to the next rung down. Such requests should be saved for the most serious matters. Major change is necessary here; this change in particular is re

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

2010-02-24 Thread Simon Riggs
On Wed, 2010-02-24 at 03:11 -0500, Robert Haas wrote: > But I do think it's good to list all the > recovery.conf settings in one central place. That part is fine, as long as we have links to it from necessary places. The reason why these docs must be within a related chapter is that it then show

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

2010-02-24 Thread Robert Haas
On Wed, Feb 24, 2010 at 2:31 AM, Simon Riggs wrote: > On Wed, 2010-02-24 at 08:30 +0200, Heikki Linnakangas wrote: >> Simon Riggs wrote: >> > On Mon, 2010-02-22 at 11:47 +, Heikki Linnakangas wrote: >> >> Log Message: >> >> --- >> >> Move documentation of all recovery.conf option to a

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

2010-02-23 Thread Simon Riggs
On Wed, 2010-02-24 at 08:30 +0200, Heikki Linnakangas wrote: > Simon Riggs wrote: > > On Mon, 2010-02-22 at 11:47 +, Heikki Linnakangas wrote: > >> Log Message: > >> --- > >> Move documentation of all recovery.conf option to a new chapter. > >> They used to be scattered between the "bac

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

2010-02-23 Thread Heikki Linnakangas
Simon Riggs wrote: > On Mon, 2010-02-22 at 11:47 +, 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

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

2010-02-23 Thread Fujii Masao
On Wed, Feb 24, 2010 at 8:24 AM, Simon Riggs wrote: > On Mon, 2010-02-22 at 11:47 +, 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 >> repl

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

2010-02-23 Thread Simon Riggs
On Mon, 2010-02-22 at 11:47 +, 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