Doc: NR Clarify finer point of repeat unfold

[lilypond.git] / Documentation / notation / repeats.itely

diff --git a/Documentation/notation/repeats.itely b/Documentation/notation/repeats.itely
index d3f473fa820d545969a63cec3163d648aa3cf7a7..7af38d2d296531e314ad02bdf51a1dd95e5fc584 100644 (file)
--- 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]