From: Bill Spitzak <spitzak@gmail.com>
Date: Fri, 19 Dec 2014 04:15:08 +0000 (-0800)
Subject: doc: Document structures and unions in addition to classes
X-Git-Tag: 1.6.91~2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=0d0a62c79a65c5961db5f108fc4bff84691f8f1c;p=platform%2Fupstream%2Fwayland.git

doc: Document structures and unions in addition to classes

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.

Tested-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
---

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>