Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M8177=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1YNXsm-0006VA-0M
 for pgsql-docs@arkaria.postgresql.org; Tue, 17 Feb 2015 02:27:28 +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+M8177=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1YNXsl-0005on-GG
 for pgsql-docs@arkaria.postgresql.org; Tue, 17 Feb 2015 02:27:27 +0000
Received: from makus.postgresql.org ([2001:4800:1501:1::229])
 by malur.postgresql.org with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256)
 (Exim 4.80) (envelope-from <tgl@sss.pgh.pa.us>) id 1YNXsk-0005oh-U6
 for pgsql-docs@postgresql.org; Tue, 17 Feb 2015 02:27:27 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
 by makus.postgresql.org with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256)
 (Exim 4.80) (envelope-from <tgl@sss.pgh.pa.us>) id 1YNXsh-0003rI-UG
 for pgsql-docs@postgresql.org; Tue, 17 Feb 2015 02:27:25 +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 t1H2RA9u025547;
 Mon, 16 Feb 2015 21:27:11 -0500
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
cc: Craig Ringer <craig@2ndquadrant.com>, pgsql-docs@postgresql.org
Subject: Re: xref labels: "Chapter 33", "Section 33.2"
In-reply-to: <20150216220834.GE24298@momjian.us>
References: 
 <CAMsr+YHXymNUBe0XTU=PL3GXKdpmQA38tZwMFDywzowKWtmztA@mail.gmail.com>
 <20150216220834.GE24298@momjian.us>
Comments: In-reply-to Bruce Momjian <bruce@momjian.us>
 message dated "Mon, 16 Feb 2015 17:08:34 -0500"
Date: Mon, 16 Feb 2015 21:27:10 -0500
Message-ID: <25546.1424140030@sss.pgh.pa.us>
X-Pg-Spam-Score: -1.9 (-)
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

Bruce Momjian <bruce@momjian.us> writes:
> On Mon, Feb 16, 2015 at 05:05:39PM +1300, Craig Ringer wrote:
>> I can't seem to make an <xref linkend="spi"> render the <title>...</title>
>> element text. The DocBook documentation implies that this should be the
>> default; e.g. if you have:

> Have you read README.links in the sgml top-level directory?

I think Craig's question is more about our overall house style/policy, ie,
how do we want such links to be rendered?  I am definitely *not* in favor
of authors of portions of the docs trying to impose their own opinions on
individual links, which is where his question seems to be leading.  But it
is a fair question whether we'd like to change the currently existing
global rendering decision, and if so what would be the best way to
implement that.

I suspect that the answer is different in different output formats,
for example PDF format would probably prefer oldschool chapter/section
numbers even if we go over to names in HTML versions.  (Consider the
manual printed on dead trees: named links would be of *zero* value there,
while you could still flip to a numbered section reasonably quickly.)
This is another reason for not thinking that hacking the text link-by-link
is an appropriate answer.

			regards, tom lane


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