[musicians-guide: 3/3] Update Audacity and Qtractor and .gitignore

Christopher Antila crantila at fedoraproject.org
Mon Sep 3 18:14:24 UTC 2012


commit 010b0ebc3802ac2a3104223fd1dcfaef5c99cff1
Author: Christopher Antila <crantila at fedoraproject.org>
Date:   Mon Sep 3 14:13:43 2012 -0400

    Update Audacity and Qtractor and .gitignore
    
    For Audacity and Qtractor, I:
    - improved section headings
    - removed third-party repository instructions where unnecessary
    - improved tagging of <application>
    
    And I did something, probably months ago, to .gitignore

 .gitignore         |    1 +
 en-US/Audacity.xml |   68 ++++++++++++++++----------------------------
 en-US/Qtractor.xml |   80 +++++++++++++++++++++++++++------------------------
 3 files changed, 68 insertions(+), 81 deletions(-)
---
diff --git a/.gitignore b/.gitignore
index 2e02fe8..7a0c25d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,3 +2,4 @@
 tmp/*
 publish/*
 */.directory
+.directory
diff --git a/en-US/Audacity.xml b/en-US/Audacity.xml
index dea301d..4014c61 100644
--- a/en-US/Audacity.xml
+++ b/en-US/Audacity.xml
@@ -7,11 +7,11 @@
 <chapter id="chap-Musicians_Guide-Audacity">
 	<title>Audacity</title>
 	<para>
-		Audacity is a high-quality sound recording application, designed to be easy to use.  We recommend Audacity to most computer users, because it is simple but it has many features and capabilities.  You do not need to understand advanced computer audio concepts before using Audacity.  If you can connect your microphone to your computer, you know enough to use Audacity.
+		Audacity is a high-quality sound recording application, designed to be easy to use.  We recommend Audacity to most computer users, because it is simple but it has many features and capabilities.  You do not need to understand advanced computer audio concepts before using <application>Audacity</application>.  If you can connect your microphone to your computer, you know enough to use Audacity.
 	</para>
 	
 	<section id="sect-Musicians_Guide-Audacity-Knowing_When_to_Use">
-		<title>Knowing When to Use Audacity</title>
+		<title>Learn When to Use Audacity</title>
 		<!-- this is basically a re-casting of "sect-Musicians_Guide-Knowing_Which_DAW_to_Use" in "Digital_Audio_Workstations.xml" -->
 		<para>
 			Audacity has a simple user interface, it is easy to use, and it has many advanced capabilities.  Audacity does not require advanced knowledge of computers, music, or recording.  Audacity is the right tool to use for editing a single audio file, and it can also coordinate multiple audio files simultaneously.  Most users will prefer Audacity over the other applications in the Musicians' Guide which can record.
@@ -25,7 +25,7 @@
 	</section>
 	
 	<section id="sect-Musicians_Guide-Audacity-Requirements_and_Installation">
-		<title>Requirements and Installation</title>
+		<title>View Requirements and Install</title>
 		
 		<section id="sect-Musicians_Guide-Audacity-Software_Requirements">
 			<title>Software Requirements</title>
@@ -33,51 +33,33 @@
 				Audacity uses several "libraries."  Libraries are incomplete programs that add capabilities to other programs or applications.  Libraries can be shared between programs.  The libraries needed by Audacity will be installed automatically.
 			</para>
 			<para>
-				The version of Audacity from the &O_S; repository does not use an MP3 library.  If you do not want to use MP3 files with Audacity, you should follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Installation" />.  If you want to use MP3 files with Audacity, you should follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Installation_with_RPM_Fusion" />.
+				The version of Audacity from the &O_S; repository does not use an MP3 library.  If you do not want to use MP3 files with <application>Audacity</application>, you should follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Installation" />.  If you want to use MP3 files with <application>Audacity</application>, you should follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Installation_with_RPM_Fusion" />.
 			</para>
 			<para>
-				Audacity can use the JACK Audio Connection Kit.  You should install JACK before installing Audacity.  Follow the instructions in <xref linkend="sect-Musicians_Guide-Install_and_Configure_JACK" /> to install JACK.  We recommend using Audacity without JACK, but JACK is installed whether or not you use it.
+				Audacity can use the JACK Audio Connection Kit.  You should install JACK before installing <application>Audacity</application>.  Follow the instructions in <xref linkend="sect-Musicians_Guide-Install_and_Configure_JACK" /> to install JACK.  We recommend using Audacity without JACK, but JACK is installed whether or not you use it.
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Audacity-Hardware_Requirements">
 			<title>Hardware Requirements</title>
 			<para>
-				You need an audio interface to use Audacity.  If you will record audio with Audacity, you must have at least one microphone connected to your audio interface.  You do not need a microphone to edit existing audio files.
+				You need an audio interface to use <application>Audacity</application>.  If you will record audio with <application>Audacity</application>, you must have at least one microphone connected to your audio interface.  You do not need a microphone to edit existing audio files.
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Audacity-Installation">
-			<title>Standard Installation</title>
+			<title>Install</title>
 			
 			<procedure>
 				<para>
-					This method installs Audacity from the &O_S; repository.  This version of Audacity does not use an MP3 library, and cannot process MP3 files.
+					Follow these instructions to install <application>Audacity</application> from the &O_S; repository. This version of <application>Audacity</application> does not use an MP3 library, and cannot process MP3 files. Third-party software repositories offer <application>Audacity</application> with MP3 support.
 				</para>
-				<step><para>Use PackageKit or Apper to install the <package>audacity</package> package.</para></step>
-				<step><para>The proposed installation includes Audacity and all of the libraries that Audacity uses.  Continue installing Audacity by reviewing and approving the proposed installation.</para></step>
-				<step><para>Audacity configures itself automatically, but it may not use the configuration you want.  You need to test Audacity before recording, so that you know that it works.  Follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Testing_Playback" /> and <xref linkend="sect-Musicians_Guide-Audacity-Testing_Recording" /> to test Audacity.</para></step>
+				<step><para>Use <application>PackageKit</application> or <application>Apper</application> to install the <package>audacity</package> package.</para></step>
+				<step><para>The proposed installation includes <application>Audacity</application> and all of the libraries that <application>Audacity</application> uses. Review the packages you must install, then continue to install <application>Audacity</application>.</para></step>
+				<step><para>Audacity configures itself automatically, but it may not use the configuration you want. We recommend you test <application>Audacity</application> before you record, so you know whether <application>Audacity</application> works. Follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Testing_Playback" /> and <xref linkend="sect-Musicians_Guide-Audacity-Testing_Recording" /> to test <application>Audacity</application>.</para></step>
 			</procedure>
 			
 		</section>
-		<section id="sect-Musicians_Guide-Audacity-Installation_with_RPM_Fusion">
-			<title>Installation with MP3 Support</title>
-			<procedure>
-				<para>
-					This method installs Audacity from the RPM Fusion repository.  This version of Audacity uses an MP3 library, and can process MP3 files. &O_S; cannot provide support for this version of Audacity because it is not prepared by &O_S;.
-				</para>
-				<step><para>Run this command in a terminal: </para>
-<screen><command>su -c 'yum localinstall --nogpgcheck http://download1.rpmfusion.org/free/fedora/\</command>
-<command>rpmfusion-free-release-stable.noarch.rpmhttp://download1.rpmfusion.org/nonfree/\</command>
-<command>fedora/rpmfusion-nonfree-release-stable.noarch.rpm'</command></screen>
-				<para>
-					Note that this a single command, broken into three lines here for presentation reasons.
-				</para></step>
-				<step><para>Use PackageKit or Apper to install the <code>audacity-freeworld</code> package.</para></step>
-				<step><para>The proposed installation includes Audacity and all of the libraries that Audacity uses.  Continue installing Audacity by reviewing and approving the proposed installation.</para></step>
-				<step><para>Audacity configures itself automatically, but it may not use the configuration you want.  You need to test Audacity before recording, so that you know that it works.  Follow the instructions in <xref linkend="sect-Musicians_Guide-Audacity-Testing_Playback" /> and <xref linkend="sect-Musicians_Guide-Audacity-Testing_Recording" /> to test Audacity.</para></step>
-			</procedure>
-		</section>
 		<section id="sect-Musicians_Guide-Audacity-Testing_Playback">
-			<title>Post-Installation Test: Playback</title>
+			<title>Post-Install Test: Playback</title>
 			<procedure>
 				<step><para>Start Audacity.</para></step>
 				<step><para>Set the volume of your audio interface and speakers to a safe level.</para></step>
@@ -89,10 +71,10 @@
 			</procedure>
 		</section>
 		<section id="sect-Musicians_Guide-Audacity-Testing_Recording">
-			<title>Post-Installation Test: Recording</title>
+			<title>Post-Install Test: Record</title>
 			<procedure>
 				<step><para>Connect your microphones to your audio interface.</para></step>
-				<step><para>Start Audacity.  Do not open a file.</para></step>
+				<step><para>Start <application>Audacity</application>.  Do not open a file.</para></step>
 				<step><para>Locate the volume level meters on the toolbar, to the right of the transport controls.  If you do not see the meters, choose <menuchoice><guimenu>View</guimenu><guisubmenu>Toolbars</guisubmenu><guimenuitem>Meter Toolbar</guimenuitem></menuchoice>, which should have a check mark next to it.</para></step>
 				<step><para>Click on the arrow next to the microphone to open the input meter's pop-up menu.  Choose <menuchoice><guimenuitem>Start Monitoring</guimenuitem></menuchoice>.</para></step>
 				<step><para>Sing, talk, or make noise into the microphone.  The volume level meter should show moving red bars.</para></step>
@@ -112,13 +94,13 @@
 		<title>Configuration</title>
 		
 		<section id="sect-Musicians_Guide-Audacity-First_Use">
-			<title>When You Run Audacity for the First Time</title>
+			<title>Run Audacity for the First Time</title>
 			<para>
-				When you run Audacity for the first time, you will be asked to select a language to use for the interface.  Before you use Audacity, we encourage you to follow the post-installation test instructions above.
+				When you run Audacity for the first time, you will be asked to select a language to use for the interface.  Before you use <application>Audacity</application>, we encourage you to follow the post-installation test instructions above.
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Audacity-Configure_to_Use_Your_Hardware">
-			<title>Configuring Audacity for Your Sound Card</title>
+			<title>Configure Audacity for Your Sound Card</title>
 			<para>
 				Audacity configures itself automatically.  If your computer has multiple sound cards or your sound cards have an unusual setup, Audacity guesses which input and output you will use.  Audacity sometimes guesses incorrectly, so you can configure it yourself.
 			</para>
@@ -153,7 +135,7 @@
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Audacity-Setting_Sample_Rate_and_Format">
-			<title>Setting the Project's Sample Rate and Format</title>
+			<title>Set the Project's Sample Rate and Format</title>
 			<para>
 				You can change the sample rate and sample format (see <xref linkend="sect-Musicians_Guide-Sample_Rate_and_Sample_Format" /> for definitions).  You should set the sample rate and sample format when you begin working on a project.  You should not change the sample rate or sample format after you record audio.  If you will use audio files that already exist, you should use the sample rate and sample format of the existing files.
 			</para>
@@ -166,7 +148,7 @@
 	</section>
 	
 	<section id="sect-Musicians_Guide-Audacity-Interface">
-		<title>The Interface</title>
+		<title>Learn the Audacity Interface</title>
 		<!-- [[File:FMG-Audacity-Interface.xcf]] -->
 		<figure id="audacity_interface"><title>The Audacity interface</title>
 			<mediaobject>
@@ -202,7 +184,7 @@
 				<caption>
 					<orderedlist>
 						<listitem><para>Each track has a <firstterm>track info area</firstterm>, which holds settings like the fader, panner, and <guibutton>mute</guibutton> and <guibutton>solo</guibutton> buttons.</para></listitem>
-						<listitem><para>The <firstterm>timeline</firstterm> is the main area of the main window of Audacity.  The leftmost point is the beginning of the audio file.</para></listitem>
+						<listitem><para>The <firstterm>timeline</firstterm> is the main area of the main window of <application>Audacity</application>.  The leftmost point is the beginning of the audio file.</para></listitem>
 					</orderedlist>
 				</caption>
 			</mediaobject>
@@ -214,7 +196,7 @@
 			<listitem><para>The "tool-selection box" changes the cursor's function.</para></listitem>
 			<listitem><para>The two "volume level meters" display the volume level of stereo audio.  The left meter displays the volume level of the output signal.  The right meter displays the volume level of the input signal.</para></listitem>
 			<listitem><para>The "ruler" displays the time since the start of the file, in minutes and seconds.</para></listitem>
-			<listitem><para>The "timeline" is the main area of the main window of Audacity.  The leftmost point is the beginning of the audio file.</para></listitem>
+			<listitem><para>The "timeline" is the main area of the main window of <application>Audacity</application>.  The leftmost point is the beginning of the audio file.</para></listitem>
 			<listitem><para>Each "track" contains two channels of audio signal data.  Audacity stacks tracks vertically in the main window.  Audacity plays back all tracks simultaneously.</para></listitem>
 			<listitem><para>Each track has a "track info area," which holds settings like the fader, panner, and <guibutton>mute</guibutton> and <guibutton>solo</guibutton> buttons.</para></listitem>
 			</itemizedlist>
@@ -225,7 +207,7 @@
 	</section>
 	
 	<section id="sect-Musicians_Guide-Audacity-Recording">
-		<title>Recording</title>
+		<title>Record</title>
 		<para>
 			This section explains possible ways to use Audacity to record.
 		</para>
@@ -274,7 +256,7 @@
 	</section>
 	
 	<section id="sect-Musicians_Guide-Audacity-Tutorial">
-		<title>Creating a New Login Sound (Tutorial)</title>
+		<title>Create a New Login Sound (Tutorial)</title>
 		
 		<section id="sect-Musicians_Guide-Audacity-Tutorial-Files">
 			<title>Files for the Tutorial</title>
@@ -315,7 +297,7 @@
 		</section>
 		
 		<section id="sect-Musicians_Guide-Audacity-Tutorial-Stretching_Tracks">
-			<title>Stretching Tracks</title>
+			<title>Stretch Tracks</title>
 			<!-- Audacity-2 -->
 			<para>
 				You can stretch or compress tracks, so that they take up more or less time.
@@ -400,7 +382,7 @@
 		</section>
 		
 		<section id="sect-Musicians_Guide-Audacity-Tutorial-Repeating_a_Segment">
-			<title>Repeat an Already-Recorded Segment</title>
+			<title>Repeat a Previously-Recorded Segment</title>
 			<!-- Audacity-5 -->
 			<para>
 				You can repeat a segment of audio that is already recorded.
diff --git a/en-US/Qtractor.xml b/en-US/Qtractor.xml
index bf74db5..f1eb1c5 100644
--- a/en-US/Qtractor.xml
+++ b/en-US/Qtractor.xml
@@ -7,22 +7,22 @@
 <chapter id="chap-Musicians_Guide-Qtractor">
 	<title>Qtractor</title>
 	<para>
-		Qtractor is a relatively new application, created and maintained by the same developers who are responsible for QjackCtl and Qsynth (both covered in other chapters of this Guide).  It offers much more flexibility than Audacity, but is still easier to use than Ardour or Rosegarden.  As such, it serves as the perfect starting-point for people first discovering software-based DAWs.
+		<application>Qtractor</application> is a relatively new application, created and maintained by the same developers who are responsible for <application>QjackCtl</application> and <application>Qsynth</application> (both covered in other chapters of this Guide). It offers much more flexibility than <application>Audacity</application>, but is still easier to use than <application>Ardour</application> or <application>Rosegarden</application>. We therefore recommend <application>Qtractor</application> for users who are new to software-based DAWs.
 	</para>
 	<para>
-		But Qtractor is much more than just a starting-point: its simplicity is its greatest strength.  Ardour and Rosegarden, may offer more features, but Qtractor takes much less time to learn.  After the initial learning-curve, you will be able to complete almost every audio or MIDI project with Qtractor.  Its interface offers simple, intuitive, point-and-click interaction with clips, integrated control of JACK connections, MIDI control integration with external devices and other MIDI-aware software, and support for LADSPA, DSSI, native VSTi, and LV2 plug-ins.  With development progressing very quickly, Qtractor is becoming more stable and usable by the minute.  The simple interface allows you to focus on creating music to suit your creative needs.
+		<application>Qtractor</application> is easy to use, but also very powerful. Simplicity is what makes <application>Qtractor</application> useful. After the initial learning curve, you will be able to complete almost every audio or MIDI project with <application>Qtractor</application>. The <application>Qtractor</application> interface offers simple, intuitive, point-and-click interaction with clips, integrated control of JACK connections, MIDI control integration with external devices and other MIDI-aware software, and support for LADSPA, DSSI, native VSTi, and LV2 plug-ins.
 	</para>
 	<para>
-		Beginners and advanced users alike will be pleased to see how Qtractor can work for them.
+		Beginners and advanced users alike will enjoy <application>Qtractor</application>.
 	</para>
 	
 	<section id="sect-Musicians_Guide-Qtractor-Requirements_and_Installation">
-		<title>Requirements and Installation</title>
+		<title>View Requirements and Install</title>
 		
 		<section id="sect-Musicians_Guide-Qtractor-Knowledge_Requirements">
 			<title>Knowledge Requirements</title>
 			<para>
-				Qtractor is easy to use, and its user interface is similar to other DAWs.  We recommend that you read <xref linkend="sect-Musicians_Guide-DAW_User_Interface" /> if you have not used a DAW before.
+				<application>Qtractor</application> is easy to use, and has a similar user interface to other DAWs. We recommend you read <xref linkend="sect-Musicians_Guide-DAW_User_Interface" /> if you have not used a DAW before.
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Software_Requirements">
@@ -40,36 +40,39 @@
 		<section id="sect-Musicians_Guide-Qtractor-Other_Requirements">
 			<title>Other Requirements</title>
 			<para>
-				You need a MIDI synthesizer to use Qtractor as a MIDI sequencer.  You can use hardware-based and software-based synthesizers with Qtractor.  We recommend using the software-based <application>FluidSynth</application> MIDI synthesizer.  See <xref linkend="chap-Musicians_Guide-FluidSynth" /> for information about <application>FluidSynth</application>.
+				You need a MIDI synthesizer to use <application>Qtractor</application> as a MIDI sequencer.  You can use hardware-based and software-based synthesizers with Qtractor.  We recommend using the software-based <application>FluidSynth</application> MIDI synthesizer.  See <xref linkend="chap-Musicians_Guide-FluidSynth" /> for information about <application>FluidSynth</application>.
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Installation">
-			<title>Installation</title>
-			<para>
-				Qtractor is not available from the &O_S; software repositories.  Qtractor is available from the "Planet CCRMA at Home" and "RPM Fusion" repositories.  If you have already enabled one of those repositories, you should install Qtractor from that repository.  If you have not already enabled one of those repositories, we recommend that you install Qtractor from the "Planet CCRMA at Home" repository.  See <xref linkend="sect-Musicians_Guide-CCRMA_Installing_Repository" /> for instructions to enable the "Planet CCRMA at Home" repository.  The "Planet CCRMA at Home" repository contains a wide variety of music and audio applications.
-			</para>
-			<para>
-				After you enable the "RPM Fusion" or "Planet CCRMA at Home" repository, use PackageKit or Apper to install the "qtractor" packge.  Other required software is installed automatically.
-			</para>
+			<title>Install</title>
+			
+			<procedure>
+				<para>
+					Follow these instructions to install <application>Qtractor</application> from the &O_S; repository. This version of <application>Qtractor</application> does not use an MP3 library, and cannot process MP3 files. Third-party software repositories offer <application>Qtractor</application> with MP3 support.
+				</para>
+				<step><para>Use <application>PackageKit</application> or <application>Apper</application> to install the <package>qtractor</package> package.</para></step>
+				<step><para>The proposed installation includes <application>Qtractor</application> and all of the libraries that <application>Qtractor</application> uses. Review the packages you must install, then continue to install <application>Qtractor</application>.</para></step>
+				<step><para><application>Qtractor</application> configures itself automatically, but it may not use the configuration you want. We recommend you test <application>Qtractor</application> before you record, so you know whether <application>Qtractor</application> works.</para></step>
+			</procedure>
 		</section>
 	</section>
 	
 	<section id="sect-Musicians_Guide-Qtractor-Configuration">
-		<title>Configuration</title>
+		<title>Configure Qtractor</title>
 		<para>
 			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>.
+				The same developer (Rui Nuno Capela) maintains <application>QjackCtl</application>, <application>Qsynth</application>, and <application>Qtractor</application>. Therefore, we recommend 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>.
+					The <application>Qtractor</application> "Connections" window looks like 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>
@@ -80,7 +83,8 @@
 			<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.
+				The "Capture/Export" setting allows you to choose the format in which <application>Qtractor</application> 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_Sampl
 e_Format" /> for more information 
+about sample formats.
 			</para>
 			<para>
 				Setting the "Transport mode" will allow you to adjust the behaviour of the transport.
@@ -90,7 +94,7 @@
 				<listitem><para>Master : allows Qtractor's transport to send instructions to JACK's transport, which can be viewed by QjackCtl, or used by another application.</para></listitem>
 				<listitem><para>Full : is equivalent to "Master" and "Slave" modes simultaneously; Qtractor's transport will both send and accept instructions.</para></listitem>
 				</itemizedlist>
-				If you are using Qtractor alone, or if you don't know which to choose, then "None" is a good choice.  This setting can be adjusted at any time, if you later decide to link the transport in multiple applications.
+				If you are using <application>Qtractor</application> alone, or if you don't know which to choose, then "None" is a good choice.  This setting can be adjusted at any time, if you later decide to link the transport in multiple applications.
 			</para>
 			<para>
 				The "Metronome" section allows you to use a (short) audio file as the metronome sound, rather than the standard, MIDI-based metronome.  You can choose the same file for "beat," and "bar," if you prefer.  The "Dedicated audio metronome outputs" option outputs the audio metronome's signal through separate outputs in JACK.  This is Ardour's default behaviour.
@@ -105,12 +109,12 @@
 			<para>
 				"MMC" stands for "MIDI Machine Control," and it allows multiple MIDI-connected devices to interact and control each other.  Setting the "Transport mode" to a setting other than "None" allows it be controlled by MMC messages.
 				<itemizedlist>
-				<listitem><para>None : will have Qtractor ignore incoming MMC messages, and not provide outgoing MMC messages</para></listitem>
-				<listitem><para>Input : will have Qtractor follow incoming MMC instructions, but not provide outgoing MMC messages</para></listitem>
-				<listitem><para>Output : will have Qtractor ignore incoming MMS messages, but provide outgoing MMC messages</para></listitem>
-				<listitem><para>Duplex : will have Qtractor follow incoming MMC instructions, and provide outgoing MMC messages</para></listitem>
+				<listitem><para>None : will have <application>Qtractor</application> ignore incoming MMC messages, and not provide outgoing MMC messages</para></listitem>
+				<listitem><para>Input : will have <application>Qtractor</application> follow incoming MMC instructions, but not provide outgoing MMC messages</para></listitem>
+				<listitem><para>Output : will have <application>Qtractor</application> ignore incoming MMS messages, but provide outgoing MMC messages</para></listitem>
+				<listitem><para>Duplex : will have <application>Qtractor</application> follow incoming MMC instructions, and provide outgoing MMC messages</para></listitem>
 				</itemizedlist>
-				You can also select a particular MIDI device number with which Qtractor will interact; if you do this, it will ignore MMC messages from other devices, and not send MMC messages to other devices.  Enabled the "Dedicated MIDI control input/output" will provide JACK with MIDI inputs and outputs that will be used by Qtractor only for MMC messages.  Qtractor will not send or receive MMC messages sent on other inputs or outputs if this option is enabled.  "SPP" stands for "Song Position Pointer," and helps MIDI-connected applications to keep track of the current location in a session (in other words, where the transport is).  This should probably be set to the same setting as "MMC."  If you don't know which of these settings to use, then setting "MMC" to "None" is a good choice.  This setting can be adjusted at any time, if you later decide to link applications with MMC messages.
+				You can also select a particular MIDI device number with which <application>Qtractor</application> will interact; if you do this, it will ignore MMC messages from other devices, and not send MMC messages to other devices.  Enabled the "Dedicated MIDI control input/output" will provide JACK with MIDI inputs and outputs that will be used by <application>Qtractor</application> only for MMC messages.  <application>Qtractor</application> will not send or receive MMC messages sent on other inputs or outputs if this option is enabled.  "SPP" stands for "Song Position Pointer," and helps MIDI-connected applications to keep track of the current location in a session (in other words, where the transport is).  This should probably be set to the same setting as "MMC."  If you don't know which of these settings to use, then setting "MMC" to "None" is a good choice.  This setting can be adjusted at any time, if you later decide to link applications with MMC messages.
 			</para>
 			<para>
 				The default metronome sound is provided by the "MIDI Metronome," and you can adjust its settings here.  In particular, you may wish to provide a "Dedicated MIDI metronome output," to help you separate the metronome's signal.
@@ -119,13 +123,13 @@
 		<section id="sect-Musicians_Guide-Qtractor-Configuration-MIDI_Channel_Names">
 			<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").
+				If you're using "<application>FluidSynth</application>" with QSynth, you should tell <application>Qtractor</application> about the SoundFont that you're using.  When you do this, you enable <application>Qtractor</application> to help you choose instruments ("patches").
 				<orderedlist>
 				<listitem><para>Click on 'View > Instruments'</para></listitem>
 				<listitem><para>In the "Instruments" window, click "Import."</para></listitem>
 				<listitem><para>Navigate to <filename>/usr/share/soundfonts</filename></para></listitem>
 				<listitem><para>Select the SoundFonts that you would like to use.  The default is the FluidR3 GM SoundFont, but you can choose multiple SoundFonts to use simultaneously.</para></listitem>
-				<listitem><para>Close the "Instruments" window to return to the main Qtractor window.</para></listitem>
+				<listitem><para>Close the "Instruments" window to return to the main <application>Qtractor</application> window.</para></listitem>
 				</orderedlist>
 			</para>
 		</section>
@@ -134,13 +138,13 @@
 	<section id="sect-Musicians_Guide-Qtractor-Using">
 		<title>Use Qtractor</title>
 		<para>
-			The "Tutorial" section teaches you how to use Qtractor by example. This section is designed to serve as a reference while you complete the tutorial, and for refreshing your memory afterwards.
+			The "Tutorial" section teaches you how to use <application>Qtractor</application> by example. This section is designed to serve as a reference while you complete the tutorial, and for refreshing your memory afterwards.
 		</para>
 		
 		<section id="sect-Musicians_Guide-Qtractor-Using-Blue_Place_Markers">
-			<title>Using the Blue Place-Markers</title>
+			<title>Use the Blue Place-Markers</title>
 			<para>
-				In addition to the transport, Qtractor provides two other place-markers.  They are blue.  Here are some things you can do with the blue place-markers:
+				In addition to the transport, <application>Qtractor</application> provides two other place-markers.  They are blue.  Here are some things you can do with the blue place-markers:
 				<itemizedlist>
 				<listitem><para>* Mark a range:
 					<orderedlist>
@@ -231,16 +235,16 @@
 		<section id="sect-Musicians_Guide-Qtractor-Using-Exporting_Audio_and_MIDI_Together">
 			<title>Export a Whole File (Audio and MIDI Together)</title>
 			<para>
-				Qtractor can export all of a session's audio clips as one audio file, but it cannot export the MIDI clips directly into that audio file.  This is because Qtractor does not synthesize audio from MIDI signals, but uses an external MIDI synthesizer to do this.  Thankfully, there is a relatively simple way to overcome this, allowing both audio and MIDI to be exported in the same audio file: use Qtractor to record the audio signal produced by the MIDI synthesizer.  This procedure only works if you use a MIDI synthesizer (like <application>FluidSynth</application>) which outputs its audio signal to JACK.
+				Qtractor can export all of a session's audio clips as one audio file, but it cannot export the MIDI clips directly into that audio file.  This is because <application>Qtractor</application> does not synthesize audio from MIDI signals, but uses an external MIDI synthesizer to do this.  Thankfully, there is a relatively simple way to overcome this, allowing both audio and MIDI to be exported in the same audio file: use <application>Qtractor</application> to record the audio signal produced by the MIDI synthesizer.  This procedure only works if you use a MIDI synthesizer (like <application>FluidSynth</application>) which outputs its audio signal to JACK.
 				<orderedlist>
-				<listitem><para>Create a new audio track in Qtractor by clicking on 'Track > Add Track'.</para></listitem>
+				<listitem><para>Create a new audio track in <application>Qtractor</application> by clicking on 'Track > Add Track'.</para></listitem>
 				<listitem><para>Ensure that your MIDI synthesizer is set up correctly to produce output in the usual method (through your speakers).</para></listitem>
 				<listitem><para>Use Qtractor's "Connections" window (press F8 on the keyboard) to ensure that the output from your MIDI synthesizer is routed to the input for the newly-created audio track.</para></listitem>
 				<listitem><para>Move Qtractor's transport to the start of the session.</para></listitem>
 				<listitem><para>Ensure that only the newly-created audio track is armed for recording.</para></listitem>
 				<listitem><para>Arm Qtractor's transport for recording.</para></listitem>
 				<listitem><para>Press "Play" on the transport, and wait as the session plays through.</para></listitem>
-				<listitem><para>When you have reached the end of the session, stop the transport.  Qtractor will not automatically stop the transport.</para></listitem>
+				<listitem><para>When you have reached the end of the session, stop the transport.  <application>Qtractor</application> will not automatically stop the transport.</para></listitem>
 				<listitem><para>Export the file as you normally would by clicking 'Track > Export Tracks > Audio'.</para></listitem>
 				</orderedlist>
 			</para>
@@ -255,7 +259,7 @@
 				If you wish to scroll horizontally in Qtractor's tracks pane or the matrix editor, hold down the Control (Ctrl) key as you adjust your mouse's scrollwheel.
 			</para>
 			<para>
-				Qtractor files should be saved in an otherwise-empty folder.  Unlike Ardour, Audacity, and Rosegarden, Qtractor will not create a new sub-folder automatically, but will instead store all of a session's clips in the same folder as the the Qtractor file itself.
+				Qtractor files should be saved in an otherwise-empty folder.  Unlike Ardour, Audacity, and Rosegarden, <application>Qtractor</application> will not create a new sub-folder automatically, but will instead store all of a session's clips in the same folder as the the <application>Qtractor</application> file itself.
 			</para>
 			<section id="sect-Musicians_Guide-Qtractor-Using-Tips-Transport">
 				<title>Transport</title>
@@ -311,7 +315,7 @@ You can import <application>LilyPond</application> MIDI output in <application>Q
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Requirements">
-			<title>Files for the Tutorial</title>
+			<title>Get Files for the Tutorial</title>
 			<para>
 				<itemizedlist>
 					<listitem>
@@ -387,9 +391,9 @@ You can import <application>LilyPond</application> MIDI output in <application>Q
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Marking_the_First_Formal_Area">
-			<title>Marking the First Formal Area</title>
+			<title>Mark the First Formal Area</title>
 			<para>
-				In addition to the transport, Qtractor has two blue place-markers, which sometimes merge into one.  The best way to learn the behaviour of the blue place-markers is by using them.  They are intended to mark a range in the work area ("main screen").
+				In addition to the transport, <application>Qtractor</application> has two blue place-markers, which sometimes merge into one.  The best way to learn the behaviour of the blue place-markers is by using them.  They are intended to mark a range in the work area ("main screen").
 			</para>
 			<para>
 				<orderedlist>
@@ -403,7 +407,7 @@ You can import <application>LilyPond</application> MIDI output in <application>Q
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Creating_our_Theme">
-			<title>Creating our Theme</title>
+			<title>Create a Theme</title>
 			<para>
 				I want something simple, to match the simple-sounding chorale at the beginning that is the theme of this movement.  What could be simpler than a moment of sound, followed by some moments of silence?
 			</para>
@@ -415,7 +419,7 @@ You can import <application>LilyPond</application> MIDI output in <application>Q
 					<listitem><para>Click the pencil where you want the note to appear.  A box will appear.  If you drag the box to the right, then the note will sound for longer.</para></listitem>
 					<listitem><para>I put all of the notes on the same pitch, but it doesn't matter whether you put them on the same pitches or not - they will be changed later.</para></listitem>
 					<listitem><para>I also made a mistake when I was inputting the notes, so there's one place where they are only two beats apart instead of three.  This didn't matter to me, but it might matter to you.</para></listitem>
-					<listitem><para>Continue inputting notes until you have filled the whole pre-selected region (between the blue markers).  Qtractor will let you continue beyond that point, so you need to keep an eye on the marker yourself.</para></listitem>
+					<listitem><para>Continue inputting notes until you have filled the whole pre-selected region (between the blue markers).  <application>Qtractor</application> will let you continue beyond that point, so you need to keep an eye on the marker yourself.</para></listitem>
 					<listitem><para>To scroll sideways, you can hold down either Shift or Ctrl and use your mouse's scroll wheel.</para></listitem>
 					</orderedlist>
 					</para></listitem>
@@ -458,7 +462,7 @@ You can import <application>LilyPond</application> MIDI output in <application>Q
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Repeat_the_Theme">
 			<title>Repeat the Theme</title>
 			<para>
-				The beginning of this composition opens with a thirteen-measure (in this Qtractor session) segment that is immediately repeated.  If you chose to create a thirteen-measure theme, like we did, you will either need to create a second MIDI segment to cover Beethoven's repeat, or you can do what I did, and copy-and-paste to get an exact repetition of your theme.
+				The beginning of this composition opens with a thirteen-measure (in this <application>Qtractor</application> session) segment that is immediately repeated.  If you chose to create a thirteen-measure theme, like we did, you will either need to create a second MIDI segment to cover Beethoven's repeat, or you can do what I did, and copy-and-paste to get an exact repetition of your theme.
 			</para>
 			<para>
 				To repeat your theme exactly:


More information about the docs-commits mailing list