Index: introduction/welcome/changelog.xml
===================================================================
--- introduction/welcome/changelog.xml	(revision 2bda6610caeabe599b07889dae4e00b494de62bc)
+++ introduction/welcome/changelog.xml	(revision e5d2270e161eb76c8f8e163a6857d057275e7ac3)
@@ -48,4 +48,8 @@
       <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
Index: multimedia/libdriv/pulseaudio.xml
===================================================================
--- multimedia/libdriv/pulseaudio.xml	(revision 2bda6610caeabe599b07889dae4e00b494de62bc)
+++ multimedia/libdriv/pulseaudio.xml	(revision e5d2270e161eb76c8f8e163a6857d057275e7ac3)
@@ -100,4 +100,5 @@
       <xref linkend="bluez"/> (runtime),
       <xref linkend="check"/>,
+      <xref linkend="consolekit"/> (runtime),
       <xref linkend="GConf"/>,
       <xref linkend="gtk3"/>,
@@ -195,4 +196,61 @@
   </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,5 +265,6 @@
           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,6 +277,5 @@
           /usr/include/pulse,
           /usr/lib/cmake/PulseAudio,
-          /usr/lib/pulse,
-          /usr/libexec/pulse and
+          /usr/lib/pulse, and
           /usr/share/pulseaudio
         </seg>
@@ -382,4 +440,5 @@
       </varlistentry>
 
+<!-- only installed if FFTW is present
       <varlistentry id="qpaeq">
         <term><command>qpaeq</command></term>
@@ -394,5 +453,5 @@
         </listitem>
       </varlistentry>
-
+-->
       <varlistentry id="start-pulseaudio-kde">
         <term><command>start-pulseaudio-kde</command></term>
