From 9dd913c87e4b2616c45f753a265fe53972a93868 Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Thu, 3 Jul 2008 20:19:11 -0700 Subject: [PATCH] Update from Andrew. --- Documentation/user/keyboards.itely | 83 +++++++++++++----------------- 1 file changed, 35 insertions(+), 48 deletions(-) diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely index f0e6833b05..d9c12777e8 100644 --- 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 - 1\sustainUp - c4\sostenutoDown e g c, - 1\sostenutoUp - c4\unaCorda d e g - 1\treCorde -} +@lilypond[quote,ragged-right,fragment,verbatim,relative=2] +c4\sustainDown d e g +1\sustainUp +c4\sostenutoDown e g c, +1\sostenutoUp +c4\unaCorda d e g +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} -- 2.39.5