Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-hackers-owner+M244130=pgsql-hackers-arkari@postgresql.org>)
 id 1WBUxK-0004Ui-7B
 for pgsql-hackers@arkaria.postgresql.org; Thu, 06 Feb 2014 19:49:50 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
 by malur.postgresql.org with smtp (Exim 4.80) (envelope-from
 <pgsql-hackers-owner+M244130=pgsql-hackers-arkari@postgresql.org>)
 id 1WBUxJ-0003nw-J7
 for pgsql-hackers@arkaria.postgresql.org; Thu, 06 Feb 2014 19:49:49 +0000
Received: from makus.postgresql.org ([2001:4800:7903:4::125])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <stefan@kaltenbrunner.cc>)
 id 1WBUxI-0003nV-8X; Thu, 06 Feb 2014 19:49:48 +0000
Received: from cronos.madness.at ([2a02:16a8:dc41::10])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <stefan@kaltenbrunner.cc>)
 id 1WBUxF-00015h-6f; Thu, 06 Feb 2014 19:49:47 +0000
Received: from mastermind.kaltenbrunner.cc ([2001:470:7a2d::22])
 by cronos.madness.at with esmtpsa (TLS1.0:DHE_RSA_CAMELLIA_256_CBC_SHA1:256)
 (Exim 4.80) (envelope-from <stefan@kaltenbrunner.cc>)
 id 1WBUx6-0007WB-IU; Thu, 06 Feb 2014 20:49:38 +0100
Message-ID: <52F3E74F.5050300@kaltenbrunner.cc>
Date: Thu, 06 Feb 2014 20:49:35 +0100
From: Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
 rv:24.0) Gecko/20100101 Thunderbird/24.2.0
MIME-Version: 1.0
To: Robert Haas <robertmhaas@gmail.com>
CC: Noah Misch <noah@leadboat.com>, Tom Lane <tgl@sss.pgh.pa.us>,
 "pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>,
 pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: [DOCS] 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>
	<20140204050809.GA2410543@tornado.leadboat.com>
	<2486.1391495937@sss.pgh.pa.us>
	<CA+TgmobCN4ABNYS=4FwQP3MUNdJ8+rdoyedXNn5gGiWSEPdnWg@mail.gmail.com>
	<20140205044328.GB2422724@tornado.leadboat.com>
 <CA+TgmobAS1wK7CgjC3bnT8CRscMEkjm2P+Ew9jt7yDTdoen5Vw@mail.gmail.com>
In-Reply-To: 
 <CA+TgmobAS1wK7CgjC3bnT8CRscMEkjm2P+Ew9jt7yDTdoen5Vw@mail.gmail.com>
X-Enigmail-Version: 1.5.2
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-Pg-Spam-Score: -1.9 (-)
List-Archive: <http://archives.postgresql.org/pgsql-hackers>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-hackers.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@postgresql.org>
List-Post: <mailto:pgsql-hackers@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-hackers>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-hackers>
X-Mailing-List: pgsql-hackers
Precedence: bulk
Sender: pgsql-hackers-owner@postgresql.org

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


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