X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 821B29DC824 for ; Tue, 3 Jan 2006 22:19:59 -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 94187-05 for ; Tue, 3 Jan 2006 22:20:03 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from flake.decibel.org (unknown [67.100.216.10]) by postgresql.org (Postfix) with ESMTP id 4F2869DC878 for ; Tue, 3 Jan 2006 22:19:56 -0400 (AST) Received: by flake.decibel.org (Postfix, from userid 1001) id A6CF53983E; Tue, 3 Jan 2006 20:19:58 -0600 (CST) Date: Tue, 3 Jan 2006 20:19:58 -0600 From: "Jim C. Nasby" To: Joe Conway Cc: Tom Lane , pgsqlrpms-hackers@pgfoundry.org, Tino Wildenhain , Andre Truter , PostgreSQL-documentation Subject: Re: Supplemental contrib docs (was: [GENERAL] DBlink documentation) Message-ID: <20060104021958.GJ82560@pervasive.com> References: <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> <9980.1134852474@sss.pgh.pa.us> <43BB0E38.1050602@joeconway.com> <27674.1136332597@sss.pgh.pa.us> <43BB14D6.8000803@joeconway.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <43BB14D6.8000803@joeconway.com> X-Operating-System: FreeBSD 6.0-RELEASE amd64 X-Distributed: Join the Effort! http://www.distributed.net User-Agent: Mutt/1.5.11 X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.07 required=5 tests=[AWL=0.070] X-Spam-Score: 0.07 X-Spam-Level: X-Archive-Number: 200601/7 X-Sequence-Number: 3397 On Tue, Jan 03, 2006 at 04:20:38PM -0800, Joe Conway wrote: > Tom Lane wrote: > >Joe Conway writes: > >>Tom Lane wrote: > >> > >>>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? > > > >>While I'm messing with dblink, did you want me to do anything WRT this? > > > >I don't think we settled on what we want to do yet. Any thoughts? > > > >I'm kind of leaning toward the subdirectory idea myself... > > (I removed GENERAL, and added DOCS to the distribution of this thread) > > Well I like {prefix}/doc given that's how dblink is already set up ;-) > > Questions: > - Do we want a naming convention for the files in > {prefix}/doc? > - Do we pre-create {prefix}/doc for every contrib > directory in advance? > > I think the answers are no, and yes, but I don't feel strongly about either. By {prefix} do you mean where PostgreSQL is being installed? If so, that would be highly non-standard. I think what you'd want is {prefix}/share/doc/postgresql/contrib/. -- Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com Pervasive Software http://pervasive.com work: 512-231-6117 vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461