Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.14.0"
@node Repeats
@section Repeats
@item unfold
The repeated music is fully written out, as many times as
-specified by @var{repeatcount}. This is useful when
+specified by @code{@var{repeatcount}}. This is useful when
entering repetitious music.
@item percent
@end example
@noindent
-where @var{musicexpr} is a music expression.
+where @code{@var{musicexpr}} is a music expression.
A single repeat without an alternate ending:
@end example
@noindent
-where @var{musicexpr} is a music expression.
+where @code{@var{musicexpr}} is a music expression.
If there are more repeats than there are alternate endings, the earliest
repeats are given the first alternative.
A single repeat with one alternate ending:
@lilypond[verbatim,quote,relative=2]
-\repeat volta 2 { c4 d e f }
+\repeat volta 2 { c4 d e f | }
\alternative {
- { c2 e }
- { f2 g }
+ { c2 e | }
+ { f2 g | }
}
c1
@end lilypond
A single repeat with more than one alternate ending:
@lilypond[verbatim,quote,relative=2]
-\repeat volta 4 { c4 d e f }
+\repeat volta 4 { c4 d e f | }
\alternative {
- { c2 e }
- { f2 g }
+ { c2 e | }
+ { f2 g | }
}
c1
@end lilypond
Multiple repeats with more than one alternate ending:
@lilypond[verbatim,quote,relative=2]
-\repeat volta 3 { c4 d e f }
+\repeat volta 3 { c4 d e f | }
\alternative {
- { c2 e }
- { f2 g }
- { a2 g }
+ { c2 e | }
+ { f2 g | }
+ { a2 g | }
}
c1
@end lilypond
+@warning{If there are two or more alternatives, nothing should appear
+between the closing brace of one and the opening brace of the next
+in an @code{@bs{}alternative} block, otherwise you will not get the
+expected number of endings.}
+
@warning{If you include @code{@bs{}relative} inside a
@code{@bs{}repeat} without explicitly instantiating the
@code{Voice} context, extra (unwanted) staves will appear. See
@cindex pickup in a repeat
@funindex \partial
-
If a repeat starts in the middle of a measure and has no alternate
endings, normally the end of the repeat will also fall in the
middle of a measure, so that the two ends add up to one complete
@snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{shortening-volta-brackets.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{adding-volta-brackets-to-additional-staves.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{setting-the-double-repeat-default-for-volte.ly}
@seealso
@snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
@end example
@noindent
-where @var{musicexpr} is a music expression and @var{repeatcount} is
-the number of times @var{musicexpr} is repeated.
+where @code{@var{musicexpr}} is a music expression and
+@code{@var{repeatcount}} is the number of times
+@code{@var{musicexpr}} is repeated.
@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 { c4 d e f }
c1
@end lilypond
-If there are more alternate endings than repeats then the first
-alternatives are applied, LilyPond will ignore the remaining
-alternatives which will not be printed.
+If there are more alternate endings than repeats then only the first
+alternatives are applied. The remaining alternatives will be ignored
+and not printed.
@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 { c4 d e f }
The syntax is
@example
-@code{\repeat percent @var{number} @var{musicexpr}}
+\repeat percent @var{number} @var{musicexpr}
@end example
@noindent
-where @var{musicexpr} is a music expression.
+where @code{@var{musicexpr}} is a music expression.
Patterns that are shorter than one measure are replaced by slashes.
@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c128 d e f }
+\repeat percent 4 { c64 d e f }
+\repeat percent 5 { c32 d e f }
+\repeat percent 4 { c16 d e f }
\repeat percent 4 { c8 d }
\repeat percent 4 { c4 }
\repeat percent 2 { c2 }
@end lilypond
-Patterns of one or two measures are replaced by percent-like signs.
+Patterns of one or two measures are replaced by percent-like symbols.
@lilypond[verbatim,quote,relative=2]
-\repeat percent 3 { c4 d e f }
-\repeat percent 4 { c2 d }
+\repeat percent 2 { c4 d e f }
+\repeat percent 2 { c2 d }
+\repeat percent 2 { c1 }
@end lilypond
@lilypond[verbatim,quote,relative=2]
\repeat percent 3 { c4 d e f | c2 g' }
@end lilypond
+Patterns that are shorter than one measure but contain mixed durations
+use a double-percent symbol.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c8. <d f>16 }
+\repeat percent 2 { \times 2/3 { r8 c d } e4 }
+@end lilypond
+
@snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{percent-repeat-counter.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{percent-repeat-count-visibility.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{isolated-percent-repeats.ly}
-
@seealso
Music Glossary:
@rglos{percent repeat},
Internals Reference:
@rinternals{RepeatSlash},
+@rinternals{RepeatSlashEvent},
+@rinternals{DoubleRepeatSlash},
@rinternals{PercentRepeat},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic},
+@rinternals{Percent_repeat_engraver},
+@rinternals{DoublePercentEvent},
@rinternals{DoublePercentRepeat},
@rinternals{DoublePercentRepeatCounter},
-@rinternals{PercentRepeatCounter},
-@rinternals{PercentRepeatedMusic}.
-
-
-@knownissues
-
-Only three kinds of percent repeats are supported: a single slash
-representing a single beat (regardless of the duration of the repeated
-notes); a single slash with dots representing one full measure; and
-two slashes with dots crossing a bar line representing two full
-measures. Neither multiple slashes representing single beat repeats
-consisting of sixteenth or shorter notes, nor two slashes with dots
-representing single beat repeats consisting of notes of varying
-durations, are supported.
+@rinternals{Double_percent_repeat_engraver},
+@rinternals{Slash_repeat_engraver}.
@node Tremolo repeats
@funindex tremoloFlags
@funindex :
-The same output can be obtained by adding
-@q{@code{:}[@var{number}]} after the note. The number indicates
-the duration of the subdivision, and it must be at least 8. A
-@var{number} value of 8 gives one line across the note stem. If
-the length is omitted, the last value (stored in
-@code{tremoloFlags}) is used:
+The same output can be obtained by adding @code{:@var{N}} after
+the note, where @code{@var{N}} indicates the duration of the
+subdivision (it must be at least 8). If @code{@var{N}} is 8, one
+beam is added to the note's stem. If @code{@var{N}} is omitted,
+the last value (stored in @code{tremoloFlags}) is used:
@lilypond[quote,verbatim,relative=2]
c2:8 c:32
@snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{cross-staff-tremolos.ly}