Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtp (Exim 4.84_2)
	(envelope-from
 <pgsql-docs-owner+M9065=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
	id 1cRhwj-0003G6-Fk
	for pgsql-docs@arkaria.postgresql.org; Thu, 12 Jan 2017 16:09:49 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
	by malur.postgresql.org with smtp (Exim 4.84_2)
	(envelope-from
 <pgsql-docs-owner+M9065=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
	id 1cRhwi-0006DR-Sk
	for pgsql-docs@arkaria.postgresql.org; Thu, 12 Jan 2017 16:09:48 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256)
	(Exim 4.84_2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1cRhwM-0005nD-O7
	for pgsql-docs@postgresql.org; Thu, 12 Jan 2017 16:09:26 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256)
	(Exim 4.84_2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1cRhwI-0006GI-Ur
	for pgsql-docs@postgresql.org; Thu, 12 Jan 2017 16:09:26 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id v0CG9KWg021630;
	Thu, 12 Jan 2017 11:09:20 -0500
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Robert Haas <robertmhaas@gmail.com>
cc: =?UTF-8?Q?J=C3=BCrgen_Purtz?= <juergen@purtz.de>,
        pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Questionable tag usage
In-reply-to: 
 <CA+TgmoYozNAwrDRzMaZn8KJy9mVVsprHzzDmyk+4AjSYFxrGXw@mail.gmail.com>
References: <20170105.084028.597689697549228909.t-ishii@sraoss.co.jp>
 <47b30046-f492-c1ed-6a68-68efa1eb6d40@purtz.de>
 <CA+TgmoYozNAwrDRzMaZn8KJy9mVVsprHzzDmyk+4AjSYFxrGXw@mail.gmail.com>
Comments: In-reply-to Robert Haas <robertmhaas@gmail.com>
	message dated "Thu, 12 Jan 2017 10:50:10 -0500"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <21628.1484237360.1@sss.pgh.pa.us>
Content-Transfer-Encoding: 8bit
Date: Thu, 12 Jan 2017 11:09:20 -0500
Message-ID: <21629.1484237360@sss.pgh.pa.us>
X-Pg-Spam-Score: -5.1 (-----)
List-Archive: <http://archives.postgresql.org/pgsql-docs>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-docs.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@postgresql.org>
List-Post: <mailto:pgsql-docs@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-docs>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
X-Mailing-List: pgsql-docs
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

Robert Haas <robertmhaas@gmail.com> writes:
> On Wed, Jan 11, 2017 at 3:46 AM, Jürgen Purtz <juergen@purtz.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


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs