Index: multimedia/libdriv/alsa.xml
===================================================================
--- multimedia/libdriv/alsa.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ multimedia/libdriv/alsa.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -18,21 +18,13 @@
 kernel.</para>
 
-<para>You currently need to decide whether to use the 0.5.x series or
-the 0.9-beta series.  At the moment, if you use the 0.9.x drivers, some
-older software will fail to compile with ALSA support.  This is because
-there is a new API in the 0.9.x series which isn't yet widely supported.
-In these cases it is usually possible just to use the OSS driver
-emulation which ALSA supplies (which can be superior to the OSS drivers
-themselves).  We don't recommend one ALSA series over the other
-as there are advantages to both versions, however you should probably
-use the latest point release of whichever series you decide to
-use.</para>
-
-&alsa-intro;
-&alsa-desc;
-&alsa-inst;
-&alsa-config;
-&alsa-cards;
+<para>The following five sections of the book deal with the five seperate
+components of alsa: the drivers, the libraries, the utilities, the tools and
+the OSS compatibility libraries.</para>
 
 </sect1>
 
+&alsa-driver;
+&alsa-lib;
+&alsa-utils;
+&alsa-tools;
+&alsa-oss;
Index: multimedia/libdriv/alsa/alsa-cards.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-cards.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ 	(revision )
@@ -1,23 +1,0 @@
-<sect2>
-<title>Soundcards supported by alsa</title>
-
-<para>try "cat /proc/pci | grep audio" and look for the PCI ID:</para>
-
-<screen>PCI-ID          Name                            Driver
-EMU10k1         Soundblaster SB Live! (or else) emu10k1
-10b9:5451       ALi 5451 Onboard                ali5451
-ES1371          Ensoniq 1371 (Soundblaster)     ens1371
-ES1370          Ensoniq 1370 (Soundblaster)     ens1370
-ES1983S         ESS Maestro 3                   es1983
-VIA             VIA AC97 Audio Controller 686A  via686a 
-ES1986          ESS Maestro 2                   es1986
-Vortex 2        Aureal Vortex II                ???
-ALS4000         Avance Logic ALS 4000           als4000</screen>
-
-<para>For further cards look at CARDS-Status (0.9.x-version) or
-the doc/CARDS file (older Version). Please send an email to
-l.x.@gmx.de about what you'd got on "cat /proc/pci | grep audio" and
-what driver you used. If that Appendix grows big enough, I'll
-use it for an automatic installation script.</para>
-
-</sect2>
Index: multimedia/libdriv/alsa/alsa-config.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-config.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ 	(revision )
@@ -1,32 +1,0 @@
-<sect2>
-<title>Configuring alsa</title>
-
-<sect3><title>/dev/sndstat</title>
-
-<para>There is software out there to look at /dev/sndstat to find out wether a
-sound driver is installed. If you have such software sniggering at you
-"no soundcard found", try the following (before giving up):</para>
-
-<para><screen><userinput>rm /dev/sndstat
-ln -s /proc/asound/sndstat /dev/sndstat</userinput></screen></para>
-
-</sect3>
-
-<sect3>
-<title>Device permissions</title>
-
-<para>If the software is complaining about having no access to the 
-devices with your current UID, you need to set the proper permissions
-(as root):</para>
-
-<para><userinput>chmod a+rw /dev/mi* /dev/dsp* /dev/seq*</userinput>
-This should do the job.</para>
-
-<para>Alternatively, add your user to the <userinput>audio</userinput>
-group and make sure the above <filename>/dev</filename> files are 
-chgrp'd to the audio group and have group read and write access.</para>
-
-</sect3>
-
-</sect2>
-
Index: multimedia/libdriv/alsa/alsa-desc.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-desc.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ 	(revision )
@@ -1,24 +1,0 @@
-<sect2>
-<title>Contents</title>
-
-<para>There are 5 different alsa-packages:</para>
-
-<para>The alsa-driver package contains the driver module sources.</para>
-
-<para>The alsa-lib package contains a Library for sound access methods
-provided by the alsa-driver.</para>
-
-<para>The alsa-utils package contains the tools 
-<userinput>alsamixer</userinput>, a ncurses based console mixer,
-<userinput>alsactl</userinput>, a control program for the driver,
-<userinput>aplay</userinput>, a simple player for .wav and .au files,
-and <userinput>arecord</userinput>, a simple sound recorder.
-</para>
-
-<para>The alsa-oss-lib package (only version 0.9.x) contains a library
-for developers to convert their OSS applications to ALSA.</para>
-
-<para>The alsa-tools package (only version 0.9.x) contains some utlis
-for older cards and for expensive multichannel cards.</para>
-
-</sect2>
Index: multimedia/libdriv/alsa/alsa-driver.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-driver.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/alsa-driver.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,12 @@
+<sect1 id="alsa-driver" xreflabel="alsa-driver-&alsa-driver-version;">
+<?dbhtml filename="alsa-driver.html" dir="multimedia"?>
+<title>alsa-driver-&alsa-driver-version;</title>
+
+&alsa-driver-intro;
+&alsa-driver-inst;
+&alsa-driver-exp;
+&alsa-driver-config;
+&alsa-driver-desc;
+
+</sect1>
+
Index: multimedia/libdriv/alsa/alsa-exp.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-exp.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ 	(revision )
@@ -1,7 +1,0 @@
-<sect1>
-<title>Command explanations</title>
-
-<para><userinput>COMMAND:</userinput> This command does something.</para>
-
-</sect1>
-
Index: multimedia/libdriv/alsa/alsa-inst.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-inst.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ 	(revision )
@@ -1,189 +1,0 @@
-<sect2>
-<title>Installation of alsa</title>
-
-<para>Unpack the packages you've downloaded</para>
-
-<sect3>
-<title>Installation of the driver</title>
-
-<para><screen><userinput>./configure \
-    --with-moddir=/lib/modules/&lt;kernel-version&gt;/kernel/drivers/sound/ \
-	--with-kernel=&lt;path-to-kernel-source-tree-to-build-for&gt; \
-	--with-sequencer=yes --with-oss=yes \
-	--with-cards=&lt;soundcards-to-compile&gt; &&
-make &&
-make install </userinput></screen></para>
-
-<para>Replace &lt;path-to-kernel-source-tree-to-build-for&gt; and
-&lt;kernel-version&gt; with which the path to the source tree of the 
-kernel version you want to build the drivers for (most commonly your 
-current version) and the kernel version number respectively.  You also
-need to replace &lt;soundcards-to-compile&gt; with the card names 
-you need drivers for (read the SOUNDCARDS section below); otherwise 
-"./configure --help" gives you a list of
-drivers you can compile.</para>
-
-<para>There are two ways of setting up the modules. The easiest
-way is the "let the kernel module loader load them automatically"-way, 
-the other one is to use the bootscript you'll find in the
-/utils-directory of the driver.</para>
-
-<para>For both ways, you need to add some lines to /etc/modules.conf:</para>
-
-<para><screen><userinput>cat &gt;&gt; /etc/modules.conf &lt;&lt; "EOF"</userinput>
-alias char-major-116 snd
-options snd snd_major=116 snd_cards_limit=1
-alias snd-card-0 snd-card-&lt;soundcard&gt;
-alias sound-slot-0 snd-card-0
-alias sound-service-0-0 snd-mixer-oss
-alias sound-service-0-3 snd-pcm-oss
-post-install snd-card-&lt;soundcard&gt; /usr/sbin/alsactl restore
-<userinput>EOF</userinput></screen></para>
-
-<para>Remember to replace &lt;soundcard&gt; with whatever is 
-appropriate.  Note that if you are going to use the LFS-style alsa
-script we give below, there is no need for the post-install line.</para>
-
-<para>If you want kmod to automatically load the modules, as long as you
-have the post-install line in modules.conf, you don't need a startup
-script.  If on the other hand you want to use an LFS style startup
-script (because you want to perform other operations at startup/shutdown
-or for another reason), you can use this script here:</para>
-
-<para><screen><userinput>cat &gt; /etc/rc.d/init.d/alsa &lt;&lt; "EOF"</userinput>
-#!/bin/sh
-# Begin $rc_base/init.d/alsa
-
-# Based on sysklogd script from LFS-3.1 and earlier.
-# Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
-# ALSA specific parts by Mark Hymers - markh@linuxfromscratch.org
-
-source /etc/sysconfig/rc
-source $rc_functions
-
-if [ -f /etc/sysconfig/alsa ]
-then
-	source /etc/sysconfig/alsa
-fi
-
-if [ -z "$CONF" ] 
-then
-	echo "Please create an /etc/sysconfig/alsa file containing"
-	echo "a CONF value (usually /etc/asound.conf)"
-	exit 1;
-fi
-
-case "$1" in
-	start)
-		echo -n "Starting alsa...    Restoring volumes..."
-		loadproc /usr/sbin/alsactl -f $CONF restore
-		#echo -n "                    Loading MIDI font..."
-		#loadproc sfxload $FONT
-		;;
-
-	stop)
-		echo -n "Stopping alsa...    Saving volumes......"
-		loadproc /usr/sbin/alsactl -f $CONF store
-		#echo -n "            Removing MIDI font.........."
-		#loadproc sfxload -i
-		;;
-
-	restart)
-		$0 stop
-		/usr/bin/sleep 1
-		$0 start
-		;;
-	
-	*)
-		echo "Usage: $0 {start|stop|restart}"
-		exit 1
-		;;
-
-esac
-
-# End $rc_base/init.d/alsa
-<userinput>EOF
-chmod 755 /etc/rc.d/init.d/alsa</userinput></screen></para>
-
-<para>Note that the Loading and Removing MIDI font lines are commented out.
-This is because they are only needed for certain soundcards and also
-require an additional program (<userinput>sfxload</userinput>).  An
-example of a soundcard which needs MIDI fonts loaded in order to play
-MIDI files is the Soundblaster Live! which is based on a emu10k1
-chip.</para>
-
-<para>If you are using the above script, you will also need 
-a <filename>/etc/sysconfig/alsa</filename> file.  Create this using
-the following commands:</para>
-
-<para><screen><userinput>cat &gt; /etc/sysconfig/alsa &lt;&lt; "EOF"</userinput>
-# Begin /etc/sysconfig/alsa
-
-# CONF is where you want the system to store volume settings.
-# /etc/asound.conf is recommended
-CONF=/etc/asound.conf
-
-# FONT is where your midi font (if any) is stored.
-FONT=/usr/share/8mbgmsfx.sf2
-
-# End /etc/sysconfig/alsa
-<userinput>EOF</userinput></screen></para>
-
-<para>Then create the appropriate symlinks:
-<screen><userinput>cd /etc/rc.d/init.d &amp;&amp;
-ln -sf ../init.d/alsa ../rc0.d/K35alsa &amp;&amp;
-ln -sf ../init.d/alsa ../rc1.d/K35alsa &amp;&amp;
-ln -sf ../init.d/alsa ../rc2.d/S40alsa &amp;&amp;
-ln -sf ../init.d/alsa ../rc3.d/S40alsa &amp;&amp;
-ln -sf ../init.d/alsa ../rc4.d/S40alsa &amp;&amp;
-ln -sf ../init.d/alsa ../rc5.d/S40alsa &amp;&amp;
-ln -sf ../init.d/alsa ../rc6.d/K35alsa</userinput></screen></para>
-
-<para>Beware. All channels of your soundcard are muted by default. You can use
-the <filename>alsamixer</filename> (in alsa-utils, requires alsa-lib) or any 
-other OSS mixer program (like kmix, gmix, aumix) to unmute them.  We
-recommend that you do this <emphasis>before</emphasis> running the
-script above because otherwise alsactl will complain that it cannot read
-the <filename>/etc/asound.conf</filename> file.  You can do this by 
-running <userinput>alsamixer</userinput>, setting the volumes and then
-running <userinput>alsactl -f /etc/asound.conf store</userinput>.  This
-means that the first time you run the script, it will have a valid
-<filename>asound.conf</filename> file to use.</para>
-
-<para>If you get an error like
-<screen>alsamixer: failed to open mixer #0/#0: No such file or directory</screen>
-run the snddevices script in the alsa-driver directory.  From the
-alsa-driver source directory run:</para>
-
-<para><screen><userinput>./snddevices</userinput></screen></para>
-</sect3>
-
-<sect3>
-<title>Installation of the library</title>
-<para>From the alsa-lib source directory, run:</para>
-<para><screen><userinput>./configure &&
-make install</userinput></screen></para>
-</sect3>
-
-<sect3>
-<title>Installation of the utils</title>
-<para>From the alsa-utils source directory, run:</para>
-<para><screen><userinput>./configure &&
-make install</userinput></screen></para>
-</sect3>
-
-<sect3>
-<title>Installation of additional packages (alsa-oss-lib and alsa-tools)</title>
-
-<para><screen><userinput>./configure &&
-make install</userinput></screen></para>
-
-<para>These commands are all you need to install 
-alsa-oss-lib or alsa-tools.  Remember oss-lib is only for future 
-versions and the alsa-tools are only useful for the owners of very old 
-or expensive cards (e.g multichannel cards), so most people 
-don't need it.</para>
-
-</sect3>
-</sect2>
-
Index: multimedia/libdriv/alsa/alsa-intro.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-intro.xml	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ 	(revision )
@@ -1,14 +1,0 @@
-<sect2>
-<title>Introduction to alsa</title>
-
-<screen>Download location (HTTP):       <ulink url="&alsa-download-http;"/>
-Download location (FTP):        <ulink url="&alsa-download-ftp;"/>
-Version used:                   &alsa-version;
-Package size:                   &alsa-size;
-Estimated Disk space required:  &alsa-buildsize;</screen>
-
-<para>The alsa packages contains a sound driver collection for
-the most known sound cards, a library for easy sound programming
-and some little utilities.</para>
-
-</sect2>
Index: multimedia/libdriv/alsa/alsa-lib.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-lib.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/alsa-lib.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<sect1 id="alsa-lib" xreflabel="alsa-lib-&alsa-lib-version;">
+<?dbhtml filename="alsa-lib.html" dir="multimedia"?>
+<title>alsa-lib-&alsa-lib-version;</title>
+
+&alsa-lib-intro;
+&alsa-lib-inst;
+&alsa-lib-config;
+&alsa-lib-desc;
+
+</sect1>
+
Index: multimedia/libdriv/alsa/alsa-oss.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-oss.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/alsa-oss.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,16 @@
+<sect1 id="alsa-oss" xreflabel="alsa-oss-&alsa-oss-version;">
+<?dbhtml filename="alsa-oss.html" dir="multimedia"?>
+<title>alsa-oss-&alsa-oss-version;</title>
+
+<para>This section is a placeholder for future releases of alsa in which the
+oss-compatibility libraries will be used.</para>
+
+<!--
+&alsa-oss-intro;
+&alsa-oss-inst;
+&alsa-oss-exp;
+&alsa-oss-config;
+&alsa-oss-desc;
+-->
+</sect1>
+
Index: multimedia/libdriv/alsa/alsa-tools.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-tools.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/alsa-tools.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<sect1 id="alsa-tools" xreflabel="alsa-tools-&alsa-tools-version;">
+<?dbhtml filename="alsa-tools.html" dir="multimedia"?>
+<title>alsa-tools-&alsa-tools-version;</title>
+
+&alsa-tools-intro;
+&alsa-tools-inst;
+&alsa-tools-config;
+&alsa-tools-desc;
+
+</sect1>
+
Index: multimedia/libdriv/alsa/alsa-utils.xml
===================================================================
--- multimedia/libdriv/alsa/alsa-utils.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/alsa-utils.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<sect1 id="alsa-utils" xreflabel="alsa-utils-&alsa-utils-version;">
+<?dbhtml filename="alsa-utils.html" dir="multimedia"?>
+<title>alsa-utils-&alsa-utils-version;</title>
+
+&alsa-utils-intro;
+&alsa-utils-inst;
+&alsa-utils-config;
+&alsa-utils-desc;
+
+</sect1>
+
Index: multimedia/libdriv/alsa/alsa.ent
===================================================================
--- multimedia/libdriv/alsa/alsa.ent	(revision b3747795b50994f13da43b19760658e8a518262f)
+++ multimedia/libdriv/alsa/alsa.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -1,11 +1,14 @@
 <!ENTITY alsa SYSTEM "../alsa.xml">
-<!ENTITY alsa-intro SYSTEM "alsa-intro.xml">
-<!ENTITY alsa-inst SYSTEM "alsa-inst.xml">
-<!ENTITY alsa-desc SYSTEM "alsa-desc.xml">
-<!ENTITY alsa-config SYSTEM "alsa-config.xml">
-<!ENTITY alsa-cards SYSTEM "alsa-cards.xml">
-<!ENTITY alsa-buildsize "4-6MB (depending on chosen drivers)">
-<!ENTITY alsa-version "0.5.12a/0.9.0rc2">
-<!ENTITY alsa-download-http "http://www.alsa-project.org">
-<!ENTITY alsa-download-ftp "">
-<!ENTITY alsa-size "400-600k (depending on version)">
+<!ENTITY alsa-version "0.9.0rc3">
+
+<!ENTITY % alsa-driver SYSTEM "driver/alsa-driver.ent">
+<!ENTITY % alsa-lib SYSTEM "lib/alsa-lib.ent">
+<!ENTITY % alsa-utils SYSTEM "utils/alsa-utils.ent">
+<!ENTITY % alsa-tools SYSTEM "tools/alsa-tools.ent">
+<!ENTITY % alsa-oss SYSTEM "oss/alsa-oss.ent">
+
+%alsa-driver;
+%alsa-lib;
+%alsa-utils;
+%alsa-tools;
+%alsa-oss;
Index: multimedia/libdriv/alsa/driver/alsa-driver-config.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/driver/alsa-driver-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,132 @@
+<sect2>
+<title>Configuring alsa-driver</title>
+
+<sect3><title>Config files</title>
+
+<para><userinput>/etc/modules.conf</userinput> and 
+<userinput>/etc/asound.state</userinput></para>
+
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>To configure the alsa drivers, you need to add some lines to
+<filename>/etc/modules.conf</filename>:</para>
+
+<para><screen><userinput>cat &gt;&gt; /etc/modules.conf &lt;&lt; "EOF"</userinput>
+alias char-major-14 soundcore
+alias char-major-116 snd
+
+alias snd-card-0 snd-&lt;soundcard-name&gt;
+
+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
+<userinput>EOF</userinput></screen></para>
+
+<para>&lt;soundcard-name&gt; needs to be replaced with the driver relevant
+to your soundcard.  If you have more than one soundcard, you can add
+additional sections by repeating the above but changing the first 0 to 1 and
+so on.</para>
+
+<para>After editing <filename>/etc/modules.conf</filename> you need to run
+<filename>depmod</filename>.  If the drivers you have compiled are for the
+version of the kernel you are currently running, simply run
+<screen><userinput>depmod</userinput></screen>  If you are compiling 
+drivers for a different kernel version to that which you are running, you 
+will need to use a line along the lines of:
+<screen><userinput>depmod -a 2.4.19 -F /boot/System.map-2.4.19</userinput></screen></para>
+
+<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 alsa-drivers 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
+LFS system and so we create our own script
+<filename>/etc/rc.d/init.d/alsa</filename>.</para>
+
+<para>To create the alsa script, do the following:</para>
+
+<para><screen><userinput>cat &gt; /etc/rc.d/init.d/alsa &lt;&lt; "EOF"</userinput>
+#!/bin/sh
+# Begin $rc_base/init.d/alsa
+
+# Based on sysklogd script from LFS-3.1 and earlier.
+# Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
+# ALSA specific parts by Mark Hymers - markh@linuxfromscratch.org
+# Stores mixer settings in the default location: /etc/asound.state
+
+source /etc/sysconfig/rc
+source $rc_functions
+
+case "$1" in
+    start)
+        echo -n "Starting alsa...    Restoring volumes..."
+        loadproc /usr/sbin/alsactl restore
+        #echo -n "                    Loading MIDI font..."
+        #loadproc sfxload /path/to/soundfont
+        ;;
+
+    stop)
+        echo -n "Stopping alsa...    Saving volumes......"
+        loadproc /usr/sbin/alsactl store
+        #echo -n "            Removing MIDI font.........."
+        #loadproc sfxload -i
+        ;;
+
+    restart)
+        $0 stop
+        /usr/bin/sleep 1
+        $0 start
+        ;;
+
+    *)
+        echo "Usage: $0 {start|stop|restart}"
+        exit 1
+        ;;
+
+esac
+
+# End $rc_base/init.d/alsa
+<userinput>EOF
+chmod 755 /etc/rc.d/init.d/alsa</userinput></screen></para>
+
+<para>You can then create the appropriate symlinks:
+<screen><userinput>cd /etc/rc.d/init.d &amp;&amp;
+ln -sf ../init.d/alsa ../rc0.d/K35alsa &amp;&amp;
+ln -sf ../init.d/alsa ../rc1.d/K35alsa &amp;&amp;
+ln -sf ../init.d/alsa ../rc2.d/S40alsa &amp;&amp;
+ln -sf ../init.d/alsa ../rc3.d/S40alsa &amp;&amp;
+ln -sf ../init.d/alsa ../rc4.d/S40alsa &amp;&amp;
+ln -sf ../init.d/alsa ../rc5.d/S40alsa &amp;&amp;
+ln -sf ../init.d/alsa ../rc6.d/K35alsa</userinput></screen></para>
+
+<para>Note that all channels of your soundcard are muted by default. You can
+use the <filename>alsamixer</filename> program from alsa-utils (or any other
+OSS mixer) to change this.</para>
+
+<para>Also, 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 alsa-utils:
+<screen><userinput>touch /etc/asound.state &amp;&amp;
+alsactl store</userinput></screen></para>
+
+<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
+seperate package of interest to SoundBlaster AWE and Live! users.  It is
+designed for loading "sound-fonts" (which are used for MIDI output).  You
+may wish to delete these lines and add your own or, if you have the relevant
+soundcard, install <filename>sfxload</filename> and uncomment them.</para>
+
+</sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/driver/alsa-driver-desc.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/driver/alsa-driver-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,21 @@
+<sect2>
+<title>Contents</title>
+
+<para>The alsa-driver package contains the <userinput>alsa sound card
+drivers</userinput>and <userinput>include files</userinput></para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>alsa sound card drivers</title>
+<para>These are kernel modules which provide audio and MIDI 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 <filename>alsa-lib</filename>.</para></sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/driver/alsa-driver-exp.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-exp.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/driver/alsa-driver-exp.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,44 @@
+<sect2>
+<title>Command explanations</title>
+
+<para><userinput>rm include/linux/isapnp.h</userinput>: This is recommended
+by the alsa developers for this release only.  It is due to an extra file
+being included in the tarball.</para>
+
+<para>&lt;kernel-version&gt; should be replaced with your kernel version,
+including any EXTRAVERSION such as -ac1 or -aa2.  If you are using a normal
+kernel tarball, it will simply be the standard number (such as
+2.4.19).</para>
+
+<para>&lt;path-to-kernel-source-tree-to-build-for&gt; should be replaced
+with the directory where the kernel source tree is for the version of the
+kernel you wish to build for.  For example, if you want to build for kernel
+2.4.19, it may be <filename
+class="directory">/usr/src/linux-2.4.19</filename>.  This is needed because
+the alsa drivers must be compiled against the correct version of the kernel
+headers.</para>
+
+<para><userinput>--with-sequencer=yes </userinput>: This tells the
+alsa-driver package to build the sequencer modules for whichever soundcards
+you are building for.  Most people want them so you will usually want to
+leave it set to yes.</para>
+
+<para><userinput>--with-oss=yes </userinput>: This tells the package to
+build the OSS/Free emulation modules.  Again, most people want this so it's
+probably best to stick with yes.</para>
+
+<para><userinput>--with-isapnp=no </userinput>: Most sound cards these days
+are PCI and so ISA Plug and Play support isn't needed.  If you are using an
+ISA soundcard, it's best to say yes here.</para>
+
+<para><userinput>--with-cards=... </userinput>: You can tell the script just
+to build the drivers for your particular sound card here.  For full information
+on which drivers are available see <userinput>./configure
+--help</userinput>.  If you aren't sure which chipset your soundcard uses,
+have a look in <filename>CARDS-STATUS</filename> in the alsa-driver source
+tree.  If you want to build all drivers (for some reason) then
+simply leave out the <userinput>--with-cards</userinput> statement
+entirely.</para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/driver/alsa-driver-inst.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/driver/alsa-driver-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,31 @@
+<sect2>
+<title>Installation of alsa-driver</title>
+
+<para>Before installing the alsa-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
+alsa driver modules.</para>
+
+<para>Install alsa-driver using the following commands as a template:</para>
+
+<para><screen><userinput>rm include/linux/isapnp.h &amp;&amp;
+./configure \
+   --with-moddir=/lib/modules/&lt;kernel-version&gt;/kernel/drivers/sound/ \
+   --with-kernel=&lt;path-to-kernel-source-tree-to-build-for&gt; \
+   --with-sequencer=yes \
+   --with-oss=yes \
+   --with-isapnp=no \
+   --with-cards=&lt;soundcards-to-compile&gt; &amp;&amp;
+make &amp;&amp;
+make install</userinput></screen></para>
+
+<para>If this is the first time you have installed the alsa drivers, you
+will need to create the <filename class="directory">/dev</filename> entries
+using the script provided in the alsa-driver source tree:
+<screen><userinput>./snddevices</userinput></screen></para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/driver/alsa-driver-intro.xml
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/driver/alsa-driver-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,13 @@
+<sect2>
+<title>Introduction to alsa-driver</title>
+
+<screen>Download location (HTTP):       <ulink url="&alsa-driver-download-http;"/>
+Download location (FTP):        <ulink url="&alsa-driver-download-ftp;"/>
+Version used:                   &alsa-driver-version;
+Package size:                   &alsa-driver-size;
+Estimated Disk space required:  &alsa-driver-buildsize;</screen>
+
+<para>The alsa-driver package contains the alsa sound drivers.  These are
+the next generation of sound drivers for Linux.</para>
+
+</sect2>
Index: multimedia/libdriv/alsa/driver/alsa-driver.ent
===================================================================
--- multimedia/libdriv/alsa/driver/alsa-driver.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/driver/alsa-driver.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<!ENTITY alsa-driver SYSTEM "../alsa-driver.xml">
+<!ENTITY alsa-driver-intro SYSTEM "alsa-driver-intro.xml">
+<!ENTITY alsa-driver-inst SYSTEM "alsa-driver-inst.xml">
+<!ENTITY alsa-driver-exp SYSTEM "alsa-driver-exp.xml">
+<!ENTITY alsa-driver-desc SYSTEM "alsa-driver-desc.xml">
+<!ENTITY alsa-driver-config SYSTEM "alsa-driver-config.xml">
+<!ENTITY alsa-driver-buildsize "24 MB (for all drivers)">
+<!ENTITY alsa-driver-version "0.9.0rc3">
+<!ENTITY alsa-driver-download-http "http://www.alsa-project.org/alsa/ftp/driver/alsa-driver-0.9.0rc3.tar.bz2">
+<!ENTITY alsa-driver-download-ftp "ftp://ftp.alsa-project.org/pub/driver/alsa-driver-0.9.0rc3.tar.bz2">
+<!ENTITY alsa-driver-size "1.3 MB">
Index: multimedia/libdriv/alsa/lib/alsa-lib-config.xml
===================================================================
--- multimedia/libdriv/alsa/lib/alsa-lib-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/lib/alsa-lib-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<sect2>
+<title>Configuring alsa-lib</title>
+
+<sect3><title>Configuration Information</title>
+
+&library-config;
+
+</sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/lib/alsa-lib-desc.xml
===================================================================
--- multimedia/libdriv/alsa/lib/alsa-lib-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/lib/alsa-lib-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,18 @@
+<sect2>
+<title>Contents</title>
+
+<para>The alsa-lib package contains <userinput>aserver</userinput>and the
+<userinput>alsa library</userinput>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>aserver</title>
+<para>No description is currently available.</para></sect3>
+
+<sect3><title>libasound (alsa library)</title>
+<para>libasound provides alsa functions for application programs.</para></sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/lib/alsa-lib-inst.xml
===================================================================
--- multimedia/libdriv/alsa/lib/alsa-lib-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/lib/alsa-lib-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<sect2>
+<title>Installation of alsa-lib</title>
+
+<para>Install alsa-lib by running the following commands:</para>
+
+<para><screen><userinput>./configure &amp;&amp;
+make &amp;&amp;
+make install</userinput></screen></para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/lib/alsa-lib-intro.xml
===================================================================
--- multimedia/libdriv/alsa/lib/alsa-lib-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/lib/alsa-lib-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,15 @@
+<sect2>
+<title>Introduction to alsa-lib</title>
+
+<screen>Download location (HTTP):       <ulink url="&alsa-lib-download-http;"/>
+Download location (FTP):        <ulink url="&alsa-lib-download-ftp;"/>
+Version used:                   &alsa-lib-version;
+Package size:                   &alsa-lib-size;
+Estimated Disk space required:  &alsa-lib-buildsize;</screen>
+
+<para>The alsa-lib package contains the alsa library.  This is used by
+programs (including alsa-utils) which wish to use the alsa sound interface.</para>
+
+<screen>alsa-lib depends on the header files from <xref linkend="alsa-driver"/></screen>
+
+</sect2>
Index: multimedia/libdriv/alsa/lib/alsa-lib.ent
===================================================================
--- multimedia/libdriv/alsa/lib/alsa-lib.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/lib/alsa-lib.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,10 @@
+<!ENTITY alsa-lib SYSTEM "../alsa-lib.xml">
+<!ENTITY alsa-lib-intro SYSTEM "alsa-lib-intro.xml">
+<!ENTITY alsa-lib-inst SYSTEM "alsa-lib-inst.xml">
+<!ENTITY alsa-lib-desc SYSTEM "alsa-lib-desc.xml">
+<!ENTITY alsa-lib-config SYSTEM "alsa-lib-config.xml">
+<!ENTITY alsa-lib-buildsize "6.1 MB">
+<!ENTITY alsa-lib-version "0.9.0rc3">
+<!ENTITY alsa-lib-download-http "http://www.alsa-project.org/alsa/ftp/lib/alsa-lib-0.9.0rc3.tar.bz2">
+<!ENTITY alsa-lib-download-ftp "ftp://ftp.alsa-project.org/pub/lib/alsa-lib-0.9.0rc3.tar.bz2">
+<!ENTITY alsa-lib-size "395 KB">
Index: multimedia/libdriv/alsa/oss/alsa-oss-config.xml
===================================================================
--- multimedia/libdriv/alsa/oss/alsa-oss-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/oss/alsa-oss-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,15 @@
+<sect2>
+<title>Configuring alsa-oss</title>
+
+<sect3><title>Config files</title>
+<para><userinput>List of config files</userinput></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para><userinput>USERINPUT GOES HERE</userinput> Blah blah blah about config.
+</para>
+</sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/oss/alsa-oss-desc.xml
===================================================================
--- multimedia/libdriv/alsa/oss/alsa-oss-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/oss/alsa-oss-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,17 @@
+<sect2>
+<title>Contents</title>
+
+<para>The alsa-oss package contains <userinput>LISTOFFILES</userinput></para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>item1</title>
+<para>item1 does this</para></sect3>
+
+<sect3><title>item2</title>
+<para>item2 does that</para></sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/oss/alsa-oss-exp.xml
===================================================================
--- multimedia/libdriv/alsa/oss/alsa-oss-exp.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/oss/alsa-oss-exp.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,7 @@
+<sect2>
+<title>Command explanations</title>
+
+<para><userinput>COMMAND:</userinput> This command does something.</para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/oss/alsa-oss-inst.xml
===================================================================
--- multimedia/libdriv/alsa/oss/alsa-oss-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/oss/alsa-oss-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,9 @@
+<sect2>
+<title>Installation of alsa-oss</title>
+
+<para>Install alsa-oss by running the following commands:</para>
+
+<para><screen><userinput>./configure </userinput></screen></para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/oss/alsa-oss-intro.xml
===================================================================
--- multimedia/libdriv/alsa/oss/alsa-oss-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/oss/alsa-oss-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,15 @@
+<sect2>
+<title>Introduction to alsa-oss</title>
+
+<screen>Download location (HTTP):       <ulink url="&alsa-oss-download-http;"/>
+Download location (FTP):        <ulink url="&alsa-oss-download-ftp;"/>
+Version used:                   &alsa-oss-version;
+Package size:                   &alsa-oss-size;
+Estimated Disk space required:  &alsa-oss-buildsize;</screen>
+
+<para>The alsa-oss package contains... This is useful for...</para>
+
+<screen>alsa-oss depends on:
+DEPENDENCY LIST (if any)</screen>
+
+</sect2>
Index: multimedia/libdriv/alsa/oss/alsa-oss.ent
===================================================================
--- multimedia/libdriv/alsa/oss/alsa-oss.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/oss/alsa-oss.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<!ENTITY alsa-oss SYSTEM "../alsa-oss.xml">
+<!ENTITY alsa-oss-intro SYSTEM "alsa-oss-intro.xml">
+<!ENTITY alsa-oss-inst SYSTEM "alsa-oss-inst.xml">
+<!ENTITY alsa-oss-exp SYSTEM "alsa-oss-exp.xml">
+<!ENTITY alsa-oss-desc SYSTEM "alsa-oss-desc.xml">
+<!ENTITY alsa-oss-config SYSTEM "alsa-oss-config.xml">
+<!ENTITY alsa-oss-buildsize "">
+<!ENTITY alsa-oss-version "0.9.0rc1">
+<!ENTITY alsa-oss-download-http "http://www.alsa-project.org/alsa/ftp/oss-lib/alsa-oss-0.9.0rc1.tar.bz2">
+<!ENTITY alsa-oss-download-ftp "ftp://ftp.alsa-project.org/pub/oss-lib/alsa-oss-0.9.0rc1.tar.bz2">
+<!ENTITY alsa-oss-size "91 KB">
Index: multimedia/libdriv/alsa/tools/alsa-tools-config.xml
===================================================================
--- multimedia/libdriv/alsa/tools/alsa-tools-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/tools/alsa-tools-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,15 @@
+<sect2>
+<title>Configuring alsa-tools</title>
+
+<sect3><title>Config files</title>
+<para><userinput>List of config files</userinput></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para><userinput>USERINPUT GOES HERE</userinput> Blah blah blah about config.
+</para>
+</sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/tools/alsa-tools-desc.xml
===================================================================
--- multimedia/libdriv/alsa/tools/alsa-tools-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/tools/alsa-tools-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,32 @@
+<sect2>
+<title>Contents</title>
+
+<para>The tools available in this package are <userinput>ac3dec</userinput>,
+<userinput>as10k1</userinput>, <userinput>envy24control</userinput>,
+<userinput>sb16_csp</userinput> and <userinput>sbiload</userinput>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>ac3dec</title>
+<para>ac3dec is a free AC-3 stream decoder.</para></sect3>
+
+<sect3><title>as10k1</title>
+<para>as10k1 is an assembler for the emu10k1 DSP chip present in the
+Creative SB Live, PCI 512, and emu APS sound cards. It is used to make 
+audio effects such as a flanger, chorus or reverb.</para></sect3>
+
+<sect3><title>envy24control</title>
+<para>envy24control is a control tool for Envy24 (ice1712) based 
+soundcards</para></sect3>
+
+<sect3><title>sb16_csp</title>
+<para>sb16_csp is an SB16/AWE32 Creative Signal Processor (ASP/CSP) control
+program.</para></sect3>
+
+<sect3><title>sbiload</title>
+<para>sbiload is an OPL2/3 FM instrument loader for the ALSA sequencer.</para></sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/tools/alsa-tools-inst.xml
===================================================================
--- multimedia/libdriv/alsa/tools/alsa-tools-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/tools/alsa-tools-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,14 @@
+<sect2>
+<title>Installation of alsa-tools</title>
+
+<para>The alsa-tools package is only needed by those with advanced
+requirements for their sound card.  The tools are not all built together,
+instead you need to <userinput>cd</userinput> into the directory of each
+tool you wish to compile and run the following commands:</para>
+
+<para><screen><userinput>./configure &amp;&amp;
+make &amp;&amp;
+make install</userinput></screen></para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/tools/alsa-tools-intro.xml
===================================================================
--- multimedia/libdriv/alsa/tools/alsa-tools-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/tools/alsa-tools-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,14 @@
+<sect2>
+<title>Introduction to alsa-tools</title>
+
+<screen>Download location (HTTP):       <ulink url="&alsa-tools-download-http;"/>
+Download location (FTP):        <ulink url="&alsa-tools-download-ftp;"/>
+Version used:                   &alsa-tools-version;
+Package size:                   &alsa-tools-size;
+Estimated Disk space required:  &alsa-tools-buildsize;</screen>
+
+<para>The alsa-tools package contains advanced tools for certain soundcards.</para>
+
+<screen>alsa-tools depends on <xref linkend="alsa-lib"/>.</screen>
+
+</sect2>
Index: multimedia/libdriv/alsa/tools/alsa-tools.ent
===================================================================
--- multimedia/libdriv/alsa/tools/alsa-tools.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/tools/alsa-tools.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,10 @@
+<!ENTITY alsa-tools SYSTEM "../alsa-tools.xml">
+<!ENTITY alsa-tools-intro SYSTEM "alsa-tools-intro.xml">
+<!ENTITY alsa-tools-inst SYSTEM "alsa-tools-inst.xml">
+<!ENTITY alsa-tools-desc SYSTEM "alsa-tools-desc.xml">
+<!ENTITY alsa-tools-config SYSTEM "alsa-tools-config.xml">
+<!ENTITY alsa-tools-buildsize "3.0 MB (to compile all tools)">
+<!ENTITY alsa-tools-version "0.9.0rc1">
+<!ENTITY alsa-tools-download-http "http://www.alsa-project.org/alsa/ftp/tools/alsa-tools-0.9.0rc1.tar.bz2">
+<!ENTITY alsa-tools-download-ftp "ftp://ftp.alsa-project.org/pub/tools/alsa-tools-0.9.0rc1.tar.bz2">
+<!ENTITY alsa-tools-size "161 KB">
Index: multimedia/libdriv/alsa/utils/alsa-utils-config.xml
===================================================================
--- multimedia/libdriv/alsa/utils/alsa-utils-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/utils/alsa-utils-config.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,15 @@
+<sect2>
+<title>Configuring alsa-utils</title>
+
+<sect3><title>Config files</title>
+<para><userinput>List of config files</userinput></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para><userinput>USERINPUT GOES HERE</userinput> Blah blah blah about config.
+</para>
+</sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/utils/alsa-utils-desc.xml
===================================================================
--- multimedia/libdriv/alsa/utils/alsa-utils-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/utils/alsa-utils-desc.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,42 @@
+<sect2>
+<title>Contents</title>
+
+<para>The alsa-utils package contains <userinput>aconnect</userinput>, 
+<userinput>alsactl</userinput>, <userinput>alsamixer</userinput>,
+<userinput>amixer</userinput>, <userinput>aplay</userinput>,
+<userinput>arecord</userinput> and <userinput>aseqnet</userinput>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>aconnect</title>
+<para>aconnect is a utility for connecting and disconnecting two existing
+ports in the ALSA sequencer system.</para></sect3>
+
+<sect3><title>alsactl</title>
+<para>alsactl is used to control advanced settings for the ALSA
+soundcard drivers.</para></sect3>
+
+<sect3><title>alsamixer</title>
+<para>alsamixer is an ncurses-based mixer program for use with the ALSA
+soundcard drivers.</para></sect3>
+
+<sect3><title>amixer</title>
+<para>amixer allows command-line control of the mixers for the ALSA soundcard
+drivers.</para></sect3>
+
+<sect3><title>aplay</title>
+<para>aplay is a command-line soundfile player for the ALSA soundcard
+drivers.</para></sect3>
+
+<sect3><title>arecord</title>
+<para>arecord is a command-line soundfile recorder for the ALSA soundcard
+drivers.</para></sect3>
+
+<sect3><title>aseqnet</title>
+<para>aseqnet is an ALSA sequencer client which sends and receives event
+packets over a network.</para></sect3>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/utils/alsa-utils-inst.xml
===================================================================
--- multimedia/libdriv/alsa/utils/alsa-utils-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/utils/alsa-utils-inst.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,11 @@
+<sect2>
+<title>Installation of alsa-utils</title>
+
+<para>Install alsa-utils by running the following commands:</para>
+
+<para><screen><userinput>./configure &amp;&amp;
+make &amp;&amp;
+make install</userinput></screen></para>
+
+</sect2>
+
Index: multimedia/libdriv/alsa/utils/alsa-utils-intro.xml
===================================================================
--- multimedia/libdriv/alsa/utils/alsa-utils-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/utils/alsa-utils-intro.xml	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,15 @@
+<sect2>
+<title>Introduction to alsa-utils</title>
+
+<screen>Download location (HTTP):       <ulink url="&alsa-utils-download-http;"/>
+Download location (FTP):        <ulink url="&alsa-utils-download-ftp;"/>
+Version used:                   &alsa-utils-version;
+Package size:                   &alsa-utils-size;
+Estimated Disk space required:  &alsa-utils-buildsize;</screen>
+
+<para>The alsa-utils package contains various utilities which are useful for
+controlling your sound card.</para>
+
+<screen>alsa-utils depends on <xref linkend="alsa-lib"/>.</screen>
+
+</sect2>
Index: multimedia/libdriv/alsa/utils/alsa-utils.ent
===================================================================
--- multimedia/libdriv/alsa/utils/alsa-utils.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
+++ multimedia/libdriv/alsa/utils/alsa-utils.ent	(revision 64bc4bd4a37df9bc76d1dea6f3c4b99d860f8d38)
@@ -0,0 +1,10 @@
+<!ENTITY alsa-utils SYSTEM "../alsa-utils.xml">
+<!ENTITY alsa-utils-intro SYSTEM "alsa-utils-intro.xml">
+<!ENTITY alsa-utils-inst SYSTEM "alsa-utils-inst.xml">
+<!ENTITY alsa-utils-desc SYSTEM "alsa-utils-desc.xml">
+<!ENTITY alsa-utils-config SYSTEM "alsa-utils-config.xml">
+<!ENTITY alsa-utils-buildsize "1.2 MB">
+<!ENTITY alsa-utils-version "0.9.0rc3">
+<!ENTITY alsa-utils-download-http "http://www.alsa-project.org/alsa/ftp/utils/alsa-utils-0.9.0rc3.tar.bz2">
+<!ENTITY alsa-utils-download-ftp "ftp://ftp.alsa-project.org/pub/utils/alsa-utils-0.9.0rc3.tar.bz2">
+<!ENTITY alsa-utils-size "85 KB">
