Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-hackers-owner+M243890=pgsql-hackers-arkari@postgresql.org>)
 id 1WAZex-0000FB-1n
 for pgsql-hackers@arkaria.postgresql.org; Tue, 04 Feb 2014 06:39:03 +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+M243890=pgsql-hackers-arkari@postgresql.org>)
 id 1WAZew-0002Hm-Ho
 for pgsql-hackers@arkaria.postgresql.org; Tue, 04 Feb 2014 06:39:02 +0000
Received: from makus.postgresql.org ([2001:4800:7903:4::125])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <tgl@sss.pgh.pa.us>)
 id 1WAZev-0002HX-BU; Tue, 04 Feb 2014 06:39:01 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <tgl@sss.pgh.pa.us>)
 id 1WAZet-0000kJ-4G; Tue, 04 Feb 2014 06:39:00 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
 by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id s146cvW1002487;
 Tue, 4 Feb 2014 01:38:57 -0500
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Noah Misch <noah@leadboat.com>
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.)
In-reply-to: <20140204050809.GA2410543@tornado.leadboat.com>
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>
Comments: In-reply-to Noah Misch <noah@leadboat.com>
 message dated "Tue, 04 Feb 2014 00:08:09 -0500"
Date: Tue, 04 Feb 2014 01:38:57 -0500
Message-ID: <2486.1391495937@sss.pgh.pa.us>
X-Pg-Spam-Score: -2.5 (--)
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

Noah Misch <noah@leadboat.com> writes:
>> Robert Haas <robertmhaas@gmail.com> writes:
>>> I wonder if these standalone things are really worthwhile.

> I wonder how difficult it would be to make sufficient link data available when
> building the standalone files.  There would be no linking per se; we would
> just need the referent's text fragment emitted where the <xref> tag appears.

IIRC, that's basically what the "workaround" is, except it's not very
automated.  Even if it were automated, though, there's still a problem:
such links aren't really *useful* in flat text format.  I think that
forcing the author to actually think about what to put there in the
flat text version is a good thing, if we're going to retain the flat
text version at all.

			regards, tom lane


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