From: James Lowe <pkx166h@gmail.com>
Date: Sun, 19 Jul 2015 18:31:39 +0000 (+0100)
Subject: Doc: NR add @knownissues for Percent Repeats
X-Git-Tag: release/2.19.25-1~37
X-Git-Url: https://git.donarmstrong.com/?p=lilypond.git;a=commitdiff_plain;h=ca2d9d22be422c4de98bc246dc94f7f2fd274dd2

Doc: NR add @knownissues for Percent Repeats

Issue 4506

Added @knownissue where
percent repeats will not
'repeat' any timing changes
or /partial commands.
---

diff --git a/Documentation/notation/repeats.itely b/Documentation/notation/repeats.itely
index ed3083090b..b29bb60464 100644
--- a/Documentation/notation/repeats.itely
+++ b/Documentation/notation/repeats.itely
@@ -778,6 +778,26 @@ Internals Reference:
 @rinternals{Double_percent_repeat_engraver},
 @rinternals{Slash_repeat_engraver}.
 
+@knownissues
+Percent repeats will not contain anything else apart from the percent
+sign itself; in particular, timing changes will not be repeated.
+
+@lilypond[quote,verbatim,relative=2]
+\repeat percent 3 { \time 5/4 c2. 2 \time 4/4 2 2 }
+@end lilypond
+
+@noindent
+Any meter changes or @code{\partial} commands need to occur in parallel
+passages @emph{outside} of any percent repeat, e.g in a separate
+timing track.
+
+@lilypond[quote,verbatim,relative=2]
+<<
+  \repeat percent 3 { c2. 2 2 2 }
+  \repeat unfold 3 { \time 5/4 s4*5 \time 4/4 s1 }
+>>
+@end lilypond
+
 
 @node Tremolo repeats
 @unnumberedsubsubsec Tremolo repeats