X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fpiano.itely;h=54ed891e003499ddf2a3ad0b58d054f3a0de2984;hb=a91aefbb9ef4a0ca7f2db0ec89fe9430f42cd6f8;hp=3c18be1ec936266a3f8b1ebe6f48b5b99ec52f92;hpb=555d8e498a31380d62be9f4853ab514b3786e986;p=lilypond.git

diff --git a/Documentation/user/piano.itely b/Documentation/user/piano.itely
index 3c18be1ec9..54ed891e00 100644
--- a/Documentation/user/piano.itely
+++ b/Documentation/user/piano.itely
@@ -31,7 +31,7 @@ handle this cross-staffing behavior.  In this section we discuss the
 * Cross staff stems::           
 @end menu
 
-@refbugs
+@knownissues
 
 Dynamics are not centered, but workarounds do exist.  See the
 @q{piano centered dynamics} template in @rlearning{Piano templates}.
@@ -42,7 +42,7 @@ Dynamics are not centered, but workarounds do exist.  See the
 
 
 @node Automatic staff changes
-@unnumberedsubsubsec Automatic staff changes
+@subsubsection Automatic staff changes
 @cindex Automatic staff changes
 
 Voices can be made to switch automatically between the top and the bottom
@@ -85,13 +85,13 @@ advance.  Here is a practical example
 
 @seealso
 
-In this manual: @ref{Manual staff switches}.
+Notation Reference: @ref{Manual staff switches}.
 
-Program reference: @internalsref{AutoChangeMusic}.
+Internals Reference: @internalsref{AutoChangeMusic}.
 
 
 
-@refbugs
+@knownissues
 
 The staff switches may not end up in optimal places.  For high
 quality output, staff switches should be specified manually.
@@ -101,7 +101,7 @@ quality output, staff switches should be specified manually.
 
 
 @node Manual staff switches
-@unnumberedsubsubsec Manual staff switches
+@subsubsection Manual staff switches
 
 @cindex manual staff switches
 @cindex staff switch, manual
@@ -115,7 +115,7 @@ Voices can be switched between staves manually, using the command
 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
@@ -130,7 +130,7 @@ usually the setup for a score will start with a setup of the staves,
 @end example
 
 
-and the @context{Voice} is inserted afterwards
+and the @code{Voice} is inserted afterwards
 
 @example
 \context Staff = down
@@ -139,7 +139,7 @@ and the @context{Voice} is inserted afterwards
 
 
 @node Pedals
-@unnumberedsubsubsec Pedals
+@subsubsection Pedals
 @cindex Pedals
 
 Pianos have pedals that alter the way sound is produced.  Generally, a
@@ -193,7 +193,7 @@ c\sostenutoDown d e c, f g a\sostenutoUp
 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
 
@@ -204,10 +204,10 @@ c\sostenutoDown d e c, f g a\sostenutoUp
 
 @seealso
 
-In this manual: @ref{Ties} (laissez vibrer).
+Notation Reference: @ref{Ties} (laissez vibrer).
 
 @node Staff switch lines
-@unnumberedsubsubsec Staff switch lines
+@subsubsection Staff switch lines
 
 
 @cindex follow voice
@@ -234,9 +234,9 @@ can be printed automatically.  This is switched on by setting
 
 @seealso
 
-Program reference: @internalsref{VoiceFollower}.
+Internals Reference: @internalsref{VoiceFollower}.
 
-@refcommands
+@predefined
 
 @funindex \showStaffSwitch
 @code{\showStaffSwitch},
@@ -245,7 +245,7 @@ Program reference: @internalsref{VoiceFollower}.
 
 
 @node Cross staff stems
-@unnumberedsubsubsec 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