[musicians-guide] Added fix for Bug 673519

crantila crantila at fedoraproject.org
Mon Jun 27 02:03:11 UTC 2011


commit 68f0a5a02feef6c6a3eb112d2aa0b9dfaffc87a7
Author: Christopher Antila <crantila at fedoraproject.org>
Date:   Sun Jun 26 22:03:03 2011 -0400

    Added fix for Bug 673519

 en-US/Revision_History.xml |    3 ++-
 en-US/Rosegarden.xml       |   36 +++++++++++++++++-------------------
 2 files changed, 19 insertions(+), 20 deletions(-)
---
diff --git a/en-US/Revision_History.xml b/en-US/Revision_History.xml
index e97c28e..4e4d452 100644
--- a/en-US/Revision_History.xml
+++ b/en-US/Revision_History.xml
@@ -327,6 +327,7 @@
 					  <member>Fixed Bug 670533.</member>
 					  <member>Revised parts of Chapter 9 (Rosegarden configuration).</member>
 					  <member>Revised parts of Chapter 8 (Qtractor configuration).</member>
+					  <member>Fixed Bug 673519.</member>
 					</simplelist>
 				</revdescription>
 			</revision>
@@ -337,8 +338,8 @@
 			<!-- TODO: standardize the paragraph about installing JACK -->
 			<!-- TODO: ensure correct permissions for JACK; I think I have the user group wrong -->
 			<!-- TODO: finish the "TODO" in Ardour.xml at line 178 -->
-			<!-- TODO: Bug 673519 ("Where is 'Percussion' check-box?") -->
 			<!-- TODO: Bug 710330 ("Section 11.5.1 Broken Link to Local Help File") -->
+			<!-- QA: Bug 673519 ("Where is 'Percussion' check-box?") -->
 			
 			<!-- Fedora 16 (LilyPond) -->
 			<!-- TODO: Bug 710333 ("Section 12.6 Needs to Be Rewritten") -->
diff --git a/en-US/Rosegarden.xml b/en-US/Rosegarden.xml
index df59548..6ac9397 100644
--- a/en-US/Rosegarden.xml
+++ b/en-US/Rosegarden.xml
@@ -145,7 +145,7 @@
 	<section id="sect-Musicians_Guide-Rosegarden-Tutorial">
 		<title>Write a Song in <application>Rosegarden</application> (Tutorial)</title>
 		<para>
-			When using <application>Rosegarden</application>'s notation editor, the application may accidentally leave some notes playing longer than it should.  You can fix this, if it bothers you, by pressing the "panic" button in <application>Qsynth</application>.  If you are using another synthesizer with a panic button, it should server the same function.
+			The <application>Rosegarden</application> notation editor may accidentally leave some notes playing longer than it should. Press the <guibutton>panic</guibutton> button in <application>Qsynth</application> to fix this. Other synthesizers should also have a <guibutton>panic</guibutton> button.
 		</para>
 		<section id="sect-Musicians_Guide-Rosegarden-Tutorial-Bass_Line">
 			<title>Start the Score with a Bass Line</title>
@@ -154,10 +154,10 @@
 				<listitem><para>Start <application>QjackCtl</application>, then <application>Qsynth</application>, then <application>Rosegarden</application>.</para></listitem>
 				<listitem><para>For this tutorial, we'll be using the default "Fluid R3" SoundFont, but you can use any General MIDI SoundFont.</para></listitem>
 				<listitem><para>Setup <application>Rosegarden</application> in <application>JACK</application> for MIDI use only.</para></listitem>
-				<listitem><para>From the <application>Rosegarden</application> menu, select 'Edit > Preferences'.  Click the "MIDI" tab, then the 'General' tab, then select "Send all MIDI controllers at start of each playback".  This will ensure that the MIDI synthesizer (<application>FluidSynth</application> for this tutorial) uses the right patches.</para></listitem>
+				<listitem><para>From the <application>Rosegarden</application> menu, select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.  Click the "MIDI" tab, then the 'General' tab, then select "Send all MIDI controllers at start of each playback".  This will ensure that the MIDI synthesizer (<application>FluidSynth</application> for this tutorial) uses the right patches.</para></listitem>
 				<listitem><para>Create a new segment.
 					<orderedlist>
-					<listitem><para>Click on the "Draw" tool on the toolbar (it looks like a red pencil), or press 'F3' on the keyboard.</para></listitem>
+					<listitem><para>Select the "Draw" tool on the toolbar (it looks like a red pencil), or press 'F3' on the keyboard.</para></listitem>
 					<listitem><para>In the first track, click-and-drag to select the area over the first two bars.</para></listitem>
 					<listitem><para>When you release the mouse, there should be a rectangle that says, "Acoustic Grand Piano," or something similar.</para></listitem>
 					</orderedlist>
@@ -185,31 +185,29 @@
 		</section>
 		<section id="sect-Musicians_Guide-Rosegarden-Tutorial-Percussion_Track">
 			<title>Add a Percussion Track</title>
-			<para>
-				<orderedlist>
-				<listitem><para>Select the second track, and rename it to "Percussion" (or something else, if you prefer).</para></listitem>
-				<listitem><para>In the "Instrument Parameters" portion of the toolbox on the left side of the editor window, check the "Percussion" check-box.</para></listitem>
-				<listitem><para>Play the transport for just a second, so that <application>Rosegarden</application> synchronized the re-assignment with FluidSynth</para></listitem>
-				<listitem><para>Press 'F3' on the keyboard, or click on the "Draw" tool, which looks like a pencil.</para></listitem>
-				<listitem><para>Create a one-measure segment in the second track, then right-click on the segment, and select 'Open in Percussion Matrix Editor'.
+			<procedure>
+				<step><para>Select the second track, and rename it to "Percussion" (or something else, if you prefer).</para></step>
+				<step><para>In the "Instrument Parameters" portion of the toolbox on the left side of the editor window, check the "Percussion" check-box. If you do not see the "Instrument Parameters" panel, select <menuchoice><guimenu>View</guimenu><guimenuitem>Show Special Parameters</guimenuitem></menuchoice> from the menu.</para></step>
+				<step><para>Select <guibutton>Play</guibutton> on the transport for just a second, then stop it. <application>Rosegarden</application> synchronizes the re-assignment with <application>FluidSynth</application></para></step>
+				<step><para>Press <keycombo><keycap>F3</keycap></keycombo> on the keyboard, or click on the "Draw" tool that looks like a pencil.</para></step>
+				<step><para>Create a one-measure segment in the second track, then right-click on the segment, and select <menuchoice><guimenuitem>Open in Percussion Matrix Editor</guimenuitem></menuchoice>.
 					<orderedlist>
 					<listitem><para>The percussion matrix editor is like the matrix editor, but each pitch is labeled with the instrument it triggers.</para></listitem>
 					<listitem><para>Experiment with the different instruments and pitches to find a pattern of four quarter notes that you want to repeat in each measure.</para></listitem>
-					<listitem><para>When you're happy with your pattern, close the editor.</para></listitem>
+					<listitem><para>When you finish with your pattern, close the editor.</para></listitem>
 					</orderedlist>
-					</para></listitem>
-				<listitem><para>Select the newly-created percussion segment, then from the menu select 'Edit > Copy'.</para></listitem>
-				<listitem><para>Move the transport's playhead to the end of the first measure.  First move it to the beginning, then press the "fast forward" button to advance it to the end of the first measure.</para></listitem>
-				<listitem><para>Be sure that the second track is still selected.</para></listitem>
-				<listitem><para>Press 'Ctrl + v' or from the menu choose 'Edit > Paste' a few times, so that the percussion track fills up the same space as the bassline.</para></listitem>
-				</orderedlist>
-			</para>
+					</para></step>
+				<step><para>Select the newly-created percussion segment, then choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice> from the menu.</para></step>
+				<step><para>Move the transport playhead to the end of the first measure.  First move it to the beginning, then press the "fast forward" button to advance it to the end of the first measure.</para></step>
+				<step><para>Confirm that the second track is still selected.</para></step>
+				<step><para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> a few times, so the percussion track fills up the same space as the bassline.</para></step>
+			</procedure>
 		</section>
 		<section id="sect-Musicians_Guide-Rosegarden-Tutorial-Spice_up_the_Percussion">
 			<title>Spice up the Percussion</title>
 			<para>
 				<orderedlist>
-				<listitem><para>Four quarter notes isn't really a suitable percussion accompaniment, so let's make it more interesting.</para></listitem>
+				<listitem><para>Four quarter notes is not a very long percussion accompaniment, so let's make it more interesting.</para></listitem>
 				<listitem><para>Open the first percussion segment in the standard notation editor by double-clicking it.</para></listitem>
 				<listitem><para>From the menu select 'Edit > Select Whole Staff'.</para></listitem>
 				<listitem><para>Then from the menu select 'Adjust > Notes > Eighth Note'.</para></listitem>


More information about the docs-commits mailing list