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

From: Stefan Kaltenbrunner <stefan(at)kaltenbrunner(dot)cc>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: Noah Misch <noah(at)leadboat(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [DOCS] Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Date: 2014-02-06 19:49:35
Message-ID: 52F3E74F.5050300@kaltenbrunner.cc
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs pgsql-hackers

On 02/05/2014 07:27 PM, Robert Haas wrote:
> On Tue, Feb 4, 2014 at 11:43 PM, Noah Misch <noah(at)leadboat(dot)com> wrote:
>>> Right. I mean, a lot of the links say things like "Section 26.2"
>>> which obviously makes no sense in a standalone text file.
>>
>> For <xref>s normally displayed that way, text output could emit a URL, either
>> inline or in the form of a footnote. For link targets (e.g. SQL commands)
>> having a friendly text fragment for <xref> sites, use the normal fragment.
>
> True. If we're going to keep these things around, something like that
> would avoid some annoyances for documentation authors. But I still
> think we ought to just nuke them, because who cares?

I dont care about HISTORY and even less so about regress_README but I
would prefer to keep INSTALL because I know that people do look at that
one...

Stefan

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2014-02-07 00:38:19 pgsql: In RelationClearRelation, postpone cache reload if !IsTransactio
Previous Message Andrew Dunstan 2014-02-06 17:13:25 pgsql: Alphabeticize list in OBJS definition in utils/adt Makefile.

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2014-02-08 01:48:24 Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Previous Message Robert Haas 2014-02-05 18:27:38 Re: 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-06 21:22:01 Re: Recovery inconsistencies, standby much larger than primary
Previous Message Tom Lane 2014-02-06 19:42:29 Re: PoC: Partial sort