@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
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
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
@menu
-* Writing long repeats::
+* Long repeats::
* Short repeats::
@end menu
-@node Writing long repeats
-@subsection Writing long repeats
+@node Long repeats
+@subsection Long repeats
+
+This section discusses how to input long (usually multi-measure)
+repeats. The repeats can take two forms: repeats enclosed between
+repeat signs; or written out repeats, used to input repetitious music.
+Repeat signs can also be controlled manually.
@menu
* Normal repeats::
* Manual repeat marks::
-* Written-out repeats::
+* Written-out repeats::
@end menu
@cindex volta
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:
Normal repeats with alternate endings:
@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\repeat volta 2 { g f e d }
+\repeat volta 2 { g4 f e d }
\alternative {
{ cis2 g' }
{ cis,2 b }
\new Staff {
\partial 4
e |
- \repeat volta 4 { c2 d2 | e2 f2 | }
- \alternative { { g4 g g e } { a a a a | b2. } }
+ \repeat volta 4 { c2 d | e2 f | }
+ \alternative {
+ { g4 g g e }
+ { a4 a a a | b2. }
+ }
}
@end lilypond
@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
\new Staff {
\partial 4
- \repeat volta 4 { e | c2 d2 | e2 f2 | }
- \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
+ \repeat volta 4 { e4 | c2 d | e2 f | }
+ \alternative {
+ { \partial 4*3 g4 g g }
+ { a4 a a a | b2. }
+ }
}
@end lilypond
@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
c1
\repeat volta 2 {c4 d e f ~ }
-\alternative { {f2 d} {f\repeatTie f,} }
+\alternative {
+ {f2 d}
+ {f2\repeatTie f,}
+}
@end lilypond
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{shortening-volta-brackets.ly}
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{adding-volta-brackets-to-additional-staves.ly}
Notation Reference: @ref{Bar lines}, @ref{Modifying context plug-ins}.
-Snippets: @lsrdir{Repeats,Repeats}.
+Snippets: @rlsr{Repeats}.
-Internals Reference: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic}, @internalsref{VoltaRepeatedMusic},
-@internalsref{UnfoldedRepeatedMusic}.
+Internals Reference: @rinternals{VoltaBracket},
+@rinternals{RepeatedMusic}, @rinternals{VoltaRepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
@knownissues
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c4
\set Score.repeatCommands = #'((volta "93") end-repeat)
-c4 c4
+c4 b
\set Score.repeatCommands = #'((volta #f))
-c4 c4
+d4 e
@end lilypond
@c FIXME: improve visibility of bar lines link?
Notation Reference: @ref{Bar lines}, @ref{Formatting text}.
-Snippets: @lsrdir{Repeats,Repeats}
+Snippets: @rlsr{Repeats}.
-Internals Reference: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic}, @internalsref{VoltaRepeatedMusic}.
+Internals Reference: @rinternals{VoltaBracket},
+@rinternals{RepeatedMusic}, @rinternals{VoltaRepeatedMusic}.
@node Written-out repeats
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:
@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 }
@seealso
-Snippets: @lsrdir{Repeats,Repeats}.
+Snippets: @rlsr{Repeats}.
-Internals Reference: @internalsref{RepeatedMusic},
-@internalsref{UnfoldedRepeatedMusic}.
+Internals Reference: @rinternals{RepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
@node Short repeats
@subsection Short repeats
+This section discusses how to input short repeats. Short repeats can
+take two basic forms: repeats of a single note to two measures,
+represented by slashes or percent signs; and tremolos.
+
@menu
* Percent repeats::
* Tremolo repeats::
@cindex percent repeats
@cindex measure repeats
-Repeated short patterns of notes are also supported. The music is
-printed once, and the pattern is replaced with a special sign.
-Patterns of one and two measures are replaced by percent-like signs,
-patterns that are shorter than onee measure are replaced by slashes.
-Percent repeats must be declared within a @code{Voice} context. The
-syntax is
+Repeated short patterns of notes are supported. The music is printed
+once, and the pattern is replaced with a special sign. Patterns that
+are shorter than one measure are replaced by slashes, and patterns of
+one or two measures are replaced by percent-like signs. Percent
+repeats must be declared within a @code{Voice} context. The syntax is
@example
-@code{\repeat percent @var{number} @var{repeatbody}}
-@end expample
+@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' {
+\relative c' {
\repeat percent 4 { c4 }
- \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
+ \repeat percent 2 { b'4 a g f }
+ \repeat percent 2 { c2 es | f4 fis g c | }
}
@end lilypond
-Measure repeats of more than two measures get a counter if you
-switch on the @code{countPercentRepeats} property:
+Measure repeats of more than two repeats get a counter if you switch
+on the @code{countPercentRepeats} property:
@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
+\relative c' {
\set countPercentRepeats = ##t
\repeat percent 4 { c1 }
}
@seealso
-Snippets: @lsrdir{Repeats,Repeats}
+Snippets: @rlsr{Repeats}.
-Internals Reference: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.
+Internals Reference: @rinternals{RepeatSlash},
+@rinternals{PercentRepeat}, @rinternals{DoublePercentRepeat},
+@rinternals{DoublePercentRepeatCounter},
+@rinternals{PercentRepeatCounter}, @rinternals{PercentRepeatedMusic}.
@node Tremolo repeats
@subsubsection Tremolo repeats
+Tremolos can take two forms: alternation between two chords or two
+notes, and rapid repetition of a single
+note or chord. Tremolos consisting of an alternation are indicated by
+adding beams between the notes or chords being alternated, while
+tremolos consisting of the rapid repetition of a single note are
+indicated by adding beams or slashes to a single note.
+
@cindex tremolo beams
To place tremolo marks between notes, use @code{\repeat} with
tremolo style:
@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
- \repeat tremolo 8 { c16 d16 }
- \repeat tremolo 4 { c16 d16 }
- \repeat tremolo 2 { c16 d16 }
+\relative c' {
+ \repeat tremolo 8 { c16 d }
+ \repeat tremolo 4 { c16 d }
+ \repeat tremolo 2 { c16 d }
}
@end lilypond
Notation Reference: @ref{Tremolo repeats}.
-Internals Reference: @internalsref{Beam},
-@internalsref{StemTremolo}.
-
-Snippets: @lsrdir{Repeats,Repeats}
-
-Elsewhere: @internalsref{StemTremolo}.
-
+Internals Reference: @rinternals{Beam}, @rinternals{StemTremolo}.
+Snippets: @rlsr{Repeats}.
+Elsewhere: @rinternals{StemTremolo}.