@c \version "2.11.61"
-@node Keyboard and other many-stringed instruments
-@section Keyboard and other many-stringed instruments
+@node Keyboard and other multi-staff instruments
+@section Keyboard and other multi-staff instruments
@lilypondfile[quote]{keyboard-headword.ly}
-This section discusses several aspects of music notation that are unique
-to keyboard instruments and other instruments with many strings, such as
-the harp.
+This section discusses several aspects of music notation that are
+unique to keyboard instruments and other instruments notated on
+many staves, such as harps and vibraphones. For the purposes of
+this section this entire group of multi-staff instruments is called
+@qq{keyboards} for short, even though some of them do not have a
+keyboard.
@menu
* Common notation for keyboards::
@end itemize
-@seealso
+@seealso
Learning Manual:
@rlearning{Real music example},
@rlearning{Other uses for tweaks}.
Snippets:
@rlsr{Keyboards}.
+
@knownissues
@cindex keyboard music, centering dynamics
example of beam tweaking, see @rlearning{Fixing overlapping
notation}.
-@seealso
+@seealso
Learning Manual:
@rlearning{Fixing overlapping notation}.
>>
@end lilypond
-@seealso
+@seealso
Notation Reference:
@ref{Changing staff manually}.
Internals Reference:
@rinternals{AutoChangeMusic}.
+
@knownissues
@cindex chords, splitting across staves with \autochange
>>
@end lilypond
+
@predefined
+@code{\showStaffSwitch},
+@code{\hideStaffSwitch}.
+@endpredefined
-@code{\showStaffSwitch}, @code{\hideStaffSwitch}.
@seealso
-
Snippets:
@rlsr{Keyboards}.
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{indicating-cross-staff-chords-with-arpeggio-bracket.ly}
-@seealso
+@seealso
Snippets:
@rlsr{Keyboards}.
Internals Reference:
@rinternals{Stem}.
+
@node Piano
@subsection Piano
sustain pedal during piano performance. Pedalling to the final bar line
is indicated by omitting the final pedal up command.
-@seealso
+@seealso
Notation Reference:
@ref{Ties}.
@rinternals{PianoPedalBracket},
@rinternals{Piano_pedal_engraver}.
+
@node Accordion
@subsection Accordion
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{accordion-discant-symbols.ly}
-@seealso
+@seealso
Snippets:
@rlsr{Keyboards}.
@node Harp
@subsection Harp
+@menu
+* Harp notation::
+* Harp pedals::
+@end menu
+
+@node Harp notation
+@unnumberedsubsubsec Harp notation
+
TBC
@ignore
An LSR snippet could be used to demonstrate the main items; in the
case of glissandi, it would be desirable to have a demonstration
of different styles.
-
@end ignore
+@node Harp pedals
+@unnumberedsubsubsec Harp pedals
+
+@cindex harp pedals
+@cindex harp pedal diagrams
+@cindex pedals, harp
+@cindex pedal diagrams, harp
+
+Harps have seven strings per octave that may be sounded at the natural,
+flattened, or sharpened pitch. In lever harps, each string is adjusted
+individually, but in pedal harps every string with the same pitch name
+is controlled by a single pedal. From the player's left to right, the
+pedals are D, C, and B on the left and E, F, G, and A on the right.
+The position of the pedals may be indicated with text marks:
+
+@lilypond[quote,verbatim,relative=2]
+\textLengthOn
+cis1_\markup \concat \vcenter { [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
+c!1_\markup \concat \vcenter {[ C \natural ]}
+@end lilypond
+
+or pedal diagrams:
+
+@lilypond[quote,verbatim,relative=2]
+\textLengthOn
+cis1_\markup { \harp-pedal #"^v-|vv-^" }
+c!1_\markup { \harp-pedal #"^o--|vv-^" }
+@end lilypond
+
+The @code{\harp-pedal} command accepts a string of characters, where
+@code{^} is the highest pedal position (flattened pitch), @code{-} is
+the middle pedal postion (natural pitch), @code{v} is the lowest pedal
+position (sharpened pitch), and @code{|} is the divider. A prefixed
+@code{o} will circle the following pedal symbol.
+
+@seealso
+Notation Reference:
+@ruser{Text scripts}