From: James Lowe <james.lowe@datacore.com>
Date: Thu, 15 Sep 2011 21:44:42 +0000 (+0100)
Subject: Doc: NR Clarify finer point of repeat unfold
X-Git-Tag: release/2.15.13-1~13
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=f84eab93e732ed2b9aa50436202a28f34243c658;p=lilypond.git

Doc: NR Clarify finer point of repeat unfold

This is for tracker issue 1801.

Explain as an example, that \repeat unfold 2 {music expression} is
not always the same as writing out the music expression twice - especially
in a \relative context.
---

diff --git a/Documentation/notation/repeats.itely b/Documentation/notation/repeats.itely
index d3f473fa82..7af38d2d29 100644
--- a/Documentation/notation/repeats.itely
+++ b/Documentation/notation/repeats.itely
@@ -471,6 +471,21 @@ where @code{@var{musicexpr}} is a music expression and
 c1
 @end lilypond
 
+In some cases, especially in a @code{\relative} context, the
+@code{\repeat unfold} function is not the same as writing out the
+music expression multiple times. E.g,
+
+@example
+\repeat unfold 2 @{ a'4 b c @}
+@end example
+
+is not equivalent to
+
+@example
+a'4 b c | a'4 b c
+@end example
+
+
 Unfold repeats can be made with alternate endings.
 
 @lilypond[verbatim,quote,relative=2]