Changeset e5d2270e

Timestamp:

09/01/2014 03:37:26 PM (10 years ago)

Author:

Pierre Labastie <pieere@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.6, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

acc0c06

Parents:

2bda6610

Message:

Add configuration instructions to PulseAudio.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@14156 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:

• introduction/welcome/changelog.xml (modified) (1 diff)
• multimedia/libdriv/pulseaudio.xml (modified) (6 diffs)

introduction/welcome/changelog.xml

@@ -48 +48 @@
       <para>September 1st, 2014</para>
       <itemizedlist>
+        <listitem>
+          <para>[pierre] - Add basic configuration instructions to PulseAudio.
+          Fixes <ulink url="&blfs-ticket-root;5455">#5455</ulink>.</para>
+        </listitem>
         <listitem>
           <para>[fernando] - Add LXDM-0.5.0, copied, modified, from BLFS

multimedia/libdriv/pulseaudio.xml

@@ -100 +100 @@
       <xref linkend="bluez"/> (runtime),
       <xref linkend="check"/>,
+      <xref linkend="consolekit"/> (runtime),
       <xref linkend="GConf"/>,
       <xref linkend="gtk3"/>,
@@ -195 +196 @@
   </sect2>
 
+  <sect2 role="configuration">
+    <title>Configuring PulseAudio</title>
+
+    <sect3 id="pulseaudio-config">
+      <title>Config Files</title>
+      <para>
+        There are system wide configuration files:
+        <filename>/etc/pulse/daemon.conf</filename>,
+        <filename>/etc/pulse/client.conf</filename>,
+        <filename>/etc/pulse/default.pa</filename>, and user configuration
+        files with the same names in
+        <filename class="directory">~/.config/pulse</filename>. User
+        configuration files take precedence over system wide ones.
+      </para>
+
+      <indexterm zone="pulseaudio pulseaudio-config">
+        <primary sortas="e-AA.config-pulse">~/.config/pulse</primary>
+      </indexterm>
+
+      <indexterm zone="pulseaudio pulseaudio-config">
+        <primary
+        sortas="e-etc-pulse-daemon.conf">/etc/pulse/daemon.conf</primary>
+      </indexterm>
+
+      <indexterm zone="pulseaudio pulseaudio-config">
+        <primary
+        sortas="e-etc-pulse-client.conf">/etc/pulse/client.conf</primary>
+      </indexterm>
+
+      <indexterm zone="pulseaudio pulseaudio-config">
+        <primary
+        sortas="e-etc-pulse-default.pa">/etc/pulse/default.pa</primary>
+      </indexterm>
+    </sect3>
+
+    <sect3><title>Configuration Information</title>
+
+      <para>
+        The default configuration files allow to set up a working installation,
+        except that you need to remove a reference to Console-Kit if it is
+        not installed. For example, issue the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root"><userinput>sed '/load-module module-console-kit/s/^/#/' \
+                    -i /etc/pulse/default.pa</userinput></screen>
+
+      <para>
+        You may also have to configure the audio system. You may start
+        <application>pulseaudio</application> in command line mode using
+        <command>pulseaudio -C</command>. You can then list various
+        informations and change some settings. See
+        <command>man pulse-cli-syntax</command>.
+      </para>
+    </sect3>
+  </sect2>
+
   <sect2 role="content">
     <title>Contents</title>
@@ -207 +265 @@
           esdcompat, pacat, pacmd, pactl, padsp, pamon (symlink),
           paplay (symlink), parec (symlink), parecord (symlink), pasuspender,
-          pax11publish, pulseaudio, qpaeq,
+          pax11publish, pulseaudio,
+          <!-- it looks like the equalizer needs FFTW: qpaeq, -->
           start-pulseaudio-kde and start-pulseaudio-x11
         </seg>
@@ -218 +277 @@
           /usr/include/pulse,
           /usr/lib/cmake/PulseAudio,
-          /usr/lib/pulse,
-          /usr/libexec/pulse and
+          /usr/lib/pulse, and
           /usr/share/pulseaudio
         </seg>
@@ -382 +440 @@
       </varlistentry>
 
+<!-- only installed if FFTW is present
       <varlistentry id="qpaeq">
         <term><command>qpaeq</command></term>
@@ -394 +453 @@
         </listitem>
       </varlistentry>
-
+-->
       <varlistentry id="start-pulseaudio-kde">
         <term><command>start-pulseaudio-kde</command></term>