Update Studio Integration XML transform files to add top-level descriptions for each...

diff --git a/LUFA/StudioIntegration/lufa_extension_transform.xslt b/LUFA/StudioIntegration/lufa_extension_transform.xslt
index 7796b2d..a40176a 100644 (file)
--- a/LUFA/StudioIntegration/lufa_extension_transform.xslt
+++ b/LUFA/StudioIntegration/lufa_extension_transform.xslt
@@ -8,6 +8,9 @@
 
 <!-- Atmel Studio framework Extension XML transform file -->
 
+<!-- Creates an extension.xml document from a given manifest list of XML files,
+     and adds appropriate documentation base URI entries and version
+     information. -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
        <xsl:output method="xml" omit-xml-declaration="yes"/>
 

diff --git a/LUFA/StudioIntegration/lufa_filelist_transform.xslt b/LUFA/StudioIntegration/lufa_filelist_transform.xslt
index 758bc98..103ff51 100644 (file)
--- a/LUFA/StudioIntegration/lufa_filelist_transform.xslt
+++ b/LUFA/StudioIntegration/lufa_filelist_transform.xslt
@@ -8,6 +8,8 @@
 
 <!-- Atmel Studio framework Module XML transform file -->
 
+<!-- Outputs a flat file list of all source files referenced in all modules of
+     the input manifest XML file, so that they can be checked for existence. -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
        <xsl:output method="xml" omit-xml-declaration="yes"/>
 

diff --git a/LUFA/StudioIntegration/lufa_indent_transform.xslt b/LUFA/StudioIntegration/lufa_indent_transform.xslt
index dccca04..a05a824 100644 (file)
--- a/LUFA/StudioIntegration/lufa_indent_transform.xslt
+++ b/LUFA/StudioIntegration/lufa_indent_transform.xslt
@@ -8,6 +8,7 @@
 
 <!-- Atmel Studio framework Module XML transform file -->
 
+<!-- Indents a given XML document to match the node hierarchy. -->
 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
        <xsl:output method="xml" omit-xml-declaration="yes" indent="yes"/>
 

diff --git a/LUFA/StudioIntegration/lufa_module_transform.xslt b/LUFA/StudioIntegration/lufa_module_transform.xslt
index 7db09e5..e3a0329 100644 (file)
--- a/LUFA/StudioIntegration/lufa_module_transform.xslt
+++ b/LUFA/StudioIntegration/lufa_module_transform.xslt
@@ -8,6 +8,9 @@
 
 <!-- Atmel Studio framework Module XML transform file -->
 
+<!-- Creates an asf.xml module document from a given manifest list of XML files,
+     and adds appropriate documentation links by cross-referencing the Doxygen
+     tag output file to map Doxygen group names to generated filenames. -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
        <xsl:output method="xml" omit-xml-declaration="yes"/>
 
@@ -21,17 +24,8 @@
 
                <asf xmlversion="1.0">
                        <xsl:for-each select="xml-source">
-
-                               <xsl:text>&#xA;&#xA;</xsl:text>
                                <xsl:comment>Sourced from <xsl:value-of select="@filename"/></xsl:comment>
-                               <xsl:text>&#xA;</xsl:text>
-
                                <xsl:apply-templates select="document(@filename)/lufa/asf/*"/>
-
-                               <xsl:if test="position()=last()">
-                                       <xsl:text>&#xA;&#xA;</xsl:text>
-                               </xsl:if>
-
                        </xsl:for-each>
                </asf>
        </xsl:template>
@@ -43,11 +37,9 @@
                </xsl:copy>
        </xsl:template>
 
-       <!-- For Doxygen entry point nodes we need to convert them to add additional
-               help link nodes so that they show up as links in Studio correctly -->
+       <!-- 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 -->
        <xsl:template match="build[@type='doxygen-entry-point']">
-               <xsl:copy-of select="current()"/>
-
                <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>