Re: many contrib links are broken

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: many contrib links are broken
Date: 2011-05-08 02:25:32
Message-ID: 201105080225.p482PWe03624@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Peter Eisentraut wrote:
> 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.

Thanks for the help. I added xreflabels to the contrib module pages and
that fixed the item you showed me, so we should be good now. I also
updated README.links to accurately descripbe xref. Applied patch
attached.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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

Attachment Content-Type Size
/rtmp/diff text/x-diff 24.9 KB

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2011-05-08 02:33:20 Re: Change to documentation headers
Previous Message Peter Eisentraut 2011-05-07 21:38:18 Re: should pg_basebackup be listed as a server application?