From 85fe0f15000f793435221fab2688ba3fa65a028f Mon Sep 17 00:00:00 2001
From: James Lowe <james.lowe@datacore.com>
Date: Mon, 28 Mar 2011 19:37:13 +0100
Subject: [PATCH] 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.
---
 Documentation/changes.tely           | 23 +++++++++++++--
 Documentation/notation/repeats.itely | 42 ++++++++++++++++------------
 2 files changed, 44 insertions(+), 21 deletions(-)

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index a45b36c458..db24229459 100644
--- 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 1e8de840be..fd4260051a 100644
--- 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
-- 
2.39.5