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 6290F9DC992 for ; Sat, 17 Dec 2005 14:31:10 -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 27935-01 for ; Sat, 17 Dec 2005 14:31:09 -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 DB9449DC8D9 for ; Sat, 17 Dec 2005 14:31:07 -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 jBHIV8Vu008868; Sat, 17 Dec 2005 13:31:08 -0500 (EST) To: Tino Wildenhain cc: Andre Truter , pgsql-general@postgresql.org, pgsqlrpms-hackers@pgfoundry.org Subject: Re: DBlink documentation In-reply-to: <1134835756.4975.183.camel@Andrea.peacock.de> 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> Comments: In-reply-to Tino Wildenhain message dated "Sat, 17 Dec 2005 17:09:16 +0100" Date: Sat, 17 Dec 2005 13:31:08 -0500 Message-ID: <8867.1134844268@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.013 required=5 tests=[AWL=0.013] X-Spam-Score: 0.013 X-Spam-Level: X-Archive-Number: 200512/888 X-Sequence-Number: 88451 Tino Wildenhain writes: > Am Samstag, den 17.12.2005, 16:53 +0200 schrieb Andre Truter: >> I would be nice if the documentation could be online though, then I >> would not need to download the whole postgres source just to get the >> documentation for one small part. > This is understandable ;) But in this case not postgres peoples > fault. There is no reason a package manager should exclude parts > of the software at will. Actually, I don't think you can reasonably blame the Debian packager for having overlooked the fact that contrib/dblink has more documentation files besides its README. The PGDG RPM people overlooked that too, as did Red Hat (ie, me). Now that I look, tsearch2 has also adopted a nonstandard documentation layout. While we (the packagers) could fix this now that our attention has been called to it, I wonder whether the better plan wouldn't be to insist that dblink and tsearch2 fall into line with the rest of the contrib modules. At the very least we need a uniform convention for docs files so that packagers won't be playing catchup forever. regards, tom lane