commit 752efcf4d565cd12eeb3f795581e705590e85121
Author: Christopher Antila <crantila at fedoraproject.org>
Date: Tue May 21 01:24:43 2013 -0400
Improved "Integrate PulseAudio with JACK" Section
Still could use improvement.
en-US/Sound_Servers.xml | 29 +++++++++++++++--------------
1 files changed, 15 insertions(+), 14 deletions(-)
---
diff --git a/en-US/Sound_Servers.xml b/en-US/Sound_Servers.xml
index 32ffdff..c082b79 100644
--- a/en-US/Sound_Servers.xml
+++ b/en-US/Sound_Servers.xml
@@ -100,30 +100,31 @@
</para>
</section>
<section id="sect-Musicians_Guide-Integrating_PulseAudio_with_JACK">
- <title>Integrating <systemitem>PulseAudio</systemitem> with <systemitem>JACK</systemitem></title>
+ <title>Integrate <systemitem>PulseAudio</systemitem> with <systemitem>JACK</systemitem></title>
<para>
- The default configuration of <systemitem>PulseAudio</systemitem> yields control of the audio equipment to <systemitem>JACK</systemitem> when the <systemitem>JACK</systemitem> server starts. <systemitem>PulseAudio</systemitem> will not be able to receive input or send output of any audio signals on the audio interface used by <systemitem>JACK</systemitem>. This is fine for occasional users of <systemitem>JACK</systemitem>, but many users will want to use <systemitem>JACK</systemitem> and <systemitem>PulseAudio</systemitem> simultaneously, or switch between the two frequently. The following instructions will configure <systemitem>PulseAudio</systemitem> so that its input and output is routed through <systemitem>JACK</systemitem>.
+ By default, <systemitem>PulseAudio</systemitem> yields control of your computer's audio and MIDI interfaces to <systemitem>JACK</systemitem> when the <systemitem>JACK</systemitem> server starts. <systemitem>PulseAudio</systemitem> will not receive input or send output on an audio interface that <systemitem>JACK</systemitem> is using. You may want to use <systemitem>JACK</systemitem> and <systemitem>PulseAudio</systemitem> at the same time, or switch between them frequently. Follow these instructions to configure <systemitem>PulseAudio</systemitem> so its input and output is routed through <systemitem>JACK</systemitem>, so you can use both sound servers at the same time.
</para>
<procedure>
- <step><para>Use PackageKit or Apper to install the <package>pulseaudio-module-jack</package> package.</para></step>
- <step><para>Approve the installation and ensure that it is carried out properly.</para></step>
- <step><para>You'll need to edit the <systemitem>PulseAudio</systemitem> configuration file to use the <systemitem>JACK</systemitem> module.</para>
+ <step><para>Use <application>PackageKit</application> or <application>Apper</application> to install the <package>pulseaudio-module-jack</package> package.</para></step>
+ <step><para>Edit the <systemitem>PulseAudio</systemitem> configuration file to use the <systemitem>JACK</systemitem> module.</para>
+ <important>
+ <title>Use Your Text Editor with Caution</title>
+ <para>Follow these steps carefully. We recommend you make a back-up copy of this file, since a mistake may prevent your computer's audio interface from working properly.</para>
+ </important>
<substeps>
- <step><para>Be careful! You will be editing an important system file as the root user!</para></step>
- <step><para>Run the following command in a terminal: <command>sudo -c 'gedit /etc/pulse/default.pa'</command></para></step>
- <step><para>Add the following lines, underneath the line that says [code]#load-module module-alsa-sink[/code]:
+ <step><para>Use a text editor to open <filename>/etc/pulse/default.pa</filename> with superuser privileges. For example, run this command in a terminal window: <command>su -c 'nano /etc/pulse/default.pa'</command></para></step>
+ <step><para>Add this text, under the line with <code>#load-module module-alsa-sink</code>:
<programlisting><![CDATA[
load-module module-jack-sink
load-module module-jack-source
]]></programlisting>
</para></step>
</substeps></step>
- <step><para>Restart <systemitem>PulseAudio</systemitem> by running the following command in a terminal: <command>killall pulseaudio</command> <systemitem>PulseAudio</systemitem> restarts automatically.</para></step>
- <step><para>Confirm that this has worked by opening <application>QjackCtl</application>. The display should confirm that <systemitem>JACK</systemitem> is "Active".</para></step>
- <step><para>In the "Connect" window, on the "Audio" tab, there should be <systemitem>PulseAudio</systemitem> devices on each side, and they should be connected to "system" devices on the opposite sides.</para></step>
- <step><para>Open <application>QjackCtl</application>'s "Setup" window, then click on the "Options" tab. Uncheck "Execute script after Shutdown: killall jackd". If you did not make this change, then <application>QjackCtl</application> would stop the <systemitem>JACK</systemitem> server from running every time the program quits. Since <systemitem>PulseAudio</systemitem> is still expecting to use <systemitem>JACK</systemitem> after that, you shouldn't do this any more.</para></step>
- <step><para>When <systemitem>PulseAudio</systemitem> starts <systemitem>JACK</systemitem>, it uses the command found in the <filename>~/.jackdrc</filename> file. <application>QjackCtl</application> automatically updates this file when you change settings, but you may have to restart both <systemitem>PulseAudio</systemitem> and <systemitem>JACK</systemitem> in order to get the new changes to take effect. If they refuse to take effect, you can edit that file yourself.</para></step>
- <step><para>Be careful about using a very high sample rate with <systemitem>PulseAudio</systemitem>, since it will tend to use a lot of CPU power.</para></step>
+ <step><para>Run this command in a terminal to restart <systemitem>PulseAudio</systemitem>: <command>killall pulseaudio</command> <systemitem>PulseAudio</systemitem> restarts automatically.</para></step>
+ <step><para>Open <application>QjackCtl</application>. The display should state that <systemitem>JACK</systemitem> is "Active."</para></step>
+ <step><para>Open the "Connect" window. On the "Audio" tab, there are <systemitem>PulseAudio</systemitem> devices on each side. Ensure the <systemitem>PulseAudio</systemitem> devices are connected to "system" devices on opposite sides.</para></step>
+ <step><para>Open the <application>QjackCtl</application> "Setup" window, then choose the "Options" tab. Uncheck this option: "Execute script after Shutdown: killall jackd." If you do not make this change, <application>QjackCtl</application> wwill stop the <systemitem>JACK</systemitem> server every time the program quits, even though <systemitem>PulseAudio</systemitem> is still using it.</para></step>
+ <step><para>When <systemitem>PulseAudio</systemitem> starts <systemitem>JACK</systemitem>, it uses the command found in the <filename>~/.jackdrc</filename> file. <application>QjackCtl</application> automatically updates this file when you change settings, but you may have to restart both <systemitem>PulseAudio</systemitem> and <systemitem>JACK</systemitem> for new changes to take effect. You may also edit that file yourself.</para></step>
</procedure>
</section>
</section>