@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+ When revising a translation, copy the HEAD committish of the
+ version that you are working on. See TRANSLATION for details.
+@end ignore
@node Piano music
@section Piano music
+@menu
+* Piano sections::
+@end menu
+
+@node Piano sections
+@subsection Piano sections
+
Piano staves are two normal staves coupled with a brace. The staves
are largely independent, but sometimes voices can cross between the
two staves. The same notation is also used for harps and other key
@internalsref{PianoStaff} and some other pianistic peculiarities.
@menu
+* Automatic staff changes::
+* Manual staff switches::
+* Pedals::
+* Staff switch lines::
+* Cross staff stems::
@end menu
@refbugs
Dynamics are not centered, but workarounds do exist. See the
-@q{piano centered dynamics} template in @ref{Piano templates}.
+@q{piano centered dynamics} template in @rlearning{Piano templates}.
@cindex cross staff stem
@cindex stem, cross staff
@cindex distance between staves in piano music
-@anchor{Automatic staff changes}
-@unnumberedsubsubsec Automatic staff changes
+@node Automatic staff changes
+@subsubsection Automatic staff changes
@cindex Automatic staff changes
Voices can be made to switch automatically between the top and the bottom
@seealso
-In this manual: @ref{Manual staff switches}.
+Notation Reference: @ref{Manual staff switches}.
-Program reference: @internalsref{AutoChangeMusic}.
+Internals Reference: @internalsref{AutoChangeMusic}.
@code{\autochange} cannot be inside @code{\times}.
-@anchor{Manual staff switches}
-@unnumberedsubsubsec Manual staff switches
+@node Manual staff switches
+@subsubsection Manual staff switches
@cindex manual staff switches
@cindex staff switch, manual
The string @var{staffname} is the name of the staff. It switches the
current voice from its current staff to the Staff called
@var{staffname}. Typically @var{staffname} is @code{"up"} or
-@code{"down"}. The @context{Staff} referred to must already exist, so
+@code{"down"}. The @code{Staff} referred to must already exist, so
usually the setup for a score will start with a setup of the staves,
@example
@end example
-and the @context{Voice} is inserted afterwards
+and the @code{Voice} is inserted afterwards
@example
\context Staff = down
@end example
-@anchor{Pedals}
-@unnumberedsubsubsec Pedals
+@node Pedals
+@subsubsection Pedals
@cindex Pedals
Pianos have pedals that alter the way sound is produced. Generally, a
For fine-tuning the appearance of a pedal bracket, the properties
@code{edge-width}, @code{edge-height}, and @code{shorten-pair} of
@code{PianoPedalBracket} objects (see
-@internalsref{PianoPedalBracket} in the Program reference) can be
+@internalsref{PianoPedalBracket} in the Internals Reference) can be
modified. For example, the bracket may be extended to the right edge
of the note head
@seealso
-In this manual: @ref{Laissez vibrer ties}.
+Notation Reference: @ref{Ties} (laissez vibrer).
-@anchor{Staff switch lines}
-@unnumberedsubsubsec Staff switch lines
+@node Staff switch lines
+@subsubsection Staff switch lines
@cindex follow voice
@seealso
-Program reference: @internalsref{VoiceFollower}.
+Internals Reference: @internalsref{VoiceFollower}.
@refcommands
@code{\hideStaffSwitch}.
-@anchor{Cross staff stems}
-@unnumberedsubsubsec Cross staff stems
+@node Cross staff stems
+@subsubsection Cross staff stems
Chords that cross staves may be produced by increasing the length
of the stem in the lower staff, so it reaches the stem in the upper