Minor documentation improvements.

[pub/USBasp.git] / LUFA / StudioIntegration / HV1 / lufa_docbook_transform.xslt

diff --git a/LUFA/StudioIntegration/HV1/lufa_docbook_transform.xslt b/LUFA/StudioIntegration/HV1/lufa_docbook_transform.xslt
index ca08b67..680cea5 100644 (file)
--- a/LUFA/StudioIntegration/HV1/lufa_docbook_transform.xslt
+++ b/LUFA/StudioIntegration/HV1/lufa_docbook_transform.xslt
@@ -74,7 +74,7 @@
                                </xsl:if>
                        </xsl:for-each>
 
                                </xsl:if>
                        </xsl:for-each>
 

-                       <!-- Add Module chapter -->
+                       <!-- Add Modules chapter -->

                        <chapter>
                                <title>Modules</title>
                                <xsl:for-each select="compounddef[@kind = 'group']">
                        <chapter>
                                <title>Modules</title>
                                <xsl:for-each select="compounddef[@kind = 'group']">


@@ -103,10 +103,6 @@
                </chapter>
        </xsl:template>
 
                </chapter>
        </xsl:template>
 

-       <xsl:template match="compounddef">
-               <!-- Discard compounddef elements unless a later template matches -->
-       </xsl:template>
-

        <xsl:template match="compounddef[@kind = 'page']">
                <section id="{@id}">
                        <title>
        <xsl:template match="compounddef[@kind = 'page']">
                <section id="{@id}">
                        <title>


@@ -230,7 +226,7 @@
                                                        <xsl:for-each select="memberdef">
                                                                <row id="{@id}" xreflabel="{name}">
                                                                        <entry>
                                                        <xsl:for-each select="memberdef">
                                                                <row id="{@id}" xreflabel="{name}">
                                                                        <entry>

-                                                                               <xsl:apply-templates select="type"/>
+                                                                               <xsl:value-of select="type"/>

                                                                        </entry>
                                                                        <entry>
                                                                                <xsl:value-of select="name"/>
                                                                        </entry>
                                                                        <entry>
                                                                                <xsl:value-of select="name"/>


@@ -305,16 +301,14 @@
        </xsl:template>
 
        <xsl:template match="memberdef[@kind = 'enum']">
        </xsl:template>
 
        <xsl:template match="memberdef[@kind = 'enum']">

-               <xsl:variable name="name" select="name"/>
-

                <section id="{@id}" xreflabel="{name}">
                        <title>
                                <xsl:text>Enum </xsl:text>
                <section id="{@id}" xreflabel="{name}">
                        <title>
                                <xsl:text>Enum </xsl:text>

-                               <xsl:value-of select="$name"/>
+                               <xsl:value-of select="name"/>

                        </title>
 
                        <xsl:call-template name="generate.index.id">
                        </title>
 
                        <xsl:call-template name="generate.index.id">

-                               <xsl:with-param name="name" select="$name"/>
+                               <xsl:with-param name="name" select="name"/>

                        </xsl:call-template>
 
                        <xsl:apply-templates select="detaileddescription"/>
                        </xsl:call-template>
 
                        <xsl:apply-templates select="detaileddescription"/>


@@ -334,7 +328,7 @@
                                                                <entry>
                                                                        <para id="{@id}" xreflabel="{name}">
                                                                                <xsl:value-of select="name"/>
                                                                <entry>
                                                                        <para id="{@id}" xreflabel="{name}">
                                                                                <xsl:value-of select="name"/>

-                                                                               <indexterm id="{$keyword.namespace}.{$name}.{name}"/>
+                                                                               <indexterm id="{$keyword.namespace}.{name}"/>

                                                                        </para>
                                                                </entry>
                                                                <entry>
                                                                        </para>
                                                                </entry>
                                                                <entry>


@@ -441,7 +435,7 @@
                </section>
        </xsl:template>
 
                </section>
        </xsl:template>
 

-       <xsl:template match="linebreak">
+       <xsl:template match="linebreak | simplesectsep">

                <literallayout>
                </literallayout>
        </xsl:template>
                <literallayout>
                </literallayout>
        </xsl:template>


@@ -473,42 +467,42 @@
                                        <title>
                                                <xsl:value-of select="title"/>
                                        </title>
                                        <title>
                                                <xsl:value-of select="title"/>
                                        </title>

-                                       <xsl:apply-templates select="para"/>
+                                       <xsl:apply-templates/>

                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'return'">
                                <note>
                                        <title>Returns</title>
                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'return'">
                                <note>
                                        <title>Returns</title>

-                                       <xsl:apply-templates select="para"/>
+                                       <xsl:apply-templates/>

                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'warning'">
                                <warning>
                                        <title>Warning</title>
                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'warning'">
                                <warning>
                                        <title>Warning</title>

-                                       <xsl:apply-templates select="para"/>
+                                       <xsl:apply-templates/>

                                </warning>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'pre'">
                                <note>
                                        <title>Precondition</title>
                                </warning>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'pre'">
                                <note>
                                        <title>Precondition</title>

-                                       <xsl:apply-templates select="para"/>
+                                       <xsl:apply-templates/>

                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'see'">
                                <note>
                                        <title>See also</title>
                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'see'">
                                <note>
                                        <title>See also</title>

-                                       <xsl:apply-templates select="para"/>
+                                       <xsl:apply-templates/>

                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'note'">
                                <note>
                                        <title>Note</title>
                                </note>
                        </xsl:when>
 
                        <xsl:when test="@kind = 'note'">
                                <note>
                                        <title>Note</title>

-                                       <xsl:apply-templates select="para"/>
+                                       <xsl:apply-templates/>

                                </note>
                        </xsl:when>
 
                                </note>
                        </xsl:when>
 


@@ -529,7 +523,7 @@
                                <tbody>
                                        <xsl:for-each select="parameteritem">
                                                <row>
                                <tbody>
                                        <xsl:for-each select="parameteritem">
                                                <row>

-                                                       <xsl:apply-templates/>
+                                                       <xsl:apply-templates select="."/>

                                                </row>
                                        </xsl:for-each>
                                </tbody>
                                                </row>
                                        </xsl:for-each>
                                </tbody>


@@ -550,7 +544,7 @@
                                <tbody>
                                        <xsl:for-each select="parameteritem">
                                                <row>
                                <tbody>
                                        <xsl:for-each select="parameteritem">
                                                <row>

-                                                       <xsl:apply-templates/>
+                                                       <xsl:apply-templates select="."/>

                                                </row>
                                        </xsl:for-each>
                                </tbody>
                                                </row>
                                        </xsl:for-each>
                                </tbody>


@@ -588,16 +582,16 @@
                </entry>
        </xsl:template>
 
                </entry>
        </xsl:template>
 

-       <xsl:template match="type">
-               <xsl:apply-templates/>
-       </xsl:template>
-
-       <xsl:template match="para">
+       <xsl:template match="parameterdescription">

                <para>
                        <xsl:apply-templates/>
                </para>
        </xsl:template>
 
                <para>
                        <xsl:apply-templates/>
                </para>
        </xsl:template>
 

+       <xsl:template match="type">
+               <xsl:apply-templates/>
+       </xsl:template>
+

        <xsl:template match="bold">
                <emphasis role="bold">
                        <xsl:apply-templates/>
        <xsl:template match="bold">
                <emphasis role="bold">
                        <xsl:apply-templates/>


@@ -614,30 +608,26 @@
                <xsl:apply-templates/>
        </xsl:template>
 
                <xsl:apply-templates/>
        </xsl:template>
 

-       <xsl:template match="computeroutput">
+       <xsl:template match="mdash | ndash">
+               <xsl:text>--</xsl:text>
+       </xsl:template>
+
+       <xsl:template match="computeroutput | preformatted">

                <computeroutput>
                        <xsl:apply-templates/>
                </computeroutput>
        </xsl:template>
 
                <computeroutput>
                        <xsl:apply-templates/>
                </computeroutput>
        </xsl:template>
 

+       <xsl:template match="codeline">
+                       <xsl:apply-templates/>
+       </xsl:template>
+

        <xsl:template match="ulink">
                <ulink url="{@url}">
                        <xsl:value-of select="."/>
                </ulink>
        </xsl:template>
 
        <xsl:template match="ulink">
                <ulink url="{@url}">
                        <xsl:value-of select="."/>
                </ulink>
        </xsl:template>
 

-       <xsl:template match="registered">
-               <xsl:text>&#174;</xsl:text>
-       </xsl:template>
-
-       <xsl:template match="copy">
-               <xsl:text>&#169;</xsl:text>
-       </xsl:template>
-
-       <xsl:template match="trademark">
-               <xsl:text>&#8482;</xsl:text>
-       </xsl:template>
-

        <xsl:template match="superscript">
                <superscript>
                        <xsl:apply-templates/>
        <xsl:template match="superscript">
                <superscript>
                        <xsl:apply-templates/>


@@ -650,6 +640,12 @@
                </subscript>
        </xsl:template>
 
                </subscript>
        </xsl:template>
 

+       <xsl:template match="para">
+               <para>
+                       <xsl:apply-templates/>
+               </para>
+       </xsl:template>
+

        <xsl:template match="ref">
                <xsl:choose>
                        <!-- Don't show links inside program listings -->
        <xsl:template match="ref">
                <xsl:choose>
                        <!-- Don't show links inside program listings -->


@@ -671,6 +667,12 @@
                </xsl:choose>
        </xsl:template>
 
                </xsl:choose>
        </xsl:template>
 

+       <xsl:template match="entry">
+               <entry>
+                       <xsl:apply-templates/>
+               </entry>
+       </xsl:template>
+

        <xsl:template match="table">
                <xsl:choose>
                        <xsl:when test="caption">
        <xsl:template match="table">
                <xsl:choose>
                        <xsl:when test="caption">


@@ -678,6 +680,7 @@
                                        <title>
                                                <xsl:value-of select="caption"/>
                                        </title>
                                        <title>
                                                <xsl:value-of select="caption"/>
                                        </title>

+

                                        <xsl:call-template name="write.table.content"/>
                                </table>
                        </xsl:when>
                                        <xsl:call-template name="write.table.content"/>
                                </table>
                        </xsl:when>


@@ -695,22 +698,14 @@
                        <thead>
                                <xsl:for-each select="row[1]">
                                        <row>
                        <thead>
                                <xsl:for-each select="row[1]">
                                        <row>

-                                               <xsl:for-each select="entry">
-                                                       <entry>
-                                                               <xsl:apply-templates/>
-                                                       </entry>
-                                               </xsl:for-each>
+                                               <xsl:apply-templates select="entry"/>

                                        </row>
                                </xsl:for-each>
                        </thead>
                        <tbody>
                                <xsl:for-each select="row[position() != 1]">
                                        <row>
                                        </row>
                                </xsl:for-each>
                        </thead>
                        <tbody>
                                <xsl:for-each select="row[position() != 1]">
                                        <row>

-                                               <xsl:for-each select="entry">
-                                                       <entry>
-                                                               <xsl:apply-templates/>
-                                                       </entry>
-                                               </xsl:for-each>
+                                               <xsl:apply-templates select="entry"/>

                                        </row>
                                </xsl:for-each>
                        </tbody>
                                        </row>
                                </xsl:for-each>
                        </tbody>


@@ -738,7 +733,7 @@
        <xsl:template match="programlisting">
                <programlisting language="c">
                        <xsl:for-each select="codeline[position() > 1 or highlight]">
        <xsl:template match="programlisting">
                <programlisting language="c">
                        <xsl:for-each select="codeline[position() > 1 or highlight]">

-                               <xsl:apply-templates/>
+                               <xsl:apply-templates select="."/>

                                <xsl:text>&#10;</xsl:text>
                        </xsl:for-each>
                </programlisting>
                                <xsl:text>&#10;</xsl:text>
                        </xsl:for-each>
                </programlisting>


@@ -795,4 +790,8 @@
 
        <xsl:template match="title"/>
 
 
        <xsl:template match="title"/>
 

+       <xsl:template match="*">
+               <xsl:message>NO XSL TEMPLATE MATCH: <xsl:value-of select="name()"/></xsl:message>
+       </xsl:template>
+

 </xsl:stylesheet>
 </xsl:stylesheet>