From 075fcc3cbdd873a06cf8d7737786bd1a59a7c98f Mon Sep 17 00:00:00 2001
From: Douglas Gregor <doug.gregor@gmail.com>
Date: Mon, 27 Oct 2003 01:13:34 +0000
Subject: [PATCH] doxygen/doxygen2boostbook.xsl: Don't strip <para> elements
 from within (generated) <purpose> elements; just make them <simpara>
 elements.

annotation.xsl: Added a "purpose" mode that strips paragraph elements
for printing the purpose in a comment

function.xsl: Don't compact methods or overloaded methods.


[SVN r20499]
---
 xsl/annotation.xsl                | 14 +++++++
 xsl/doxygen/doxygen2boostbook.xsl |  7 +++-
 xsl/function.xsl                  | 65 ++++++++++++++-----------------
 3 files changed, 49 insertions(+), 37 deletions(-)

diff --git a/xsl/annotation.xsl b/xsl/annotation.xsl
index a6c9116..ecabb47 100644
--- a/xsl/annotation.xsl
+++ b/xsl/annotation.xsl
@@ -268,4 +268,18 @@
       </xsl:apply-templates>
     </xsl:element>
   </xsl:template>
+
+  <!-- The "purpose" mode strips simpara/para elements so that we can
+       place the resulting text into a comment in the synopsis. -->
+  <xsl:template match="para|simpara" mode="purpose">
+    <xsl:apply-templates mode="annotation"/>
+  </xsl:template>
+
+  <xsl:template match="*" mode="purpose">
+    <xsl:apply-templates select="." mode="annotation"/>
+  </xsl:template>
+
+  <xsl:template match="text()" mode="purpose">
+    <xsl:apply-templates select="." mode="annotation"/>
+  </xsl:template>
 </xsl:stylesheet>
diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index 8d1f95d..1f27f49 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -1147,7 +1147,8 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
     <xsl:apply-templates select="." mode="passthrough"/>
   </xsl:template>
 
-  <!-- Remove top-level "para" and elements in the purpose -->
+  <!-- Replace top-level "para" elements with "simpara" elements in
+       the purpose -->
   <xsl:template match="*" mode="purpose">
     <xsl:apply-templates mode="passthrough"/>
   </xsl:template>
@@ -1157,7 +1158,9 @@ Cannot handle memberdef element with kind=<xsl:value-of select="@kind"/>
   </xsl:template>
 
   <xsl:template match="para" mode="purpose">
-    <xsl:apply-templates select="*|text()" mode="passthrough"/>
+    <simpara>
+      <xsl:apply-templates select="*|text()" mode="passthrough"/>
+    </simpara>
   </xsl:template>
 
  </xsl:stylesheet>
diff --git a/xsl/function.xsl b/xsl/function.xsl
index 8d857f4..53921fd 100644
--- a/xsl/function.xsl
+++ b/xsl/function.xsl
@@ -468,7 +468,8 @@
     <xsl:variable name="compact"
       select="not (para|description|requires|effects|postconditions|returns|
                    throws|complexity|notes|rationale) and 
-              ($boost.compact.function='1')"/>
+              ($boost.compact.function='1') and
+              not (local-name(.)='method')"/>
 
     <xsl:choose>
       <xsl:when test="$compact">
@@ -484,7 +485,7 @@
             <xsl:with-param name="text">
               <xsl:text>// </xsl:text>
               <xsl:apply-templates select="purpose/*|purpose/text()"
-                mode="annotation"/>
+                mode="purpose"/>
             </xsl:with-param>
           </xsl:call-template>
         </xsl:if>
@@ -512,7 +513,8 @@
     <xsl:variable name="compact"
       select="not (para|description|requires|effects|postconditions|returns|
                    throws|complexity|notes|rationale) and 
-              ($boost.compact.function='1')"/>
+              ($boost.compact.function='1') and
+              not (local-name(.)='overloaded-method')"/>
 
     <xsl:choose>
       <xsl:when test="$compact">
@@ -898,7 +900,8 @@
     <xsl:variable name="compact"
       select="not (para|description|requires|effects|postconditions|returns|
                    throws|complexity|notes|rationale) and 
-              ($boost.compact.function='1')"/>
+              ($boost.compact.function='1') and
+              not (local-name(.)='method')"/>
 
     <xsl:if test="not ($compact)">
       <xsl:call-template name="function.documentation">
@@ -1052,37 +1055,29 @@
   <xsl:template match="overloaded-method" mode="reference">
     <xsl:variable name="name" select="@name"/>
 
-    <!-- True if we should compact this function -->
-    <xsl:variable name="compact"
-      select="not (para|description|requires|effects|postconditions|returns|
-                   throws|complexity|notes|rationale) and 
-              ($boost.compact.function='1')"/>
-
-    <xsl:if test="not ($compact)">
-      <xsl:call-template name="function.documentation">
-        <xsl:with-param name="text">
-          <para>
-            <xsl:attribute name="id">
-              <xsl:call-template name="generate.id"/>
-            </xsl:attribute>
-            
-            <xsl:call-template name="preformatted">
-              <xsl:with-param name="text">
-                <xsl:for-each select="signature">
-                  <xsl:call-template name="function">
-                    <xsl:with-param name="indentation" select="0"/>
-                    <xsl:with-param name="is-reference" select="true()"/>
-                    <xsl:with-param name="name" select="$name"/>
-                    <xsl:with-param name="standalone" select="true()"/>
-                  </xsl:call-template>
-                </xsl:for-each>
-              </xsl:with-param>
-            </xsl:call-template>
-          </para>
-          <xsl:call-template name="function-requirements"/>
-        </xsl:with-param>
-      </xsl:call-template>
-    </xsl:if>
+    <xsl:call-template name="function.documentation">
+      <xsl:with-param name="text">
+        <para>
+          <xsl:attribute name="id">
+            <xsl:call-template name="generate.id"/>
+          </xsl:attribute>
+          
+          <xsl:call-template name="preformatted">
+            <xsl:with-param name="text">
+              <xsl:for-each select="signature">
+                <xsl:call-template name="function">
+                  <xsl:with-param name="indentation" select="0"/>
+                  <xsl:with-param name="is-reference" select="true()"/>
+                  <xsl:with-param name="name" select="$name"/>
+                  <xsl:with-param name="standalone" select="true()"/>
+                </xsl:call-template>
+              </xsl:for-each>
+            </xsl:with-param>
+          </xsl:call-template>
+        </para>
+        <xsl:call-template name="function-requirements"/>
+      </xsl:with-param>
+    </xsl:call-template>
   </xsl:template>
 
   <!-- Group member functions together under a category name (synopsis)-->