X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Frepeats.itely;h=86e7bd9acecae300af9181b47fea40580bc2d5a5;hb=fb4492cb129eb5640878b4ace2cb4264dc615db4;hp=911ceb53931cc9d8ecdb7bf1337f4c2fd23a6a61;hpb=5479ee9877d8e418aefd1010bd786fd3315dccbd;p=lilypond.git diff --git a/Documentation/user/repeats.itely b/Documentation/user/repeats.itely index 911ceb5393..86e7bd9ace 100644 --- a/Documentation/user/repeats.itely +++ b/Documentation/user/repeats.itely @@ -20,11 +20,11 @@ exist for repetitions. LilyPond supports the following kinds of repeats: @table @code @item volta -The repeated music is not written out but enclosed in repeat bar +The repeated music is not written out but enclosed between repeat bar lines. If the repeat is at the beginning of a piece, a repeat bar line is only printed at the end. Alternative endings (volte) are -printed, left to right with brackets. This is the standard -notation for repeats with alternatives. +printed, left to right with brackets. This is the standard notation +for repeats with alternatives. @item unfold The repeated music is fully written out, as many times as @@ -32,11 +32,11 @@ specified by @var{repeatcount}. This is useful when entering repetitious music. @item percent -Write beat or measure repeats. These look like percent signs. +These are beat or measure repeats. They look like percent signs. Percent repeats must be declared within a @code{Voice} context. @item tremolo -Write tremolo beams. +This is used to write tremolo beams. @end table @@ -45,10 +45,10 @@ LilyPond has one syntactic construct for specifying different types of repeats. The syntax is @example -\repeat @var{variant} @var{repeatcount} @var{repeatbody} +\repeat @var{variant} @var{repeatcount} @var{musicexpr} @end example -where @var{repeatbody} is a music expression. +where @var{musicexpr} is a music expression. Alternative endings are entered with @@ -97,10 +97,10 @@ to be played more than once. The syntax for a normal repeat is @example -\repeat volta @var{repeatcount} @var{repeatbody} +\repeat volta @var{repeatcount} @var{musicexpr} @end example -where @var{repeatbody} is a music expression. Alternate endings can +where @var{musicexpr} is a music expression. Alternate endings can be produced using @code{\alternative}. Normal repeats without alternate endings: @@ -250,9 +250,9 @@ Stop a running volta bracket. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] c4 \set Score.repeatCommands = #'((volta "93") end-repeat) -c4 c4 +c4 b4 \set Score.repeatCommands = #'((volta #f)) -c4 c4 +d4 e4 @end lilypond @c FIXME: improve visibility of bar lines link? @@ -279,10 +279,10 @@ By using the @code{unfold} command, repeats can be used to simplify the writing out of repetitious music. The syntax is @example -\repeat unfold @var{repeatcount} @var{repeatbody} +\repeat unfold @var{repeatcount} @var{musicexpr} @end example -where @var{repeatbody} is a music expression. Unfold repeats can be +where @var{musicexpr} is a music expression. Unfold repeats can be made with or without alternate endings. Unfold repeats without alternate endings: @@ -296,7 +296,7 @@ Unfold repeats with alternate endings: @lilypond[quote,ragged-right,verbatim,fragment,relative=2] c1 -\repeat unfold 2 { g f e d } +\repeat unfold 2 { g4 f e d } \alternative { { cis2 g' } { cis,2 b } @@ -334,14 +334,15 @@ Percent repeats must be declared within a @code{Voice} context. The syntax is @example -@code{\repeat percent @var{number} @var{repeatbody}} +@code{\repeat percent @var{number} @var{musicexpr}} @end example -where @var{repeatbody} is a music expression. +where @var{musicexpr} is a music expression. @lilypond[quote,verbatim,ragged-right] \new Voice \relative c' { \repeat percent 4 { c4 } + \repeat percent 2 { b4 a4 g4 f4 } \repeat percent 2 { c2 es2 f4 fis4 g4 c4 } } @end lilypond