Update.

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index 680d639d0ea97e7071643c25bd5e1fc380309d61..7ae11e0fd7dab52ff541331a82a6243c240d60b9 100644 (file)
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -309,9 +309,7 @@ Internals Reference:
 @cindex cross-staff stems
 @cindex stems, cross-staff
 
-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
-staff, or vice versa.
+Chords that cross staves may be produced:
 
 @lilypond[ragged-right,verbatim,quote]
 \new PianoStaff <<
@@ -322,12 +320,16 @@ staff, or vice versa.
     << {
       \clef bass
       \stemUp
-      \override Stem #'length = #12
+      % 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' }
+    } \\ {
+      f,2 d'
+    }
     >>
   }
 >>