docs: newapi: Avoid table where every row has an cell with 'colspan'

The HTML standard requires that a table column must include at least one
row which defines it exclusively, thus having a table where all rows
unite it via 'colspan' is illegal.

Modify the enum value generator to always output the description field
even when it's empty rather than uniting it, as in case when each value
doesn't have a description the generated document would violate the
standard.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Pavel Hrdina <phrdina@redhat.com>

diff --git a/docs/newapi.xsl b/docs/newapi.xsl
index 539e0a4175873dc6e2bdf01f729edd8ab38d2e95..36bb41c8772a55a36c97ac146f2ca0e321a28fb6 100644 (file)
--- a/docs/newapi.xsl
+++ b/docs/newapi.xsl
@@ -317,9 +317,9 @@
           <tr>
             <td><a id="{@name}"><xsl:value-of select="@name"/></a></td>
             <td><xsl:text> = </xsl:text></td>
+            <td class="enumvalue"><xsl:call-template name="enumvalue"/></td>
             <xsl:choose>
               <xsl:when test="@info != ''">
-                <td class="enumvalue"><xsl:call-template name="enumvalue"/></td>
                 <td>
                   <div class="comment">
                     <xsl:call-template name="dumptext">
@@ -329,7 +329,7 @@
                 </td>
               </xsl:when>
               <xsl:otherwise>
-                <td colspan="2" class="enumvalue"><xsl:call-template name="enumvalue"/></td>
+                <td><xsl:comment> </xsl:comment></td>
               </xsl:otherwise>
             </xsl:choose>
           </tr>