+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=2]
+\repeat volta 2 { c4 d e f | }
+\alternative {
+ { 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 | }
+\alternative {
+ { c2 e | }
+ { f2 g | }
+}
+c1
+@end lilypond
+
+Multiple repeats with more than one alternate ending: