Received: from maia.hub.org (maia-2.hub.org [200.46.204.251])
	by mail.postgresql.org (Postfix) with ESMTP id 61A781337B67
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sat,  7 May 2011 15:29:15 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia,
	port 10024) with ESMTP id 04417-05 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sat,  7 May 2011 18:28:57 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from momjian.us (momjian.us [70.90.9.53])
	by mail.postgresql.org (Postfix) with ESMTP id 278ED133655C
	for <pgsql-docs@postgresql.org>; Sat,  7 May 2011 15:28:57 -0300 (ADT)
Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id
 p47ISvS27195;
	Sat, 7 May 2011 14:28:57 -0400 (EDT)
From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201105071828.p47ISvS27195@momjian.us>
Subject: Re: many contrib links are broken
In-Reply-To: <1304708829.28821.5.camel@vanquo.pezone.net>
To: Peter Eisentraut <peter_e@gmx.net>
Date: Sat, 7 May 2011 14:28:57 -0400 (EDT)
CC: pgsql-docs <pgsql-docs@postgresql.org>
X-Mailer: ELM [version 2.4ME+ PL124 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201105/31
X-Sequence-Number: 6706

Peter Eisentraut wrote:
> The commit 159e3d86292cfec2a2828f9f69ac7a6cb1be242d created some funny
> business out of many links to contrib modules.  Take a look at this
> page:
> 
> http://developer.postgresql.org/pgdocs/postgres/log-shipping-alternative.html
> 
> It now reads: "See the Section F.31 module for a reference
> implementation of this." (where it previously said "the pg_standby
> module")  There are many other places like that now.
> 
> I don't think the toolchain changed in this area, so the whole change
> was broken to begin with.  The idea is sound, IMO, but the
> implementation needs to be reevaluated.

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

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +