Skip to content

Commit 4c9f9a8

Browse files
committed
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/[email protected] Backpatch-through: 12
1 parent 0d530cf commit 4c9f9a8

File tree

2 files changed

+14
-0
lines changed

2 files changed

+14
-0
lines changed

doc/src/sgml/release.sgml

+9
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,15 @@ For new features, add links to the documentation sections.
7171
review, so each item is truly a community effort.
7272
</para>
7373

74+
<para id="release-no-print-output">
75+
Section markers (&sect;) in the release notes link to <ulink
76+
url="https://git.postgresql.org/gitweb/?p=postgresql.git"><application>gitweb</application></ulink>
77+
pages which show the primary <application>git</application> commit
78+
messages and source tree changes responsible for the release note item.
79+
There might be additional <application>git</application> commits which
80+
are not shown.
81+
</para>
82+
7483
<!--
7584
When beginning a new major-release series, create a new release-NN.sgml
7685
file, removing the previous one, and change the &-reference here.

doc/src/sgml/stylesheet-fo.xsl

+5
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,11 @@
1616
<!-- Do nothing for ulink to avoid footnotes -->
1717
</xsl:template>
1818

19+
<!-- Also suppress the description of the section markers in print mode -->
20+
<xsl:template match="appendix[@id='release']//para[@id='release-no-print-output']">
21+
<!-- Output nothing for this para -->
22+
</xsl:template>
23+
1924
<xsl:param name="use.extensions" select="1"></xsl:param>
2025
<xsl:param name="variablelist.as.blocks" select="1"></xsl:param>
2126
<xsl:param name="orderedlist.label.width">1.5em</xsl:param>

0 commit comments

Comments
 (0)