Index: multimedia/libdriv/alsa/driver/alsa-driver-config.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-config.xml	(revision 45e4bc507204e4add7a4111e8ad518a876f54aa7)
+++ multimedia/libdriv/alsa/driver/alsa-driver-config.xml	(revision be1cb1765becb0651fee97a5569657f835937664)
@@ -13,5 +13,5 @@
 <filename>/etc/modules.conf</filename>:</para>
 
-<para><screen><userinput>cat &gt;&gt; /etc/modules.conf &lt;&lt; "EOF"</userinput>
+<screen><userinput><command>cat &gt;&gt; /etc/modules.conf &lt;&lt; "EOF"
 alias char-major-14 soundcore
 alias char-major-116 snd
@@ -25,5 +25,5 @@
 alias sound-service-0-3 snd-pcm-oss
 alias sound-service-0-8 snd-seq-midi
-<userinput>EOF</userinput></screen></para>
+EOF</command></userinput></screen>
 
 <para>&lt;soundcard-name&gt; needs to be replaced with the driver relevant
@@ -35,11 +35,11 @@
 <filename>depmod</filename>.  If the drivers you have compiled are for the
 version of the kernel you are currently running, simply run
-<screen><userinput>depmod</userinput></screen>  If you are compiling 
+<screen><userinput><command>depmod</command></userinput></screen>  If you are compiling 
 drivers for a different kernel version to that which you are running, you 
 will need to use a line along the lines of:
-<screen><userinput>depmod -a 2.4.19 -F /boot/System.map-2.4.19</userinput></screen></para>
+<screen><userinput><command>depmod -a 2.4.19 -F /boot/System.map-2.4.19</command>
+</userinput></screen></para>
 
 </sect3>
 
 </sect2>
-
Index: multimedia/libdriv/alsa/driver/alsa-driver-desc.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-desc.xml	(revision 45e4bc507204e4add7a4111e8ad518a876f54aa7)
+++ multimedia/libdriv/alsa/driver/alsa-driver-desc.xml	(revision be1cb1765becb0651fee97a5569657f835937664)
@@ -2,6 +2,6 @@
 <title>Contents</title>
 
-<para>The alsa-driver package contains the <userinput>alsa sound card
-drivers</userinput>and <userinput>include files</userinput></para>
+<para>The alsa-driver package contains the alsa sound card
+drivers and include files.</para>
 
 </sect2>
@@ -10,5 +10,6 @@
 
 <sect3><title>alsa sound card drivers</title>
-<para>These are kernel modules which provide audio and MIDI functionality
+<para>These are kernel modules which provide audio and
+<acronym>MIDI</acronym> functionality
 to the operating system.</para></sect3>
 
@@ -16,6 +17,5 @@
 <para>These are installed in <filename
 class="directory">/usr/include/sound</filename> and are required to compile
-certain packages such as <filename>alsa-lib</filename>.</para></sect3>
+certain packages such as alsa-lib.</para></sect3>
 
 </sect2>
-
Index: multimedia/libdriv/alsa/driver/alsa-driver-exp.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-exp.xml	(revision 45e4bc507204e4add7a4111e8ad518a876f54aa7)
+++ multimedia/libdriv/alsa/driver/alsa-driver-exp.xml	(revision be1cb1765becb0651fee97a5569657f835937664)
@@ -2,23 +2,24 @@
 <title>Command explanations</title>
 
-<para><userinput>--with-sequencer=yes </userinput>: This tells the
+<para><command>--with-sequencer=yes</command> : This tells the
 alsa-driver package to build the sequencer modules for whichever soundcards
-you are building for.  Most people want them so you will usually want to
+you are building for. Most people want them so you will usually want to
 leave it set to yes.</para>
 
-<para><userinput>--with-oss=yes </userinput>: This tells the package to
-build the OSS/Free emulation modules.  Again, most people want this so it's
+<para><command>--with-oss=yes</command> : This tells the package to
+build the <acronym>OSS</acronym>/Free emulation modules. Again, most people want this so it's
 probably best to stick with yes.</para>
 
-<para><userinput>--with-isapnp=no </userinput>: Most sound cards these days
-are PCI and so ISA Plug and Play support isn't needed.  If you are using an
-ISA soundcard, it's best to say yes here.</para>
+<para><command>--with-isapnp=no</command> : Most sound cards these days
+are <acronym>PCI</acronym> and so <acronym>ISA</acronym> Plug and Play 
+support isn't needed. If you are using an
+<acronym>ISA</acronym> soundcard, it's best to say yes here.</para>
 
-<para><userinput>--with-cards=all </userinput>: You can tell the script just
-to build the drivers for your particular sound card here.  For full information
-on which drivers are available see <userinput>./configure
---help</userinput>.  If you aren't sure which chipset your soundcard uses,
+<para><command>--with-cards=all</command> : You can tell the script just
+to build the drivers for your particular sound card here. For full information
+on which drivers are available see <command>./configure
+--help</command>. If you aren't sure which chipset your soundcard uses,
 have a look in <filename>CARDS-STATUS</filename> in the alsa-driver source
-tree.  the default specified here will build all drivers.</para>
+tree. The default specified here will build all drivers.</para>
 
 </sect2>
Index: multimedia/libdriv/alsa/driver/alsa-driver-inst.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-inst.xml	(revision 45e4bc507204e4add7a4111e8ad518a876f54aa7)
+++ multimedia/libdriv/alsa/driver/alsa-driver-inst.xml	(revision be1cb1765becb0651fee97a5569657f835937664)
@@ -1,4 +1,4 @@
 <sect2>
-<title>Installation of alsa-driver</title>
+<title>Installation of <application>alsa-driver</application></title>
 
 <para>Before installing the alsa-drivers note that in your kernel
@@ -10,7 +10,12 @@
 alsa driver modules.</para>
 
-<para>Install alsa-driver using the following commands as a template:</para>
+<note><para>Because alsa drivers are kernel
+modules, they must be compiled with the same compiler the kernel has
+used.</para></note>
 
-<para><screen><userinput>./configure \
+<para>Install <application>alsa-driver</application> using the following 
+commands as a template:</para>
+
+<screen><userinput><command>./configure \
    --with-moddir=/lib/modules/`uname -r`/kernel/drivers/sound \
    --with-kernel=/lib/modules/`uname -r`/build \
@@ -20,11 +25,10 @@
    --with-cards=all &amp;&amp;
 make &amp;&amp;
-make install</userinput></screen></para>
+make install</command></userinput></screen>
 
 <para>If this is the first time you have installed the alsa drivers, you
 will need to create the <filename class="directory">/dev</filename> entries
 using the script provided in the alsa-driver source tree:
-<screen><userinput>./snddevices</userinput></screen></para>
+<screen><userinput><command>./snddevices</command></userinput></screen></para>
 
 </sect2>
-
Index: multimedia/libdriv/alsa/driver/alsa-driver-intro.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-intro.xml	(revision 45e4bc507204e4add7a4111e8ad518a876f54aa7)
+++ multimedia/libdriv/alsa/driver/alsa-driver-intro.xml	(revision be1cb1765becb0651fee97a5569657f835937664)
@@ -1,13 +1,16 @@
 <sect2>
-<title>Introduction to alsa-driver</title>
+<title>Introduction to <application>alsa-driver</application></title>
 
-<screen>Download location (HTTP):       <ulink url="&alsa-driver-download-http;"/>
-Download location (FTP):        <ulink url="&alsa-driver-download-ftp;"/>
-Version used:                   &alsa-driver-version;
-Package size:                   &alsa-driver-size;
-Estimated Disk space required:  &alsa-driver-buildsize;</screen>
-
-<para>The alsa-driver package contains the alsa sound drivers.  These are
+<para>The <application>alsa-driver</application> package contains the alsa sound drivers. These are
 the next generation of sound drivers for Linux.</para>
 
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&alsa-driver-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&alsa-driver-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &alsa-driver-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &alsa-driver-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &alsa-driver-time;</para></listitem></itemizedlist>
+</sect3>
+
 </sect2>
Index: multimedia/libdriv/alsa/driver/alsa-driver.ent
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver.ent	(revision 45e4bc507204e4add7a4111e8ad518a876f54aa7)
+++ multimedia/libdriv/alsa/driver/alsa-driver.ent	(revision be1cb1765becb0651fee97a5569657f835937664)
@@ -10,2 +10,3 @@
 <!ENTITY alsa-driver-download-ftp "ftp://ftp.alsa-project.org/pub/driver/alsa-driver-&alsa-driver-version;.tar.bz2">
 <!ENTITY alsa-driver-size "1.5 MB">
+<!ENTITY alsa-driver-time "0.55 SBU">
