Index: multimedia/libdriv/sdl.xml
===================================================================
--- multimedia/libdriv/sdl.xml	(revision 62d4da77746c48c7ca021c4597383a7006142607)
+++ multimedia/libdriv/sdl.xml	(revision 576a2308d5c9e5eb35761641863443fdc54e9389)
@@ -1,2 +1,3 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
@@ -13,159 +14,170 @@
 
 <sect1 id="sdl" xreflabel="SDL-&sdl-version;">
-<sect1info>
-<othername>$LastChangedBy$</othername>
-<date>$Date$</date>
-</sect1info>
-<?dbhtml filename="sdl.html"?>
-<title>SDL-&sdl-version;</title>
-<indexterm zone="sdl">
-<primary sortas="a-SDL">SDL</primary>
-</indexterm>
+  <?dbhtml filename="sdl.html"?>
 
-<sect2>
-<title>Introduction to <application><acronym>SDL</acronym></application></title>
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
 
-<para>The Simple DirectMedia Layer 
-(<application><acronym>SDL</acronym></application> for short) is a 
-cross-platform library designed to make it easy to write multimedia software, 
-such as games and emulators.</para>
+  <title>SDL-&sdl-version;</title>
 
-<sect3><title>Package information</title>
-<itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): 
-<ulink url="&sdl-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): 
-<ulink url="&sdl-download-ftp;"/></para></listitem>
-<listitem><para>Download MD5 sum: &sdl-md5sum;</para></listitem>
-<listitem><para>Download size: &sdl-size;</para></listitem>
-<listitem><para>Estimated disk space required: 
-&sdl-buildsize;</para></listitem>
-<listitem><para>Estimated build time: 
-&sdl-time;</para></listitem></itemizedlist>
-</sect3>
+  <indexterm zone="sdl">
+    <primary sortas="a-SDL">SDL</primary>
+  </indexterm>
 
-<sect3><title><application><acronym>SDL</acronym></application> 
-dependencies</title>
-<sect4><title>Optional</title>
-<para><xref linkend="alsa"/>, 
-<xref linkend="esound"/>,
-<xref linkend="arts"/>,
-<xref linkend="nas"/>,
-<xref linkend="NASM"/>, 
-X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
-<xref linkend="aalib"/>,
-<ulink url="http://www.directfb.org/">DirectFB</ulink>, 
-<ulink url="http://www.svgalib.org/">SVGAlib</ulink>, 
-<ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>, 
-<ulink url="http://www.trolltech.com/download/qtopia/">Qtopia</ulink> and 
-<ulink url="http://picogui.org/">PicoGUI</ulink></para>
-</sect4>
-</sect3>
+  <sect2 role="package">
+    <title>Introduction to SDL</title>
 
-</sect2>
+    <para>The Simple DirectMedia Layer (<application>SDL</application> 
+    for short) is a cross-platform library designed to make it easy to write 
+    multimedia software, such as games and emulators.</para>
 
-<sect2>
-<title>Installation of <application><acronym>SDL</acronym></application></title>
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&sdl-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&sdl-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &sdl-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &sdl-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &sdl-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &sdl-time;</para>
+      </listitem>
+    </itemizedlist>
 
-<para>Install <application><acronym>SDL</acronym></application> by running the 
-following commands:</para>
+    <bridgehead renderas="sect3">TEMPLATE Dependencies</bridgehead>
 
-<screen><userinput><command>./configure --prefix=/usr --disable-debug &amp;&amp;
-make</command></userinput></screen>
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para><xref linkend="alsa"/>, 
+    <xref linkend="esound"/>,
+    <xref linkend="arts"/>,
+    <xref linkend="nas"/>,
+    <xref linkend="NASM"/>, 
+    X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
+    <xref linkend="aalib"/>,
+    <ulink url="http://www.directfb.org/">DirectFB</ulink>, 
+    <ulink url="http://www.svgalib.org/">SVGAlib</ulink>, 
+    <ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>, 
+    <ulink url="http://www.trolltech.com/download/qtopia/">Qtopia</ulink> and 
+    <ulink url="http://picogui.org/">PicoGUI</ulink></para>
 
-<para>Now, as the root user:</para>
+  </sect2>
 
-<screen><userinput role='root'><command>make install &amp;&amp;
+  <sect2 role="installation">
+    <title>Installation of SDL</title>
+
+    <para>Install <application>SDL</application> by running the 
+    following commands:</para>
+
+<screen><userinput>./configure --prefix=/usr --disable-debug &amp;&amp;
+make</userinput></screen>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &amp;&amp;
 install -v -m755 -d /usr/share/doc/SDL-1.2.8/html &amp;&amp;
-install -v -m644 docs/html/*.html /usr/share/doc/SDL-1.2.8/html</command></userinput></screen>
+install -v -m644 docs/html/*.html /usr/share/doc/SDL-1.2.8/html</userinput></screen>
 
-</sect2>
+  </sect2>
 
-<sect2>
-<title>Command explanations</title>
+  <sect2 role="commands">
+    <title>Command Explanations</title>
 
-<para><parameter>--disable-debug</parameter>: This switch configures
-<application><acronym>SDL</acronym></application> to build with aggressive 
-optimizations.</para>
+    <para><parameter>--disable-debug</parameter>: This switch configures
+    <application>SDL</application> to build with aggressive 
+    optimizations.</para>
 
-<para><option>--enable-video-aalib</option>: This switch
-is required to build <application><acronym>SDL</acronym></application>
-with <acronym>AA</acronym>lib video support.</para>
+    <para><option>--enable-video-aalib</option>: This switch
+    is required to build <application>SDL</application>
+    with AAlib video support.</para>
 
-</sect2>
+    <sect3>
+      <title>Testing SDL</title>
 
-<sect2>
-<title>Testing <application><acronym>SDL</acronym></application></title>
+      <para>It is advisable to test the installation of 
+      <application>SDL</application> using the included
+      test programs. It is not required to install any of the resulting binaries
+      to validate the installation. Issue the following commands to build the
+      test programs:</para>
 
-<para>It is advisable to test the installation of 
-<application><acronym>SDL</acronym></application> using the included
-test programs. It is not required to install any of the resulting binaries
-to validate the installation. Issue the following commands to build the
-test programs:</para>
+<screen><userinput>cd test &amp;&amp;
+./configure &amp;&amp;
+make</userinput></screen>
 
-<screen><userinput><command>cd test &amp;&amp;
-./configure &amp;&amp;
-make</command></userinput></screen>
+      <para>You'll need to manually run all the test programs.</para>
 
-<para>You'll need to manually run all the test programs.</para>
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring SDL</title>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Program</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+   
+      <seglistitem>
+        <seg>sdl-config</seg>
+        <seg>libSDL*.[so,a]</seg>
+        <seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
+      </seglistitem>
+    </segmentedlist>
     
-</sect2>
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+      
+      <varlistentry id="sdl-config">
+        <term><command>sdl-config</command></term>
+        <listitem>
+          <para>determines the compile and linker flags that should be used to 
+          compile and link programs that use 
+          <filename class='libraryfile'>libSDL</filename>.</para>
+          <indexterm zone="sdl sdl-config">
+            <primary sortas="b-sdl-config">sdl-config</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
 
-<sect2>
-<title>Configuring <application><acronym>SDL</acronym></application></title>
+      <varlistentry id="libsdl">
+        <term><filename class='libraryfile'>libSDL*.[so,a]</filename></term>
+        <listitem>
+          <para> libraries provide low level access to audio, keyboard, mouse,
+          joystick, 3D hardware via OpenGL, and
+          2D frame buffer across multiple platforms.</para>
+          <indexterm zone="sdl libsdl">
+            <primary sortas="c-libsdl">libSDL*.[so,a]</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+ 
+    </variablelist>
 
-<sect3><title>Configuration Information</title>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
-</sect3>
-
-</sect2>
-
-<sect2>
-<title>Contents</title>
-
-<segmentedlist>
-<segtitle>Installed Program</segtitle>
-<segtitle>Installed Libraries</segtitle>
-<segtitle>Installed Directories</segtitle>
-   
-<seglistitem>
-<seg>sdl-config</seg>
-<seg>libSDL*.[so,a]</seg>
-<seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
-</seglistitem>
-</segmentedlist>
-    
-<variablelist>
-<bridgehead renderas="sect3">Short Descriptions</bridgehead>
-<?dbfo list-presentation="list"?>
-<?dbhtml list-presentation="table"?>
-      
-<varlistentry id="sdl-config">
-<term><command>sdl-config</command></term>
-<listitem>
-<para>determines the compile and linker flags that should be used to 
-compile and link programs that use 
-<filename class='libraryfile'>libSDL</filename>.</para>
-<indexterm zone="sdl sdl-config">
-<primary sortas="b-sdl-config">sdl-config</primary>
-</indexterm>
-</listitem>
-</varlistentry>
-
-<varlistentry id="libsdl">
-<term><filename class='libraryfile'>libSDL*.[so,a]</filename></term>
-<listitem>
-<para> libraries provide low level access to audio, keyboard, mouse,
-joystick, <acronym>3D</acronym> hardware via OpenGL, and
-<acronym>2D</acronym> frame buffer across multiple platforms.</para>
-<indexterm zone="sdl libsdl">
-<primary sortas="c-libsdl">libSDL*.[so,a]</primary>
-</indexterm>
-</listitem>
-</varlistentry>
- 
-</variablelist>
-
-</sect2>
+  </sect2>
 
 </sect1>
