Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id EADF81337C1B
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sat,  7 May 2011 17:53:21 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia,
	port 10024) with ESMTP id 69312-03 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sat,  7 May 2011 20:53:14 +0000 (UTC)
X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6
Received: from mailout-de.gmx.net (mailout-de.gmx.net [213.165.64.23])
	by mail.postgresql.org (Postfix) with SMTP id 5F5081337C28
	for <pgsql-docs@postgresql.org>; Sat,  7 May 2011 17:52:53 -0300 (ADT)
Received: (qmail invoked by alias); 07 May 2011 20:52:52 -0000
Received: from a88-115-218-165.elisa-laajakaista.fi (EHLO [10.0.0.101])
	[88.115.218.165]
	by mail.gmx.net (mp023) with SMTP; 07 May 2011 22:52:52 +0200
X-Authenticated: #495269
X-Provags-ID: V01U2FsdGVkX190JN1vU9Z0UO06bKI+5iBk1hJ2mP6ppSBuylQote
	+RlnocZG1eO2fa
Subject: Re: many contrib links are broken
From: Peter Eisentraut <peter_e@gmx.net>
To: Bruce Momjian <bruce@momjian.us>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
In-Reply-To: <201105071828.p47ISvS27195@momjian.us>
References: <201105071828.p47ISvS27195@momjian.us>
Content-Type: text/plain; charset="UTF-8"
Date: Sat, 07 May 2011 23:52:50 +0300
Message-ID: <1304801570.15989.9.camel@vanquo.pezone.net>
Mime-Version: 1.0
X-Mailer: Evolution 2.32.2 
Content-Transfer-Encoding: 8bit
X-Y-GMX-Trusted: 0
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.909 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201105/32
X-Sequence-Number: 6707

On lör, 2011-05-07 at 14:28 -0400, Bruce Momjian wrote:
> Yep, this clearly needs cleanup.  The README.links file I wrote says:
> 
> <xref>
>         use to get link text from the title of the target link; has no
>         close tag
> 
> http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
> 
> Is that not true?

It is not true in general.

> The URL seems to suggest that the title is used if
> there is no xreflabel, though it suggests the the supplied text is
> "Chapter ##:  title".  Of course, we are not seeing that behavior so
> maybe README.links is wrong.

Using xreflabel might be the fix, but you'll have to try it to see if it
comes out OK.