| From: | Gavin Flower <GavinFlower(at)archidevsys(dot)co(dot)nz> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Peter Eisentraut <peter_e(at)gmx(dot)net> |
| Cc: | Robert Haas <robertmhaas(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org, pgsql-docs(at)postgresql(dot)org |
| Subject: | Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.) |
| Date: | 2014-02-08 06:40:48 |
| Message-ID: | 52F5D170.4000309@archidevsys.co.nz |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-committers pgsql-docs pgsql-hackers |
On 08/02/14 19:05, Tom Lane wrote:
> Peter Eisentraut <peter_e(at)gmx(dot)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
>
>
How about adding URL's for the online versions of HISTORY & README's (or
their rough equivalents - perhaps the online version of the latest
'Appendix E. Release Notes' would be sufficient?) to the INSTALL file?
Cheers,
Gavin