Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7914=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WAmbz-0008KU-8c
 for pgsql-docs@arkaria.postgresql.org; Tue, 04 Feb 2014 20:28:51 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
 by malur.postgresql.org with smtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7914=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WAmby-0004On-2c
 for pgsql-docs@arkaria.postgresql.org; Tue, 04 Feb 2014 20:28:50 +0000
Received: from makus.postgresql.org ([2001:4800:7903:4::125])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <robertmhaas@gmail.com>)
 id 1WAmbx-0004Oc-FU; Tue, 04 Feb 2014 20:28:49 +0000
Received: from mail-wg0-x22b.google.com ([2a00:1450:400c:c00::22b])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <robertmhaas@gmail.com>)
 id 1WAmbu-0008E4-Rv; Tue, 04 Feb 2014 20:28:48 +0000
Received: by mail-wg0-f43.google.com with SMTP id y10so13129132wgg.34
 for <multiple recipients>; Tue, 04 Feb 2014 12:28:45 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:in-reply-to:references:date:message-id:subject:from:to
 :cc:content-type;
 bh=R9G90iqYJKw05ZUvjdOtmjUSlCDfMUeb/LVvl+ad4EU=;
 b=G/xeSY1RiG8Cjv7yOiF9uy2Oh6Q6313yzsq9JaVT57UNVQ4LQrdKaUN4hYmXbQ9fNg
 199DPWl/WQzmfWg9PmAUclLPUU5EbNb9a/E4+m0VjXo/mq1/AdgP14b9c42RBnB3RgpP
 VOuRoDnRJ7BZ8WyXOEhYLd6wIoyuuk2xyKBRMIfqOnzpPhZxapZM3FOUApPTLzsVi1Dt
 Bn1m3kLJqWgrfqmV2nVFstVZdQTl/FZL1iOt8bGJliv8KYKIzg2x9IGVhkuOqAUyGK0h
 o/sKJhydLpgtps28MNnH7WgRLkNZOtI8ACEfN/CYO1yXPgKrAvyiBh3w8fgEQS+4ihoZ
 SGtQ==
MIME-Version: 1.0
X-Received: by 10.194.134.132 with SMTP id pk4mr17830wjb.82.1391545725779;
 Tue, 04 Feb 2014 12:28:45 -0800 (PST)
Received: by 10.227.158.4 with HTTP; Tue, 4 Feb 2014 12:28:45 -0800 (PST)
In-Reply-To: <2486.1391495937@sss.pgh.pa.us>
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>
Date: Tue, 4 Feb 2014 15:28:45 -0500
Message-ID: 
 <CA+TgmobCN4ABNYS=4FwQP3MUNdJ8+rdoyedXNn5gGiWSEPdnWg@mail.gmail.com>
Subject: Re: Viability of text HISTORY/INSTALL/regression README files (was
 Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
From: Robert Haas <robertmhaas@gmail.com>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Noah Misch <noah@leadboat.com>,
 "pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>,
 pgsql-docs <pgsql-docs@postgresql.org>
Content-Type: text/plain; charset=ISO-8859-1
X-Pg-Spam-Score: -2.0 (--)
List-Archive: <http://archives.postgresql.org/pgsql-docs>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-docs.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@postgresql.org>
List-Post: <mailto:pgsql-docs@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-docs>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
X-Mailing-List: pgsql-docs
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

On Tue, Feb 4, 2014 at 1:38 AM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> 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.

Right.  I mean, a lot of the links say things like "Section 26.2"
which obviously makes no sense in a standalone text file.

I agree with your comments upthread: INSTALL *might* still be useful
to somebody, but I would be pretty surprised if anyone uses HISTORY or
regress_README for anything any more.

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


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