Message-ID: <52F5D170.4000309@archidevsys.co.nz>
Date: Sat, 08 Feb 2014 19:40:48 +1300
From: Gavin Flower <GavinFlower@archidevsys.co.nz>
Organization: ArchiDevSys
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
 rv:24.0) Gecko/20100101 Thunderbird/24.2.0
MIME-Version: 1.0
To: Tom Lane <tgl@sss.pgh.pa.us>, Peter Eisentraut <peter_e@gmx.net>
CC: Robert Haas <robertmhaas@gmail.com>, pgsql-hackers@postgresql.org,
 pgsql-docs@postgresql.org
Subject: Re: Viability of text HISTORY/INSTALL/regression README
 files (was Re: [COMMITTERS] pgsql: Document a few more regression test
 hazards.)
References: <E1WALm6-0000nT-M0@gemulon.postgresql.org>
 <22438.1391463522@sss.pgh.pa.us>
 <CA+Tgmob0Jx_9v9KK95gojkjojeP2hTa38_P8JtOFXVDjjSkT=A@mail.gmail.com>
 <28834.1391478486@sss.pgh.pa.us> <52F58CE8.4090902@gmx.net>
 <18083.1391839531@sss.pgh.pa.us>
In-Reply-To: <18083.1391839531@sss.pgh.pa.us>
Content-Type: text/plain; charset=ISO-8859-15; format=flowed
Content-Transfer-Encoding: 7bit
Precedence: bulk
Sender: pgsql-hackers-owner@postgresql.org

On 08/02/14 19:05, Tom Lane wrote:
> 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
>
>
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


-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers