Update from Andrew.

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index f0e6833b05f40e2e04b608d45b0d2d53f010b1aa..d9c12777e8de58c8c5ad2072024d1403ac144217 100644 (file)
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -8,14 +8,13 @@
 
 @c \version "2.11.38"
 
-@c "I have finished the first draft." -AH
-
 @node Keyboard instruments
 @section Keyboard instruments
 
 @lilypondfile[quote]{keyboard-headword.ly}
 
-FIXME add sentence
+This section discusses several aspects of music notation that are unique
+to keyboard instruments.
 
 @menu
 * Common notation for keyboards::
@@ -26,7 +25,8 @@ FIXME add sentence
 @node Common notation for keyboards
 @subsection Common notation for keyboards
 
-FIXME add sentence
+This section discusses notation issues that may arise for most keyboard
+instruments.
 
 @menu
 * References for keyboards::
@@ -84,10 +84,6 @@ as shown in @rlearning{Other uses for tweaks}.
 
 @end itemize
 
-@c @snippets
-@c @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
-@c {creating-slurs-across-voices.ly}
-
 @seealso
 
 Learning Manual:
@@ -115,9 +111,9 @@ Snippets:
 
 Dynamics are not automatically centered, but workarounds do exist.  One
 option is the @q{piano centered dynamics} template under
-@rlearning{Piano templates}; another option is to add dynamics
-normally and then increase their staff-paddingm as discussed in
-@rlearning{Moving objects}.
+@rlearning{Piano templates}; another option is to increase the
+@code{staff-padding} of dynamics as discussed in @rlearning{Moving
+objects}.
 
 @node Changing staff manually
 @subsubsection Changing staff manually
@@ -261,9 +257,8 @@ Internals Reference:
 The staff switches may not end up in optimal places.  For high
 quality output, staff switches should be specified manually.
 
-Chords will not be split across the staves; the staff will be
-chosen by the first note named in the chord.
-
+Chords will not be split across the staves; they will be assigned to a
+staff based on the first note named in the chord construct.
 
 @node Staff-change lines
 @subsubsection Staff-change lines
@@ -353,6 +348,9 @@ Internals Reference:
 @node Piano
 @subsection Piano
 
+This section discusses notation issues that relate most directly to the
+piano.
+
 @menu
 * Piano pedals::
 @end menu
@@ -377,39 +375,32 @@ produced: @notation{sustain}, @notation{sostenuto}
 (@notation{sos.}), and @notation{una corde} (@notation{U.C.}).
 Sustain pedals are also found on vibraphones and celestas.
 
-FIXME: see policy for allowed lilypond[] options.
-(ie use [relative=2])
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c4\sustainDown d e g
-  <c, f a>1\sustainUp
-  c4\sostenutoDown e g c,
-  <bes d f>1\sostenutoUp
-  c4\unaCorda d e g
-  <d fis a>1\treCorde
-}
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c4\sustainDown d e g
+<c, f a>1\sustainUp
+c4\sostenutoDown e g c,
+<bes d f>1\sostenutoUp
+c4\unaCorda d e g
+<d fis a>1\treCorde
 @end lilypond
 
 There are three styles of pedal indications: text, bracket, and mixed.
 The sustain pedal and the una corda pedal use the text style by default
 while the sostenuto pedal uses mixed by default.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c4\sustainDown g c2\sustainUp
-  \set Staff.pedalSustainStyle = #'mixed
-  c4\sustainDown g c d
-  d\sustainUp\sustainDown g, c2\sustainUp
-  \set Staff.pedalSustainStyle = #'bracket
-  c4\sustainDown g c d
-  d\sustainUp\sustainDown g, c2
-  \bar "|."
-}
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c4\sustainDown g c2\sustainUp
+\set Staff.pedalSustainStyle = #'mixed
+c4\sustainDown g c d
+d\sustainUp\sustainDown g, c2\sustainUp
+\set Staff.pedalSustainStyle = #'bracket
+c4\sustainDown g c d
+d\sustainUp\sustainDown g, c2
+\bar "|."
 @end lilypond
 
 The placement of the pedal commands matches the physical movement of the
-sustain pedal during piano performance.  Pedalling to the final barline
+sustain pedal during piano performance.  Pedalling to the final bar line
 is indicated by omitting the final pedal up command.
 
 @seealso
@@ -433,7 +424,7 @@ Internals Reference:
 @node Accordion
 @subsection Accordion
 
-FIXME add sentence
+This section discusses notation that is unique to the accordion.
 
 @menu
 * Discant symbols::
@@ -445,20 +436,16 @@ FIXME add sentence
 @cindex discant symbols, accordion
 @cindex accordion shifts
 
-@c FIXME: use @notation, not @q.
-@c FIXME: you might want to submit some of these terms to the MG.
-@c    If so, send an email to Kurt about this.
-
 Accordions are often built with more than one set of reeds that may be
 in unison with, an octave above, or an octave below the written pitch.
-Each accordian maker has different names for the @q{shifts} that
-select the various reed combinations, such as @q{oboe}, @q{musette}, or
-@q{bandonium}, so a system of symbols has come into use to simplify
-the performance instructions.
+Each accordion maker has different names for the @notation{shifts} that
+select the various reed combinations, such as @notation{oboe},
+@notation{musette}, or @notation{bandonium}, so a system of symbols has
+come into use to simplify the performance instructions.
 
 @snippets
 
-@c FIXME: invalid snippet name.  Check the GDP snippet list.
+@c This snippet should work once it's been tagged for the docs.
 @c @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
 @c {accordion-discant-symbols.ly}