Doc: NR more examples to Repeats for beat slashes

This is for Tracker Issue 1574

Showing short-duration repeats and beat slashes along with
mixed length notes.

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index a45b36c4586d35ddab646b225eb6904c426fc02e..db242294592be90e4dbb9b00c6033c02965555fc 100644 (file)
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -62,7 +62,20 @@ which scares away people.
 @end ignore
 
 @item
-Lilypond typesets woodwind fingering charts.
+Single beat repeats for sixteenth or shorter notes and beat repeats for
+measures containing notes of varying durations are now supported.
+
+@lilypond[fragment,relative=2]
+\repeat percent 2 { c16 d }
+\repeat percent 2 { c32 e }
+\repeat percent 2 { c64 f }
+\repeat percent 2 { c128 g' }
+@end lilypond
+
+
+@item
+Lilypond now engraves woodwind fingering charts.
+
 @lilypond
 \relative c' {
   \textLengthOn
@@ -174,10 +187,11 @@ motif = \relative c'' { d8 c f,4 <a f'> <a f'> }
 @end lilypond
 
 @item
-Black mensural notation has minimal support.
+Added minimal support for black mensural notation.
 
 @item
-Support for obliqua shapes within white mensural ligatures enhanced.
+Enhanced support for obliqua shapes within white mensural ligatures.
+
 @lilypond
 \context MensuralStaff
 {
@@ -204,6 +218,7 @@ Support for obliqua shapes within white mensural ligatures enhanced.
 @item
 Compound time signatures are now supported by the @code{\compoundMeter} command,
 which can be used instead of @code{\time}:
+
 @lilypond
 \relative c'' {
   \compoundMeter #'(3 1 8)
@@ -236,6 +251,7 @@ By using @code{\cueDuringWithClef}, cue notes can now also have their own
 clef, which is correctly reset at the end of the cue notes.  At the begin
 of each line, the standard clef is still displayed, but the cue clef is
 shown after the time/key signature in smaller size.
+
 @lilypond
 vI = \relative c'' { \clef "treble" \repeat unfold 40 g4 }
 \addQuote vIQuote { \vI }
@@ -280,6 +296,7 @@ based on user input.
 
 @item
 The part-combiner's decision to combine/not combine notes can now be customized
+
 @lilypond[quote,relative=2]
 \partcombine
 \relative c' { c2 \partcombineApart c | \partcombineChordsOnce e' e }

diff --git a/Documentation/notation/repeats.itely b/Documentation/notation/repeats.itely
index 1e8de840be18135c816e3920ddc1fe0cb472518b..fd4260051a9924c6812bea69c55c6fd571d7714d 100644 (file)
--- a/Documentation/notation/repeats.itely
+++ b/Documentation/notation/repeats.itely
@@ -578,22 +578,35 @@ where @code{@var{musicexpr}} is a music expression.
 Patterns that are shorter than one measure are replaced by slashes.
 
 @lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c128 d e f }
+\repeat percent 4 { c64 d e f }
+\repeat percent 5 { c32 d e f }
+\repeat percent 4 { c16 d e f }
 \repeat percent 4 { c8 d }
 \repeat percent 4 { c4 }
 \repeat percent 2 { c2 }
 @end lilypond
 
-Patterns of one or two measures are replaced by percent-like signs.
+Patterns of one or two measures are replaced by percent-like symbols.
 
 @lilypond[verbatim,quote,relative=2]
-\repeat percent 3 { c4 d e f }
-\repeat percent 4 { c2 d }
+\repeat percent 2 { c4 d e f }
+\repeat percent 2 { c2 d }
+\repeat percent 2 { c1 }
 @end lilypond
 
 @lilypond[verbatim,quote,relative=2]
 \repeat percent 3 { c4 d e f | c2 g' }
 @end lilypond
 
+Patterns that are shorter than one measure but contain mixed durations
+use a double-percent symbol.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c8. <d f>16 }
+\repeat percent 2 { \times 2/3 { r8 c d } e4 }
+@end lilypond
+
 @snippets
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
@@ -605,7 +618,6 @@ Patterns of one or two measures are replaced by percent-like signs.
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {isolated-percent-repeats.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{percent repeat},
@@ -616,23 +628,17 @@ Snippets:
 
 Internals Reference:
 @rinternals{RepeatSlash},
+@rinternals{RepeatSlashEvent},
+@rinternals{DoubleRepeatSlash},
 @rinternals{PercentRepeat},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic},
+@rinternals{Percent_repeat_engraver},
+@rinternals{DoublePercentEvent},
 @rinternals{DoublePercentRepeat},
 @rinternals{DoublePercentRepeatCounter},
-@rinternals{PercentRepeatCounter},
-@rinternals{PercentRepeatedMusic}.
-
-
-@knownissues
-
-Only three kinds of percent repeats are supported: a single slash
-representing a single beat (regardless of the duration of the repeated
-notes); a single slash with dots representing one full measure; and
-two slashes with dots crossing a bar line representing two full
-measures.  Neither multiple slashes representing single beat repeats
-consisting of sixteenth or shorter notes, nor two slashes with dots
-representing single beat repeats consisting of notes of varying
-durations, are supported.
+@rinternals{Double_percent_repeat_engraver},
+@rinternals{Slash_repeat_engraver}.
 
 
 @node Tremolo repeats