Re: Doc: NR Clarify finer point of repeat unfold (issue 5075047)

[pkx166h]

Reviewers: ,

Message:
commit  f84eab93e732ed2b9aa50436202a28f34243c6

closing issue

Description:
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.

Please review this at http://codereview.appspot.com/5075047/

Affected files:
  M Documentation/notation/repeats.itely


Index: Documentation/notation/repeats.itely
diff --git a/Documentation/notation/repeats.itely  
b/Documentation/notation/repeats.itely
index  
d3f473fa820d545969a63cec3163d648aa3cf7a7..7af38d2d296531e314ad02bdf51a1dd95e5fc584  
100644
--- a/Documentation/notation/repeats.itely
+++ b/Documentation/notation/repeats.itely
@@ -471,6 +471,21 @@ where @address@hidden is a music expression and
 c1
 @end lilypond

+In some cases, especially in a @code{\relative} context, the
address@hidden unfold} function is not the same as writing out the
+music expression multiple times. E.g,
+
address@hidden
+\repeat unfold 2 @{ a'4 b c @}
address@hidden example
+
+is not equivalent to
+
address@hidden
+a'4 b c | a'4 b c
address@hidden example
+
+
 Unfold repeats can be made with alternate endings.

 @lilypond[verbatim,quote,relative=2]