Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1jZdV1-0004h7-If
	for pgsql-docs@arkaria.postgresql.org; Fri, 15 May 2020 16:47:51 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1jZdV0-0005eI-Ed
	for pgsql-docs@arkaria.postgresql.org; Fri, 15 May 2020 16:47:50 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1jZdV0-0005eB-9D
	for pgsql-docs@lists.postgresql.org; Fri, 15 May 2020 16:47:50 +0000
Received: from momjian.us ([72.94.173.45])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1jZdUy-0006wE-44
	for pgsql-docs@postgresql.org; Fri, 15 May 2020 16:47:49 +0000
Received: from bruce by momjian.us with local (Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1jZdUx-00047Z-1t; Fri, 15 May 2020 12:47:47 -0400
Date: Fri, 15 May 2020 12:47:47 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Adding xreflable
Message-ID: <20200515164747.GH3894@momjian.us>
References: <20200515123923.GB3894@momjian.us>
 <18482.1589549850@sss.pgh.pa.us>
 <20200515134900.GD3894@momjian.us>
 <19807.1589551746@sss.pgh.pa.us>
 <20200515142204.GE3894@momjian.us>
 <22323.1589555218@sss.pgh.pa.us>
 <20200515153034.GG3894@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20200515153034.GG3894@momjian.us>
User-Agent: Mutt/1.10.1 (2018-07-13)
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk

On Fri, May 15, 2020 at 11:30:34AM -0400, Bruce Momjian wrote:
> On Fri, May 15, 2020 at 11:06:58AM -0400, Tom Lane wrote:
> > Bruce Momjian <bruce@momjian.us> writes:
> > > Well, I would like both the SQL command references and the application
> > > man pages to have xreflabel text.
> > 
> > I guess my point is that in the other several thousand pages of the docs,
> > we just use <xref linkend="sql-whatever"/> or <xref
> > linkend="app-whatever"/>, and it looks fine and works fine.  Why are you
> > insisting on doing it differently in the release notes?
> > 
> > (I also have a vague memory that we used to use special xref labels for
> > SQL commands, and got rid of it.  So this seems like undoing history
> > with no solid reasoning.  That was with the previous doc toolchain of
> > course, but it's still the case that we don't seem to need this.)
> 
> I think I see it now.  Our README.links says:
> 
> <xref>
>         use to get chapter/section number from the title of the target
> -->     link, or xreflabel if defined at the target, or refentrytitle if target
> -->     is a refentry;  has no close tag
>         http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
> 
> I was not aware that refentry can pull from refentrytitle.  I just
> tested it for pg_upgrade, and it worked fine.  I will adjust the release
> notes now to use them.  Thanks.

Done.  Thanks for the tips.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EnterpriseDB                             https://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +