Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-hackers-owner+M243989=pgsql-hackers-arkari@postgresql.org>)
 id 1WAuKn-0005dd-3W
 for pgsql-hackers@arkaria.postgresql.org; Wed, 05 Feb 2014 04:43:37 +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+M243989=pgsql-hackers-arkari@postgresql.org>)
 id 1WAuKl-0007b3-9C
 for pgsql-hackers@arkaria.postgresql.org; Wed, 05 Feb 2014 04:43:35 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <noah@leadboat.com>) id 1WAuKk-0007an-9J
 for pgsql-hackers@postgresql.org; Wed, 05 Feb 2014 04:43:34 +0000
Received: from mail-qc0-f175.google.com ([209.85.216.175])
 by magus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <noah@leadboat.com>) id 1WAuKh-0008Ao-Ct
 for pgsql-hackers@postgresql.org; Wed, 05 Feb 2014 04:43:33 +0000
Received: by mail-qc0-f175.google.com with SMTP id x13so15126452qcv.20
 for <pgsql-hackers@postgresql.org>; Tue, 04 Feb 2014 20:43:30 -0800 (PST)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20130820;
 h=x-gm-message-state:date:from:to:cc:subject:message-id:references
 :mime-version:content-type:content-disposition:in-reply-to
 :user-agent;
 bh=f6ABTakuEosDpqhf8BHm+k3Sx41I9i+neoj6sVxQ7mo=;
 b=bk3MEfn3PUOnL/U/PPUpkIiatKMxV9FXGLv4Zak7COM/aHLb4yXrSUvtf8+QsZaEL2
 ouTmlaYWiV43BUJvbEkpC7eHIh9Z9/a1XAXxDg68+5lVE4is5gmm+Wni1bOBjaBaUUE1
 L/BFaK5MTMb5SapoFF/PWkpaFu0oMJLvlR/QrcK6Z8vQJybL+dGIsvaNYmsYDeeb+fAV
 A3Leos5Q6+SFIYX1+sS0yka9wTlILPznN+7teafl1mrV3GKpSsUzn0AQDWhuNTWK/yKj
 DqdN1saNDIg6owrPx3dZ530jcS+ShQsQadJk2HCoyQ7whz5pEKa1j+yJisz7aowuu1Ub
 nlYA==
X-Gm-Message-State: 
 ALoCoQkk1ezllNrBXyMZCwCcABmJlh5Ht1n5/gHRuKe1Hn9bNYXkWU/JLSEgB8v9chArPvAM8dHl
X-Received: by 10.140.49.9 with SMTP id p9mr67703975qga.75.1391575410074;
 Tue, 04 Feb 2014 20:43:30 -0800 (PST)
Received: from tornado.leadboat.com (c-107-4-219-91.hsd1.va.comcast.net.
 [107.4.219.91])
 by mx.google.com with ESMTPSA id 67sm35518494qgr.15.2014.02.04.20.43.29
 for <multiple recipients>
 (version=TLSv1 cipher=RC4-SHA bits=128/128);
 Tue, 04 Feb 2014 20:43:29 -0800 (PST)
Date: Tue, 4 Feb 2014 23:43:28 -0500
From: Noah Misch <noah@leadboat.com>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>,
 "pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>,
 pgsql-docs <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.)
Message-ID: <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>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: 
 <CA+TgmobCN4ABNYS=4FwQP3MUNdJ8+rdoyedXNn5gGiWSEPdnWg@mail.gmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-Pg-Spam-Score: -2.6 (--)
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 Tue, Feb 04, 2014 at 03:28:45PM -0500, Robert Haas wrote:
> 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.

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.

-- 
Noah Misch
EnterpriseDB                                 http://www.enterprisedb.com


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