Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.) - Mailing list pgsql-docs

From Tom Lane
Subject Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Date
Msg-id 18083.1391839531@sss.pgh.pa.us
Whole thread Raw
In response to Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)  (Gavin Flower <GavinFlower@archidevsys.co.nz>)
List pgsql-docs
Peter Eisentraut <peter_e@gmx.net> writes:
> On 2/3/14, 8:48 PM, Tom Lane wrote:
>> That's a very fair question.  It's a reasonable bet that pretty much
>> nobody actually looks at the text versions of either HISTORY or
>> regress_README anymore.  It's conceivable that somebody somewhere makes
>> use of the text version of INSTALL when trying to get PG going on some
>> bare-bones platform ... but really, can't they look it up on the net?
>> How'd they get the PG sources they're installing, anyway?

> I think having an INSTALL file is good form, and it costs us little to
> maintain it.

> The other files could be removed, IMO.

That seems like a reasonable compromise to me.  The HISTORY file is
certainly the worst pain-in-the-rear among these, since it's generated
from files that we change constantly, and so we're always tripping over
the link restrictions.

            regards, tom lane


pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Next
From: Tom Lane
Date:
Subject: Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)