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 3982f8f79398ab5e3c72082bae5e91b961c3c8e1..0d32e55c95bb643add20bdd85de57f6e87996036 100644 (file)
--- 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>