From 02fd5d3611b921698f5c5e483a941c48b2374f09 Mon Sep 17 00:00:00 2001
From: Douglas Gregor <doug.gregor@gmail.com>
Date: Sat, 15 Nov 2003 05:36:47 +0000
Subject: [PATCH] function.xsl: Default values can not be annotated

doxygen/doxygen2boostbook.xsl: If the string "detail::" is found in a
type or default argument, the type/argument is replaced with
"unspecified".


[SVN r20810]
---
 xsl/doxygen/doxygen2boostbook.xsl | 42 +++++++++++++++++++------------
 xsl/function.xsl                  | 13 ++++++++--
 2 files changed, 37 insertions(+), 18 deletions(-)

diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index 1f27f49..95b69e9 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -19,6 +19,10 @@
     This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
   </xsl:param>
 
+  <!-- The substring used to identify unspecified types that we can't
+       mask from within Doxygen. This is a hack (big surprise). -->
+  <xsl:param name="boost.doxygen.detail">detail::</xsl:param>
+
   <xsl:output method="xml" indent="yes" standalone="yes"/>
 
   <xsl:key name="compounds-by-kind" match="compounddef" use="@kind"/>
@@ -651,10 +655,7 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
       <xsl:apply-templates select="briefdescription" mode="passthrough"/>
       <xsl:apply-templates select="detaileddescription" mode="passthrough"/>
       
-      <type>
-        <xsl:apply-templates select="type/text()|type/*"
-          mode="passthrough"/>
-      </type>
+      <type><xsl:apply-templates select="type"/></type>
     </typedef>
   </xsl:template>
 
@@ -667,15 +668,21 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
       </xsl:attribute>
 
       <!-- Parameter type -->
-      <paramtype>
-        <xsl:apply-templates select="type"/>
-      </paramtype>
+      <paramtype><xsl:apply-templates select="type"/></paramtype>
 
       <!-- Default argument -->
       <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>
 
@@ -786,9 +793,7 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
             </xsl:attribute>
             
             <!-- Return type -->
-            <type>
-              <xsl:apply-templates select="type"/>
-            </type>
+            <type><xsl:apply-templates select="type"/></type>
             
             <xsl:call-template name="function.children"/>
           </function>          
@@ -905,9 +910,7 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
       </xsl:if>
 
       <!-- Return type -->
-      <type>
-        <xsl:apply-templates select="type"/>
-      </type>
+      <type><xsl:apply-templates select="type"/></type>
 
       <xsl:call-template name="function.children"/>
     </method>
@@ -1035,7 +1038,14 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
   </xsl:template>
 
   <xsl:template match="type">
-    <xsl:apply-templates mode="type"/>
+    <xsl:choose>
+      <xsl:when test="contains(string(.), $boost.doxygen.detail)">
+        <emphasis>unspecified</emphasis>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:apply-templates mode="type"/>
+      </xsl:otherwise>
+    </xsl:choose>
   </xsl:template>
 
   <xsl:template match="ref" mode="type">
diff --git a/xsl/function.xsl b/xsl/function.xsl
index 53921fd..3f4294f 100644
--- a/xsl/function.xsl
+++ b/xsl/function.xsl
@@ -376,7 +376,16 @@
           </xsl:when>
           <xsl:when test="$parameter/default">
             <xsl:text> = </xsl:text>
-            <xsl:value-of select="string($parameter/default)"/>
+            <xsl:choose>
+              <xsl:when test="$final">
+                <xsl:apply-templates
+                  select="$parameter/default/*|$parameter/default/text()"
+                  mode="annotation"/>
+              </xsl:when>
+              <xsl:otherwise>
+                <xsl:value-of select="string($parameter/default)"/>
+              </xsl:otherwise>
+            </xsl:choose>
           </xsl:when>
         </xsl:choose>
       </xsl:variable>
@@ -399,7 +408,7 @@
                 <xsl:with-param name="highlight" select="true()"/>
               </xsl:apply-templates>
               <xsl:value-of select="$name"/>
-              <xsl:value-of select="$default"/>
+              <xsl:copy-of select="$default"/>
             </xsl:when>
             <xsl:otherwise>
               <xsl:value-of select="concat($prefix, $text)"/>