Received: from maia.hub.org (unknown [200.46.204.183]) by mail.postgresql.org (Postfix) with ESMTP id 1CA326327D8 for ; Wed, 24 Feb 2010 04:29:42 -0400 (AST) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024) with ESMTP id 65892-01 for ; Wed, 24 Feb 2010 08:29:31 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from outmail136028.authsmtp.co.uk (outmail136028.authsmtp.co.uk [62.13.136.28]) by mail.postgresql.org (Postfix) with ESMTP id 76BB66323E9 for ; Wed, 24 Feb 2010 04:29:31 -0400 (AST) Received: from mail-c187.authsmtp.com (mail-c187.authsmtp.com [62.13.128.33]) by punt3.authsmtp.com (8.14.2/8.14.2/Kp) with ESMTP id o1O8TQql074827; Wed, 24 Feb 2010 08:29:26 GMT Received: from [192.168.0.2] (88-110-213-69.dynamic.dsl.as9105.com [88.110.213.69]) (authenticated bits=0) by mail.authsmtp.com (8.14.2/8.14.2/Kp) with ESMTP id o1O8TOOi010621; Wed, 24 Feb 2010 08:29:24 GMT Subject: Re: Re: [COMMITTERS] pgsql: Move documentation of all recovery.conf option to a new chapter. From: Simon Riggs To: Robert Haas Cc: Heikki Linnakangas , pgsql-hackers@postgresql.org In-Reply-To: <603c8f071002240011t3151cc3q3e6e3ed3172b51d8@mail.gmail.com> References: <20100222114730.ADEC37541D0@cvs.postgresql.org> <1266967446.3752.4843.camel@ebony> <4B84C783.2090408@enterprisedb.com> <1266996685.3752.5825.camel@ebony> <603c8f071002240011t3151cc3q3e6e3ed3172b51d8@mail.gmail.com> Content-Type: text/plain Date: Wed, 24 Feb 2010 08:26:14 +0000 Message-Id: <1266999974.3752.5937.camel@ebony> Mime-Version: 1.0 X-Mailer: Evolution 2.26.1 Content-Transfer-Encoding: 7bit X-Server-Quench: b733d2b2-211e-11df-ab46-001185d377ca X-AuthReport-Spam: If SPAM / abuse - report it at: http://www.authsmtp.com/abuse X-AuthRoute: OCdxZQATClZOTQEd DAteCiN5VAwpPBRK HVkIKg5MJUcNSQVJ NksadRtFagFba1xT HGQLWlREUFV7W2p/ aQ8fZQ1DY0tOQQdr U1ZPS01XHAJ3AVJe B2EWNmYNLgVHeHhy ZAhmX3ZfEhZ9dkUp QBxWCG8HZDJ9aWFL Bl0JJQdSbQNKfx5N bwR8U3ReMCtlM3Bw LC8aFBMcBw5qYB5Y EEk+BnU3ZGc3IhMG fCVKBTo0BElXDwA0 MRFuJlkXAUMcNFk7 LVomXxofPVcbDgkW fQlXDSReOVQbVmwg CgVUFUkGDDxaR29A BVUhahlFHXRZWiNA GEZfDXkA X-Authentic-SMTP: 61633235383639.1000:706/Kp X-AuthFastPath: 255 X-Virus-Status: No virus detected - but ensure you scan with your own anti-virus system. X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-2.599 tagged_above=-10 required=5 tests=BAYES_00=-2.599 X-Spam-Level: X-Archive-Number: 201002/1930 X-Sequence-Number: 158273 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 up on the chapter TOC, allowing you to quickly answer the "where were the docs for that?" question. If you go back up to the main TOC there are way too many other chapters to be able to see which one you should go to, even if you are used to the manual. -- Simon Riggs www.2ndQuadrant.com