postgres.git / summary / log / commit / refs
commit 923241acb15659c8fbbadeab1a6ce7b687672fd3
Author: Bruce Momjian <bruce@momjian.us>
Date: Wed Sep 18 21:13:19 2024 +0000
First released in: 18.0, 12.21, 13.17, 14.14, 15.9, 16.5, 17.0
doc PG relnotes: add paragraph explaining the section symbol
And suppress the symbol in print mode, where the section symbol does not
appear.
Discussion: https://postgr.es/m/ZuobILbmGGetxEg5@momjian.us
Backpatch-through: 12
doc/src/sgml/release.sgml | 9 +++++++++
doc/src/sgml/stylesheet-fo.xsl | 5 +++++
2 files changed, 14 insertions(+)
diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index f2aadd48d43..b9103ab7f08 100644
--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
@@ -69,6 +69,15 @@ For new features, add links to the documentation sections.
review, so each item is truly a community effort.
</para>
+ <para id="release-no-print-output">
+ Section markers (§) in the release notes link to <ulink
+ url="https://git.postgresql.org/gitweb/?p=postgresql.git"><application>gitweb</application></ulink>
+ pages which show the primary <application>git</application> commit
+ messages and source tree changes responsible for the release note item.
+ There might be additional <application>git</application> commits which
+ are not shown.
+ </para>
+
<!--
When beginning a new major-release series, create a new release-NN.sgml
file, removing the previous one, and change the &-reference here.
diff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xsl
index 647666727cf..9378ba350c2 100644
--- a/doc/src/sgml/stylesheet-fo.xsl
+++ b/doc/src/sgml/stylesheet-fo.xsl
@@ -16,6 +16,11 @@
<!-- Do nothing for ulink to avoid footnotes -->
</xsl:template>
+<!-- Also suppress the description of the section markers in print mode -->
+<xsl:template match="appendix[@id='release']//para[@id='release-no-print-output']">
+ <!-- Output nothing for this para -->
+</xsl:template>
+
<xsl:param name="use.extensions" select="1"></xsl:param>
<xsl:param name="variablelist.as.blocks" select="1"></xsl:param>
[parent: 67ffd2eb52a5]