From ebd059d0eb07055d3d949f53ba284e23eac23bc6 Mon Sep 17 00:00:00 2001
From: Dean Camera <dean@fourwalledcubicle.com>
Date: Mon, 8 Apr 2013 18:59:25 +0000
Subject: Update AS integration scripts and transforms - extract out the module
 description from the Doxygen XML output for the GUI.

---
 .../XSLT/lufa_module_transform.xslt                | 23 +++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

(limited to 'LUFA/StudioIntegration/XSLT')

diff --git a/LUFA/StudioIntegration/XSLT/lufa_module_transform.xslt b/LUFA/StudioIntegration/XSLT/lufa_module_transform.xslt
index 65ff2f0b0..9146202a4 100644
--- 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>
-- 
cgit v1.2.3