Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7915=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WB7CK-0005mr-Pq
 for pgsql-docs@arkaria.postgresql.org; Wed, 05 Feb 2014 18:27:45 +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+M7915=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WB7CK-0007XI-98
 for pgsql-docs@arkaria.postgresql.org; Wed, 05 Feb 2014 18:27:44 +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 1WB7CJ-0007WG-GG; Wed, 05 Feb 2014 18:27:43 +0000
Received: from mail-wi0-x22d.google.com ([2a00:1450:400c:c05::22d])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <robertmhaas@gmail.com>)
 id 1WB7CG-000785-9S; Wed, 05 Feb 2014 18:27:42 +0000
Received: by mail-wi0-f173.google.com with SMTP id hn9so870440wib.12
 for <multiple recipients>; Wed, 05 Feb 2014 10:27:38 -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=z3SoMgJVUQTPeDhjAbbet/qWTyFPog47puplXPcru88=;
 b=cJ9N2iS40XUJAM1BdYbj6TwjZoHVtgjvFAwvEl3r+g1NF1Y1xFx0TCb4FLl29jcYo5
 oJRnkTqKCHj/Ki3JRXarnmzFA2UKOrv7Anhp0nAa+/qOq7iy+02rkPcz+9u2bz7Pfujn
 m6BHQ52W1HflkXxA4Z1KcgKkpvGnYpiPuKjjqjNTcnr0qb4mf9mlGKKtIiSmn1uTNy4N
 Hv9j+0SyGi2zh7h/QxD9XZI2KugL6Ti8CsG4/bNriASWi97uBfYJ5aAGvhN/UDli4yJl
 3fi+HKE3fFt5+VgQIgvHYvBSCLt4t+2kHAHFvCFQXKgoWdlw5JHS/aAJ4o3T8OVTsntv
 9xtA==
MIME-Version: 1.0
X-Received: by 10.194.8.229 with SMTP id u5mr670305wja.80.1391624858538; Wed,
 05 Feb 2014 10:27:38 -0800 (PST)
Received: by 10.227.158.4 with HTTP; Wed, 5 Feb 2014 10:27:38 -0800 (PST)
In-Reply-To: <20140205044328.GB2422724@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>
 <2486.1391495937@sss.pgh.pa.us>
 <CA+TgmobCN4ABNYS=4FwQP3MUNdJ8+rdoyedXNn5gGiWSEPdnWg@mail.gmail.com>
 <20140205044328.GB2422724@tornado.leadboat.com>
Date: Wed, 5 Feb 2014 13:27:38 -0500
Message-ID: 
 <CA+TgmobAS1wK7CgjC3bnT8CRscMEkjm2P+Ew9jt7yDTdoen5Vw@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: Noah Misch <noah@leadboat.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>,
 "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 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?

-- 
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