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

From Stefan Kaltenbrunner
Subject Re: [DOCS] Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Date
Msg-id 52F3E74F.5050300@kaltenbrunner.cc
Whole thread Raw
In response to Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-hackers
On 02/05/2014 07:27 PM, Robert Haas wrote:
> On Tue, Feb 4, 2014 at 11:43 PM, Noah Misch <noah@leadboat.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


pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: PoC: Partial sort
Next
From: Greg Stark
Date:
Subject: Re: Recovery inconsistencies, standby much larger than primary