[musicians-guide] Version 15.9.2; fixed bug 670533 and other small things.
crantila
crantila at fedoraproject.org
Sun Jun 26 19:00:32 UTC 2011
commit 46032a95f394a863f209dcab86dfba46ed0d814c
Author: Christopher Antila <crantila at fedoraproject.org>
Date: Sun Jun 26 15:00:19 2011 -0400
Version 15.9.2; fixed bug 670533 and other small things.
en-US/Book_Info.xml | 2 +-
en-US/Qtractor.xml | 39 +++++++++++++++++++----------------
en-US/Revision_History.xml | 21 +++++++++++++++++-
en-US/Rosegarden.xml | 47 +++++++++++++++++++++++++------------------
en-US/Sound_Servers.xml | 6 ++--
5 files changed, 71 insertions(+), 44 deletions(-)
---
diff --git a/en-US/Book_Info.xml b/en-US/Book_Info.xml
index bd6f3be..397ef5d 100644
--- a/en-US/Book_Info.xml
+++ b/en-US/Book_Info.xml
@@ -9,7 +9,7 @@
<!-- Haydn: <subtitle>A guide to Fedora Linux's audio creation and music capabilities, written in a new and special way.</subtitle> -->
<productname>Fedora Draft Documentation</productname>
<pubsnumber>0</pubsnumber> <!-- N.B.: I have no idea why this is here, but the book doesn't work without it -CRA -->
- <edition>15.9.1</edition>
+ <edition>15.9.2</edition>
<abstract>
<para>
diff --git a/en-US/Qtractor.xml b/en-US/Qtractor.xml
index ddaf624..772d270 100644
--- a/en-US/Qtractor.xml
+++ b/en-US/Qtractor.xml
@@ -57,11 +57,27 @@
<section id="sect-Musicians_Guide-Qtractor-Configuration">
<title>Configuration</title>
<para>
- Qtractor will work by itself, without further configuration. The options described here are for the settings you are most likely to want to discuss. Click on 'View > Options' to open the "Options" window.
+ Qtractor works without further configuration. This section describes settings that you may want to change. Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Options</guimenuitem></menuchoice> to open the "Options" window.
</para>
-
+ <section id="sect-Musicians_Guide-Qtractor-Configuration-JACK">
+ <title>Use <application>Qtractor</application> with <systemitem>JACK</systemitem> (<application>QjackCtl</application>)</title>
+ <para>
+ The same developer (Rui Nuno Capela) maintains <application>QjackCtl</application>, <application>Qsynth</application>, and <application>Qtractor</application>. Therefore, we recommend that you use <application>Qtractor</application> with <application>QjackCtl</application> and <application>Qsynth</application>.
+ </para>
+ <para>
+ <application>Qtractor</application> does some of the same things as <application>QjackCtl</application>. For example, <application>Qtractor</application> automatically starts JACK with the same settings as the last time you used <application>QjackCtl</application>. Also, <application>Qtractor</application> remembers the JACK connections that you use with every <application>Qtractor</application> file. If you want to change the JACK settings, you must use <application>QjackCtl</application>.
+ </para>
+ <important>
+ <para>
+ The <application>Qtractor</application> "Connections" window looks similarly to the <application>QjackCtl</application> "Connections" window, but they are not the same. Connections on the "MIDI" tab in <application>Qtractor</application> appear on the "ALSA" tab in <application>QjackCtl</application>. Connections on the "MIDI" tab in <application>QjackCtl</application> are not available in <application>Qtractor</application>.
+ </para>
+ </important>
+ <para>
+ <application>Qtractor</application> does not automatically control <application>Qsynth</application> or <application>FluidSynth</application>.
+ </para>
+ </section>
<section id="sect-Musicians_Guide-Qtractor-Configuration-Audio_Tab">
- <title>Audio Options</title>
+ <title>Change Audio Options</title>
<!-- "Options Window: Audio Tab" -->
<para>
The "Capture/Export" setting allows you to choose the format in which Qtractor stores its audio clips when recorded or exported. You will be able to choose a file type, such as "WAV Microsoft" for standard ".wav" files, "AIFF Apple-SGI" for standard ".aiff" files, or the preferable "FLAC Lossless Audio Codec," format. FLAC is an open-source, lossless, compressed format for storing audio signals and metadata. See the <citetitle>FLAC Website</citetitle> <ulink url="http://flac.sourceforge.net/" /> for more information. You will also be asked to select a quality setting for lossy compressed formats, or a sample format for all lossless formats. If you do not know which sample format to choose, then "Signed 16-Bit" is a good choice for almost all uses, and will provide you with CD-quality audio. Most non-speciality hardware is incapable of making good use of higher sample formats. See <xref linkend="sect-Musicians_Guide-Sample_Rate_and_Sample_Format" /> for more infor
mation about sample formats.
@@ -81,7 +97,7 @@
</para>
</section>
<section id="sect-Musicians_Guide-Qtractor-Configuration-MIDI_Tab">
- <title>MIDI Options</title>
+ <title>Change MIDI Options</title>
<!-- "Options Window: MIDI Tab" -->
<para>
Adjusting the "File format" allows you to change how MIDI clips are stored. You will not need to adjust this unless required by an external application. Refer to <citetitle>Musical Instrument Digital Interface: Standard MIDI (.mid or .smf) (Wikipedia)</citetitle> at <ulink url="http://en.wikipedia.org/wiki/Musical_Instrument_Digital_Interface#Standard_MIDI_.28.mid_or_.smf.29" /> for more information about file types.
@@ -101,7 +117,7 @@
</para>
</section>
<section id="sect-Musicians_Guide-Qtractor-Configuration-MIDI_Channel_Names">
- <title>Configuring MIDI Channel Names</title>
+ <title>Configure MIDI Channel Names</title>
<para>
If you're using "<application>FluidSynth</application>" with QSynth, you should tell Qtractor about the SoundFont that you're using. When you do this, you enable Qtractor to help you choose instruments ("patches").
<orderedlist>
@@ -212,19 +228,6 @@
</para>
</section>
- <section id="sect-Musicians_Guide-Qtractor-Using-JACK">
- <title>Using JACK with Qtractor</title>
- <para>
- Qtractor and QjackCtl are programmed and maintained by the same developers. For this reason, Qtractor offers a QjackCtl-like interface to modify JACK's connections. Furthermore, Qtractor preserves all of the connections with every Qtractor file, so there is no need to use QjackCtl's "patch bay" feature (which does the same thing). However, if you wish to change JACK's settings, you will need to use QjackCtl.
- </para>
- <para>
- To view the JACK connections window within Qtractor, press the F8 key, or click 'View > Connections'. Pressing F8 again will hide the window. Qtractor's "MIDI" tab displays the devices on QjackCtl's "ALSA" tab.
- </para>
- <para>
- Qtractor automatically starts JACK, unless it is already running.
- </para>
- </section>
-
<section id="sect-Musicians_Guide-Qtractor-Using-Exporting_Audio_and_MIDI_Together">
<title>Exporting a Whole File (Audio and MIDI Together)</title>
<para>
diff --git a/en-US/Revision_History.xml b/en-US/Revision_History.xml
index 285c3b6..e97c28e 100644
--- a/en-US/Revision_History.xml
+++ b/en-US/Revision_History.xml
@@ -308,12 +308,29 @@
<revdescription>
<simplelist>
<member>Fixed Bug 670540.</member>
- <member>Revised several other aspects of Chapters 9 (Rosegarden) and 10 (FluidSynth).</member>
+ <member>Revised parts of Chapters 9 (Rosegarden) and 10 (FluidSynth).</member>
<member>Removed period from end of subtitle.</member>
</simplelist>
</revdescription>
</revision>
+ <revision>
+ <revnumber>15.9.2</revnumber>
+ <date>26 June 2011</date>
+ <author>
+ <firstname>Christopher</firstname>
+ <surname>Antila</surname>
+ <email>crantila at fedoraproject.org</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Fixed Bug 670533.</member>
+ <member>Revised parts of Chapter 9 (Rosegarden configuration).</member>
+ <member>Revised parts of Chapter 8 (Qtractor configuration).</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+
<!-- NOTE: When adding a revision above, be sure to update the <edition> tag in "Book_Info.xml" -->
<!-- Fedora 16 (General) -->
@@ -331,7 +348,7 @@
<!-- Fedora 16 (Qthings) -->
<!-- QA: Bug 670540 ("Qsynth's MIDI driver... ") -->
- <!-- TODO: Bug 670533 ("Qtractor chapter needs step-by-step... ") -->
+ <!-- QA: Bug 670533 ("Qtractor chapter needs step-by-step... ") -->
<!-- Low-Priority -->
<!-- TODO: Bug 665662 ("SuperCollider Chapters Are in First Person") -->
diff --git a/en-US/Rosegarden.xml b/en-US/Rosegarden.xml
index 38c9245..df59548 100644
--- a/en-US/Rosegarden.xml
+++ b/en-US/Rosegarden.xml
@@ -37,7 +37,7 @@
<section id="sect-Musicians_Guide-Rosegarden-Installation">
<title>Installation</title>
<para>
- Use <application>PackageKit</application> or <application>KPackageKit</application> to install the <package>rosegarden4</package> packge. Other required software is installed automatically.
+ Use <application>PackageKit</application> or <application>KPackageKit</application> to install the <package>rosegarden4</package> packge. <application>PackageKit</application> automatically installs other required software.
</para>
</section>
</section> <!-- Ends "Requirements and Installation" Section -->
@@ -46,7 +46,10 @@
<title>Configuration</title>
<section id="sect-Musicians_Guide-Rosegarden-Configuration-JACK_and_Qsynth">
- <title>Setup <application>JACK</application> and <application>Qsynth</application></title>
+ <title>Setup <application>JACK</application> and <application>FluidSynth</application> (<application>Qsynth</application>)</title>
+ <para>
+ Follow these instructions to setup <application>JACK</application> and <application>Qsynth</application>. Then follow the instructions in <xref linkend="sect-Musicians_Guide-Rosegarden-Configuration-Rosegarden" /> to connect <application>Rosegarden</application> with <application>JACK</application> and <application>Qsynth</application>.
+ </para>
<procedure>
<step><para>Start <application>QjackCtl</application> to control <application>JACK</application>.</para></step>
<step><para>Start <application>Qsynth</application> to control <application>FluidSynth</application>. <application>FluidSynth</application> starts automatically.</para></step>
@@ -74,7 +77,7 @@
<listitem><para>3:out 2 - General MIDI Device (for the second set of MIDI instruments in the session)</para></listitem>
</itemizedlist>
</para></listitem>
- <listitem><para>If you want <application>Rosegarden</application> to accept commands from other MIDI devices, connect these <application>Rosegarden</application> input ports to the other devices output ports:
+ <listitem><para>If you want <application>Rosegarden</application> to accept commands from other MIDI devices, connect these <application>Rosegarden</application> input ports to the other devices' output ports:
<itemizedlist>
<listitem><para>0:record in</para></listitem>
<listitem><para>2:external controller</para></listitem>
@@ -92,28 +95,32 @@
<section id="sect-Musicians_Guide-Rosegarden-Configuration-Rosegarden">
<title>Setup <application>Rosegarden</application></title>
-
<para>
- <orderedlist>
- <listitem><para>'Edit > Preferences'</para></listitem>
- <listitem><para>Setup "General" as desired.
+ Follow the instructions in <xref linkend="sect-Musicians_Guide-Rosegarden-Configuration-JACK_and_Qsynth" /> to setup <application>JACK</application> and <application>Qsynth</application>. Then follow these instructions to connect <application>Rosegarden</application> with <application>JACK</application> and <application>Qsynth</application>.
+ </para>
+ <procedure>
+ <step><para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from the <application>Rosegarden</application> menu.</para></step>
+ <step><para>Setup "General" as desired:
<itemizedlist>
- <listitem><para>On "Behaviour" tab maybe "Use <application>JACK</application> Transport"</para></listitem>
- <listitem><para>On "Extrenal Applications" tab maybe change those to match what's installed (GNOME users)</para></listitem>
+ <listitem><para>On the "Behaviour" tab. Select "Use <application>JACK</application> Transport" if you want <application>Rosegarden</application> to follow instructions from the transport shown in <application>QjackCtl</application>.</para></listitem>
+ <listitem><para>On the "External Applications" tab. If you are not using <application>KDE</application> then we recommend that you change these applications to match what is installed on your computer.</para></listitem>
</itemizedlist>
- </para></listitem>
- <listitem><para>Setup "MIDI" as desired.
- <itemizedlist><listitem><para>On "MIDI Sync" tab maybe set to "Send MIDI Clock, Start and Stop" if <application>Rosegarden</application> is the ultimate controller, or "Accept Start, Stop and Continue" if it's being controlled. Otherwise "Off" is safe.</para></listitem></itemizedlist>
- </para></listitem>
- <listitem><para>Setup "Audio" as desired.
+ </para></step>
+ <step><para>Setup "MIDI" as desired. For the "MIDI Sync" tab:
<itemizedlist>
- <listitem><para>The preview scale will not affect the audio, just its appearance.</para></listitem>
- <listitem><para>Reducing quality from 32-bit to 16-bit may help low-power systems keep up.</para></listitem>
- <listitem><para>Changing the external audio editor only affects when you choose to use an extrenal editor.</para></listitem>
+ <listitem><para>Choose "Send MIDI Clock, Start and Stop" if <application>Rosegarden</application> controls all other MIDI devices.</para></listitem>
+ <listitem><para>Choose "Accept Start, Stop and Continue" if <application>Rosegarden</application> accepts control signals from other MIDI devices.</para></listitem>
+ <listitem><para>Choose "Off" if you do not understand which option to choose.</para></listitem>
</itemizedlist>
- </para></listitem>
- </orderedlist>
- </para>
+ </para></step>
+ <step><para>Setup "Audio" as desired:
+ <itemizedlist>
+ <listitem><para>The preview scale changes the way <application>Rosegarden</application> looks, but not how the audio sounds.</para></listitem>
+ <listitem><para>If <application>Rosegarden</application> performs slowly on your computer, reduce quality from 32-bit to 16-bit. We do not recommend using 16-bit quality unless you need it, because you will have lower-quality audio.</para></listitem>
+ <listitem><para>Choose a different external editor if you do not want to use the default choice (<application>Audacity</application>).</para></listitem>
+ </itemizedlist>
+ </para></step>
+ </procedure>
</section>
</section> <!-- Ends "Configuration" Section --> <!-- <application>Rosegarden</application>-Configuration- -->
diff --git a/en-US/Sound_Servers.xml b/en-US/Sound_Servers.xml
index ff1f366..af59a1b 100644
--- a/en-US/Sound_Servers.xml
+++ b/en-US/Sound_Servers.xml
@@ -53,7 +53,7 @@
<section id="sect-Musicians_Guide-Using_JACK">
<title>Using the <systemitem>JACK</systemitem> Audio Connection Kit</title>
<section id="sect-Musicians_Guide-Install_and_Configure_JACK">
- <title>Installing and Configuring <systemitem>JACK</systemitem></title>
+ <title>Install and Configure <systemitem>JACK</systemitem></title>
<procedure>
<step><para>Use <application>PackageKit</application> or <application>KPackageKit</application> to install the <package>jack-audio-connection-kit</package> and <package>qjackctl</package> packages.</para></step>
<step><para>Review and approve the installation, making sure that it completes correctly.</para></step>
@@ -68,14 +68,14 @@
<systemitem>JACK</systemitem> operates with special real-time privileges. You must add all users to the <systemitem>jackuser</systemitem> and <systemitem>pulse-rt</systemitem> groups so they can use <systemitem>JACK</systemitem>. For instructions to add users to groups, see Chapter 22, <citetitle>Users and Groups</citetitle> of the <citetitle>Fedora Deployment Guide</citetitle>, available at <ulink url="http://docs.fedoraproject.org" />. Do not add users to these groups if they will not use <systemitem>JACK</systemitem>.
</para>
</important>
- <para> <!-- Modified by CRA for Bug 670520 -->
+ <para>
By default, <application>QjackCtl</application> configures <systemitem>JACK</systemitem> to use the 'default' sound card. The 'default' sound card uses all features of the <systemitem>ALSA</systemitem> driver, even though <systemitem>JACK</systemitem> provides the same features. To save memory and processor time, you should configure <application>QjackCtl</application> with a specific sound card.
</para>
<!-- Part of this procedure appears in the Audacity chapter. Keep them in sync. -->
<procedure>
<step><para>Open a terminal. In GNOME, choose <menuchoice><guimenu>Applications</guimenu> <guisubmenu>System</guisubmenu> <guimenuitem>Terminal</guimenuitem></menuchoice>. In KDE, click on the application launcher, then choose <menuchoice><guimenu>System</guimenu> <guimenuitem>Konsole</guimenuitem></menuchoice>.</para></step>
<step><para>Execute this command: <command>cat /proc/asound/cards</command></para></step>
- <step><para>The <application>cat</application> program outputs a list of sound cards in your computer, which looks similar to this list:
+ <step><para>The <application>cat</application> program outputs a list of sound cards in your computer that looks similarly to this:
<programlisting><![CDATA[
0 [SB ]: HDA-Intel - HDA ATI SB
HDA ATI SB at 0xf7ff4000 irq 16
More information about the docs-commits
mailing list