Merge branch 'master' of git://git.sv.gnu.org/lilypond

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

diff --git a/Documentation/user/repeats.itely b/Documentation/user/repeats.itely
index 911ceb53931cc9d8ecdb7bf1337f4c2fd23a6a61..86e7bd9acecae300af9181b47fea40580bc2d5a5 100644 (file)
--- 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