Index: general.ent
===================================================================
--- general.ent	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ general.ent	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -418,5 +418,5 @@
 <!-- Part XII -->
 <!-- Chapter 37 --> 
-<!ENTITY alsa-version                 "1.0.7"> 
+<!ENTITY alsa-version                 "1.0.8"> 
 <!ENTITY alsa-lib-version             "&alsa-version;"> 
 <!ENTITY alsa-utils-version           "&alsa-version;">  
Index: introduction/welcome/changelog.xml
===================================================================
--- introduction/welcome/changelog.xml	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ introduction/welcome/changelog.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -23,6 +23,6 @@
 <itemizedlist>
 
-<listitem><para>March 27th, 2005 [randy]: Updated to libtiff-3.7.2 and 
-pkgconfig-0.16.0.</para></listitem>
+<listitem><para>March 27th, 2005 [randy]: Updated to libtiff-3.7.2, 
+pkgconfig-0.16.0 and ALSA-1.0.8.</para></listitem>
 
 <listitem><para>March 26th, 2005 [randy]: Updated to HTML Tidy-050324 and 
Index: introduction/welcome/credits.xml
===================================================================
--- introduction/welcome/credits.xml	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ introduction/welcome/credits.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -149,5 +149,5 @@
 </listitem>
 
-<listitem><para>Apache Ant, Cyrus-SASL, DejaGnu, desktop-file-utils, 
+<listitem><para>ALSA Tools, Apache Ant, Cyrus-SASL, DejaGnu, desktop-file-utils, 
 DocBook-utils, Ethereal, Evolution Data Server, Exim (many additions), Expect, 
 FOP, GNOME Doc Utils, GnuCash (many additions), Heimdal, HTML Tidy, JadeTeX, 
Index: multimedia/libdriv/alsa-firmware.xml
===================================================================
--- multimedia/libdriv/alsa-firmware.xml	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ multimedia/libdriv/alsa-firmware.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -6,8 +6,8 @@
   <!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-md5sum        "91b29697c758406d3b969006556fa606">
-  <!ENTITY alsa-firmware-size          "1007 KB">
-  <!ENTITY alsa-firmware-buildsize     "5.8 MB">
-  <!ENTITY alsa-firmware-time          "0.03 SBU">
+  <!ENTITY alsa-firmware-md5sum        "6073fde43e0aea850ecdf64d0c2e46b2">
+  <!ENTITY alsa-firmware-size          "1.5 MB">
+  <!ENTITY alsa-firmware-buildsize     "19.2 MB">
+  <!ENTITY alsa-firmware-time          "0.04 SBU">
 ]>
 <sect1 id="alsa-firmware" xreflabel="ALSA Firmware-&alsa-firmware-version;">
@@ -18,4 +18,6 @@
 <?dbhtml filename="alsa-firmware.html"?>
 <title>ALSA Firmware-&alsa-firmware-version;</title>
+<indexterm zone="alsa-firmware">
+<primary sortas="a-ALSA-Firmware">ALSA Firmware</primary></indexterm>
 
 <sect2>
@@ -60,6 +62,9 @@
 
 <screen><userinput><command>./configure --prefix=/usr &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 </sect2>
Index: multimedia/libdriv/alsa-lib.xml
===================================================================
--- multimedia/libdriv/alsa-lib.xml	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ multimedia/libdriv/alsa-lib.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -6,8 +6,8 @@
   <!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-md5sum        "34ceaac0d1f0fc2b1462cef7c3a6825e">
-  <!ENTITY alsa-lib-size          "661 KB">
-  <!ENTITY alsa-lib-buildsize     "33.7 MB (45.5 MB if docs are built)">
-  <!ENTITY alsa-lib-time          "0.59 SBU">
+  <!ENTITY alsa-lib-md5sum        "c677299ed39d069c9a4b6a999e34ffe7">
+  <!ENTITY alsa-lib-size          "682 KB">
+  <!ENTITY alsa-lib-buildsize     "34.2 MB (additional 11.4 MB to build and install docs)">
+  <!ENTITY alsa-lib-time          "0.56 SBU">
 ]>
 
@@ -19,4 +19,6 @@
 <?dbhtml filename="alsa-lib.html"?>
 <title>ALSA Library-&alsa-lib-version;</title>
+<indexterm zone="alsa-lib">
+<primary sortas="a-ALSA-Library">ALSA Library</primary></indexterm>
 
 <sect2>
@@ -53,5 +55,5 @@
 </sect2>
 
-<sect2>
+<sect2 id="alsa-lib-kernel">
 <title>Installation of <application><acronym>ALSA</acronym> 
 Library</application>
@@ -62,4 +64,6 @@
 audio hardware and disable deprecated <userinput>Open Sound System</userinput>. 
 Recompile and install your new kernel.</para>
+<indexterm zone="alsa-lib alsa-lib-kernel">
+<primary sortas="d-ALSA">ALSA</primary></indexterm>
 
 <para>Install <application><acronym>ALSA</acronym> Library</application> by 
@@ -67,6 +71,9 @@
 
 <screen><userinput><command>./configure --enable-static &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 <para>If you have <application><acronym>JACK</acronym></application> installed 
@@ -75,7 +82,14 @@
 
 <screen><userinput><command>cd src/pcm/ext &amp;&amp;
-make jack &amp;&amp;
-make install-jack &amp;&amp;
-cd ../../..</command></userinput></screen>
+make jack</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install-jack</command></userinput></screen>
+
+<para>Ensure the unprivileged user's current working directory is the root of 
+the source tree:</para>
+
+<screen><userinput><command>cd ../../..</command></userinput></screen>
 
 <para>If you have <application>Doxygen</application> installed and you wish to 
@@ -83,7 +97,10 @@
 commands from the top-level directory of the source tree:</para>
 
-<screen><userinput><command>make doc &amp;&amp;
-install -d -m755 /usr/share/alsa/doc/html &amp;&amp;
-install -m644 doc/doxygen/html/* /usr/share/alsa/doc/html</command></userinput></screen>
+<screen><userinput><command>make doc</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>install -v -d -m755 /usr/share/alsa/doc/html &amp;&amp;
+install -v -m644 doc/doxygen/html/* /usr/share/alsa/doc/html</command></userinput></screen>
 
 </sect2>
@@ -101,13 +118,22 @@
 Library</application></title>
 
-<sect3><title>Config files</title>
-<para><filename>/usr/share/alsa/alsa.conf</filename>, 
+<sect3 id="alsa-lib-config"><title>Config files</title>
+<para><filename>~/.asoundrc</filename>, 
 <filename>/etc/asound.conf</filename>, 
-<filename>~/.asoundrc</filename> and 
+<filename>/usr/share/alsa/alsa.conf</filename> and 
 <filename>/usr/share/alsa/{cards,pcm}/*.conf</filename></para>
+<indexterm zone="alsa-lib alsa-lib-config">
+<primary sortas="e-AA.asoundrc">~/.asoundrc</primary></indexterm>
+<indexterm zone="alsa-lib alsa-lib-config">
+<primary sortas="e-etc-asound.conf">/etc/asound.conf</primary></indexterm>
+<indexterm zone="alsa-lib alsa-lib-config"><primary 
+sortas="e-usr-share-alsa-alsa.conf">/usr/share/alsa/alsa.conf</primary>
+</indexterm>
+<indexterm zone="alsa-lib alsa-lib-config"><primary 
+sortas="e-usr-share-alsa-cards">/usr/share/alsa/{cards,pcm}/*.conf</primary>
+</indexterm>
 </sect3>
 
 <sect3><title>Configuration information</title>
-
 <para>The default <filename>alsa.conf</filename> is adequate for most
 installations. For extra functionality and/or advanced control of your sound 
@@ -117,5 +143,4 @@
 plugin, visit <ulink 
 url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>.</para>
-
 </sect3>
 
@@ -125,18 +150,29 @@
 <title>Contents</title>
 
-<para>The <application><acronym>ALSA</acronym> Library</application> package 
-contains <command>aserver</command>, 
-<command>alsalisp</command>, 
-the <filename class="libraryfile">libasound</filename> library and optionally, 
-the <application><acronym>JACK</acronym></application> <acronym>PCM</acronym> 
-plugin library.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>alsalisp and aserver</seg>
+<seg>libasound.[so,a] and optionally, libasound_module_pcm_jack.[so,a]</seg>
+<seg>/usr/include/alsa, /usr/lib/alsa-lib, /usr/share/alsa</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2><title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>libasound (alsa library)</title>
-<para><filename class="libraryfile">libasound</filename> provides
-<acronym>ALSA</acronym> functions for application programs.</para></sect3>
+<varlistentry id="libasound">
+<term><filename class='libraryfile'>libasound.[so,a]</filename></term>
+<listitem><para>provides <acronym>ALSA</acronym> functions for application 
+programs.</para>
+<indexterm zone="alsa-lib libasound">
+<primary sortas="c-libasound">libasound.[so,a]</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
Index: multimedia/libdriv/alsa-oss.xml
===================================================================
--- multimedia/libdriv/alsa-oss.xml	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ multimedia/libdriv/alsa-oss.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -6,8 +6,8 @@
   <!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-md5sum        "8e4af2a1ce93a0e5945325097b9a0341">
-  <!ENTITY alsa-oss-size          "219 KB">
-  <!ENTITY alsa-oss-buildsize     "2.4 MB">
-  <!ENTITY alsa-oss-time          "0.06 SBU">
+  <!ENTITY alsa-oss-md5sum        "fb13eed47ab086d9c5acf746de34b872">
+  <!ENTITY alsa-oss-size          "223 KB">
+  <!ENTITY alsa-oss-buildsize     "2.8 MB">
+  <!ENTITY alsa-oss-time          "0.08 SBU">
 ]>
 
@@ -19,4 +19,6 @@
 <?dbhtml filename="alsa-oss.html"?>
 <title>ALSA OSS-&alsa-oss-version;</title>
+<indexterm zone="alsa-oss">
+<primary sortas="a-ALSA-OSS">ALSA OSS</primary></indexterm>
 
 <sect2>
@@ -61,6 +63,9 @@
 
 <screen><userinput><command>./configure &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 </sect2>
@@ -79,9 +84,31 @@
 <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>
+<segmentedlist>
+<segtitle>Installed Program</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
+
+<seglistitem>
+<seg>aoss</seg>
+<seg>libalsatoss.[so,a], libaoss.[so,a] and libossredir.a</seg>
+<seg>None</seg>
+</seglistitem>
+</segmentedlist>
+
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="aoss">
+<term><command>aoss</command></term>
+<listitem><para>is a simple wrapper script which facilitates the use of the 
+<acronym>ALSA</acronym> <acronym>OSS</acronym> compatibility library. It just 
+sets the appropriate <envar>LD_PRELOAD</envar> path and then runs the 
+command.</para>
+<indexterm zone="alsa-oss aoss">
+<primary sortas="b-aoss">aoss</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
Index: multimedia/libdriv/alsa-tools.xml
===================================================================
--- multimedia/libdriv/alsa-tools.xml	(revision 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ multimedia/libdriv/alsa-tools.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -6,8 +6,8 @@
   <!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-md5sum        "efd8660f818f2bbd7fd4761e0068fde1">
-  <!ENTITY alsa-tools-size          "757 KB">
-  <!ENTITY alsa-tools-buildsize     "20 MB (to compile all tools)">
-  <!ENTITY alsa-tools-time          "0.44 SBU (to compile all tools)">
+  <!ENTITY alsa-tools-md5sum        "cf51eccd14e818a9f0be455cedcd52ff">
+  <!ENTITY alsa-tools-size          "821 KB">
+  <!ENTITY alsa-tools-buildsize     "7-9 MB depending on the tool being built">
+  <!ENTITY alsa-tools-time          "0.01-0.06 SBU depending on the tool being built">
 ]>
 
@@ -19,4 +19,6 @@
 <?dbhtml filename="alsa-tools.html"?>
 <title>ALSA Tools-&alsa-tools-version;</title>
+<indexterm zone="alsa-tools">
+<primary sortas="a-ALSA-Tools">ALSA Tools</primary></indexterm>
 
 <sect2>
@@ -48,6 +50,8 @@
 
 <sect4><title>Optional</title>
-<para><xref linkend="GTK"/> and
-<ulink url="http://www.fltk.org/">FLTK</ulink></para>
+<para><xref linkend="GTK"/> (to build <command>echomixer</command>, 
+<command>envy24control</command> and <command>rmedigicontrol</command>) and 
+<ulink url="http://www.fltk.org/">FLTK</ulink> (to build 
+<command>hdspconf</command> and <command>hdspmixer</command>)</para>
 </sect4>
 </sect3>
@@ -58,4 +62,11 @@
 <title>Installation of <application><acronym>ALSA</acronym> 
 Tools</application></title>
+
+<para>The <command>as10k1</command> program needs a minor change to the 
+source code to compile using 
+<application><acronym>GCC</acronym></application>-3.4.x. The following 
+<command>sed</command> command fixes the problem:</para>
+
+<screen><userinput><command>sed -i -e "s/^next_cli_arg:/&amp;\n\n\tbreak;/" as10k1/as10k1.c</command></userinput></screen>
 
 <para>The <application><acronym>ALSA</acronym> Tools</application> package is 
@@ -66,6 +77,9 @@
 
 <screen><userinput><command>./configure --prefix=/usr &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 </sect2>
@@ -74,35 +88,193 @@
 <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>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directory</segtitle>
+
+<seglistitem>
+<seg>ac3dec, extract_ac3, as10k1, echomixer, envy24control, hdspconf, 
+hdsploader, hdspmixer, mixartloader, pcxhrloader, rmedigicontrol, cspctl, 
+sbiload, sscape_ctl, us428control, usx2yloader and vxloader</seg>
+<seg>None</seg>
+<seg>/usr/share/applications, /usr/share/pixmaps and 
+/usr/share/sounds</seg>
+</seglistitem>
+</segmentedlist>
+
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="ac3dec">
+<term><command>ac3dec</command></term>
+<listitem><para>is a free AC-3 stream decoder.</para>
+<indexterm zone="alsa-tools ac3dec">
+<primary sortas="b-ac3dec">ac3dec</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="extract_ac3">
+<term><command>extract_ac3</command></term>
+<listitem><para>will take an <acronym>MPEG</acronym>-2 stream and produce 
+AC-3 audio to stdout if it exists.</para>
+<indexterm zone="alsa-tools extract_ac3">
+<primary sortas="b-extract_ac3">extract_ac3</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="as10k1">
+<term><command>as10k1</command></term>
+<listitem><para>is an assembler for the emu10k1 <acronym>DSP</acronym> chip 
+present in the Creative <acronym>SB</acronym> 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>
+<indexterm zone="alsa-tools as10k1">
+<primary sortas="b-as10k1">as10k1</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="echomixer">
+<term><command>echomixer</command></term>
+<listitem><para>is the Linux equivalent of the Echoaudio console application 
+from Echoaudio. It is a tool to control all the features of any Echoaudio 
+soundcard. This includes clock sources, input and output gains, mixers, 
+etc.</para>
+<indexterm zone="alsa-tools echomixer">
+<primary sortas="b-echomixer">echomixer</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="envy24control">
+<term><command>envy24control</command></term>
+<listitem><para>is a control tool for Envy24 (ice1712) based sound 
+cards.</para>
+<indexterm zone="alsa-tools envy24control">
+<primary sortas="b-envy24control">envy24control</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="hdspconf">
+<term><command>hdspconf</command></term>
+<listitem><para>is a <acronym>GUI</acronym> to control the Hammerfall 
+HDSP Alsa Settings. Up to four hdsp cards are supported.</para>
+<indexterm zone="alsa-tools hdspconf">
+<primary sortas="b-hdspconf">hdspconf</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="hdsploader">
+<term><command>hdsploader</command></term>
+<listitem><para>is used to load the firmware required by the Hammerfall 
+HDSP sound cards.</para>
+<indexterm zone="alsa-tools hdsploader">
+<primary sortas="b-hdsploader">hdsploader</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="hdspmixer">
+<term><command>hdspmixer</command></term>
+<listitem><para>is the Linux equivalent of the Totalmix application from RME. 
+It is a tool to control the advanced routing features of the RME Hammerfall 
+DSP soundcard series.</para>
+<indexterm zone="alsa-tools hdspmixer">
+<primary sortas="b-hdspmixer">hdspmixer</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="mixartloader">
+<term><command>mixartloader</command></term>
+<listitem><para>is a helper program to load the firmware binaries onto the 
+Digigram's miXart board sound drivers. The following modules require this 
+program: snd-mixart. These drivers don't work properly at all until the 
+certain firmwares are loaded, i.e. no PCM nor mixer devices will 
+appear.</para>
+<indexterm zone="alsa-tools mixartloader">
+<primary sortas="b-mixartloader">mixartloader</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="pcxhrloader">
+<term><command>pcxhrloader</command></term>
+<listitem><para>is a helper program to load the firmware binaries onto 
+Digigram's pcxhr compatible board sound drivers. The following modules 
+require this program: snd-pcxhr. These drivers don't work properly at all 
+until the certain firmwares are loaded, i.e. no PCM nor mixer devices will 
+appear.</para>
+<indexterm zone="alsa-tools pcxhrloader">
+<primary sortas="b-pcxhrloader">pcxhrloader</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="rmedigicontrol">
+<term><command>rmedigicontrol</command></term>
+<listitem><para>is a control tool for RME Digi32 and RME Digi96 sound cards. 
+It provides a graphical frontend for all the sound card controls and 
+switches.</para>
+<indexterm zone="alsa-tools rmedigicontrol">
+<primary sortas="b-rmedigicontrol">rmedigicontrol</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="cspctl">
+<term><command>cspctl</command></term>
+<listitem><para>is an SB16/AWE32 Creative Signal Processor
+(<acronym>ASP</acronym>/<acronym>CSP</acronym>) control program.</para>
+<indexterm zone="alsa-tools cspctl">
+<primary sortas="b-cspctl">cspctl</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="sbiload">
+<term><command>sbiload</command></term>
+<listitem><para>is an <acronym>OPL</acronym>2/3 FM instrument loader for the 
+<acronym>ALSA</acronym> sequencer.</para>
+<indexterm zone="alsa-tools sbiload">
+<primary sortas="b-sbiload">sbiload</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="sscape_ctl">
+<term><command>sscape_ctl</command></term>
+<listitem><para>is an <acronym>ALSA</acronym> SoundScape control 
+utility.</para>
+<indexterm zone="alsa-tools sscape_ctl">
+<primary sortas="b-sscape_ctl">sscape_ctl</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="us428control">
+<term><command>us428control</command></term>
+<listitem><para>is a Tascam US-428 control program.</para>
+<indexterm zone="alsa-tools us428control">
+<primary sortas="b-us428control">us428control</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="usx2yloader">
+<term><command>usx2yloader</command></term>
+<listitem><para>is a helper program to load the 2nd Phase firmware binaries 
+onto the Tascam USX2Y USB sound cards. It has proven to work so far for the 
+US122, US224 and US428. The snd-usb-usx2y module requires this program.</para>
+<indexterm zone="alsa-tools usx2yloader">
+<primary sortas="b-usx2yloader">usx2yloader</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="vxloader">
+<term><command>vxloader</command></term>
+<listitem><para>is a helper program to load the firmware binaries onto the 
+Digigram's VX-board sound drivers. The following modules require this program: 
+snd-vx222, snd-vxpocket, snd-vxp440. These drivers don't work properly at all 
+until the certain firmwares are loaded, i.e. no PCM nor mixer devices will 
+appear.</para>
+<indexterm zone="alsa-tools vxloader">
+<primary sortas="b-vxloader">vxloader</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </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 0d25b6c58fed1050094e74226f45e9bb45bb869f)
+++ multimedia/libdriv/alsa-utils.xml	(revision ac789c067ed034cba2c0125d932c3a4271af166b)
@@ -6,7 +6,7 @@
   <!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-md5sum        "b9dc0f9aae6131a6e6df9934a7b96a18">
-  <!ENTITY alsa-utils-size          "145 KB">
-  <!ENTITY alsa-utils-buildsize     "2.3 MB">
+  <!ENTITY alsa-utils-md5sum        "c72d0efa9c88770a10733ec2abc1a872">
+  <!ENTITY alsa-utils-size          "224 KB">
+  <!ENTITY alsa-utils-buildsize     "3.6 MB">
   <!ENTITY alsa-utils-time          "0.08 SBU">
 ]>
@@ -19,4 +19,6 @@
 <?dbhtml filename="alsa-utils.html"?>
 <title>ALSA Utilities-&alsa-utils-version;</title>
+<indexterm zone="alsa-utils">
+<primary sortas="a-ALSA-Utilities">ALSA Utilities</primary></indexterm>
 
 <sect2>
@@ -59,6 +61,9 @@
 
 <screen><userinput><command>./configure &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 </sect2>
@@ -68,16 +73,21 @@
 Utilities</application></title>
 
-<sect3><title>Config files</title>
+<sect3 id="alsa-utils-config"><title>Config files</title>
 <para><filename>/etc/asound.state</filename></para>
-</sect3>
-
-<sect3><title>Configuration Information</title>
+<indexterm zone="alsa-utils alsa-utils-config">
+<primary sortas="e-etc-asound.state">/etc/asound.state</primary></indexterm>
+</sect3>
+
+<sect3 id="alsa-utils-init"><title>Configuration Information</title>
 <para>Probably the easiest way to store mixer levels is to set and retrieve
 them using a bootscript.</para>
-
-<para>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>
+<indexterm zone="alsa-utils alsa-utils-init">
+<primary sortas="f-alsa">alsa</primary></indexterm>
+
+<para>As the root user, install the init script 
+<filename>/etc/rc.d/init.d/alsa</filename> included in the 
+<xref linkend="intro-important-bootscripts"/> package.</para>
+
+<screen><userinput role='root'><command>make install-alsa</command></userinput></screen>
 
 <para>Note that all channels of your sound card are muted by default. You can
@@ -88,8 +98,8 @@
 <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;
+prevent this by running the following commands as the root user after 
+installing <application><acronym>ALSA</acronym> Utilities</application>:</para>
+
+<screen><userinput role='root'><command>touch /etc/asound.state &amp;&amp;
 alsactl store</command></userinput></screen>
 
@@ -100,6 +110,6 @@
 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>
+your own or, if you have the relevant sound card, install 
+<filename>sfxload</filename> and uncomment them.</para>
 
 </sect3>
@@ -110,43 +120,142 @@
 <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>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
+
+<seglistitem>
+<seg>aconnect, alsaconf, alsactl, alsamixer, amidi, amixer, aplay, aplaymidi, 
+arecord, arecordmidi, aseqnet, iecset and speaker-test</seg>
+<seg>None</seg>
+<seg>None</seg>
+</seglistitem>
+</segmentedlist>
+
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="aconnect">
+<term><command>aconnect</command></term>
+<listitem><para>is a utility for connecting and disconnecting two existing 
+ports in the <acronym>ALSA</acronym> sequencer system.</para>
+<indexterm zone="alsa-utils aconnect">
+<primary sortas="b-aconnect">aconnect</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="alsaconf">
+<term><command>alsaconf</command></term>
+<listitem><para>is a configuration tool which tries to detect the sound cards 
+on your system and write a suitable configuration file for 
+<acronym>ALSA</acronym>.</para>
+<indexterm zone="alsa-utils alsaconf">
+<primary sortas="b-alsaconf">alsaconf</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="alsactl">
+<term><command>alsactl</command></term>
+<listitem><para>is used to control advanced settings for the 
+<acronym>ALSA</acronym> sound card drivers.</para>
+<indexterm zone="alsa-utils alsactl">
+<primary sortas="b-alsactl">alsactl</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="alsamixer">
+<term><command>alsamixer</command></term>
+<listitem><para>is an ncurses-based mixer program for use with the 
+<acronym>ALSA</acronym> sound card drivers.</para>
+<indexterm zone="alsa-utils alsamixer">
+<primary sortas="b-alsamixer">alsamixer</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="amidi">
+<term><command>amidi</command></term>
+<listitem><para>is used to read from and write to <acronym>ALSA</acronym> 
+RawMIDI ports.</para>
+<indexterm zone="alsa-utils amidi">
+<primary sortas="b-amidi">amidi</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="amixer">
+<term><command>amixer</command></term>
+<listitem><para> allows command-line control of the mixers for the 
+<acronym>ALSA</acronym> sound card drivers.</para>
+<indexterm zone="alsa-utils amixer">
+<primary sortas="b-amixer">amixer</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="aplay">
+<term><command>aplay</command></term>
+<listitem><para>is a command-line soundfile player for the 
+<acronym>ALSA</acronym> sound card drivers.</para>
+<indexterm zone="alsa-utils aplay">
+<primary sortas="b-aplay">aplay</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="aplaymidi">
+<term><command>aplaymidi</command></term>
+<listitem><para>is a command-line utility that plays the specified 
+<acronym>MIDI</acronym> file(s) to one or more <acronym>ALSA</acronym> 
+sequencer ports.</para>
+<indexterm zone="alsa-utils aplaymidi">
+<primary sortas="b-aplaymidi">aplaymidi</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="arecord">
+<term><command>arecord</command></term>
+<listitem><para>is a command-line soundfile recorder for the 
+<acronym>ALSA</acronym> sound card drivers.</para>
+<indexterm zone="alsa-utils arecord">
+<primary sortas="b-arecord">arecord</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="arecordmidi">
+<term><command>arecordmidi</command></term>
+<listitem><para>is a command-line utility that records a standard 
+<acronym>MIDI</acronym> file from one or more <acronym>ALSA</acronym> 
+sequencer ports.</para>
+<indexterm zone="alsa-utils arecordmidi">
+<primary sortas="b-arecordmidi">arecordmidi</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="aseqnet">
+<term><command>aseqnet</command></term>
+<listitem><para>is an <acronym>ALSA</acronym> sequencer client which sends 
+and receives event packets over a network.</para>
+<indexterm zone="alsa-utils aseqnet">
+<primary sortas="b-aseqnet">aseqnet</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="iecset">
+<term><command>iecset</command></term>
+<listitem><para>is a small utility to set or dump the IEC958 (or so-called 
+<quote>S/<acronym>PDIF</acronym></quote>) status bits of the specified sound 
+card via the <acronym>ALSA</acronym> control <acronym>API</acronym>.</para>
+<indexterm zone="alsa-utils iecset">
+<primary sortas="b-iecset">iecset</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="speaker-test">
+<term><command>speaker-test</command></term>
+<listitem><para>is a command-line speaker test tone generator for 
+<acronym>ALSA</acronym>.</para>
+<indexterm zone="alsa-utils speaker-test">
+<primary sortas="b-speaker-test">speaker-test</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
