[libvirt] [PATCH 2/3] docs: don't use <i> and <tt> HTML tags
Use of <tt> is discouraged in HTML 4.x and has finally been obsoleted
in HTML 5. Likewise for the <i> tag.
Using tables for layout is (widely) considered bad style, too.
Use defintion lists, definition term and defintion description
elements instead.
Signed-off-by: Claudio Bley <cbley(a)av-test.de>
---
docs/newapi.xsl | 62 ++++++++++++++++++++++++-------------------------------
1 file changed, 27 insertions(+), 35 deletions(-)
diff --git a/docs/newapi.xsl b/docs/newapi.xsl
index 3982f8f..0d32e55 100644
--- a/docs/newapi.xsl
+++ b/docs/newapi.xsl
@@ -457,28 +457,24 @@
</xsl:call-template>
</div>
<xsl:if test="arg | return">
- <div class="variablelist"><table border="0"><col
align="left"/><tbody>
+ <dl class="variablelist">
<xsl:for-each select="arg">
- <tr>
- <td><span
class="term"><i><tt><xsl:value-of
select="@name"/></tt></i>:</span></td>
- <td>
- <xsl:call-template name="dumptext">
+ <dt><xsl:value-of select="@name"/></dt>
+ <dd>
+ <xsl:call-template name="dumptext">
<xsl:with-param name="text" select="@info"/>
</xsl:call-template>
- </td>
- </tr>
+ </dd>
</xsl:for-each>
<xsl:if test="return/@info">
- <tr>
- <td><span
class="term"><i><tt>Returns</tt></i>:</span></td>
- <td>
- <xsl:call-template name="dumptext">
- <xsl:with-param name="text" select="return/@info"/>
- </xsl:call-template>
- </td>
- </tr>
+ <dt>Returns</dt>
+ <dd>
+ <xsl:call-template name="dumptext">
+ <xsl:with-param name="text"
select="return/@info"/>
+ </xsl:call-template>
+ </dd>
</xsl:if>
- </tbody></table></div>
+ </dl>
</xsl:if>
<br/>
<xsl:text>
@@ -538,28 +534,24 @@
</div><xsl:text>
</xsl:text>
<xsl:if test="arg | return/@info">
- <div class="variablelist"><table border="0"><col
align="left"/><tbody>
- <xsl:for-each select="arg">
- <tr>
- <td><span
class="term"><i><tt><xsl:value-of
select="@name"/></tt></i>:</span></td>
- <td>
- <xsl:call-template name="dumptext">
- <xsl:with-param name="text" select="@info"/>
- </xsl:call-template>
- </td>
- </tr>
- </xsl:for-each>
- <xsl:if test="return/@info">
- <tr>
- <td><span
class="term"><i><tt>Returns</tt></i>:</span></td>
- <td>
+ <dl class="variablelist">
+ <xsl:for-each select="arg">
+ <dt><xsl:value-of select="@name"/></dt>
+ <dd>
+ <xsl:call-template name="dumptext">
+ <xsl:with-param name="text" select="@info"/>
+ </xsl:call-template>
+ </dd>
+ </xsl:for-each>
+ <xsl:if test="return/@info">
+ <dt>Returns</dt>
+ <dd>
<xsl:call-template name="dumptext">
<xsl:with-param name="text" select="return/@info"/>
</xsl:call-template>
- </td>
- </tr>
- </xsl:if>
- </tbody></table></div>
+ </dd>
+ </xsl:if>
+ </dl>
</xsl:if>
</xsl:template>
--
1.7.9.5