Re: Supplemental contrib docs (was: [GENERAL] DBlink documentation)

From: "Jim C(dot) Nasby" <jnasby(at)pervasive(dot)com>
To: Joe Conway <mail(at)joeconway(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsqlrpms-hackers(at)pgfoundry(dot)org, Tino Wildenhain <tino(at)wildenhain(dot)de>, Andre Truter <linux(at)trusoft(dot)co(dot)za>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Supplemental contrib docs (was: [GENERAL] DBlink documentation)
Date: 2006-01-04 02:19:58
Message-ID: 20060104021958.GJ82560@pervasive.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-general

On Tue, Jan 03, 2006 at 04:20:38PM -0800, Joe Conway wrote:
> Tom Lane wrote:
> >Joe Conway <mail(at)joeconway(dot)com> 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(at)pervasive(dot)com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Joe Conway 2006-01-04 04:19:18 Re: Supplemental contrib docs
Previous Message Jim C. Nasby 2006-01-04 02:12:29 Re: CONSTRAINT syntax in ALTER TABLE

Browse pgsql-general by date

  From Date Subject
Next Message Joe Conway 2006-01-04 04:19:18 Re: Supplemental contrib docs
Previous Message Doug McNaught 2006-01-04 01:31:09 Re: Moving Tablespaces