doc: Use enum argument type to make links in protocol documentation
authorBill Spitzak <spitzak@gmail.com>
Fri, 6 Nov 2015 16:27:27 +0000 (08:27 -0800)
committerBryce Harrington <bryce@osg.samsung.com>
Sat, 20 Feb 2016 03:26:37 +0000 (19:26 -0800)
Reviewed-by: Auke Booij <auke@tulcod.com>
doc/publican/protocol-to-docbook.xsl

index fad207a..5344442 100644 (file)
     <term><xsl:value-of select="@name"/></term>
     <listitem>
         <simpara>
-          <xsl:if test="@enum">
-            <link linkend="protocol-spec-{../../@name}-enum-{@enum}">
-              <xsl:value-of select="@enum"/>
-            </link>
-           <xsl:text> </xsl:text>
-          </xsl:if>
           <xsl:value-of select="@type"/>
           <xsl:if test="@summary" >
             - <xsl:value-of select="@summary"/>
   </varlistentry>
 </xsl:template>
 
+<!-- enum and bitfield arguemnts -->
+<xsl:template match="arg[@enum]">
+  <varlistentry>
+    <term><xsl:value-of select="@name"/></term>
+    <listitem>
+        <simpara>
+          <link linkend="protocol-spec-{../../@name}-enum-{@enum}">
+            <xsl:value-of select="../../@name"/>::<xsl:value-of select="@enum"/>
+          </link>
+          (<xsl:value-of select="@type"/>)
+          <xsl:if test="@summary" >
+            - <xsl:value-of select="@summary"/>
+          </xsl:if>
+        </simpara>
+    </listitem>
+  </varlistentry>
+</xsl:template>
+
 <!-- Request/event list -->
 <xsl:template match="request|event">
   <section id="protocol-spec-{../@name}-{name()}-{@name}">
 
 <!-- Enumeration -->
 <xsl:template match="enum">
-  <section id="protocol-spec-{../@name}-{name()}-{@name}">
+  <section id="protocol-spec-{../@name}-enum-{@name}">
     <title>
       <xsl:value-of select="../@name"/>::<xsl:value-of select="@name" />
       <xsl:if test="@bitfield">