Update AS integration scripts and transforms - extract out the module description...

[pub/USBasp.git] / LUFA / StudioIntegration / XSLT / lufa_module_transform.xslt

diff --git a/LUFA/StudioIntegration/XSLT/lufa_module_transform.xslt b/LUFA/StudioIntegration/XSLT/lufa_module_transform.xslt
index 65ff2f0..9146202 100644 (file)
--- a/LUFA/StudioIntegration/XSLT/lufa_module_transform.xslt
+++ b/LUFA/StudioIntegration/XSLT/lufa_module_transform.xslt
@@ -17,6 +17,9 @@
        <!-- Store the LUFA Doxygen tag filename mentioned in the root node for later use -->
        <xsl:param name="lufa-doxygen-tagfile" select="lufa-manifest/@tagfile"/>
 
+       <!-- Store the LUFA Doxygen documentation filename mentioned in the root node for later use -->
+       <xsl:param name="lufa-doxygen-docfile" select="lufa-manifest/@docfile"/>
+
        <!-- Read manifest list, add a comment to indicate the source filename
             and then copy/process all ASF nodes in the referenced document -->
        <xsl:template match="lufa-manifest">
@@ -38,22 +41,20 @@
        </xsl:template>
 
        <!-- For Doxygen entry point nodes we need to convert them into help link
-            nodes instead, so that they show up as links in Studio correctly -->
+            nodes instead and add descriptions, so that they show up as links in
+            Studio correctly -->
        <xsl:template match="build[@type='doxygen-entry-point']">
-               <xsl:call-template name="add_help_nodes">
-                   <xsl:with-param name="filename" select="document($lufa-doxygen-tagfile)//compound[name=current()/@value]/filename"/>
-               </xsl:call-template>
-       </xsl:template>
-
-       <!-- Generate additional help nodes from the given help filename -->
-       <xsl:template name="add_help_nodes">
-               <xsl:param name="filename"/>
-
                <build type="online-help" subtype="module-help-page-append">
                        <xsl:attribute name="value">
-                           <xsl:value-of select="$filename"/>
+                               <!-- Extract filename of the HTML file that contains the documentation for this module from the Doxgen tag file -->
+                           <xsl:value-of select="document($lufa-doxygen-tagfile)/tagfile/compound[name=current()/@value]/filename"/>
                        </xsl:attribute>
                </build>
+
+               <info type="description" value="summary">
+                       <!-- Extract brief description of the module from the Doxygen combined XML documentation file -->
+                       <xsl:value-of select="document($lufa-doxygen-docfile)/doxygen/compounddef[compoundname=current()/@value]/briefdescription/para"/>
+               </info>
        </xsl:template>
 
 </xsl:stylesheet>