Index: general.ent
===================================================================
--- general.ent	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ general.ent	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -269,8 +269,38 @@
 <!-- Part XII -->
 <!-- Chapter 37 --> 
-
-
+<!ENTITY alsa-version                 "1.0.4"> 
+<!ENTITY alsa-driver-version          "&alsa-version;">    
+<!ENTITY alsa-lib-version             "&alsa-version;"> 
+<!ENTITY alsa-utils-version           "&alsa-version;">  
+<!ENTITY alsa-tools-version           "&alsa-version;">  
+<!ENTITY alsa-firmware-version        "&alsa-version;">  
+<!ENTITY alsa-oss-version             "&alsa-version;">  
+<!ENTITY alsa-download-http           "http://www.alsa-project.org/alsa/ftp">
+<!ENTITY alsa-download-ftp            "ftp://ftp.alsa-project.org/pub"> 
+
+<!ENTITY audiofile-version            "0.2.6"> 
+<!ENTITY esound-version               "0.2.34">   
+<!ENTITY SDL-version                  "1.2.7">      
+<!ENTITY libao-version                "0.8.5">   
+<!ENTITY libogg-version               "1.1">   
+<!ENTITY libvorbis-version            "1.0.1"> 
+<!ENTITY nas-version                  "1.6">  
+<!ENTITY libmpeg3-version             "1.5.4">   
+<!ENTITY libmad-version               "0.15.1b"> 
+<!ENTITY openquicktime-version        "1.0">  
+<!ENTITY libfame-version              "0.9.1">     
+<!ENTITY speex-version                "1.0.3">  
+<!ENTITY id3lib-version               "3.8.3">  
+<!ENTITY flac-version                 "1.1.0">  
+<!ENTITY libdvdcss-version            "1.2.8">  
+<!ENTITY libdvdread-version           "0.9.4"> 
+<!ENTITY libdv-version                "0.101"> 
+<!ENTITY liba52-version               "0.7.4">    
+<!ENTITY xvid-version                 "1.0.0-rc4">  
+<!ENTITY xine-lib-version             "1-rc3a">  
+<!ENTITY libmikmod-version            "3.1.10"> 
 
 <!-- Chapter 38 --> 
+
 <!-- Chapter 39 --> 
 <!-- Chapter 40 -->
Index: multimedia/libdriv/alsa-driver.xml
===================================================================
--- multimedia/libdriv/alsa-driver.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
+++ multimedia/libdriv/alsa-driver.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -0,0 +1,175 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY alsa-driver-download-http "&alsa-download-http;/driver/alsa-driver-&alsa-driver-version;.tar.bz2">
+  <!ENTITY alsa-driver-download-ftp  "&alsa-download-ftp;/driver/alsa-driver-&alsa-driver-version;.tar.bz2">
+  <!ENTITY alsa-driver-size          "1.7 MB">
+  <!ENTITY alsa-driver-buildsize     "32 MB (for all drivers)">
+  <!ENTITY alsa-driver-time          "1.26 SBU (for all drivers)">
+]>
+
+<sect1 id="alsa-driver" xreflabel="ALSA Driver-&alsa-driver-version;">
+<?dbhtml filename="alsa-driver.html"?>
+<title>ALSA Driver-&alsa-driver-version;</title>
+
+<sect2>
+<title>Introduction to <application><acronym>ALSA</acronym> Driver</application>
+</title>
+
+<para>The <application><acronym>ALSA</acronym> Driver</application> package 
+contains the <acronym>ALSA</acronym> 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>
+
+<sect2>
+<title>Installation of <application><acronym>ALSA</acronym> Driver</application></title>
+
+<para>Before installing the <application><acronym>ALSA</acronym></application> 
+drivers, note that in your 
+kernel configuration you should have <userinput>Sound Card Support
+(CONFIG_SOUND)</userinput> enabled but <emphasis>nothing</emphasis> else in
+the Sound menu (with the possible exception of TV Card Mixer support.)  In
+particular, you should <emphasis>not</emphasis> have <userinput>OSS Sound
+Modules</userinput> enabled as this will cause problems when loading the
+<application><acronym>ALSA</acronym></application> driver modules.</para>
+
+<note><para>Because <application><acronym>ALSA</acronym></application> drivers 
+are kernel modules, they must be compiled with the same compiler used to 
+compile the kernel.</para></note>
+
+<para>Install <application><acronym>ALSA</acronym> Driver</application> using 
+the following commands:</para>
+
+<screen><userinput><command>CC=/opt/gcc-2.95.3/bin/gcc ./configure \
+    --with-moddir=/lib/modules/`uname -r`/kernel/drivers/sound \
+    --with-kernel=/lib/modules/`uname -r`/build \
+    --with-sequencer=yes \
+    --with-oss=yes \
+    --with-isapnp=no \
+    --with-cards=all &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+<para>If this is the first time you have installed the
+<application><acronym>ALSA</acronym></application> drivers, you
+will need to create the <filename class="directory">/dev</filename> entries
+using the script provided in the
+<application><acronym>ALSA</acronym> Driver</application> source
+tree:</para>
+<screen><userinput><command>./snddevices</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><parameter>--with-sequencer=yes</parameter>: This tells the <application>
+<acronym>ALSA</acronym> Driver</application> package to build the sequencer 
+modules. Most people want 
+them so you will usually want to leave it set to yes.</para>
+
+<para><parameter>--with-oss=yes</parameter>: 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><parameter>--with-isapnp=no</parameter>: Most sound cards these days
+are <acronym>PCI</acronym> and <acronym>ISA</acronym> Plug and Play 
+support isn't needed. If you are using an <acronym>ISA</acronym> PnP sound card, 
+it's best to say yes here. If your card is <acronym>ISA</acronym>, but
+not PnP, it is safer to stay with 'no'.</para>
+
+<para><parameter>--with-cards=all</parameter>: 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 sound card uses,
+look at the file <filename>CARDS-STATUS</filename> in the
+<application><acronym>ALSA</acronym> Driver</application> source
+tree. The default specified here will build all drivers.</para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application><acronym>ALSA</acronym> Driver</application></title>
+
+<sect3><title>Config files</title>
+
+<para><filename>/etc/modules.conf</filename></para>
+
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>To configure the <acronym>ALSA</acronym> drivers, you need to add some 
+lines to <filename>/etc/modules.conf</filename>:</para>
+
+<screen><userinput><command>cat &gt;&gt; /etc/modules.conf &lt;&lt; "EOF"
+alias char-major-14 soundcore
+alias char-major-116 snd
+
+alias snd-card-0 snd-<replaceable>[soundcard-name]</replaceable>
+
+alias sound-slot-0 snd-card-0
+
+alias sound-service-0-0 snd-mixer-oss
+alias sound-service-0-1 snd-seq-oss
+alias sound-service-0-3 snd-pcm-oss
+alias sound-service-0-8 snd-seq-midi
+EOF</command></userinput></screen>
+
+<para><replaceable>[soundcard-name]</replaceable> needs to be replaced with the 
+driver relevant to your sound card.  If you have more than one sound card, you 
+can add additional sections by repeating the above, changing the first 0 to 
+1 and so on.</para>
+
+<para>After editing <filename>/etc/modules.conf</filename> you need to run
+<command>depmod</command>.  If the drivers you have compiled are for the
+version of the kernel you are currently running, simply run:</para>
+
+<screen><userinput><command>depmod</command></userinput></screen>  
+
+<para>If you are compiling  drivers for a different kernel version than those 
+you are running, you will need to use a line similar to:</para>
+
+<screen><userinput><command>depmod -a 2.4.22 -F /boot/System.map-2.4.22</command></userinput></screen>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application><acronym>ALSA</acronym> Driver</application> package 
+contains the <acronym>ALSA</acronym> sound card drivers and include files.
+</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title><acronym>ALSA</acronym> sound card drivers</title>
+<para>These are kernel modules which provide audio and <acronym>MIDI</acronym> 
+functionality to the operating system.</para></sect3>
+
+<sect3><title>include files</title>
+<para>These are installed in <filename class="directory">/usr/include/sound
+</filename> and are required to compile certain packages such as
+<application><acronym>ALSA</acronym> Libraries</application>.
+</para></sect3>
+
+</sect2>
+
+</sect1>
+
Index: multimedia/libdriv/alsa-firmware.xml
===================================================================
--- multimedia/libdriv/alsa-firmware.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
+++ multimedia/libdriv/alsa-firmware.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -0,0 +1,55 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY alsa-firmware-download-http "&alsa-download-http;/firmware/alsa-firmware-&alsa-firmware-version;.tar.bz2">
+  <!ENTITY alsa-firmware-download-ftp  "&alsa-download-ftp;/firmware/alsa-firmware-&alsa-firmware-version;.tar.bz2">
+  <!ENTITY alsa-firmware-size          "1007 KB">
+  <!ENTITY alsa-firmware-buildsize     "5.8 MB">
+  <!ENTITY alsa-firmware-time          "0.03 SBU">
+]>
+<sect1 id="alsa-firmware" xreflabel="ALSA Firmware-&alsa-firmware-version;">
+<?dbhtml filename="alsa-firmware.html"?>
+<title>ALSA Firmware-&alsa-firmware-version;</title>
+
+<sect2>
+<title>Introduction to <application><acronym>ALSA</acronym> Firmware</application></title>
+
+<para>The <application><acronym>ALSA</acronym> Firmware</application> package contains 
+firmware for certain sound cards.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&alsa-firmware-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&alsa-firmware-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &alsa-firmware-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &alsa-firmware-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &alsa-firmware-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application><acronym>ALSA</acronym> Firmware</application> dependencies</title>
+<sect4><title>Required</title>
+<para>
+<xref linkend="alsa-tools"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>ALSA</acronym> Firmware</application></title>
+
+<para>The <application><acronym>ALSA</acronym> Firmware</application> package is 
+only needed by those with advanced requirements for their sound card.</para>
+
+<para>Install <application><acronym>ALSA</acronym> Firmware</application> by running 
+the following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+</sect1>
Index: multimedia/libdriv/alsa-lib.xml
===================================================================
--- multimedia/libdriv/alsa-lib.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
+++ multimedia/libdriv/alsa-lib.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -0,0 +1,91 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY alsa-lib-download-http "&alsa-download-http;/lib/alsa-lib-&alsa-lib-version;.tar.bz2">
+  <!ENTITY alsa-lib-download-ftp  "&alsa-download-ftp;/lib/alsa-lib-&alsa-lib-version;.tar.bz2">
+  <!ENTITY alsa-lib-size          "560 KB">
+  <!ENTITY alsa-lib-buildsize     "24 MB">
+  <!ENTITY alsa-lib-time          "0.41 SBU">
+]>
+<sect1 id="alsa-lib" xreflabel="ALSA Library-&alsa-lib-version;">
+<?dbhtml filename="alsa-lib.html"?>
+<title>ALSA Library-&alsa-lib-version;</title>
+
+<sect2>
+<title>Introduction to <application><acronym>ALSA</acronym> Library</application></title>
+
+<para>The <application><acronym>ALSA</acronym> Library</application> package 
+contains the <acronym>ALSA</acronym> library.  This is used by programs 
+(including <application><acronym>ALSA</acronym> Utilities</application>) requiring 
+access to the <acronym>ALSA</acronym> sound interface.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&alsa-lib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&alsa-lib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &alsa-lib-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &alsa-lib-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &alsa-lib-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application><acronym>ALSA</acronym> Library</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="alsa-driver"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>ALSA</acronym> Library</application>
+</title>
+
+<para>Install <application><acronym>ALSA</acronym> Library</application> by running 
+the following commands:</para>
+
+<screen><userinput><command>./configure --enable-static &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><parameter>--enable-static</parameter>: This switch is used to enable
+building the static library because some programs link against it.  </para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application><acronym>ALSA</acronym> Library</application></title>
+
+<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>
+
+<para>The <application><acronym>ALSA</acronym> Library</application> package 
+contains <command>aserver</command> and the <filename class="libraryfile">
+libasound</filename> library.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libasound (alsa library)</title>
+<para><filename class="libraryfile">libasound</filename> provides
+<acronym>ALSA</acronym> functions for application programs.</para></sect3>
+
+</sect2>
+
+</sect1>
Index: multimedia/libdriv/alsa-oss.xml
===================================================================
--- multimedia/libdriv/alsa-oss.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
+++ multimedia/libdriv/alsa-oss.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -0,0 +1,76 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY alsa-oss-download-http "&alsa-download-http;/oss-lib/alsa-oss-&alsa-oss-version;.tar.bz2">
+  <!ENTITY alsa-oss-download-ftp  "&alsa-download-ftp;/oss-lib/alsa-oss-&alsa-oss-version;.tar.bz2">
+  <!ENTITY alsa-oss-size          "156 KB">
+  <!ENTITY alsa-oss-buildsize     "2.3 MB">
+  <!ENTITY alsa-oss-time          "0.06 SBU">
+]>
+<sect1 id="alsa-oss" xreflabel="ALSA OSS-&alsa-oss-version;">
+<?dbhtml filename="alsa-oss.html"?>
+<title>ALSA OSS-&alsa-oss-version;</title>
+
+<sect2>
+<title>Introduction to <application><acronym>ALSA</acronym> <acronym>OSS</acronym></application></title>
+
+<para>The
+<application><acronym>ALSA</acronym> <acronym>OSS</acronym></application> 
+package contains the <acronym>ALSA</acronym> <acronym>OSS</acronym> 
+compatibility library. This is used by programs which wish to use the
+<acronym>ALSA</acronym> <acronym>OSS</acronym> sound interface.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&alsa-oss-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&alsa-oss-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &alsa-oss-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &alsa-oss-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &alsa-oss-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application><acronym>ALSA</acronym> <acronym>OSS</acronym></application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="alsa-lib"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>ALSA</acronym> <acronym>OSS</acronym></application></title>
+
+<para>Install <application><acronym>ALSA</acronym> <acronym>OSS</acronym></application> by running the following commands:</para>
+
+<screen><userinput><command>./configure &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application><acronym>ALSA</acronym> <acronym>OSS</acronym></application></title>
+
+<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>
+
+<para>The <application><acronym>ALSA</acronym> <acronym>OSS</acronym>
+</application> package contains <command>aoss</command> and the
+<filename class="libraryfile">libaoss</filename>
+(<acronym>ALSA</acronym> <acronym>OSS</acronym> compatibility
+library) library.</para>
+
+</sect2>
+
+</sect1>
+
Index: multimedia/libdriv/alsa-tools.xml
===================================================================
--- multimedia/libdriv/alsa-tools.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
+++ multimedia/libdriv/alsa-tools.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -0,0 +1,94 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY alsa-tools-download-http "&alsa-download-http;/tools/alsa-tools-&alsa-tools-version;.tar.bz2">
+  <!ENTITY alsa-tools-download-ftp  "&alsa-download-ftp;/tools/alsa-tools-&alsa-tools-version;.tar.bz2">
+  <!ENTITY alsa-tools-size          "716 KB">
+  <!ENTITY alsa-tools-buildsize     "20 MB (to compile all tools)">
+  <!ENTITY alsa-tools-time          "0.44 SBU (to compile all tools)">
+]>
+<sect1 id="alsa-tools" xreflabel="ALSA Tools-&alsa-tools-version;">
+<?dbhtml filename="alsa-tools.html"?>
+<title>ALSA Tools-&alsa-tools-version;</title>
+
+<sect2>
+<title>Introduction to <application><acronym>ALSA</acronym> Tools</application></title>
+
+<para>The <application><acronym>ALSA</acronym> Tools</application> package contains 
+advanced tools for certain sound cards.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&alsa-tools-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&alsa-tools-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &alsa-tools-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &alsa-tools-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &alsa-tools-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application><acronym>ALSA</acronym> Tools</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="alsa-lib"/>
+</para></sect4>
+<sect4><title>Optional</title>
+<para>
+<xref linkend="GTK"/> and
+<ulink url="http://www.fltk.org/">FLTK</ulink>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>ALSA</acronym> Tools</application></title>
+
+<para>The <application><acronym>ALSA</acronym> Tools</application> package is 
+only needed by those with advanced requirements for their sound card.  The 
+tools are not all built together, instead you need to <command>cd</command> 
+into the directory of each tool you wish to compile and run the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The tools available in this package are <command>ac3dec</command>,
+<command>as10k1</command>, <command>envy24control</command>,
+<command>sb16_csp</command> and <command>sbiload</command>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>ac3dec</title>
+<para><command>ac3dec</command> is a free AC-3 stream decoder.</para></sect3>
+
+<sect3><title>as10k1</title>
+<para><command>as10k1</command> is an assembler for the emu10k1 <acronym>DSP
+</acronym> chip present in the Creative SB Live,
+<acronym>PCI</acronym> 512, and emu <acronym>APS</acronym> sound cards. It is 
+used to make audio effects such as a flanger, chorus or reverb.</para></sect3>
+
+<sect3><title>envy24control</title>
+<para><command>envy24control</command> is a control tool for Envy24 (ice1712) 
+based sound cards</para></sect3>
+
+<sect3><title>sb16_csp</title>
+<para><command>sb16_csp</command> is an SB16/AWE32 Creative Signal Processor (<acronym>ASP</acronym>/<acronym>CSP
+</acronym>) control program.</para></sect3>
+
+<sect3><title>sbiload</title>
+<para><command>sbiload</command>is an <acronym>OPL</acronym>2/3 FM instrument 
+loader for the <acronym>ALSA</acronym> sequencer.</para></sect3>
+
+</sect2>
+
+</sect1>
+
Index: multimedia/libdriv/alsa-utils.xml
===================================================================
--- multimedia/libdriv/alsa-utils.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
+++ multimedia/libdriv/alsa-utils.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -0,0 +1,153 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY alsa-utils-download-http "&alsa-download-http;/utils/alsa-utils-&alsa-utils-version;.tar.bz2">
+  <!ENTITY alsa-utils-download-ftp  "&alsa-download-ftp;/utils/alsa-utils-&alsa-utils-version;.tar.bz2">
+  <!ENTITY alsa-utils-size          "140 KB">
+  <!ENTITY alsa-utils-buildsize     "3.2 MB">
+  <!ENTITY alsa-utils-time          "0.08 SBU">
+]>
+<sect1 id="alsa-utils" xreflabel="ALSA Utilities-&alsa-utils-version;">
+<?dbhtml filename="alsa-utils.html"?>
+<title>ALSA Utilities-&alsa-utils-version;</title>
+
+<sect2>
+<title>Introduction to <application><acronym>ALSA</acronym> Utilities</application></title>
+
+<para>The <application><acronym>ALSA</acronym> Utilities</application> package 
+contains various utilities which are useful for controlling your sound card.
+</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&alsa-utils-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&alsa-utils-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &alsa-utils-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &alsa-utils-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &alsa-utils-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Required Patch: <ulink
+url="&patch-root;/alsa-utils-&alsa-utils-version;-arecord-1.patch"/></para></listitem>
+</itemizedlist></sect3>
+
+<sect3><title><application><acronym>ALSA</acronym> Utilities</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="alsa-lib"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>ALSA</acronym> Utilities</application></title>
+
+<para>Install <application><acronym>ALSA</acronym> Utilities</application> by running the following commands:</para>
+
+<screen><userinput><command>patch -Np1 -i ../alsa-utils-&alsa-utils-version;-arecord-1.patch &amp;&amp;
+./configure &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application><acronym>ALSA</acronym> Utilities</application></title>
+
+<sect3><title>Config files</title>
+
+<para><filename>/etc/asound.state</filename></para>
+
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>Probably the easiest way to store mixer levels is to set and retrieve
+them using a bootscript.  It is possible to do this with a
+<userinput>post-install</userinput> line in
+<filename>/etc/modules.conf</filename> but this is left as an exercise for
+those readers who wish to do this.</para>
+
+<para>The <application><acronym>ALSA</acronym> Driver</application> package 
+installs a script as <filename>/etc/rc.d/init.d/alsasound</filename>.  While it 
+is possible to use this script, it contains a lot of extraneous detail which 
+isn't needed on an <acronym>LFS</acronym> system. Instead, install the init
+script <filename>/etc/rc.d/init.d/alsa</filename> included in the 
+<xref linkend="intro-important-bootscripts"/> package.</para>
+
+<screen><userinput><command>make install-alsa</command></userinput></screen>
+
+<para>Note that all channels of your sound card are muted by default. You can
+use the <command>alsamixer</command> program from
+<application><acronym>ALSA</acronym> Utilities</application> (or any other
+<acronym>OSS</acronym> mixer) to change this.</para>
+
+<para>The first time the above script is run, it will complain that
+there is no state in <filename>/etc/asound.state</filename>.  You can
+prevent this by running the following commands after installing
+<application><acronym>ALSA</acronym> Utilities</application>:</para>
+<screen><userinput><command>touch /etc/asound.state &amp;&amp;
+alsactl store</command></userinput></screen>
+
+<para>A final note is that the lines loading <filename>sfxload</filename>
+are commented out.  They are there as an example of other things you may
+wish to do in the startup script.  <filename>sfxload</filename> is a
+separate package of interest to SoundBlaster AWE and Live! 
+users.  It is designed for loading "sound-fonts" (which are used for
+<acronym>MIDI</acronym> output).  You may wish to delete these lines and add 
+your own or, if you have the relevant sound card, install <filename>sfxload
+</filename> and uncomment them.</para>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application><acronym>ALSA</acronym> Utilities</application> package 
+contains <command>aconnect</command>, 
+<command>alsactl</command>, <command>alsamixer</command>,
+<command>amixer</command>, <command>aplay</command>,
+<command>arecord</command> and <command>aseqnet</command>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>aconnect</title>
+<para><command>aconnect</command> is a utility for connecting and disconnecting two existing ports in the <acronym>ALSA</acronym> sequencer system.</para>
+</sect3>
+
+<sect3><title>alsactl</title>
+<para><command>alsactl</command> is used to control advanced settings
+for the <acronym>ALSA</acronym> sound card drivers.</para></sect3>
+
+<sect3><title>alsamixer</title>
+<para><command>alsamixer</command> is an ncurses-based mixer program for
+use with the <acronym>ALSA</acronym> sound card drivers.</para></sect3>
+
+<sect3><title>amixer</title>
+<para><command>amixer</command> allows command-line control of the
+mixers for the <acronym>ALSA</acronym> sound card drivers.</para></sect3>
+
+<sect3><title>aplay</title>
+<para><command>aplay</command> is a command-line soundfile player for
+the <acronym>ALSA</acronym> sound card drivers.</para></sect3>
+
+<sect3><title>arecord</title>
+<para><command>arecord</command> is a command-line soundfile recorder
+for the <acronym>ALSA</acronym> sound card drivers.</para></sect3>
+
+<sect3><title>aseqnet</title>
+<para><command>aseqnet</command> is an <acronym>ALSA</acronym> sequencer 
+client which sends and receives event packets over a network.</para></sect3>
+
+</sect2>
+
+</sect1>
+
Index: multimedia/libdriv/alsa.xml
===================================================================
--- multimedia/libdriv/alsa.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/alsa.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,2 +1,9 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
 <sect1 id="alsa" xreflabel="ALSA-&alsa-version;">
 <?dbhtml filename="alsa.html"?>
@@ -24,8 +31,5 @@
 </sect1>
 
-&alsa-driver;
-&alsa-lib;
-&alsa-utils;
-&alsa-tools;
-&alsa-firmware;
-&alsa-oss;
+
+
+
Index: multimedia/libdriv/arts.xml
===================================================================
--- multimedia/libdriv/arts.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/arts.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,2 +1,8 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
 <sect1 id="arts" xreflabel="aRts-&arts-version;">
 <?dbhtml filename="arts.html"?>
Index: multimedia/libdriv/audiofile.xml
===================================================================
--- multimedia/libdriv/audiofile.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/audiofile.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,85 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY audiofile-download-http "http://www.68k.org/~michael/audiofile/audiofile-&audiofile-version;.tar.gz">
+  <!ENTITY audiofile-download-ftp  " ">
+  <!ENTITY audiofile-size          "354 KB">
+  <!ENTITY audiofile-buildsize     "9.5 MB">
+  <!ENTITY audiofile-time          "0.27 SBU">
+]>
 <sect1 id="audiofile" xreflabel="Audio File-&audiofile-version;">
 <?dbhtml filename="audiofile.html"?>
 <title>Audio File-&audiofile-version;</title>
 
-&audiofile-intro;
-&audiofile-inst;
-&audiofile-desc;
+<sect2>
+<title>Introduction to <application>Audio File</application></title>
+
+<para>The <application>Audio File</application> package contains the audio file 
+libraries and two sound file support programs. These are useful to support 
+basic sound file formats.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&audiofile-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&audiofile-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &audiofile-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&audiofile-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&audiofile-time;</para></listitem></itemizedlist>
+</sect3>
+
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>Audio File</application></title>
+
+<para>Install <application>Audio File</application> by running the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>Audio File</application> package contains 
+<filename class="libraryfile">libaudiofile</filename> 
+library, <command>audiofile-config</command>, <command>sfinfo
+</command>and <command>sfconvert</command>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libaudiofile library</title>
+<para>The <filename>libaudiofile</filename> library is used by programs
+to support <acronym>AIFF</acronym>, <acronym>AIFF</acronym>-compressed,
+Sun/NeXT, <acronym>WAV</acronym> and <acronym>BIC</acronym> audio
+formats.</para></sect3>
+
+<sect3><title>audiofile-config</title>
+<para>The <command>audiofile-config</command> script is used during the compile 
+process by programs linking to this library.</para></sect3>
+
+<sect3><title>sfinfo</title>
+<para>The <command>sfinfo</command> program displays the sound file format, 
+audio encoding, sampling rate and duration for audio formats supported by this 
+library.</para></sect3>
+
+<sect3><title>sfconvert</title>
+<para>The <command>sfconvert</command> program converts sound file formats 
+where the original format and destination format are supported by this library.
+</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/esound.xml
===================================================================
--- multimedia/libdriv/esound.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/esound.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,11 +1,131 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY esound-download-http "http://ftp.gnome.org/pub/GNOME/sources/esound/0.2/esound-&esound-version;.tar.bz2">
+  <!ENTITY esound-download-ftp  "ftp://ftp.gnome.org/pub/GNOME/sources/esound/0.2/esound-&esound-version;.tar.bz2">
+  <!ENTITY esound-size          "312 KB">
+  <!ENTITY esound-buildsize     "4.9 MB">
+  <!ENTITY esound-time          "0.16 SBU">
+]>
+
 <sect1 id="esound" xreflabel="EsounD-&esound-version;">
 <?dbhtml filename="esound.html"?>
 <title>EsounD-&esound-version;</title>
 
-&esound-intro;
-&esound-inst;
-&esound-exp;
-&esound-config;
-&esound-desc;
+<sect2>
+<title>Introduction to <application>EsounD</application></title>
+
+<para>The <application>EsounD</application> package contains the Enlightened Sound 
+Daemon. This is useful for mixing together several digitized audio streams for 
+playback by a single device.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&esound-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&esound-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &esound-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &esound-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &esound-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>EsounD</application> dependencies</title>
+<sect4><title>Required</title>
+<para>
+<xref linkend="audiofile"/>
+</para></sect4>
+<sect4><title>Optional</title>
+<para>
+<xref linkend="alsa"/>,
+<xref linkend="tcpwrappers"/> and
+<ulink url="http://sources.redhat.com/docbook-tools/">docbook-utils</ulink>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>EsounD</application></title>
+
+<para>Install <application>EsounD</application> by running the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><parameter>--sysconfdir=/etc</parameter>: This switch puts configuration 
+files in <filename class="directory">/etc</filename> instead of
+<filename class="directory">/usr/etc</filename>.
+</para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application>EsounD</application></title>
+
+<sect3><title>Config files</title>
+<para><filename>/etc/esd.conf</filename></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>Instructions and information about the configuration file is
+located in the <filename>TIPS</filename> file in the <application>EsounD
+</application> source directory.</para>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>EsounD</application> package contains 
+<command>esd</command>,
+<command>esdcat</command>, <command>esdctl</command>,
+<command>esdloop</command>, <command>esdmon</command>,
+<command>esdrec</command>, <command>esdsample</command> and
+<filename class="libraryfile">libesd</filename> libraries.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>esd</title>
+<para><command>esd</command> is the Enlightened Sound Daemon.</para></sect3>
+
+<sect3><title>esdcat</title>
+<para><command>esdcat</command> plays a <filename>RAW</filename> audio stream 
+through the daemon.</para></sect3>
+
+<sect3><title>esdctl</title>
+<para><command>esdctl</command> controls certain aspects of the sound daemon.</para></sect3>
+
+<sect3><title>esdloop</title>
+<para><command>esdloop</command> is test scaffolding for sample cache, loop, 
+and free.</para></sect3>
+
+<sect3><title>esdmon</title>
+<para><command>esdmon</command> outputs the mixed stream from the daemon.</para></sect3>
+
+<sect3><title>esdrec</title>
+<para><command>esdrec</command> outputs from the sound device's current
+input.</para></sect3>
+
+<sect3><title>esdsample</title>
+<para><command>esdsample</command> is test scaffolding for sample cache, play 
+back, and free.</para></sect3>
+
+<sect3><title>esd libraries</title>
+<para><filename class="libraryfile">libesd</filename> libraries contain the functions used
+by <command>esd</command>.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/flac.xml
===================================================================
--- multimedia/libdriv/flac.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/flac.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,93 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY flac-download-http "http://prdownloads.sourceforge.net/flac/flac-&flac-version;.tar.gz">
+  <!ENTITY flac-download-ftp  " ">
+  <!ENTITY flac-size          "1.2 MB">
+  <!ENTITY flac-buildsize     "33 MB">
+  <!ENTITY flac-time          "0.71 SBU">
+]>
+
 <sect1 id="flac" xreflabel="FLAC-&flac-version;">
 <?dbhtml filename="flac.html"?>
 <title>FLAC-&flac-version;</title>
 
-&flac-intro;
-&flac-inst;
-&flac-desc;
+<sect2>
+<title>Introduction to <application><acronym>FLAC</acronym></application></title>
+
+<para><application><acronym>FLAC</acronym></application> is an audio
+<acronym>CODEC</acronym> similar to <filename>MP3</filename>, but
+lossless, meaning that audio is compressed without losing any
+information.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&flac-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&flac-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &flac-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &flac-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &flac-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application><acronym>FLAC</acronym></application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="libogg"/>, <xref linkend="xmms"/>, <xref
+linkend="id3lib"/> and <xref linkend="NASM"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>FLAC</acronym></application></title>
+
+<para>Install <application><acronym>FLAC</acronym></application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <acronym>FLAC</acronym> package contains
+<command>flac</command>, 
+<command>metaflac</command>,
+<filename class="libraryfile">libFLAC</filename>,
+<filename class="libraryfile">libFLAC++</filename>,
+<filename class="libraryfile">libOggFLAC</filename>,
+<filename class="libraryfile">libOggFLAC++</filename> and
+<filename class="libraryfile">libxmms-flac</filename>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>flac</title>
+<para><command>flac</command> is a command-line utility for
+encoding, decoding and converting <acronym>FLAC</acronym>
+files.</para></sect3>
+
+<sect3><title>metaflac</title>
+<para><command>metaflac</command> is a program for listing, adding,
+removing, or editing metadata in one or more <acronym>FLAC</acronym>
+files.</para></sect3>
+
+<sect3><title>libFLAC, libFLAC++, libOggFLAC and libOggFLAC++</title>
+<para>These libraries provide native
+<acronym>FLAC</acronym> and Ogg <acronym>FLAC</acronym> C/C++
+<acronym>API</acronym>s for programs utilizing
+<acronym>FLAC</acronym>.</para></sect3>
+
+<sect3><title>libxmms-flac</title>
+<para><filename class="libraryfile">libxmms-flac</filename> is a plugin
+for <application><acronym>XMMS</acronym></application>.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/id3lib.xml
===================================================================
--- multimedia/libdriv/id3lib.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/id3lib.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,81 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY id3lib-download-http "http://prdownloads.sourceforge.net/id3lib/id3lib-&id3lib-version;.tar.gz">
+  <!ENTITY id3lib-download-ftp  " ">
+  <!ENTITY id3lib-size          "928 KB">
+  <!ENTITY id3lib-buildsize     "39 MB">
+  <!ENTITY id3lib-time          "1.01 SBU">
+]>
+
 <sect1 id="id3lib" xreflabel="id3lib-&id3lib-version;">
 <?dbhtml filename="id3lib.html"?>
 <title>id3lib-&id3lib-version;</title>
 
-&id3lib-intro;
-&id3lib-inst;
-&id3lib-desc;
+<sect2>
+<title>Introduction to <application>id3lib</application></title>
+
+<para><application>id3lib</application> is a library for reading, writing and manipulating ID3v1
+and ID3v2 tags.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&id3lib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&id3lib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &id3lib-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &id3lib-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &id3lib-time;</para></listitem></itemizedlist>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>id3lib</application></title>
+
+<para>Install <application>id3lib</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The id3lib package contains the <filename
+class="libraryfile">libid3</filename> library and
+<command>id3convert</command>, <command>id3cp</command>,
+<command>id3info</command> and <command>id3tag</command>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libid3</title>
+<para><filename class="libraryfile">libid3</filename> 
+provides functions for the ID3v1/v2 tag editing programs.
+</para></sect3>
+
+<sect3><title>id3convert</title>
+<para><command>id3convert</command> converts between
+ID3v1/v2 tagging formats.</para></sect3>
+
+<sect3><title>id3cp</title>
+<para><command>id3cp</command> extracts ID3v1/v2 tags from
+digital audio files.</para></sect3>
+
+<sect3><title>id3info</title>
+<para><command>id3info</command> prints ID3v1/v2 tag
+contents.</para></sect3>
+
+<sect3><title>id3tag</title>
+<para><command>id3tag</command> is an utility for editing ID3v1/v2
+tags.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/liba52.xml
===================================================================
--- multimedia/libdriv/liba52.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/liba52.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,77 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY liba52-download-http "http://liba52.sourceforge.net/files/a52dec-&liba52-version;.tar.gz">
+  <!ENTITY liba52-download-ftp  " ">
+  <!ENTITY liba52-size          "236 KB">
+  <!ENTITY liba52-buildsize     "2.8 MB">
+  <!ENTITY liba52-time          "0.07 SBU">
+]>
+
 <sect1 id="liba52" xreflabel="liba52-&liba52-version;">
 <?dbhtml filename="liba52.html"?>
 <title>liba52-&liba52-version;</title>
 
-&liba52-intro;
-&liba52-inst;
-&liba52-desc;
+<sect2>
+<title>Introduction to <application>liba52</application></title>
+
+<para><application>liba52</application> is a free library for decoding
+<acronym>ATSC</acronym> A/52 (also known as AC-3) streams. The A/52
+standard is used in a variety of applications, including digital
+television and <acronym>DVD</acronym>.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&liba52-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&liba52-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &liba52-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &liba52-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &liba52-time;</para></listitem></itemizedlist>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>liba52</application></title>
+
+<para>Install <application>liba52</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr --enable-shared &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The liba52 package contains <command>a52dec</command>,
+<command>extract_a52</command> and <filename
+class="libraryfile">liba52</filename>.
+
+</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>a52dec</title>
+<para><command>a52dec</command> plays <acronym>ATSC</acronym> A/52 audio
+streams.</para></sect3>
+
+<sect3><title>extract_a52</title>
+<para><command>extract_a52</command> extracts <acronym>ATSC</acronym> A/52 audio from a
+<acronym>MPEG</acronym> stream.</para></sect3>
+
+<sect3><title>liba52</title>
+<para><filename class="libraryfile">liba52</filename> provides functions
+for the programs dealing with <acronym>ATSC</acronym> A/52
+streams.</para></sect3>
+
+</sect2>
 
 </sect1>
+
Index: multimedia/libdriv/libao.xml
===================================================================
--- multimedia/libdriv/libao.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libao.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,77 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libao-download-http "http://www.xiph.org/ao/src/libao-&libao-version;.tar.gz">
+  <!ENTITY libao-download-ftp  " ">
+  <!ENTITY libao-size          "262 KB">
+  <!ENTITY libao-buildsize     "2.7 MB">
+  <!ENTITY libao-time          "0.10 SBU">
+]>
+
 <sect1 id="libao" xreflabel="libao-&libao-version;">
 <?dbhtml filename="libao.html"?>
 <title>libao-&libao-version;</title>
 
-&libao-intro;
-&libao-inst;
-&libao-desc;
+<sect2>
+<title>Introduction to <application>libao</application></title>
+
+<para>The <application>libao</application> package contains a cross-platform 
+audio library. This is useful to output audio on a wide variety of platforms.  
+It currently supports <acronym>WAV</acronym> files,
+<acronym>OSS</acronym> (Open Sound System), <acronym>ESD</acronym> (Enlighten 
+Sound Daemon) and <acronym>ALSA</acronym> (Advanced Linux Sound Architecture).
+</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libao-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libao-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libao-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libao-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libao-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>libao</application> dependencies</title>
+<sect4><title>Optional</title>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), <xref linkend="esound"/>, <xref
+linkend="alsa"/>, <xref linkend="arts"/> and <xref linkend="nas"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libao</application></title>
+
+<para>Install <application>libao</application> by running the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>libao</application> package contains <filename
+class="libraryfile">libao</filename> libraries.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>ao libraries</title>
+<para><filename class="libraryfile">libao</filename> libraries provide functions for programs 
+wishing to output sound over supported platforms.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libdriv.xml
===================================================================
--- multimedia/libdriv/libdriv.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libdriv.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,2 +1,9 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
 <chapter id="multimedia-libdriv">
 <?dbhtml filename="libdriv.html"?>
@@ -9,27 +16,33 @@
 enable it to support certain functionality.</para>
 
-&alsa;
-&arts;
-&audiofile;
-&esound;
-&SDL;
-&libao;
-&libogg;
-&libvorbis;
-&nas;
-&libmpeg3;
-&libmad;
-&openquicktime;
-&libfame;
-&speex;
-&id3lib;
-&flac;
-&libdvdcss;
-&libdvdread;
-&libdv;
-&liba52;
-&xvid;
-&xine-lib;
-&libmikmod;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa-driver.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa-lib.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa-utils.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa-tools.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa-firmware.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="alsa-oss.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="arts.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="audiofile.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="esound.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sdl.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libao.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libogg.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libvorbis.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nas.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libmpeg3.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libmad.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openquicktime.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libfame.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="speex.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="id3lib.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="flac.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libdvdcss.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libdvdread.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libdv.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="liba52.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xvid.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xine-lib.xml"/> 
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libmikmod.xml"/> 
 
 </chapter>
Index: multimedia/libdriv/libdv.xml
===================================================================
--- multimedia/libdriv/libdv.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libdv.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,88 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libdv-download-http "http://prdownloads.sourceforge.net/libdv/libdv-&libdv-version;.tar.gz">
+  <!ENTITY libdv-download-ftp  " ">
+  <!ENTITY libdv-size          "465 KB">
+  <!ENTITY libdv-buildsize     "8.5 MB">
+  <!ENTITY libdv-time          "0.21 SBU">
+]>
+
 <sect1 id="libdv" xreflabel="libdv-&libdv-version;">
 <?dbhtml filename="libdv.html"?>
 <title>libdv-&libdv-version;</title>
 
-&libdv-intro;
-&libdv-inst;
-&libdv-desc;
+<sect2>
+<title>Introduction to <application>libdv</application></title>
+
+<para><application>libdv</application> (Quasar DV) is a software
+<acronym>CODEC</acronym> for DV video, the encoding format used by most digital camcorders.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libdv-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libdv-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libdv-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libdv-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libdv-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>libdv</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="popt"/>, <xref linkend="SDL"/>, <xref linkend="GTK"/> and X (<xref
+linkend="xfree86"/> or <xref linkend="xorg"/>).
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libdv</application></title>
+
+<para>Install <application>libdv</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+<note><para>The configure check for <application>GTK+</application> is
+broken. If <application>GTK+</application> is not installed, also pass
+<option>--without-gtk</option> to the configure script.</para></note>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The libdv package contains <command>dvconnect</command>,
+<command>encodedv</command>, <command>playdv</command> and <filename
+class="libraryfile">libdv</filename>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>dvconnect</title>
+<para><command>dvconnect</command> is a small utility to send or capture
+raw data from and to the camcorder.</para></sect3>
+
+<sect3><title>encodedv</title> 
+<para><command>encodedv</command> encodes a series of images to a digital
+video stream.</para></sect3>
+
+<sect3><title>playdv</title>
+<para><command>playdv</command> displays digital video streams on
+the screen.</para></sect3>
+
+<sect3><title>libdv</title>
+<para><filename class="libraryfile">libdv</filename>
+provides functions for the programs manipulating with the Quasar DV
+<acronym>CODEC</acronym>.</para></sect3>
+
+</sect2>
 
 </sect1>
+
Index: multimedia/libdriv/libdvdcss.xml
===================================================================
--- multimedia/libdriv/libdvdcss.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libdvdcss.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,69 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libdvdcss-download-http "http://www.videolan.org/pub/libdvdcss/&libdvdcss-version;/libdvdcss-&libdvdcss-version;.tar.bz2">
+  <!ENTITY libdvdcss-download-ftp  "ftp://ftp.us.sinuspl.net/pub/src/libdvdcss-&libdvdcss-version;.tar.bz2">
+  <!ENTITY libdvdcss-size          "205 KB">
+  <!ENTITY libdvdcss-buildsize     "2.6 MB">
+  <!ENTITY libdvdcss-time          "0.07 SBU">
+]>
+
 <sect1 id="libdvdcss" xreflabel="libdvdcss-&libdvdcss-version;">
 <?dbhtml filename="libdvdcss.html"?>
 <title>libdvdcss-&libdvdcss-version;</title>
 
-&libdvdcss-intro;
-&libdvdcss-inst;
-&libdvdcss-desc;
+<sect2>
+<title>Introduction to <application>libdvdcss</application></title>
+
+<para><application>libdvdcss</application> is a 
+simple library designed for accessing <acronym>DVD</acronym>s as a block
+device without having to bother about the decryption.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libdvdcss-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libdvdcss-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libdvdcss-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libdvdcss-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libdvdcss-time;</para></listitem></itemizedlist>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libdvdcss</application></title>
+
+<para>Install <application>libdvdcss</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The libdvdcss package contains the <filename
+class="libraryfile">libdvdcss</filename> library.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libdvdcss</title>
+<para><filename class="libraryfile">libdvdcss</filename> provides
+the functionality that is required for transparent
+<acronym>DVD</acronym> access with <acronym>CSS</acronym> decryption.
+</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libdvdread.xml
===================================================================
--- multimedia/libdriv/libdvdread.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libdvdread.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,10 +1,80 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libdvdread-download-http "http://www.dtek.chalmers.se/groups/dvd/dist/libdvdread-&libdvdread-version;.tar.gz">
+  <!ENTITY libdvdread-download-ftp  " ">
+  <!ENTITY libdvdread-size          "251 KB">
+  <!ENTITY libdvdread-buildsize     "4.0 MB">
+  <!ENTITY libdvdread-time          "0.12 SBU">
+]>
+
 <sect1 id="libdvdread" xreflabel="libdvdread-&libdvdread-version;">
 <?dbhtml filename="libdvdread.html"?>
 <title>libdvdread-&libdvdread-version;</title>
 
-&libdvdread-intro;
-&libdvdread-inst;
-&libdvdread-exp;
-&libdvdread-desc;
+<sect2>
+<title>Introduction to <application>libdvdread</application></title>
+
+<para><application>libdvdread</application> is a 
+library which provides a simple foundation for reading
+<acronym>DVD</acronym>s.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libdvdread-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libdvdread-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libdvdread-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libdvdread-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libdvdread-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>libdvdread</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="libdvdcss"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libdvdread</application></title>
+
+<para>Install <application>libdvdread</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><option>--with-libdvdcss</option>: 
+This switch is needed if you want <application>libdvdread</application> to be able to read
+<acronym>CSS</acronym> encrypted <acronym>DVD</acronym>s.</para>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The libdvdread package contains the <filename
+class="libraryfile">libdvdread</filename> library.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libdvdread</title>
+<para><filename class="libraryfile">libdvdread</filename> provides
+the functionality that is required to access
+<acronym>DVD</acronym>s.</para></sect3>
+
+</sect2>
 
 </sect1>
+
Index: multimedia/libdriv/libfame.xml
===================================================================
--- multimedia/libdriv/libfame.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libfame.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,70 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libfame-download-http "http://prdownloads.sourceforge.net/fame/libfame-&libfame-version;.tar.gz">
+  <!ENTITY libfame-download-ftp  " ">
+  <!ENTITY libfame-size          "290 KB">
+  <!ENTITY libfame-buildsize     "4.9 MB">
+  <!ENTITY libfame-time          "0.19 SBU">
+]>
+
 <sect1 id="libfame" xreflabel="libFAME-&libfame-version;">
 <?dbhtml filename="libfame.html"?>
 <title>libFAME-&libfame-version;</title>
 
-&libfame-intro;
-&libfame-inst;
-&libfame-desc;
+<sect2>
+<title>Introduction to <application>lib<acronym>FAME</acronym></application></title>
+
+<para><application>lib<acronym>FAME</acronym></application> is a 
+fast (real-time) MPEG-1 as well as MPEG-4 rectangular and arbitrary shaped
+video encoding library.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libfame-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libfame-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libfame-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libfame-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libfame-time;</para></listitem></itemizedlist>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>lib<acronym>FAME</acronym></application></title>
+
+<para>Install <application>lib<acronym>FAME</acronym></application> by running 
+the following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>lib<acronym>FAME</acronym></application> package 
+contains <command>libfame-config</command> and
+<filename class="libraryfile">libfame</filename>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libfame-config</title>
+<para><command>libfame-config</command>
+provides configuration information for <filename class="libraryfile">libfame</filename>.
+</para></sect3>
+
+<sect3><title>libfame</title>
+<para><filename class="libraryfile">libfame</filename>
+provides functions for the video encoding programs.
+</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libmad.xml
===================================================================
--- multimedia/libdriv/libmad.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libmad.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,64 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libmad-download-http "http://prdownloads.sourceforge.net/mad/libmad-&libmad-version;.tar.gz">
+  <!ENTITY libmad-download-ftp  "ftp://ftp.mars.org/pub/mpeg/libmad-&libmad-version;.tar.gz">
+  <!ENTITY libmad-size          "494 KB">
+  <!ENTITY libmad-buildsize     "3.5 MB">
+  <!ENTITY libmad-time          "0.09 SBU">
+]>
+
 <sect1 id="libmad" xreflabel="libmad-&libmad-version;">
 <?dbhtml filename="libmad.html"?>
 <title>libmad-&libmad-version;</title>
 
-&libmad-intro;
-&libmad-inst;
-&libmad-desc;
+<sect2>
+<title>Introduction to <application>libmad</application></title>
+
+<para>
+<application>libmad</application> is a high-quality
+<acronym>MPEG</acronym> audio decoder capable of 24-bit output.
+</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libmad-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libmad-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libmad-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libmad-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libmad-time;</para></listitem></itemizedlist>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libmad</application></title>
+
+<para>Install <application>libmad</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>This package provides
+<filename class="libraryfile">libmad</filename> library.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libmad</title>
+<para><filename class="libraryfile">libmad</filename> 
+is a <acronym>MPEG</acronym> audio decoder library.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libmikmod.xml
===================================================================
--- multimedia/libdriv/libmikmod.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libmikmod.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,79 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libmikmod-download-http "http://www.ibiblio.org/pub/Linux/apps/sound/libs/libmikmod-&libmikmod-version;.tar.gz">
+  <!ENTITY libmikmod-download-ftp  " ">
+  <!ENTITY libmikmod-size          "520 KB">
+  <!ENTITY libmikmod-buildsize     "11 MB">
+  <!ENTITY libmikmod-time          "0.31 SBU">
+]>
+
 <sect1 id="libmikmod" xreflabel="libmikmod-&libmikmod-version;">
 <?dbhtml filename="libmikmod.html"?>
 <title>libmikmod-&libmikmod-version;</title>
 
-&libmikmod-intro;
-&libmikmod-inst;
-&libmikmod-desc;
+<sect2>
+<title>Introduction to <application>libmikmod</application></title>
+
+<para>
+<application>libmikmod</application> is a sound library capable of
+playing audio samples as well as tracker modules. Supported module
+formats include <acronym>MOD</acronym>, <acronym>S3M</acronym>,
+<acronym>XM</acronym>, <acronym>IT</acronym>, <acronym>MED</acronym>,
+<acronym>MTM</acronym> and <acronym>669</acronym>.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libmikmod-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libmikmod-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libmikmod-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libmikmod-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libmikmod-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>libmikmod</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="esound"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libmikmod</application></title>
+
+<para>Install <application>libmikmod</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>libmikmod</application> package contains
+<command>libmikmod-config</command> and the <filename
+class="libraryfile">libmikmod</filename> library.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libmikmod-config</title>
+<para><command>libmikmod-config</command> provides version information,
+compiler and linker flags to programs that utilize
+libmikmod.</para></sect3>
+
+<sect3><title>libmikmod</title>
+<para><filename class="libraryfile">libmikmod</filename> provides
+the functionality that is required to play various tracker module files.
+</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libmpeg3.xml
===================================================================
--- multimedia/libdriv/libmpeg3.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libmpeg3.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,10 +1,93 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libmpeg3-download-http "http://prdownloads.sourceforge.net/heroines/libmpeg3-&libmpeg3-version;-src.tar.bz2">
+  <!ENTITY libmpeg3-download-ftp  " ">
+  <!ENTITY libmpeg3-size          "612 KB">
+  <!ENTITY libmpeg3-buildsize     "5.7 MB">
+  <!ENTITY libmpeg3-time          "0.12 SBU">
+]>
+
 <sect1 id="libmpeg3" xreflabel="libmpeg3-&libmpeg3-version;">
 <?dbhtml filename="libmpeg3.html"?>
 <title>libmpeg3-&libmpeg3-version;</title>
 
-&libmpeg3-intro;
-&libmpeg3-inst;
-&libmpeg3-exp;
-&libmpeg3-desc;
+<sect2>
+<title>Introduction to <application>libmpeg3</application></title>
+
+<para><application>Libmpeg3</application> supports advanced editing and
+manipulation of <acronym>MPEG</acronym> streams.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libmpeg3-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libmpeg3-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libmpeg3-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libmpeg3-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libmpeg3-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>libmpeg3</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="NASM"/></para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libmpeg3</application></title>
+
+<para>Install <application>libmpeg3</application> by running the following
+commands:</para>
+
+<screen><userinput><command>make &amp;&amp;
+make install &amp;&amp;
+cp i686/libmpeg3.a /usr/lib &amp;&amp;
+cp {libmpeg3,mpeg3private,mpeg3protos}.h /usr/include</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><command>cp i686/libmpeg3.a /usr/lib &amp;&amp; cp 
+{libmpeg3,mpeg3private,mpeg3protos}.h /usr/include</command>: Since make install 
+doesn't copy the library and header files to proper locations, 
+we have to do it manually.</para>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>libmpeg3</application> package provides <filename
+class="libraryfile">libmpeg3</filename> library,
+<command>mpeg3cat</command>, <command>mpeg3dump</command>
+and <command>mpeg3toc</command> utilities.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libmpeg3</title>
+<para><filename class="libraryfile">libmpeg3</filename> decodes several
+<acronym>MPEG</acronym> standards into uncompressed data
+suitable for editing and playback.</para></sect3>
+
+<sect3><title>mpeg3cat</title>
+<para><command>mpeg3cat</command> concatenates elementary streams or
+demultiplexes a program stream (separates components of the stream).</para></sect3>
+
+<sect3><title>mpeg3dump</title>
+<para><command>mpeg3dump</command> dumps information or extracts audio
+to a 24 bit <acronym>PCM</acronym> file.</para></sect3>
+
+<sect3><title>mpeg3toc</title>
+<para><command>mpeg3toc</command> creates a table of contents for a
+<acronym>DVD</acronym> or <acronym>MPEG</acronym> stream.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libogg.xml
===================================================================
--- multimedia/libdriv/libogg.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libogg.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,69 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libogg-download-http "http://www.vorbis.com/files/1.0.1/unix/libogg-&libogg-version;.tar.gz">
+  <!ENTITY libogg-download-ftp  " ">
+  <!ENTITY libogg-size          "280 KB">
+  <!ENTITY libogg-buildsize     "2.3 MB">
+  <!ENTITY libogg-time          "0.03 SBU">
+]>
+
 <sect1 id="libogg" xreflabel="libogg-&libogg-version;">
 <?dbhtml filename="libogg.html"?>
 <title>libogg-&libogg-version;</title>
 
-&libogg-intro;
-&libogg-inst;
-&libogg-desc;
+<sect2>
+<title>Introduction to <application>libogg</application></title>
+
+<para>The <application>libogg</application> package contains the Ogg file 
+structure. This is useful for creating (encoding) or playing (decoding) a 
+single physical bit stream.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libogg-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libogg-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libogg-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libogg-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libogg-time;</para></listitem></itemizedlist>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libogg</application></title>
+
+<para>Install <application>libogg</application> by running the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>libogg</application> package contains <filename
+class="libraryfile">libogg</filename> libraries.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>ogg libraries</title>
+<para><filename class="libraryfile">libogg</filename> libraries provide the 
+functions for programs wishing to read or write Ogg
+formatted bit streams.</para>
+</sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/libvorbis.xml
===================================================================
--- multimedia/libdriv/libvorbis.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/libvorbis.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,85 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY libvorbis-download-http "http://www.vorbis.com/files/1.0.1/unix/libvorbis-&libvorbis-version;.tar.gz">
+  <!ENTITY libvorbis-download-ftp  " ">
+  <!ENTITY libvorbis-size          "1.2 MB">
+  <!ENTITY libvorbis-buildsize     "37 MB">
+  <!ENTITY libvorbis-time          "0.57 SBU">
+]>
+
 <sect1 id="libvorbis" xreflabel="libvorbis-&libvorbis-version;">
 <?dbhtml filename="libvorbis.html"?>
 <title>libvorbis-&libvorbis-version;</title>
 
-&libvorbis-intro;
-&libvorbis-inst;
-&libvorbis-desc;
+<sect2>
+<title>Introduction to <application>libvorbis</application></title>
+
+<para>The <application>libvorbis</application> package contains a general 
+purpose audio and music encoding format. This is useful for creating (encoding) 
+and playing (decoding) sound in an open (patent free) format.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libvorbis-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libvorbis-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libvorbis-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libvorbis-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libvorbis-time;</para></listitem></itemizedlist>
+</sect3>
+                                                                                
+<sect3><title><application>libvorbis</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="libogg"/></para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>libvorbis</application></title>
+
+<para>Install <application>libvorbis</application> by running the following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+<para><application>libvorbis</application> is known to cause compiler errors 
+on certain machines. If you get errors, try these commands to install libvorbis:
+</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+cd lib &amp;&amp;
+cp Makefile Makefile.bak &amp;&amp;
+sed s/-mno-ieee-fp// Makefile.bak > Makefile &amp;&amp;
+cd .. &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>libvorbis</application> package contains
+<filename class="libraryfile">
+libvorbis</filename> libraries.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>vorbis libraries</title>
+<para><filename class="libraryfile">libvorbis</filename> libraries provide the functions to read and write 
+sound files.</para></sect3>
+
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/nas.xml
===================================================================
--- multimedia/libdriv/nas.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/nas.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,11 +1,100 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY nas-download-http "http://nas.codebrilliance.com/nas/nas-&nas-version;.src.tar.gz">
+  <!ENTITY nas-download-ftp  "ftp://ftp.us.xemacs.org/pub/xemacs/aux/nas-&nas-version;.src.tar.gz">
+  <!ENTITY nas-size          "1.0 MB">
+  <!ENTITY nas-buildsize     "13 MB">
+  <!ENTITY nas-time          "0.30 SBU">
+]>
+
 <sect1 id="nas" xreflabel="NAS-&nas-version;">
 <?dbhtml filename="nas.html"?>
 <title>NAS-&nas-version;</title>
 
-&nas-intro;
-&nas-inst;
-&nas-exp;
-&nas-config;
-&nas-desc;
+<sect2>
+<title>Introduction to <application><acronym>NAS</acronym></application></title>
+
+<para>The Network Audio System is a network transparent, client/server audio
+transport system. It can be described as the audio equivalent of an
+<application>X</application> server.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&nas-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&nas-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &nas-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &nas-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &nas-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&patch-root;/nas-1.6-bison-fix.patch"/></para></listitem>
+</itemizedlist></sect3>
+
+<sect3><title><application>NAS</application> dependencies</title>
+<sect4><title>Required</title>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>NAS</acronym></application></title>
+
+<para>Install <application><acronym>NAS</acronym></application> by running the following commands:</para>
+
+<screen><userinput><command>patch -Np1 -i ../nas-1.6-bison-fix.patch &amp;&amp;
+xmkmf &amp;&amp;
+make Makefiles &amp;&amp;
+make includes &amp;&amp;
+make depend &amp;&amp;
+make &amp;&amp;
+make install install.man</command></userinput></screen>
+
+<!--
+make INCROOT=/usr/include USRLIBDIR=/usr/lib \
+MANPATH=/usr/share/man BINDIR=/usr/bin \
+LIBDIR=/usr/lib CONFIGDIR=/usr/X11R6/lib/X11/config \
+install install.man
+-->
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><command>xmkmf...</command>: These commands use the standard for compiling <application>X</application> based applications.</para>
+
+<!--
+<para><command>make INCROOT=...</command>: These commands install with
+the <filename class="directory">/usr</filename> prefix
+instead of the default <filename class="directory">/usr/X11R6</filename>
+prefix.  They also install the man pages.</para>
+-->
+
+</sect2>
+
+<sect2>
+<title>Configuring <acronym>NAS</acronym></title>
+
+<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>
+
+<para>The <application><acronym>NAS</acronym></application> package contains 
+<acronym>NAS</acronym> utilities, headers and libraries.</para>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/openquicktime.xml
===================================================================
--- multimedia/libdriv/openquicktime.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/openquicktime.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,100 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY openquicktime-download-http "http://prdownloads.sourceforge.net/openquicktime/openquicktime-&openquicktime-version;-src.tgz">
+  <!ENTITY openquicktime-download-ftp  " ">
+  <!ENTITY openquicktime-size          "313 KB">
+  <!ENTITY openquicktime-buildsize     "8.6 MB">
+  <!ENTITY openquicktime-time          "0.11 SBU">
+]>
+
 <sect1 id="openquicktime" xreflabel="OpenQuicktime-&openquicktime-version;">
 <?dbhtml filename="openquicktime.html"?>
 <title>OpenQuicktime-&openquicktime-version;</title>
 
-&openquicktime-intro;
-&openquicktime-inst;
-&openquicktime-desc;
+<sect2>
+<title>Introduction to <application>OpenQuicktime</application></title>
+
+<para><application>OpenQuicktime</application> is a small library that handles the Quicktime
+file format on most varieties of Unix. Audio and video decoding and
+encoding is provided using a plug-in mechanism.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&openquicktime-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&openquicktime-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &openquicktime-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &openquicktime-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &openquicktime-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Optional <acronym>CODEC</acronym>: <ulink
+url="http://www.openquicktime.org/codecs.php"/></para></listitem>
+</itemizedlist></sect3>
+
+<sect3><title><application>OpenQuicktime</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="GLib"/></para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="libjpeg"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>OpenQuicktime</application></title>
+
+<para>Install <application>OpenQuicktime</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>This package provides <filename class="libraryfile">libopenquicktime</filename> 
+library and utilities that allow you to manipulate Quicktime files.
+</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libopenquicktime</title>
+<para>This is the core library.</para></sect3>
+
+<sect3><title>dechunk</title>
+<para><command>dechunk</command> extracts <acronym>RGB</acronym> frames 
+from a movie and writes them as <acronym>PPM</acronym> images.
+</para></sect3>
+
+<sect3><title>make_streamable</title>
+<para>This program makes the Quicktime file streamable. 
+</para></sect3>
+
+<sect3><title>qtdump</title>
+<para><command>qtdump</command> dumps all tables in a movie.
+</para></sect3>
+
+<sect3><title>qtinfo</title>
+<para><command>qtinfo</command> reads all the information about the file.
+</para></sect3>
+
+<sect3><title>recover</title>
+<para>This program recovers <acronym>JPEG</acronym> and
+<acronym>PCM</acronym> audio from a corrupted movie.
+</para></sect3>
+
+</sect2>
 
 </sect1>
+
Index: multimedia/libdriv/sdl.xml
===================================================================
--- multimedia/libdriv/sdl.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/sdl.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,11 +1,101 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY SDL-download-http "http://www.libsdl.org/release/SDL-&SDL-version;.tar.gz">
+  <!ENTITY SDL-download-ftp  " ">
+  <!ENTITY SDL-size          "2.4 MB">
+  <!ENTITY SDL-buildsize     "46 MB">
+  <!ENTITY SDL-time          "0.99 SBU">
+]>
 <sect1 id="SDL" xreflabel="SDL-&SDL-version;">
 <?dbhtml filename="sdl.html"?>
 <title>SDL-&SDL-version;</title>
 
-&SDL-intro;
-&SDL-inst;
-&SDL-exp;
-&SDL-config;
-&SDL-desc;
+<sect2>
+<title>Introduction to <application><acronym>SDL</acronym></application></title>
+
+<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>
+
+<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 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>
+
+<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"/>,
+<xref linkend="DirectFB"/> and
+<xref linkend="SVGAlib"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>SDL</acronym></application></title>
+
+<para>Install <application><acronym>SDL</acronym></application> by running the following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr --disable-debug &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<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>--enable-video-aalib</parameter>: This switch
+is required to build <application><acronym>SDL</acronym></application>
+with <acronym>AA</acronym>lib video support.</para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application><acronym>SDL</acronym></application></title>
+
+<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>
+
+<para>The <application><acronym>SDL</acronym></application> package contains 
+the <userinput>Simple DirectMedia Layer</userinput>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>Simple DirectMedia Layer</title>
+<para>The Simple DirectMedia Layer is a generic <acronym>API</acronym> that 
+provides low level access to audio, keyboard, mouse, joystick, 3D hardware via 
+OpenGL, and 2D frame buffer across multiple platforms.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/speex.xml
===================================================================
--- multimedia/libdriv/speex.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/speex.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,79 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY speex-download-http "http://www.speex.org/download/speex-&speex-version;.tar.gz">
+  <!ENTITY speex-download-ftp  " ">
+  <!ENTITY speex-size          "392 KB">
+  <!ENTITY speex-buildsize     "3.2 MB">
+  <!ENTITY speex-time          "0.13 SBU">
+]>
+
 <sect1 id="speex" xreflabel="Speex-&speex-version;">
 <?dbhtml filename="speex.html"?>
 <title>Speex-&speex-version;</title>
 
-&speex-intro;
-&speex-inst;
-&speex-desc;
+<sect2>
+<title>Introduction to <application>Speex</application></title>
+
+<para><application>Speex</application> is an audio compression format designed
+especially for speech. It is well-adapted to Internet applications and
+provides useful features that are not present in most other
+<acronym>CODEC</acronym>s.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&speex-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&speex-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &speex-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &speex-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &speex-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>Speex</application> dependencies</title>
+<sect4><title>Recommended</title>
+<para><xref linkend="libogg"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>Speex</application></title>
+
+<para>Install <application>Speex</application> by running the
+following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The Speex package provides <command>speexdec</command>,
+<command>speexenc</command> and <filename
+class="libraryfile">libspeex</filename>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>speexdec</title>
+<para><command>speexdec</command> decodes a Speex file and produces a
+<acronym>WAV</acronym> or raw file.</para></sect3>
+
+<sect3><title>speexenc</title>
+<para><command>speexenc</command> encodes a <acronym>WAV</acronym> or
+raw files using Speex.</para></sect3>
+
+<sect3><title>libspeex</title>
+<para><filename class="libraryfile">libspeex</filename> provides
+functions for the audio encoding/decoding programs.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/xine-lib.xml
===================================================================
--- multimedia/libdriv/xine-lib.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/xine-lib.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,9 +1,83 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY xine-lib-download-http "http://prdownloads.sourceforge.net/xine/xine-lib-&xine-lib-version;.tar.gz">
+  <!ENTITY xine-lib-download-ftp  " ">
+  <!ENTITY xine-lib-size          "5.9 MB">
+  <!ENTITY xine-lib-buildsize     "60 MB">
+  <!ENTITY xine-lib-time          "4.06 SBU">
+]>
+
 <sect1 id="xine-lib" xreflabel="xine Libraries-&xine-lib-version;">
 <?dbhtml filename="xine-lib.html"?>
 <title>xine Libraries-&xine-lib-version;</title>
 
-&xine-lib-intro;
-&xine-lib-inst;
-&xine-lib-desc;
+<sect2>
+<title>Introduction to <application>xine Libraries</application></title>
+
+<para>The <application>xine Libraries</application> package contains xine libraries. 
+These are useful for interfacing with external plug-ins that allow the flow of
+information from the source to the screen and speakers.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&xine-lib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&xine-lib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &xine-lib-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &xine-lib-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &xine-lib-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>xine Libraries</application> dependencies</title>
+<sect4><title>Required</title>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="esound"/> or
+<acronym>OSS</acronym> or <xref linkend="alsa"/> or <xref
+linkend="arts"/></para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="aalib"/>, <xref linkend="libmng"/>, <xref
+linkend="gnome-vfs"/>, <xref linkend="SDL"/>, <xref
+linkend="DirectFB"/>, <xref linkend="flac"/>, <xref linkend="libfame"/>,
+<xref linkend="libogg"/>, <xref linkend="libvorbis"/>, <xref
+linkend="speex"/>, <ulink url="http://www.theora.org/">Theora</ulink>
+and <ulink url="http://www.libstk.org/">LibSTK</ulink>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>xine Libraries</application></title>
+
+<para>Install <application>xine Libraries</application> by running the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>xine Libraries</application> package contains <command>
+xine-config</command>, <filename class="libraryfile">libxine</filename> 
+libraries and various input/output plugins.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>xine-config</title>
+<para><command>xine-config</command> provides information to programs trying 
+to link with the <application>xine</application> libraries.</para></sect3>
+
+<sect3><title>libxine libraries</title>
+<para><filename class="libraryfile">libxine</filename> libraries provide the 
+<acronym>API</acronym> for processing video files.</para></sect3>
+
+</sect2>
 
 </sect1>
Index: multimedia/libdriv/xvid.xml
===================================================================
--- multimedia/libdriv/xvid.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/libdriv/xvid.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -1,10 +1,135 @@
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+ 
+  <!ENTITY xvid-download-http "http://files.xvid.org/downloads/xvidcore-&xvid-version;.tar.bz2">
+  <!ENTITY xvid-download-ftp  " ">
+  <!ENTITY xvid-size          "524 KB">
+  <!ENTITY xvid-buildsize     "5.5 MB">
+  <!ENTITY xvid-time          "0.19 SBU">
+]>
+
 <sect1 id="xvid" xreflabel="XviD-&xvid-version;">
 <?dbhtml filename="xvid.html"?>
 <title>XviD-&xvid-version;</title>
 
-&xvid-intro;
-&xvid-inst;
-&xvid-exp;
-&xvid-desc;
+<sect2>
+<title>Introduction to <application>XviD</application></title>
+
+<!--
+OpenDivX or Xvid?
+
+OpenDivX is a free implementation of the mpeg4-codec. Alas, the 
+developers at ProjectMayo didn't gratefully release their actual source
+in compileable versions, so the displeasure of the users majority
+canalized into a new project named Xvid.
+
+Xvid development was interrupted in Autumn 2002 due to a code-theft 
+the developers at Sigma design committed but it is continued now.
+
+For worse luck, OpenDivX and Xvid are using the same header file 
+names (an issue that wouldn't be resolved easily) and function
+namespace, so you'll have to choose which one to use.
+
+I personally vote for Xvid, because the installation from sources
+is much smoother. If you use mencoder and transcode at the same time,
+you may want to choose different codecs for each.
+-->
+
+<para><application>XviD</application> is a <acronym>MPEG</acronym>-4
+compliant video <acronym>CODEC</acronym>.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&xvid-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&xvid-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &xvid-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &xvid-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &xvid-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>XviD</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="NASM"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>XviD</application></title>
+
+<para>Install <application>XviD</application> by running the following commands:</para>
+
+<screen><userinput><command>cd build/generic &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
+make  &amp;&amp;
+make install &amp;&amp;
+ln -sf libxvidcore.so.4.0 /usr/lib/libxvidcore.so.4 &amp;&amp;
+ln -sf libxvidcore.so.4 /usr/lib/libxvidcore.so</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><command>ln -s libxvidcore.so.4 /usr/lib/libxvidcore.so</command>:
+This command makes applications linked against
+<filename class="libraryfile">.so</filename> names, link to
+<filename class="libraryfile">.so.<replaceable>MAJOR</replaceable></filename>.
+This ensures better binary compatibility, as
+<application>XviD</application> developers take care not changing the
+<replaceable>MAJOR</replaceable> number until there is an incompatible
+<acronym>ABI</acronym> change.</para>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>XviD</application> core package contains the <filename
+class="libraryfile">libxvidcore</filename> library.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>libxvidcore</title>
+<para><filename class="libraryfile">libxvidcore</filename> provides
+functions to encode and decode most <acronym>MPEG</acronym>-4 video
+data.</para></sect3>
+
+<!--
+<para>Following features of MPEG-4 are supported:</para>
+<para><emphasis>I, P Frame encoding</emphasis></para>
+<para>I-Frames are image frames, while P-Frames are Pattern Frames.
+Image Frames contain full images. P-Frames contain patterns of what changes in
+the image, thusly saving a lot of space.</para>
+<para><emphasis>PMVFast and EPZS with diamond a sqare pattern motion 
+estimation</emphasis></para>
+<para>Fast Motion detection that can refer a square or diamond
+shaped pattern to different directions.</para>
+<para><emphasis>inter4v mode</emphasis></para>
+<para>Fast interpolation ability.</para>
+<para><emphasis>fullpixel and halfpixel precision</emphasis></para>
+<para>Even halfpixel movements can be encoded. Better precision
+results in better compression at better quality.</para>
+<para><emphasis>both MPEG-4 and H263 quantizations</emphasis></para>
+<para>MPEG-4 is the standard DivX was derived from. H263 is a
+slightly changed subset of that standard made by Microsoft. Quantization
+means to map the quantity of color values to numbers.</para>
+<para><emphasis>custom quant matrices</emphasis></para>
+<para>The quantization can be done using custom matrices,
+possibly giving better results if the matrix is made to suit the video
+data. Every normal user should be fine with the default matrix that comes
+with <application>XviD</application>.</para>
+<para><emphasis>Adaptive quantization / Luminance masking</emphasis></para>
+<para>Qantization and Luminance masking are variant, depending
+on the input material, therefore providing better results on dark or very
+contrasting images.</para>
+-->
+
+</sect2>
 
 </sect1>
Index: multimedia/multimedia.xml
===================================================================
--- multimedia/multimedia.xml	(revision 16998db6e70bf6c3f266f3af0bdb0adb88c5ffb1)
+++ multimedia/multimedia.xml	(revision 48b72950fe88fbb42d4bd61a7009a37696f2b2b1)
@@ -3,5 +3,7 @@
 <title>Multimedia</title>
 
-&multimedia-libdriv;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multimedia/libdriv/libdriv.xml"/>
+
+<!-- &multimedia-libdriv; -->
 &multimedia-audioutils;
 &multimedia-videoutils;
