[blfs-book] r10657 - in trunk/BOOK: . introduction/welcome multimedia/libdriv

krejzi at linuxfromscratch.org krejzi at linuxfromscratch.org
Wed Sep 12 10:18:11 PDT 2012


Author: krejzi
Date: 2012-09-12 11:18:06 -0600 (Wed, 12 Sep 2012)
New Revision: 10657

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/multimedia/libdriv/alsa-lib.xml
   trunk/BOOK/multimedia/libdriv/alsa-plugins.xml
   trunk/BOOK/multimedia/libdriv/alsa-utils.xml
Log:
ALSA 1.0.26.

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2012-09-12 15:58:34 UTC (rev 10656)
+++ trunk/BOOK/general.ent	2012-09-12 17:18:06 UTC (rev 10657)
@@ -1031,10 +1031,10 @@
 <!-- Chapter 38 -->
 <!ENTITY alsa-download-http           "http://gd.tuwien.ac.at/opsys/linux/alsa">
 <!ENTITY alsa-download-ftp            "ftp://ftp.alsa-project.org/pub">
-<!ENTITY alsa-version                 "1.0.25">
-<!ENTITY alsa-lib-version             "1.0.25">
-<!ENTITY alsa-plugins-version         "1.0.25">
-<!ENTITY alsa-utils-version           "1.0.25">
+<!ENTITY alsa-version                 "1.0.26">
+<!ENTITY alsa-lib-version             "1.0.26">
+<!ENTITY alsa-plugins-version         "1.0.26">
+<!ENTITY alsa-utils-version           "1.0.26">
 <!ENTITY alsa-tools-version           "1.0.25">
 <!ENTITY alsa-firmware-version        "1.0.25">
 <!ENTITY alsa-oss-version             "1.0.25">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2012-09-12 15:58:34 UTC (rev 10656)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2012-09-12 17:18:06 UTC (rev 10657)
@@ -47,6 +47,15 @@
       <para>September 12th, 2012</para>
       <itemizedlist>
         <listitem>
+          <para>[krejzi] - ALSA Library 1.0.26.</para>
+        </listitem>
+        <listitem>
+          <para>[krejzi] - ALSA Plugins 1.0.26.</para>
+        </listitem>
+        <listitem>
+          <para>[krejzi] - ALSA Utilities 1.0.26.</para>
+        </listitem>
+        <listitem>
           <para>[krejzi] - Linux PAM 1.1.6.</para>
         </listitem>
         <listitem>

Modified: trunk/BOOK/multimedia/libdriv/alsa-lib.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/alsa-lib.xml	2012-09-12 15:58:34 UTC (rev 10656)
+++ trunk/BOOK/multimedia/libdriv/alsa-lib.xml	2012-09-12 17:18:06 UTC (rev 10657)
@@ -6,10 +6,10 @@
 
   <!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        "06fe5819020c6684b991dcffc5471304">
-  <!ENTITY alsa-lib-size          "820 KB">
-  <!ENTITY alsa-lib-buildsize     "32 MB (additional 17 MB to build and install docs)">
-  <!ENTITY alsa-lib-time          "0.3 SBU (less than 0.1 SBU to build and install docs)">
+  <!ENTITY alsa-lib-md5sum        "2dfa35d28471d721e592b616beedf965">
+  <!ENTITY alsa-lib-size          "864 KB">
+  <!ENTITY alsa-lib-buildsize     "16 MB">
+  <!ENTITY alsa-lib-time          "0.2 SBU">
 ]>
 
 <sect1 id="alsa-lib" xreflabel="alsa-lib-&alsa-lib-version;">
@@ -23,60 +23,79 @@
   <title>alsa-lib-&alsa-lib-version;</title>
 
   <indexterm zone="alsa-lib">
-    <primary sortas="a-ALSA-Library">ALSA Library</primary>
+    <primary sortas="a-alsa-lib">alsa-lib</primary>
   </indexterm>
 
   <sect2 role="package">
     <title>Introduction to ALSA Library</title>
 
-    <para>The <application>ALSA Library</application> package contains
-    the ALSA library.  This is used by programs (including <application>ALSA
-    Utilities</application>) requiring access to the ALSA sound interface.</para>
+    <para>
+      The <application>ALSA Library</application> package contains
+      the ALSA library used by programs (including <application>ALSA
+      Utilities</application>) requiring access to the ALSA sound
+      interface.
+    </para>
 
     &lfs72_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&alsa-lib-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&alsa-lib-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&alsa-lib-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&alsa-lib-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &alsa-lib-md5sum;</para>
+        <para>
+          Download MD5 sum: &alsa-lib-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &alsa-lib-size;</para>
+        <para>
+          Download size: &alsa-lib-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &alsa-lib-buildsize;</para>
+        <para>
+          Estimated disk space required: &alsa-lib-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &alsa-lib-time;</para>
+        <para>
+          Estimated build time: &alsa-lib-time;
+        </para>
       </listitem>
     </itemizedlist>
 
     <bridgehead renderas="sect3">ALSA Library Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="doxygen"/> and
-    <ulink url="ftp://ftp.lst.de/pub/people/okir/resmgr/">resmgr</ulink></para>
+    <para role="optional">
+      <xref linkend="doxygen"/> and
+      <xref linkend="python2"/>
+    </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/alsa-lib"/></para>
-
+      <ulink url="&blfs-wiki;/alsa-lib"/>
+    </para>
   </sect2>
 
   <sect2 role="kernel"  id="alsa-lib-kernel">
     <title>Kernel Configuration</title>
 
-    <para>In the Device Drivers ⇒ Sound card support ⇒ Advanced Linux
-    Sound Architecture section of the kernel configuration, select the settings
-    and drivers appropriate for your hardware.  Ensure that the deprecated Device
-    Drivers ⇒ Sound card support ⇒ Open Sound System is
-    <emphasis>not</emphasis> selected.  If necessary, recompile and install your
-    new kernel.</para>
+    <para>
+      In the Device Drivers ⇒ Sound card support ⇒ Advanced Linux
+      Sound Architecture section of the kernel configuration, select the settings
+      and drivers appropriate for your hardware.  Ensure that the deprecated Device
+      Drivers ⇒ Sound card support ⇒ Open Sound System is
+      <emphasis>not</emphasis> selected.  If necessary, recompile and install your
+      new kernel.
+    </para>
 
     <indexterm zone="alsa-lib alsa-lib-kernel">
       <primary sortas="d-ALSA">ALSA</primary>
@@ -87,65 +106,52 @@
   <sect2 role="installation">
     <title>Installation of ALSA Library</title>
 
-    <para>Install <application>ALSA Library</application> by
-    running the following commands:</para>
+    <para>
+      Install <application>ALSA Library</application> by
+      running the following commands:
+    </para>
 
 <screen><userinput>./configure &&
 make</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>
+      This package does not come with a test suite.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
-<screen role="root"><userinput>make install &&
-install -v -m644 -D doc/asoundrc.txt \
-    /usr/share/doc/alsa-lib-&alsa-lib-version;/asoundrc.txt</userinput></screen>
+<screen role="root"><userinput>make install</userinput></screen>
 
-   <para>If you have <application>Doxygen</application> installed and you wish to
-    build the library API documentation, run the following
-    commands from the top-level directory of the source tree:</para>
+   <para>
+     If you have <application>Doxygen</application> installed and you wish to
+     build the library API documentation, run the following
+     commands from the top-level directory of the source tree:
+   </para>
 
 <screen><userinput>make doc</userinput></screen>
 
-    <para>Now, to install the API documentation, as the <systemitem
-    class="username">root</systemitem> user:</para>
+    <para>
+      To install the API documentation, run the following command as
+      the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>install -v -d -m755 /usr/share/doc/alsa-lib-&alsa-lib-version;/html &&
 install -v -m644 doc/doxygen/html/* /usr/share/doc/alsa-&alsa-lib-version;/html</userinput></screen>
 
-    <para>Due to bug in libtool script it is no longer possible to build
-    shared and static libraries together. If you need static alsa library,
-    issue following commands:</para>
-
-    <screen><userinput>make clean &&
-./configure --disable-shared --enable-static  &&
-make</userinput></screen>
-
-   <para>Now, as the <systemitem class="username">root</systemitem> user
-   run: </para>
-
-   <screen role="root"><userinput>install -m644 src/.libs/libasound.a /usr/lib</userinput></screen>
-
   </sect2>
 
-  <sect2 role="commands">
-    <title>Command Explanations</title>
-
-    <para><parameter>--enable-static</parameter>: This switch is used to enable
-    building the static library as some programs link against it.</para>
-
-  </sect2>
-
   <sect2 role="configuration">
     <title>Configuring ALSA Library</title>
 
     <sect3 id="alsa-lib-config">
       <title>Config Files</title>
 
-      <para><filename>~/.asoundrc</filename>,
-      <filename>/etc/asound.conf</filename>,
-      <filename>/usr/share/alsa/alsa.conf</filename>, and
-      <filename>/usr/share/alsa/{cards,pcm}/*.conf</filename></para>
+      <para>
+        <filename>~/.asoundrc</filename> and
+        <filename>/etc/asound.conf</filename>
+      </para>
 
       <indexterm zone="alsa-lib alsa-lib-config">
         <primary sortas="e-AA.asoundrc">~/.asoundrc</primary>
@@ -155,24 +161,18 @@
         <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-alsa1">/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
-      device, you may need to create additional configuration files. For
-      information on the available configuration parameters, visit <ulink
-      url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>.</para>
+      <para>
+        The default <filename>alsa.conf</filename> is adequate for most
+        installations. For extra functionality and/or advanced control of your
+        sound device, you may need to create additional configuration files.
+        For information on the available configuration parameters, visit
+        <ulink url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>.
+      </para>
 
     </sect3>
 
@@ -183,14 +183,21 @@
 
     <segmentedlist>
       <segtitle>Installed Program</segtitle>
-      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Library</segtitle>
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>aserver</seg>
-        <seg>libasound.{so,a} and smixer-*.{so,a}</seg>
-        <seg>/usr/include/alsa, /usr/lib/alsa-lib, /usr/share/alsa and
-        /usr/share/doc/alsa-lib-&alsa-lib-version;</seg>
+        <seg>
+          aserver
+        </seg>
+        <seg>
+          libasound.so
+        </seg>
+        <seg>
+          /usr/include/alsa,
+          /usr/lib/alsa-lib,
+          /usr/share/alsa and
+          /usr/share/doc/alsa-lib-&alsa-lib-version;</seg>
       </seglistitem>
     </segmentedlist>
 
@@ -202,7 +209,9 @@
       <varlistentry id="aserver">
         <term><command>aserver</command></term>
         <listitem>
-          <para>provides the ALSA server.</para>
+          <para>
+            is the ALSA server.
+          </para>
           <indexterm zone="alsa-lib aserver">
             <primary sortas="b-aserver">aserver</primary>
           </indexterm>
@@ -210,25 +219,17 @@
       </varlistentry>
 
       <varlistentry id="libasound">
-        <term><filename class='libraryfile'>libasound.{so,a}</filename></term>
+        <term><filename class="libraryfile">libasound.so</filename></term>
         <listitem>
-          <para>provides ALSA functions for application programs.</para>
+          <para>
+            contains the ALSA API functions.
+          </para>
           <indexterm zone="alsa-lib libasound">
-            <primary sortas="c-libasound">libasound.{so,a}</primary>
+            <primary sortas="c-libasound">libasound.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
 
-      <varlistentry id="smixer">
-        <term><filename class='libraryfile'>smixer-*.{so,a}</filename></term>
-        <listitem>
-          <para>provides hardware dependent ALSA mixer functions.</para>
-          <indexterm zone="alsa-lib smixer">
-            <primary sortas="c-smixer">smixer-*.{so,a}</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
     </variablelist>
 
   </sect2>

Modified: trunk/BOOK/multimedia/libdriv/alsa-plugins.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/alsa-plugins.xml	2012-09-12 15:58:34 UTC (rev 10656)
+++ trunk/BOOK/multimedia/libdriv/alsa-plugins.xml	2012-09-12 17:18:06 UTC (rev 10657)
@@ -6,18 +6,12 @@
 
   <!ENTITY alsa-plugins-download-http "&alsa-download-http;/plugins/alsa-plugins-&alsa-plugins-version;.tar.bz2">
   <!ENTITY alsa-plugins-download-ftp  "&alsa-download-ftp;/plugins/alsa-plugins-&alsa-plugins-version;.tar.bz2">
-  <!ENTITY alsa-plugins-md5sum        "038c023eaa51171f018fbf7141255185">
-  <!ENTITY alsa-plugins-size          "328 KB">
-  <!ENTITY alsa-plugins-buildsize     "4 MB">
+  <!ENTITY alsa-plugins-md5sum        "4facd408326ef5567a7d4ceb6589e6b0">
+  <!ENTITY alsa-plugins-size          "356 KB">
+  <!ENTITY alsa-plugins-buildsize     "5.0 MB">
   <!ENTITY alsa-plugins-time          "less than 0.1 SBU">
 ]>
 
-  <!--
-  Editors: please examine the output from the configure command to see if
-  there are any new dependencies. There has been a bunch of work on the
-  plugins the last couple of releases, and that trend may continue.
-  -->
-
 <sect1 id="alsa-plugins" xreflabel="alsa-plugins-&alsa-plugins-version;">
   <?dbhtml filename="alsa-plugins.html"?>
 
@@ -29,36 +23,50 @@
   <title>alsa-plugins-&alsa-plugins-version;</title>
 
   <indexterm zone="alsa-plugins">
-    <primary sortas="a-ALSA-Plugins">ALSA Plugins</primary>
+    <primary sortas="a-alsa-plugins">alsa-plugins</primary>
   </indexterm>
 
   <sect2 role="package">
     <title>Introduction to ALSA Plugins</title>
 
-    <para>The <application>ALSA Plugins</application> package contains
-    plugins for various audio libraries and sound servers.</para>
+    <para>
+      The <application>ALSA Plugins</application> package contains
+      plugins for various audio libraries and sound servers.
+    </para>
 
     &lfs72_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&alsa-plugins-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&alsa-plugins-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&alsa-plugins-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&alsa-plugins-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &alsa-plugins-md5sum;</para>
+        <para>
+          Download MD5 sum: &alsa-plugins-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &alsa-plugins-size;</para>
+        <para>
+          Download size: &alsa-plugins-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &alsa-plugins-buildsize;</para>
+        <para>
+          Estimated disk space required: &alsa-plugins-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &alsa-plugins-time;</para>
+        <para>
+          Estimated build time: &alsa-plugins-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -89,28 +97,31 @@
     </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/alsa-plugins"/></para>
-
+      <ulink url="&blfs-wiki;/alsa-plugins"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of ALSA Plugins</title>
 
-    <para>Install <application>ALSA Plugins</application> by
-    running the following commands:</para>
+    <para>
+      Install <application>ALSA Plugins</application> by
+      running the following commands:
+    </para>
 
 <screen><userinput>patch -Np1 -i ../alsa-plugins-&alsa-plugins-version;-ffmpeg-1.patch &&
-CFLAGS="-D_GNU_SOURCE" ./configure &&
+./configure &&
 make</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>
+      This package does not come with a test suite.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
-<screen role="root"><userinput>make install &&
-install -v -m755 -d /usr/share/doc/alsa-plugins-&alsa-plugins-version; &&
-install -v -m644 doc/{README*,*.txt} \
-                    /usr/share/doc/alsa-plugins-&alsa-plugins-version;</userinput></screen>
+<screen role="root"><userinput>make install</userinput></screen>
 
   </sect2>
 
@@ -118,18 +129,15 @@
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
       <segtitle>Installed Libraries</segtitle>
-      <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
-        <seg>None</seg>
-        <seg>Numerous libasound_module_<replaceable><module></replaceable>.so
-        modules including ctl_oss, pcm_oss, pcm_upmix, pcm_usb_stream, pcm_vdownmix,
-        rate_speexrate, rate_speexrate_best, rate_speexrate_medium, and optionally
-        ctl_pulse, pcm_pulse, pcm_a52, pcm_jack and
-        rate_samplerate*</seg>
-        <seg>/usr/share/doc/alsa-plugins-&alsa-plugins-version;</seg>
+        <seg>
+          Numerous libasound_module_<replaceable><module></replaceable>.so
+          modules including ctl_oss, ctl_pulse, pcm_a52, pcm_jack, pcm_oss,
+          pcm_pulse, pcm_upmix, pcm_usb_stream, pcm_vdownmix,
+          rate_samplerate* and rate_speexrate*
+        </seg>
       </seglistitem>
     </segmentedlist>
 
@@ -139,10 +147,12 @@
       <?dbhtml list-presentation="table"?>
 
       <varlistentry id="libasound_module_pcm_oss.so">
-        <term><filename class='libraryfile'>libasound_module_pcm_oss.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_pcm_oss.so</filename></term>
         <listitem>
-          <para>Allows native <application>ALSA</application> applications to
-          run on <application>OSS</application>.</para>
+          <para>
+            Allows native <application>ALSA</application> applications to
+            run on <application>OSS</application>.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_pcm_oss.so">
             <primary sortas="c-libasound_module_pcm_oss">libasound_module_pcm_oss.so</primary>
           </indexterm>
@@ -150,9 +160,11 @@
       </varlistentry>
 
       <varlistentry id="libasound_module_pcm_upmix.so">
-        <term><filename class='libraryfile'>libasound_module_pcm_upmix.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_pcm_upmix.so</filename></term>
         <listitem>
-          <para>Allows upmixing sound to 4 or 6 channels.</para>
+          <para>
+            Allows upmixing sound to 4 or 6 channels.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_pcm_upmix.so">
             <primary sortas="c-libasound_module_pcm_upmix">libasound_module_pcm_upmix.so</primary>
           </indexterm>
@@ -160,10 +172,12 @@
       </varlistentry>
 
       <varlistentry id="libasound_module_pcm_vdownmix.so">
-        <term><filename class='libraryfile'>libasound_module_pcm_vdownmix.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_pcm_vdownmix.so</filename></term>
         <listitem>
-          <para>Allows downmixing sound from 4-6 channels to 2
-          channel stereo output.</para>
+          <para>
+            Allows downmixing sound from 4-6 channels to 2
+            channel stereo output.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_pcm_vdownmix.so">
             <primary sortas="c-libasound_module_pcm_vdownmix">libasound_module_pcm_vdownmix.so</primary>
           </indexterm>
@@ -171,10 +185,12 @@
       </varlistentry>
 
       <varlistentry id="libasound_module_pcm_jack.so">
-        <term><filename class='libraryfile'>libasound_module_pcm_jack.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_pcm_jack.so</filename></term>
         <listitem>
-          <para>Allows native <application>ALSA</application> applications to
-          work with <command>jackd</command>.</para>
+          <para>
+            Allows native <application>ALSA</application> applications to
+            work with <command>jackd</command>.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_pcm_jack.so">
             <primary sortas="c-libasound_module_pcm_jack">libasound_module_pcm_jack.so</primary>
           </indexterm>
@@ -182,11 +198,13 @@
       </varlistentry>
 
       <varlistentry id="libasound_module_pcm_pulse.so">
-        <term><filename class='libraryfile'>libasound_module_pcm_pulse.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_pcm_pulse.so</filename></term>
         <listitem>
-          <para>Allows native <application>ALSA</application> applications
-          to access a <application>PulseAudio</application> sound
-          daemon.</para>
+          <para>
+            Allows native <application>ALSA</application> applications
+            to access a <application>PulseAudio</application> sound
+            daemon.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_pcm_pulse.so">
             <primary sortas="c-libasound_module_pcm_pulse">libasound_module_pcm_pulse.so</primary>
           </indexterm>
@@ -194,10 +212,12 @@
       </varlistentry>
 
       <varlistentry id="libasound_module_pcm_a52.so">
-        <term><filename class='libraryfile'>libasound_module_pcm_a52.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_pcm_a52.so</filename></term>
         <listitem>
-          <para>Converts S16 linear sound format to A52 compressed format
-          and sends it to an SPDIF output.</para>
+          <para>
+            Converts S16 linear sound format to A52 compressed format
+            and sends it to an SPDIF output.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_pcm_a52.so">
             <primary sortas="c-libasound_module_pcm_a52">libasound_module_pcm_a52.so</primary>
           </indexterm>
@@ -205,10 +225,12 @@
       </varlistentry>
 
       <varlistentry id="libasound_module_rate_samplerate.so">
-        <term><filename class='libraryfile'>libasound_module_rate_samplerate.so</filename></term>
+        <term><filename class="libraryfile">libasound_module_rate_samplerate.so</filename></term>
         <listitem>
-          <para>Provides an external rate converter through
-          <filename class='libraryfile'>libsamplerate</filename>.</para>
+          <para>
+            Provides an external rate converter through
+            <filename class="libraryfile">libsamplerate</filename>.
+          </para>
           <indexterm zone="alsa-plugins libasound_module_rate_samplerate.so">
             <primary sortas="c-libasound_module_rate_samplerate">libasound_module_rate_samplerate.so</primary>
           </indexterm>

Modified: trunk/BOOK/multimedia/libdriv/alsa-utils.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/alsa-utils.xml	2012-09-12 15:58:34 UTC (rev 10656)
+++ trunk/BOOK/multimedia/libdriv/alsa-utils.xml	2012-09-12 17:18:06 UTC (rev 10657)
@@ -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        "f81f9dcb9a014fd32cb3a70066a5b9a9">
+  <!ENTITY alsa-utils-md5sum        "4dcf1017fafc91603af96705c073eca9">
   <!ENTITY alsa-utils-size          "1.1 MB">
   <!ENTITY alsa-utils-buildsize     "11 MB">
   <!ENTITY alsa-utils-time          "0.1 SBU">
@@ -24,36 +24,51 @@
   <title>alsa-utils-&alsa-utils-version;</title>
 
   <indexterm zone="alsa-utils">
-    <primary sortas="a-ALSA-Utilities">ALSA Utilities</primary>
+    <primary sortas="a-alsa-utils">alsa-utils</primary>
   </indexterm>
 
   <sect2 role="package">
     <title>Introduction to ALSA Utilities</title>
 
-    <para>The <application>ALSA Utilities</application> package contains
-    various utilities which are useful for controlling your sound card.</para>
+    <para>
+      The <application>ALSA Utilities</application> package contains
+      various utilities which are useful for controlling your sound
+      card.
+    </para>
 
     &lfs72_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&alsa-utils-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&alsa-utils-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&alsa-utils-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&alsa-utils-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &alsa-utils-md5sum;</para>
+        <para>
+          Download MD5 sum: &alsa-utils-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &alsa-utils-size;</para>
+        <para>
+          Download size: &alsa-utils-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &alsa-utils-buildsize;</para>
+        <para>
+          Estimated disk space required: &alsa-utils-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &alsa-utils-time;</para>
+        <para>
+          Estimated build time: &alsa-utils-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -66,41 +81,50 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="xmlto"/>,
-      <ulink url="http://hightek.org/dialog/">dialog</ulink> (for alsaconf)
+      <ulink url="http://hightek.org/dialog/">Dialog</ulink> and
+      <xref linkend="xmlto"/>
     </para>
 
     <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-       <itemizedlist spacing="compact">
-         <listitem>
-           <para>Optional patch: <ulink
-            url="&patch-root;/&alsa-utils-patch;"/></para>
-         </listitem>
-       </itemizedlist>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Optional patch:
+          <ulink url="&patch-root;/&alsa-utils-patch;"/>
+        </para>
+      </listitem>
+    </itemizedlist>
 
-
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/alsa-utils"/></para>
-
+      <ulink url="&blfs-wiki;/alsa-utils"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of ALSA Utilities</title>
 
-    <para>If you have not installed the optional dependency <xref linkend='xmlto'/>,
-    apply the following patch:</para>
+    <para>
+      If you have not installed the optional dependency <xref linkend="xmlto"/>,
+      apply the following patch:
+    </para>
 
 <screen><userinput>patch -Np1 -i ../&alsa-utils-patch;</userinput></screen>
 
-    <para>Install <application>ALSA Utilities</application> by
-    running the following commands:</para>
+    <para>
+      Install <application>ALSA Utilities</application> by
+      running the following commands:
+    </para>
 
 <screen><userinput>./configure --without-systemdsystemunitdir &&
 make</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>
+      This package does not come with a test suite.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
@@ -109,8 +133,12 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><option>--without-systemdsystemunitdir</option>:
-    Do not install systemd units.</para>
+    <para>
+      <option>--without-systemdsystemunitdir</option>:
+      This switch disables instalation of
+      <application>Systemd</application> units which are
+      not necesary for BLFS.
+    </para>
 
   </sect2>
 
@@ -120,7 +148,9 @@
     <sect3 id="alsa-utils-config">
       <title>Config Files</title>
 
-      <para><filename>/var/lib/alsa/asound.state</filename></para>
+      <para>
+        <filename>/var/lib/alsa/asound.state</filename>
+      </para>
 
       <indexterm zone="alsa-utils alsa-utils-config">
         <primary sortas="e-var-lib-alsa-asound.state">/var/lib/alsa/asound.state</primary>
@@ -131,50 +161,63 @@
     <sect3 id="alsa-utils-init">
       <title>Configuration Information</title>
 
-      <para> Use a bootscript to store the values at shutdown.</para>
+      <para>
+        Use a bootscript to store the values at shutdown.
+      </para>
 
       <indexterm zone="alsa-utils alsa-utils-init">
         <primary sortas="f-alsa">alsa</primary>
       </indexterm>
 
-      <para>As the <systemitem class="username">root</systemitem> user,
-      install the init script <filename>/etc/rc.d/init.d/alsa</filename> included
-      in the <xref linkend="bootscripts"/> package.</para>
+      <para>
+        As the <systemitem class="username">root</systemitem> user,
+        install the init script <filename>/etc/rc.d/init.d/alsa</filename> included
+        in the <xref linkend="bootscripts"/> package.
+      </para>
 
 <screen role="root"><userinput>make install-alsa</userinput></screen>
 
-      <para>Note that all channels of your sound card are muted by default.
-      You can use the <command>alsamixer</command> program from the
-      <application>ALSA Utilities</application> to change this. Use
-      <command>speaker-test</command> to check that your settings have
-      been applied correctly. You should hear <quote>pink noise</quote> on your
-      speakers.</para>
+      <para>
+        Note that all channels of your sound card are muted by default.
+        You can use the <command>alsamixer</command> program to change
+        this. Use <command>speaker-test</command> to check that your
+        settings have been applied correctly. You should hear
+        <quote>pink noise</quote> on your speakers.
+      </para>
 
-      <para>The <filename>alsactl</filename> program is normally run from a
-      standard <application>udev</application> rule.   The first time it is
-      run, it will complain that there is no state in
-      <filename>/var/lib/alsa/asound.state</filename>. You can prevent this by
-      running the following commands as the <systemitem
-      class="username">root</systemitem> user:</para>
+      <para>
+        The <filename>alsactl</filename> program is normally run from a
+        standard <application>udev</application> rule. The first time it
+        is run, it will complain that there is no state in
+        <filename>/var/lib/alsa/asound.state</filename>. You can prevent
+        this by running the following commands as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
 
 <screen role="root"><userinput>touch /var/lib/alsa/asound.state &&
 alsactl store</userinput></screen>
 
-      <para>The volume settings will be restored from the saved state by
-      <application>Udev</application> when the device is detected (during boot
-      or when plugged in for USB devices).</para>
+      <para>
+        The volume settings will be restored from the saved state by
+        <application>Udev</application> when the device is detected
+        (during boot or when plugged in for USB devices).
+      </para>
 
-      <para>All sound devices are not accessible for any user except
-      <systemitem class="username">root</systemitem> and members of the
-      <systemitem class="groupname">audio</systemitem> group. Add any users
-      that might use the sound devices to that group:</para>
+      <para>
+        All sound devices are not accessible for any user except
+        <systemitem class="username">root</systemitem> and members of the
+        <systemitem class="groupname">audio</systemitem> group. Add any
+        users that might use the sound devices to that group:
+      </para>
 
 <screen role="root"><userinput>usermod -a -G audio <replaceable><username></replaceable></userinput></screen>
 
       <note>
-        <para>You may need to log out and back in again to refresh your group
-        memberships. '<command>su <replaceable><username></replaceable></command>'
-        should work as well.</para>
+        <para>
+          You may need to log out and back in again to refresh your group
+          memberships. '<command>su <replaceable><username></replaceable></command>'
+          should work as well.
+        </para>
       </note>
 
     </sect3>
@@ -189,10 +232,15 @@
       <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
-        <seg>aconnect, alsaconf, alsactl, alsamixer, amidi,
-        amixer, aplay, aplaymidi, arecord, arecordmidi, aseqdump,
-        aseqnet, iecset, and speaker-test</seg>
-        <seg>/var/lib/alsa and /usr/share/sounds/alsa</seg>
+        <seg>
+          aconnect, alsaconf, alsactl, alsaloop, alsamixer,
+          alsaucm, amidi, amixer, aplay, aplaymidi, arecord,
+          arecordmidi, aseqdump, aseqnet, iecset and
+          speaker-test
+        </seg>
+        <seg>
+          /usr/share/sounds/alsa and /var/lib/alsa
+        </seg>
       </seglistitem>
     </segmentedlist>
 
@@ -204,8 +252,10 @@
       <varlistentry id="aconnect">
         <term><command>aconnect</command></term>
         <listitem>
-          <para>is a utility for connecting and disconnecting two existing
-          ports in the ALSA sequencer system.</para>
+          <para>
+            is a utility for connecting and disconnecting two
+            existing ports in the ALSA sequencer system.
+          </para>
           <indexterm zone="alsa-utils aconnect">
             <primary sortas="b-aconnect">aconnect</primary>
           </indexterm>
@@ -215,9 +265,11 @@
       <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 ALSA.
-          This program is incompatible with udev and hotplug.</para>
+          <para>
+            is a configuration tool which tries to detect the sound cards
+            on your system and write a suitable configuration file for ALSA.
+            This program is incompatible with Udev.
+          </para>
           <indexterm zone="alsa-utils alsaconf">
             <primary sortas="b-alsaconf">alsaconf</primary>
           </indexterm>
@@ -227,19 +279,36 @@
       <varlistentry id="alsactl">
         <term><command>alsactl</command></term>
         <listitem>
-          <para>is used to control advanced settings for the
-          ALSA sound card drivers.</para>
+          <para>
+            is used to control advanced settings for the
+            ALSA sound card drivers.
+          </para>
           <indexterm zone="alsa-utils alsactl">
             <primary sortas="b-alsactl">alsactl</primary>
           </indexterm>
         </listitem>
       </varlistentry>
 
+      <varlistentry id="alsaloop">
+        <term><command>alsaloop</command></term>
+        <listitem>
+          <para>
+            allows create a PCM loopback between a PCM capture
+            device and a PCM playback device.
+          </para>
+          <indexterm zone="alsa-utils alsaloop">
+            <primary sortas="b-alsaloop">alsaloop</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
       <varlistentry id="alsamixer">
         <term><command>alsamixer</command></term>
         <listitem>
-          <para>is an ncurses-based mixer program for use with the
-          ALSA sound card drivers.</para>
+          <para>
+            is an Ncurses based mixer program for use with
+            the ALSA sound card drivers.
+          </para>
           <indexterm zone="alsa-utils alsamixer">
             <primary sortas="b-alsamixer">alsamixer</primary>
           </indexterm>
@@ -249,8 +318,10 @@
       <varlistentry id="amidi">
         <term><command>amidi</command></term>
         <listitem>
-          <para>is used to read from and write to ALSA
-          RawMIDI ports.</para>
+          <para>
+            is used to read from and write to ALSA
+            RawMIDI ports.
+          </para>
           <indexterm zone="alsa-utils amidi">
             <primary sortas="b-amidi">amidi</primary>
           </indexterm>
@@ -271,8 +342,10 @@
       <varlistentry id="aplay">
         <term><command>aplay</command></term>
         <listitem>
-          <para>is a command-line soundfile player for the
-          ALSA sound card drivers.</para>
+          <para>
+            is a command-line soundfile player for the
+            ALSA sound card drivers.
+          </para>
           <indexterm zone="alsa-utils aplay">
             <primary sortas="b-aplay">aplay</primary>
           </indexterm>
@@ -282,8 +355,10 @@
       <varlistentry id="aplaymidi">
         <term><command>aplaymidi</command></term>
         <listitem>
-          <para>is a command-line utility that plays the specified
-          MIDI file(s) to one or more ALSA sequencer ports.</para>
+          <para>
+            is a command-line utility that plays the specified
+            MIDI file(s) to one or more ALSA sequencer ports.
+          </para>
           <indexterm zone="alsa-utils aplaymidi">
             <primary sortas="b-aplaymidi">aplaymidi</primary>
           </indexterm>
@@ -293,8 +368,10 @@
       <varlistentry id="arecord">
         <term><command>arecord</command></term>
         <listitem>
-          <para>is a command-line soundfile recorder for the
-          ALSA sound card drivers.</para>
+          <para>
+            is a command-line soundfile recorder for the
+            ALSA sound card drivers.
+          </para>
           <indexterm zone="alsa-utils arecord">
             <primary sortas="b-arecord">arecord</primary>
           </indexterm>
@@ -304,8 +381,10 @@
       <varlistentry id="arecordmidi">
         <term><command>arecordmidi</command></term>
         <listitem>
-          <para>is a command-line utility that records a standard
-          MIDI file from one or more ALSA sequencer ports.</para>
+          <para>
+            is a command-line utility that records a standard
+            MIDI file from one or more ALSA sequencer ports.
+          </para>
           <indexterm zone="alsa-utils arecordmidi">
             <primary sortas="b-arecordmidi">arecordmidi</primary>
           </indexterm>
@@ -315,8 +394,10 @@
       <varlistentry id="aseqdump">
         <term><command>aseqdump</command></term>
         <listitem>
-          <para>is a command-line utility that prints the sequencer events it
-          receives as text.</para>
+          <para>
+            is a command-line utility that prints the sequencer events it
+            receives as text.
+          </para>
           <indexterm zone="alsa-utils aseqdump">
             <primary sortas="b-aseqdump">aseqdump</primary>
           </indexterm>
@@ -326,8 +407,10 @@
       <varlistentry id="aseqnet">
         <term><command>aseqnet</command></term>
         <listitem>
-          <para>is an ALSA sequencer client which sends
-          and receives event packets over a network.</para>
+          <para>
+            is an ALSA sequencer client which sends and
+            receives event packets over a network.
+          </para>
           <indexterm zone="alsa-utils aseqnet">
             <primary sortas="b-aseqnet">aseqnet</primary>
           </indexterm>
@@ -337,9 +420,11 @@
       <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/PDIF</quote>) status bits of the specified sound
-          card via the ALSA control API.</para>
+          <para>
+            is a small utility to set or dump the IEC958 (or so-called
+            <quote>S/PDIF</quote>) status bits of the specified sound
+            card via the ALSA control API.
+          </para>
           <indexterm zone="alsa-utils iecset">
             <primary sortas="b-iecset">iecset</primary>
           </indexterm>
@@ -349,7 +434,9 @@
       <varlistentry id="speaker-test">
         <term><command>speaker-test</command></term>
         <listitem>
-          <para>is a command-line speaker test tone generator for ALSA.</para>
+          <para>
+            is a command-line speaker test tone generator for ALSA.
+          </para>
           <indexterm zone="alsa-utils speaker-test">
             <primary sortas="b-speaker-test">speaker-test</primary>
           </indexterm>




More information about the blfs-book mailing list