Re: Questionable tag usage

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: Jürgen Purtz <juergen(at)purtz(dot)de>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Questionable tag usage
Date: 2017-01-12 16:09:20
Message-ID: 21629.1484237360@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Robert Haas <robertmhaas(at)gmail(dot)com> writes:
> On Wed, Jan 11, 2017 at 3:46 AM, Jürgen Purtz <juergen(at)purtz(dot)de> wrote:
>> (1) There is a general distinction in the meaning of the two elements:
>> <xref> is an internal link with validation semantic whereas <link> is an
>> external link to any URL. See:
>> http://doccookbook.sourceforge.net/html/en/dbc.markup.xref-vs-link.html

> Eh, we use both <link> and <xref> for internal links and surely want
> both to be validated. If that's no longer happening I don't think it
> will be long before it bites us.

I think that is talking about something different, namely the difference
between linkend and href properties. linkend points to a tag in the
current document, and AFAIK it behaves the same in <link> or <xref>.
href is used for external links.

The author of the cited page may believe that <link linkend=...> is bad
style, but he doesn't say that in so many words, and even if he did
I'm not sure I would agree.

regards, tom lane

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Euler Taveira 2017-01-12 17:59:12 Re: complete 'C' trigger example needs fmgr.h
Previous Message Robert Haas 2017-01-12 15:50:10 Re: Questionable tag usage