From c7b8ab823d6a206e3c5b311d6a98fa7c87217b19 Mon Sep 17 00:00:00 2001 From: Neil Puttock Date: Sat, 12 Jul 2008 22:24:13 +0100 Subject: [PATCH] Proofreading for keyboards.itely. --- Documentation/user/keyboards.itely | 111 ++++++++++++++++++++--------------- 1 files changed, 63 insertions(+), 48 deletions(-) diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely index 7ae11e0..640a22a 100644 --- a/Documentation/user/keyboards.itely +++ b/Documentation/user/keyboards.itely @@ -41,13 +41,13 @@ instruments. Keyboard instruments are usually notated with Piano staves. These are two or more normal staves coupled with a brace. The same -notation is also used for harps and other keyed instruments. +notation is also used for other keyed instruments. Organ music is normally written with two staves inside a @code{PianoStaff} group and third, normal staff for the pedals. The staves in keyboard music are largely independent, but -sometimes voices can cross between the two staves. In this -section we discuss some notation techniques particular to keyboard +sometimes voices can cross between the two staves. This +section discusses notation techniques particular to keyboard music. Several common issues in keyboard music are covered elsewhere: @@ -93,13 +93,14 @@ Learning Manual: Notation Reference: @ref{Grouping staves}, @ref{Instrument names}, address@hidden resolution}, @ref{Writing music in parallel}, @ref{Fingering instructions}, address@hidden of articulations}, @ref{Grid lines}, @ref{Ties}, @ref{Arpeggio}, address@hidden repeats}, address@hidden of articulations}. address@hidden repeats}. Internals Reference: @rinternals{PianoStaff}. @@ -135,27 +136,28 @@ Voices can be switched between staves manually, using the command @noindent The string @var{staffname} is the name of the staff. It switches -the current voice from its current staff to the Staff called +the current voice from its current staff to the staff called @var{staffname}. Typical values for @var{staffname} are @code{"up"} and @code{"down"}, or @code{"RH"} and @code{"LH"}. Cross-staff notes are beamed automatically: address@hidden,quote,ragged-right] address@hidden,quote] \new PianoStaff << \new Staff = "up" { 8 - \change Staff = down - g fis g - \change Staff = up + \change Staff = "down" + g8 fis g + \change Staff = "up" 8 - \change Staff = down - e dis e - \change Staff = up + \change Staff = "down" + e8 dis e + \change Staff = "up" } \new Staff = "down" { \clef bass - s1 % keep staff alive + % keep staff alive + s1 } >> @end lilypond @@ -179,7 +181,8 @@ Snippets: @rlsr{Keyboards}. Internals Reference: address@hidden address@hidden, address@hidden @node Changing staff automatically @@ -200,15 +203,16 @@ bottom staff. The syntax for this is @noindent This will create two staves inside the current staff group (usually a @code{PianoStaff}), called @code{"up"} and address@hidden"down"}. The lower staff will be in bass clef by default. -The autochanger switches on basis of the pitch (middle C is the address@hidden"down"}. The lower staff will be in the bass clef by default. +The autochanger switches on the basis of the pitch (address@hidden is the turning point), and it looks ahead skipping over rests to switch in advance. address@hidden,verbatim,ragged-right] address@hidden,verbatim] \new PianoStaff { \autochange { - g4 a b c' d' r4 a g + g4 a b c' + d'4 r a g } } @end lilypond @@ -223,14 +227,14 @@ can be created manually with the names @code{"up"} and its voice between the existing staves. For example, this is necessary to place a key signature in the lower staff: address@hidden,verbatim,ragged-right] address@hidden,verbatim] \new PianoStaff << \new Staff = "up" { \new Voice = "melOne" { \key g \major \autochange \relative c' { g8 b a c b d c e - d r fis, g a2 + d8 r fis, g a2 } } } @@ -274,15 +278,18 @@ staff based on the first note named in the chord construct. Whenever a voice switches to another staff, a line connecting the notes can be printed automatically: address@hidden,ragged-right,fragment,relative=1,verbatim] address@hidden,fragment,relative=1,verbatim] \new PianoStaff << \new Staff = "one" { \showStaffSwitch c1 - \change Staff=two + \change Staff = "two" b2 a } - \new Staff = "two" { \clef bass s1*2 } + \new Staff = "two" { + \clef bass + s1*2 + } >> @end lilypond @@ -298,6 +305,7 @@ Snippets: @rlsr{Keyboards}. Internals Reference: address@hidden, @rinternals{VoiceFollower}. @@ -311,32 +319,36 @@ Internals Reference: Chords that cross staves may be produced: address@hidden,verbatim,quote] address@hidden,quote] \new PianoStaff << - \new Staff \relative c' { - f8 e4 d8 2 + \new Staff { + \relative c' { + f8 e4 d8 2 + } } - \new Staff \relative c' { - << { - \clef bass - \stemUp - % stems may overlap the other staff - \override Stem #'cross-staff = ##t - % extend the stems to reach other other staff - \override Stem #'length = #12 - % do not print extra flags - \override Stem #'flag-style = #'no-flag - a8 g4 f8 - } \\ { - f,2 d' + \new Staff { + \relative c' { + << { + \clef bass + % stems may overlap the other staff + \override Stem #'cross-staff = ##t + % extend the stems to reach other other staff + \override Stem #'length = #12 + % do not print extra flags + \override Stem #'flag-style = #'no-flag + a8 g4 f8 + } + \\ + { + f,2 d' + } >> } - >> } >> @end lilypond @snippets address@hidden,lilyquote,ragged-right,texidoc] address@hidden,lilyquote,texidoc,doctitle] {indicating-cross-staff-chords-with-arpeggio-bracket.ly} @seealso @@ -345,7 +357,7 @@ Snippets: @rlsr{Keyboards}. Internals Reference: address@hidden address@hidden @node Piano @subsection Piano @@ -363,7 +375,7 @@ piano. @cindex pedals, piano @cindex sustain pedal @cindex sostenuto pedal address@hidden una corde address@hidden una corda @cindex tre corde @funindex \sustainOn @funindex \sustainOff @@ -374,10 +386,10 @@ piano. Pianos generally have three pedals that alter the way sound is produced: @notation{sustain}, @notation{sostenuto} -(@notation{sos.}), and @notation{una corde} (@notation{U.C.}). +(@notation{sos.}), and @notation{una corda} (@notation{U.C.}). Sustain pedals are also found on vibraphones and celestas. address@hidden,ragged-right,fragment,verbatim,relative=2] address@hidden,fragment,verbatim,relative=2] c4\sustainOn d e g 1\sustainOff c4\sostenutoOn e g c, @@ -390,7 +402,7 @@ 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. address@hidden,ragged-right,fragment,verbatim,relative=2] address@hidden,fragment,verbatim,relative=2] c4\sustainOn g c2\sustainOff \set Staff.pedalSustainStyle = #'mixed c4\sustainOn g c d @@ -416,10 +428,13 @@ Snippets: Internals Reference: @rinternals{SustainPedal}, @rinternals{SustainPedalLineSpanner}, address@hidden, @rinternals{SostenutoPedal}, @rinternals{SostenutoPedalLineSpanner}, address@hidden, @rinternals{UnaCordaPedal}, @rinternals{UnaCordaPedalLineSpanner}, address@hidden, @rinternals{PianoPedalBracket}, @rinternals{Piano_pedal_engraver}. @@ -447,7 +462,7 @@ come into use to simplify the performance instructions. @snippets address@hidden,lilyquote,ragged-right,texidoc] address@hidden,lilyquote,texidoc,doctitle] {accordion-discant-symbols.ly} @seealso -- 1.5.4.3