From: Peter Eisentraut <peter_e@gmx.net>
Date: Wed, 15 Mar 2017 03:12:18 +0000 (-0400)
Subject: doc: Fix TOC generation for refentries
X-Git-Tag: REL_10_BETA1~639
X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=0c068205df5299fa41bce8ac33acdc9cfa5e7c6a;p=postgresql.git

doc: Fix TOC generation for refentries

The XSLT stylesheets by default don't show refentries inside sections in
table of contents, which for our documentation leads to some regressions
compared to the DSSSL output.  For example, in the SPI chapter, which is
mostly refentries, you don't get any usable table of contents.  Tweak
things so it's mostly back to what it was before.
---

diff --git a/doc/src/sgml/stylesheet.xsl b/doc/src/sgml/stylesheet.xsl
index 42e8cce3688..efcb80ffca2 100644
--- a/doc/src/sgml/stylesheet.xsl
+++ b/doc/src/sgml/stylesheet.xsl
@@ -63,6 +63,18 @@ section   toc
 set       toc,title
 </xsl:param>
 
+<xsl:param name="generate.section.toc.level" select="1"></xsl:param>
+
+<!-- include refentry under sect1 in tocs -->
+<xsl:template match="sect1" mode="toc">
+  <xsl:param name="toc-context" select="."/>
+  <xsl:call-template name="subtoc">
+    <xsl:with-param name="toc-context" select="$toc-context"/>
+    <xsl:with-param name="nodes" select="sect2|refentry
+                                         |bridgehead[$bridgehead.in.toc != 0]"/>
+  </xsl:call-template>
+</xsl:template>
+
 
 <!-- Put index "quicklinks" (A | B | C | ...) at the top of the bookindex page. -->