Re: Supplemental contrib docs

From: Joe Conway <mail(at)joeconway(dot)com>
To: "Jim C(dot) Nasby" <jnasby(at)pervasive(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
Date: 2006-01-04 04:19:18
Message-ID: 43BB4CC6.5060508@joeconway.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-general

Jim C. Nasby wrote:
> On Tue, Jan 03, 2006 at 04:20:38PM -0800, Joe Conway wrote:
>>Well I like {prefix}/doc given that's how dblink is already set up ;-)
>>

> 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/.

Well, I assumed Tom was referring to placement in the source tree, i.e.
{prefix} is contrib/dblink, etc.

But this raises a good question in terms of where these files should be
installed. The README.xxx files all go to {install-prefix}/doc/contrib.
I experimented with changing the Makefile line:
DOCS = README.dblink
to be:
DOCS = README.dblink doc/*

Unfortunately the files from contrib/dblink/doc still wound up being
installed to {install-prefix}/doc/contrib, which would become a naming
collision hazard. Maybe they should go to
{install-prefix}/doc/contrib/xxx (where xxx is the name of each contrib
dir)?

Joe

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2006-01-04 04:26:37 Re: CONSTRAINT syntax in ALTER TABLE
Previous Message Jim C. Nasby 2006-01-04 02:19:58 Re: Supplemental contrib docs (was: [GENERAL] DBlink documentation)

Browse pgsql-general by date

  From Date Subject
Next Message Tom Lane 2006-01-04 05:03:56 Re: Supplemental contrib docs
Previous Message Jim C. Nasby 2006-01-04 02:19:58 Re: Supplemental contrib docs (was: [GENERAL] DBlink documentation)