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 1jZZcg-0004rf-IN
	for pgsql-docs@arkaria.postgresql.org; Fri, 15 May 2020 12:39:30 +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 1jZZcf-0003Ph-BP
	for pgsql-docs@arkaria.postgresql.org; Fri, 15 May 2020 12:39:29 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1jZZcf-0003Pa-5Z
	for pgsql-docs@lists.postgresql.org; Fri, 15 May 2020 12:39:29 +0000
Received: from momjian.us ([72.94.173.45])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1jZZcb-00041O-D2
	for pgsql-docs@postgresql.org; Fri, 15 May 2020 12:39:28 +0000
Received: from bruce by momjian.us with local (Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1jZZcZ-0005Hz-JR
	for pgsql-docs@postgresql.org; Fri, 15 May 2020 08:39:23 -0400
Date: Fri, 15 May 2020 08:39:23 -0400
From: Bruce Momjian <bruce@momjian.us>
To: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Adding xreflable
Message-ID: <20200515123923.GB3894@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
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

You might know that while SGML's <link> requires you to specify link
text, <xref> can pull text from the "xreflabel" link site;  our
doc/src/sgml/README.links file explains it:

	<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
	
	linkend=
	        controls the target of the link/xref, required
	
	endterm=
	        for <xref>, allows the text of the link/xref to be taken from a
	        different link target title
	
	<link>
	        use to supply text for the link, only uses linkend, requires </link>
	        http://www.oasis-open.org/docbook/documentation/reference/html/link.html

I have noticed that our ref/*.sgml pages don't have such labels.  I
would like to add them and use them for our release notes.  Some of our
extensions need them too.

I think I need to backpatch this so that minor release notes can use
them too.  OK?  I have also noticed that the comment headings at the top
of our ref/*.sgml files are inconsistent and will fix those too.

-- 
  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 +