diff options
| author | Bruce Momjian <bruce@momjian.us> | 2024-09-18 17:13:19 -0400 |
|---|---|---|
| committer | Bruce Momjian <bruce@momjian.us> | 2024-09-18 17:13:19 -0400 |
| commit | d1389c2939fb6c4ae653fa5a5d484a7792ecfdc5 (patch) | |
| tree | 2861b7efd998d91d3407c4d7705628cbf58b0400 | |
| parent | 97ce16c7da99e8e5bb81c8dac51934fe8d68499c (diff) | |
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
| -rw-r--r-- | doc/src/sgml/release.sgml | 9 | ||||
| -rw-r--r-- | doc/src/sgml/stylesheet-fo.xsl | 5 |
2 files changed, 14 insertions, 0 deletions
diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml index 25e00556f8e..ed591478f4f 100644 --- a/doc/src/sgml/release.sgml +++ b/doc/src/sgml/release.sgml @@ -71,6 +71,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 6eadfc58267..4c254a84a18 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> <xsl:param name="orderedlist.label.width">1.5em</xsl:param> |