From 8b5189e24ed57b47c398de169a44acbfcfb378df Mon Sep 17 00:00:00 2001
From: Andrey Semashev <andrey.semashev@gmail.com>
Date: Sun, 30 Jun 2024 18:16:04 +0300
Subject: [PATCH] Conceal template parameter defaults that refer to
 implementation details.

Similar to other contexts, replace default types and values in template
parameter lists that mention implementation details, as configured in
boost.doxygen.detail parameter, with "unspecified".

This fixes dangling refs to implementation detail types and values that
were removed from BoostBook output but are still mentioned in template
parameter defaults.
---
 xsl/doxygen/doxygen2boostbook.xsl | 34 ++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index 27dee2e..d35df55 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -670,8 +670,15 @@
           </xsl:attribute>
           <xsl:if test="defval">
             <default>
-              <xsl:apply-templates select="defval/*|defval/text()" 
-                mode="passthrough"/>
+              <xsl:choose>
+                <xsl:when test="contains(string(defval), $boost.doxygen.detail)">
+                  <emphasis>unspecified</emphasis>
+                </xsl:when>
+                <xsl:otherwise>
+                  <xsl:apply-templates select="defval/*|defval/text()"
+                    mode="passthrough"/>
+                </xsl:otherwise>
+              </xsl:choose>
             </default>
           </xsl:if>
           <xsl:for-each select="../../detaileddescription//parameterlist[@kind='templateparam']/parameteritem">
@@ -696,8 +703,15 @@
           </xsl:attribute>
           <xsl:if test="defval">
             <default>
-              <xsl:apply-templates select="defval/*|defval/text()" 
-                mode="passthrough"/>
+              <xsl:choose>
+                <xsl:when test="contains(string(defval), $boost.doxygen.detail)">
+                  <emphasis>unspecified</emphasis>
+                </xsl:when>
+                <xsl:otherwise>
+                  <xsl:apply-templates select="defval/*|defval/text()"
+                    mode="passthrough"/>
+                </xsl:otherwise>
+              </xsl:choose>
             </default>
           </xsl:if>
           <xsl:for-each select="../../detaileddescription//parameterlist[@kind='templateparam']/parameteritem">
@@ -722,8 +736,15 @@
           </type>
           <xsl:if test="defval">
             <default>
-              <xsl:apply-templates select="defval/*|defval/text()" 
-                mode="passthrough"/>
+              <xsl:choose>
+                <xsl:when test="contains(string(defval), $boost.doxygen.detail)">
+                  <emphasis>unspecified</emphasis>
+                </xsl:when>
+                <xsl:otherwise>
+                  <xsl:apply-templates select="defval/*|defval/text()"
+                    mode="passthrough"/>
+                </xsl:otherwise>
+              </xsl:choose>
             </default>
           </xsl:if>
           <xsl:for-each select="../../detaileddescription//parameterlist[@kind='templateparam']/parameteritem">
@@ -1143,7 +1164,6 @@
                 mode="passthrough"/>
             </xsl:otherwise>
           </xsl:choose>
-
         </default>
       </xsl:if>