X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [200.46.204.2])
	by svr1.postgresql.org (Postfix) with ESMTP
	id 31452D1C4BC; Mon,  9 Feb 2004 09:24:10 +0000 (GMT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (neptune.hub.org [200.46.204.2]) (amavisd-new, port 10024)
	with ESMTP id 40603-02; Mon,  9 Feb 2004 05:24:01 -0400 (AST)
Received: from curie.credativ.org (credativ.com [217.160.209.18])
	by svr1.postgresql.org (Postfix) with ESMTP
	id E2400D1CCB2; Mon,  9 Feb 2004 05:23:53 -0400 (AST)
Received: from localhost (localhost [127.0.0.1])
	by curie.credativ.org (Postfix) with ESMTP
	id BB28655EED; Mon,  9 Feb 2004 10:24:00 +0100 (CET)
Received: from colt.pezone.net (dsl-213-023-254-025.arcor-ip.net
	[213.23.254.25]) (using TLSv1 with cipher RC4-MD5 (128/128 bits))
	(No client certificate requested)
	by curie.credativ.org (Postfix) with ESMTP
	id D062855BEB; Mon,  9 Feb 2004 10:23:59 +0100 (CET)
From: Peter Eisentraut <peter_e@gmx.net>
To: Michael Glaesemann <grzm@myrealbox.com>,
	Tom Lane <tgl@sss.pgh.pa.us>
Subject: Re: [HACKERS] Linking the previously separated documentation
Date: Mon, 9 Feb 2004 10:23:58 +0100
User-Agent: KMail/1.5.1
Cc: pgsql-docs@postgresql.org, pgsql-hackers@postgresql.org
References: <381A237E-5AAE-11D8-98AB-000A95C88220@myrealbox.com>
	<9500.1076303804@sss.pgh.pa.us>
	<CEE92AA8-5AC4-11D8-98AB-000A95C88220@myrealbox.com>
In-Reply-To: <CEE92AA8-5AC4-11D8-98AB-000A95C88220@myrealbox.com>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200402091023.58803.peter_e@gmx.net>
X-Virus-Scanned: by AMaViS at credativ.com
X-Virus-Scanned: by amavisd-new at postgresql.org
X-Archive-Number: 200402/4
X-Sequence-Number: 2259

Michael Glaesemann wrote:
> If I'm understanding you correctly, that's what I'm doing. Here's an
> example of the change:
>
> Original:
>      Please familiarize yourself with the
>      <citerefentry><refentrytitle>pg_dump</> reference page.
>
> Revised:
>      Please familiarize yourself with the
>      <citerefentry><refentrytitle><xref linkend="APP-PGDUMP"></></>
> reference page.

If you write xref then you already say that this is a cross-reference, 
so you don't need the citerefentry element.  (citerefentry is typically 
used to automatically link all occurences to the location of the 
manpage.  For instance, FreeBSD uses it to link all refentry 
"citations" to their online manpage gateway.)