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 5C3A09DCD0E for ; Sat, 17 Dec 2005 16:47:57 -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 43232-10 for ; Sat, 17 Dec 2005 16:47:58 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by postgresql.org (Postfix) with ESMTP id 2C1F59DCCFB for ; Sat, 17 Dec 2005 16:47:55 -0400 (AST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.13.1/8.13.1) with ESMTP id jBHKlsHV009981; Sat, 17 Dec 2005 15:47:54 -0500 (EST) To: Joe Conway cc: pgsqlrpms-hackers@pgfoundry.org, Tino Wildenhain , pgsql-general@postgresql.org, Andre Truter Subject: Re: [Pgsqlrpms-hackers] Re: DBlink documentation In-reply-to: <43A4726E.6050700@joeconway.com> References: <1134823993.14378.37.camel@fullyautomatix.home.trusoft.co.za> <43A4109C.6060304@enelserver.com> <1134827063.14378.41.camel@fullyautomatix.home.trusoft.co.za> <43A41AFE.9030007@enelserver.com> <1134828849.14378.45.camel@fullyautomatix.home.trusoft.co.za> <1134831184.14378.51.camel@fullyautomatix.home.trusoft.co.za> <1134835756.4975.183.camel@Andrea.peacock.de> <8867.1134844268@sss.pgh.pa.us> <43A4726E.6050700@joeconway.com> Comments: In-reply-to Joe Conway message dated "Sat, 17 Dec 2005 12:17:50 -0800" Date: Sat, 17 Dec 2005 15:47:54 -0500 Message-ID: <9980.1134852474@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.079 required=5 tests=[AWL=-0.052, SUBJECT_NOVOWEL=0.131] X-Spam-Score: 0.079 X-Spam-Level: X-Archive-Number: 200512/895 X-Sequence-Number: 88458 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? regards, tom lane