+Alternative endings can be produced using @code{\alternative}. Each
+group of alternatives must be themselves, enclosed in a set of braces.
+
+@example
+\repeat volta @var{repeatcount} @var{musicexpr}
+\alternative @{
+ @{ @var{musicexpr} @}
+@}
+@end example
+
+@noindent
+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 {
+ \repeat volta 2 { c''4 d e f | }
+ \alternative {
+ { c2 e | }
+ { f2 g | }
+ }
+ c1
+}
+@end lilypond
+
+Multiple repeats with one alternate ending:
+
+@lilypond[verbatim,quote]
+\relative {
+ \repeat volta 4 { c''4 d e f | }
+ \alternative {
+ { c2 e | }
+ { f2 g | }
+ }
+ c1
+}
+@end lilypond
+
+Multiple repeats with more than one alternate ending:
+
+@lilypond[verbatim,quote]
+\relative {
+ \repeat volta 3 { c''4 d e f | }
+ \alternative {
+ { 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.}
+