Date: Thu, 19 Sep 2024 18:05:29 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: doc PG relnotes: document "Unresolved ID reference found"
 cause
Message-ID: <ZuygKUU5ZGWqFxOm@momjian.us>
References: <E1srJbs-0002Hr-V2@gemulon.postgresql.org>
 <2029579.1726779139@sss.pgh.pa.us>
 <ZuyZoAdsViStKdhU@momjian.us>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="6Q9nMbKXDAuPpqUz"
Content-Disposition: inline
In-Reply-To: <ZuyZoAdsViStKdhU@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/ZuygKUU5ZGWqFxOm%40momjian.us>
Precedence: bulk


--6Q9nMbKXDAuPpqUz
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Thu, Sep 19, 2024 at 05:37:36PM -0400, Bruce Momjian wrote:
> On Thu, Sep 19, 2024 at 04:52:19PM -0400, Tom Lane wrote:
> > Bruce Momjian <bruce@momjian.us> writes:
> > > doc PG relnotes:  document "Unresolved ID reference found" cause
> > 
> > I'm really not happy with this.  We've sweated blood to get rid
> > of all those PDF warnings.  Introducing one on a permanent basis
> > is not acceptable.
> 
> Okay, what do you suggest?  I am trying to see if an empty paragraph
> will fix it.

It sounds like this problem:

	https://www.oxygenxml.com/forum/dita-editing-and-publishing-dita-content/topic22035.html

I have applied the attached solution by using some more XPath magic. 
Turns out making the paragraph empty, instead of removing it, prevents
the warning.

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

  When a patient asks the doctor, "Am I going to die?", he means 
  "Am I going to die soon?"

--6Q9nMbKXDAuPpqUz
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="master.diff"

diff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xsl
index bb22a92d0af..e7916a6a883 100644
--- a/doc/src/sgml/stylesheet-fo.xsl
+++ b/doc/src/sgml/stylesheet-fo.xsl
@@ -22,11 +22,11 @@
 
 <!--
 Suppress the description of the commit link markers in print mode.
-Caues an "Unresolved ID reference found" warning during PDF builds
-because the paragraph is suppressed in the output.
+Use "node()" to keep the paragraph but remove all content;  prevents
+an "Unresolved ID reference found" warning during PDF builds.
 -->
-<xsl:template match="appendix[@id='release']//para[@id='release-commit-links']">
-  <!-- Output nothing for this para -->
+<xsl:template match="appendix[@id='release']//para[@id='release-commit-links']//node()">
+  <!-- Output an empty para -->
 </xsl:template>
 
 <xsl:param name="use.extensions" select="1"></xsl:param>

--6Q9nMbKXDAuPpqUz--