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

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Gavin Flower <GavinFlower(at)archidevsys(dot)co(dot)nz>, Peter Eisentraut <peter_e(at)gmx(dot)net>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Date: 2014-02-09 13:33:59
Message-ID: CA+TgmobosYtGQ=5J4V47kMiU8UELqBbUQkkkBtXfC2jGbAtYTQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs pgsql-hackers

On Sat, Feb 8, 2014 at 4:41 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> I wrote:
>> Gavin Flower <GavinFlower(at)archidevsys(dot)co(dot)nz> writes:
>>> 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?
>
>> Actually, what I had in mind was to replace the dynamically-generated
>> HISTORY and README files with small text files that contain those
>> URL references.
>
> Here's a proposed patch against HEAD for this. It also gets rid of some
> rather quaint instructions for using Netscape to construct these files ;-)
>
> Barring objection, I'd like to update all the live branches this way
> before the upcoming releases. I'm tired of having to worry about
> whether the release notes will build as plain text; but that worry
> won't go away unless we nuke the text output in all the branches.

Sounds OK to me. If there's as many as two people using those files,
I'll be surprised. (Of course, I've been surprised before.)

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2014-02-09 17:24:26 Re: pgsql: Minor pg_dump improvements
Previous Message Magnus Hagander 2014-02-09 11:52:07 pgsql: Limit pg_basebackup progress output to 1/second

Browse pgsql-docs by date

  From Date Subject
Next Message J.F. Oster 2014-02-11 17:33:03 Ways to improve PgAdmin III SQL context help
Previous Message Tom Lane 2014-02-08 21:41:16 Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

Browse pgsql-hackers by date

  From Date Subject
Next Message Greg Stark 2014-02-09 13:54:51 Re: Recovery inconsistencies, standby much larger than primary
Previous Message Andrew Dunstan 2014-02-09 13:10:45 Re: narwhal and PGDLLIMPORT