X-Original-To: pgsql-general-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id E73859DC9E3 for ; Sat, 17 Dec 2005 17:10:41 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 49366-03 for ; Sat, 17 Dec 2005 17:10:42 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from rwcrmhc12.comcast.net (unknown [216.148.227.153]) by postgresql.org (Postfix) with ESMTP id 34AFB9DC88F for ; Sat, 17 Dec 2005 17:10:39 -0400 (AST) Received: from candle.pha.pa.us ([71.225.87.206]) by comcast.net (rwcrmhc13) with ESMTP id <20051217211024015004ve5le>; Sat, 17 Dec 2005 21:10:37 +0000 Received: (from pgman@localhost) by candle.pha.pa.us (8.11.6/8.11.6) id jBHLAPm20348; Sat, 17 Dec 2005 16:10:25 -0500 (EST) From: Bruce Momjian Message-Id: <200512172110.jBHLAPm20348@candle.pha.pa.us> Subject: Re: [Pgsqlrpms-hackers] Re: DBlink documentation In-Reply-To: <9980.1134852474@sss.pgh.pa.us> To: Tom Lane Date: Sat, 17 Dec 2005 16:10:25 -0500 (EST) CC: Joe Conway , pgsqlrpms-hackers@pgfoundry.org, Tino Wildenhain , pgsql-general@postgresql.org, Andre Truter X-Mailer: ELM [version 2.4ME+ PL121 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.176 required=5 tests=[AWL=0.045, SUBJECT_NOVOWEL=0.131] X-Spam-Score: 0.176 X-Spam-Level: X-Archive-Number: 200512/896 X-Sequence-Number: 88459 Tom Lane wrote: > Joe Conway writes: > > I'm happy to lump all the docs back into the README if that's what you > > want, but I split it up in the first place because it was getting very long. > > No, I'm not really proposing that we force all contrib modules to have > only a README. I'm just annoyed by the lack of consistency (dblink/doc > versus tsearch2/docs, and some of the other modules seem to have some > doc files just loose in their top directory). > > It's not only the downstream packagers that have missed these: the > Makefiles don't install them either. > > It'd be a good idea to settle on what we want the installed file layout > to be --- do we need to create subdirectories under {prefix}/doc to > forestall name conflicts? I personally never saw those doc/ files when I was modifying dblink. I had to grope around in the regression tests to see how the functions worked. -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square, Pennsylvania 19073