[PATCH 4/7] doc: Document structures and unions in addition to classes

Bill Spitzak spitzak at gmail.com
Thu Dec 18 20:15:08 PST 2014


This provides targets for some of the doxygen links, and some of
them have useful memberof function lists.

Added some if/else statements to reduce validation errors.
---
 doc/publican/doxygen-to-publican.xsl |   25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/doc/publican/doxygen-to-publican.xsl b/doc/publican/doxygen-to-publican.xsl
index 08a71e7..dfd47ee 100644
--- a/doc/publican/doxygen-to-publican.xsl
+++ b/doc/publican/doxygen-to-publican.xsl
@@ -36,13 +36,13 @@
       'SC', 'sc')"/>.
     </para>
 
-    <xsl:apply-templates select="/doxygen/compounddef[@kind='class']" />
+    <xsl:apply-templates select="/doxygen/compounddef[@kind!='file' and @kind!='dir']" />
 
     <section id="{$which}-Functions">
       <title>Functions</title>
       <para />
       <variablelist>
-        <xsl:apply-templates select="/doxygen/compounddef[@kind!='class']/sectiondef/memberdef" />
+        <xsl:apply-templates select="/doxygen/compounddef[@kind='file']/sectiondef/memberdef" />
       </variablelist>
     </section>
 
@@ -146,7 +146,6 @@
 
 <!-- classes -->
 <xsl:template match="compounddef" >
-  <xsl:if test="@kind = 'class'">
     <section id="{$which}-{@id}">
         <title>
             <xsl:value-of select="compoundname" />
@@ -154,13 +153,19 @@
                 - <xsl:apply-templates select="briefdescription" />
             </xsl:if>
         </title>
-
-        <xsl:apply-templates select="detaileddescription" />
-
-        <variablelist>
-          <xsl:apply-templates select="sectiondef/memberdef" />
-        </variablelist>
+        <xsl:choose>
+          <xsl:when test="normalize-space(detaileddescription) != ''">
+            <xsl:apply-templates select="detaileddescription" />
+          </xsl:when>
+          <xsl:otherwise>
+            <para />
+          </xsl:otherwise>
+        </xsl:choose>
+        <xsl:if test="sectiondef/memberdef[@kind='function' and @static='no']">
+          <variablelist>
+            <xsl:apply-templates select="sectiondef/memberdef" />
+          </variablelist>
+        </xsl:if>
     </section>
-  </xsl:if>
 </xsl:template>
 </xsl:stylesheet>
-- 
1.7.9.5



More information about the wayland-devel mailing list