Received: from localhost (unknown [200.46.204.182]) by postgresql.org (Postfix) with ESMTP id 71C799F95B9 for ; Sun, 11 Nov 2007 14:16:47 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.182]) (amavisd-maia, port 10024) with ESMTP id 70580-06 for ; Sun, 11 Nov 2007 14:16:42 -0400 (AST) Received: from momjian.us (momjian.us [70.90.9.53]) by postgresql.org (Postfix) with ESMTP id 50C7E9F9594 for ; Sun, 11 Nov 2007 14:16:43 -0400 (AST) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id lABIGdU15448; Sun, 11 Nov 2007 13:16:39 -0500 (EST) From: Bruce Momjian Message-Id: <200711111816.lABIGdU15448@momjian.us> Subject: Re: [PATCHES] Contrib docs v1 In-Reply-To: <19053.1194795737@sss.pgh.pa.us> To: Tom Lane Date: Sun, 11 Nov 2007 13:16:39 -0500 (EST) CC: Albert Cervera i Areny , PostgreSQL-documentation X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200711/32 X-Sequence-Number: 4565 Tom Lane wrote: > Bruce Momjian writes: > > Uh, don't start converting them yet. I now realize that > > /contrib/dict_int is an example and just like the stuff in /contrib/spi > > perhaps shouldn't have its docs moved to SGML. > > What makes you realize any such thing? You could make that argument for > test_parser, probably, but the dict modules are useful in their own > right. > > > Should we leave example /contrib modules documented in READMEs? > > What is the point of such a distinction? If the contrib value is the source code itself then it seems a README is more appropriate as people are not going to install the contrib module itself --- they are using it only to learn. -- Bruce Momjian http://momjian.us EnterpriseDB http://postgres.enterprisedb.com + If your life is a hard drive, Christ can be your backup. +