From: Claudio Bley <cbley@av-test.de>
Date: Thu, 17 Jan 2013 15:00:11 +0000 (+0100)
Subject: docs: don't use <i> and <tt> HTML tags
X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=cb022b6bc7d9746c977569dee64c0d0085acaca5;p=libvirt.git

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@av-test.de>
---

diff --git a/docs/newapi.xsl b/docs/newapi.xsl
index 3982f8f793..0d32e55c95 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>