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 si...@2ndquadrant.com 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

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 shows

[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: [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 robertmh...@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

[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:

[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

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

[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. So

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 heikki.linnakan...@enterprisedb.com 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

[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 options are

[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-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 the

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 si...@2ndquadrant.com 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

[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 taken me 15

[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 backup and restore