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
Date: Thu, 19 Sep 2024 18:05:29 -0400
Message-ID: <ZuygKUU5ZGWqFxOm@momjian.us> (raw)
In-Reply-To: <ZuyZoAdsViStKdhU@momjian.us>
References: <E1srJbs-0002Hr-V2@gemulon.postgresql.org>
<2029579.1726779139@sss.pgh.pa.us>
<ZuyZoAdsViStKdhU@momjian.us>
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?"
Attachments:master.diff (text/x-diff, 865B) downloaddiff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xslindex 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>
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-committers@postgresql.org
Cc: bruce@momjian.us, tgl@sss.pgh.pa.us, pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: doc PG relnotes: document "Unresolved ID reference found" cause
In-Reply-To: <ZuygKUU5ZGWqFxOm@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox