On Wed, Sep 18, 2024 at 10:16:48AM -0400, Tom Lane wrote: > Jelte Fennema-Nio <postg...@jeltef.nl> writes: > > On Wed, 18 Sept 2024 at 02:55, Bruce Momjian <br...@momjian.us> wrote: > >>> Also very clutter-y. I'm not convinced that any of this is a good > >>> idea that will stand the test of time: I estimate that approximately > >>> 0.01% of people who read the release notes will want these links. > > >> Yes, I think 0.01% is accurate. > > > I think that is a severe underestimation. > > I'm sure a very large fraction of the people commenting on this thread > would like to have these links. But we are by no means representative > of the average Postgres user.
I am confused how to proceed. I think Jian He did the work for PG 17 because it will help many users once PG 17 is released soon, and I wrote a script to automate this so we can easily continue this going forward. I agree with Tom that the PDF superscripts look odd. After researching XML and XPath, I have applied the attached patch to all branches, which supresses the section symbol and footnotes for PDF output. We only get a few requests a year for more details on release note items, and we tell them to look at the SGML source file to see the commit hashes, so this just isn't a frequently-requested need. On the flip side, this has been discussed for several years among active community members, usually around major release time. As I remember, the last idea was to do something with Javascript on mouse-over of an item. However, that would involve parsing the SGML in Javascript, which seems much more error-prone and harder to test than the Perl script I wrote. -- Bruce Momjian <br...@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?"
diff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xsl index 3a4a88a7288..739958bb804 100644 --- a/doc/src/sgml/stylesheet-fo.xsl +++ b/doc/src/sgml/stylesheet-fo.xsl @@ -14,6 +14,12 @@ <xsl:param name="tablecolumns.extension" select="0"></xsl:param> <xsl:param name="toc.max.depth">3</xsl:param> <xsl:param name="ulink.footnotes" select="1"></xsl:param> + +<!-- The release notes have too many ulinks to look good as footnotes in print mode --> +<xsl:template match="sect1[starts-with(@id, 'release-')]//ulink[starts-with(@url, 'https://postgr.es/c/')]"> + <!-- Do nothing for ulink to avoid footnotes --> +</xsl:template> + <xsl:param name="use.extensions" select="1"></xsl:param> <xsl:param name="variablelist.as.blocks" select="1"></xsl:param> <xsl:param name="orderedlist.label.width">1.5em</xsl:param>
