public inbox for [email protected]  

help / color / mirror / Atom feed

From: Bruce Momjian <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: pgsql-docs <[email protected]>
Subject: Re: many contrib links are broken
Date: Sat, 7 May 2011 14:28:57 -0400 (EDT)
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>

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  <[email protected]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

view thread (4+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: many contrib links are broken
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox