Doc: NR 1.2 Rhythms: cadenza beams, add to known issues

diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely
index e0321d305883f04350737058b7755a038335ef0e..3f3b1e9aa381c91eb45eac46536a3e4d2607bb77 100644 (file)
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -1345,7 +1345,7 @@ to turn them on again.
 @lilypond[verbatim,relative=2,quote]
 c4 d e d
 \cadenzaOn
-c4 c d8 d d f4 g4.
+c4 c d8[ d d] f4 g4.
 \cadenzaOff
 \bar "|"
 d4 e d c
@@ -1359,7 +1359,7 @@ cadenza were not there:
 \override Score.BarNumber #'break-visibility = #all-visible
 c4 d e d
 \cadenzaOn
-c4 c d8 d d f4 g4.
+c4 c d8[ d d] f4 g4.
 \cadenzaOff
 \bar "|"
 d4 e d c
@@ -1412,16 +1412,23 @@ staff line, you will need to insert invisible bar lines with
 @noindent
 to indicate where breaks can occur.
 
-You must explicitly create a @code{Voice} context when starting a
+Automatic beaming rules are unlikely to produce the desired beams in
+cadenzas longer than one or two beats, so it is best to specify beams
+manually with @code{[} and @code{]}.
+
+You should explicitly create a @code{Voice} context when starting a
 piece with @code{\cadenzaOn}, otherwise strange errors may occur.
 
-@lilypond[verbatim,relative=2,quote]
-\new Voice \relative c'{
-  \cadenzaOn
-  c16^"Solo Free Time" d e f g2. \bar "||"
-  \cadenzaOff
-}
-@end lilypond
+@example
+\new Voice @{
+  \relative c' @{
+    \cadenzaOn
+    c16[^"Solo Free Time" d e f] g2.
+    \bar "||"
+    \cadenzaOff
+  @}
+@}
+@end example
 
 
 @node Polymetric notation