+@lilypond[verbatim,quote,ragged-right]
+\score {
+ <<
+ \new Staff {
+ \new Voice = "singleVoice" {
+ \relative c'' { a4 a a a }
+ \new Voice = "repeatVoice" {
+ \relative c'' \repeat volta 3 { b4 b b b }
+ }
+ \relative c'' { c4 c c c }
+ }
+ }
+ \new Lyrics <<
+ \lyricsto "singleVoice" {
+ Not re -- peat -- ed.
+ The end sec -- tion.
+ }
+ \lyricsto "repeatVoice" {
+ The first time words.
+ }
+ >>
+ \new Lyrics {
+ \lyricsto "repeatVoice" {
+ Sec -- ond time words.
+ }
+ }
+ \new Lyrics {
+ \lyricsto "repeatVoice" {
+ The third time words.
+ }
+ }
+ >>
+}
+@end lilypond
+
+@c TODO lowering a common line of lyrics
+
+@subheading Repeats with alternative endings
+
+@cindex lyrics, repeats with alternative endings
+@cindex repeating lyrics with alternative endings
+@cindex alternative endings and lyrics
+
+If the words of the repeated section are the same, exactly the
+same structure can be used for both the lyrics and music.
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff {
+ \time 2/4
+ \new Voice = "melody" {
+ \relative c'' {
+ a4 a a a
+ \repeat volta 2 { b4 b }
+ \alternative { { b b } { b c } }
+ }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ Not re -- peat -- ed.
+ \repeat volta 2 { Re -- peat -- }
+ \alternative { { ed twice. } { ed twice. } }
+ }
+ }
+ >>
+}
+@end lilypond
+
+But when the repeated section has different words, a repeat
+construct cannot be used around the words and @code{\skip} commands
+have to be inserted manually as described in the previous section to
+skip over the notes in the alternative sections which do not apply.
+
+@lilypond[verbatim,quote,ragged-right]
+\score {
+ <<
+ \new Staff {
+ \time 2/4
+ \new Voice = "melody" {
+ \relative c'' {
+ \repeat volta 2 { b4 b }
+ \alternative { { b b } { b c } }
+ c4 c
+ }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ The first time words.
+ \repeat unfold 2 { \skip 1 }
+ End here.
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ Sec -- ond
+ \repeat unfold 2 { \skip 1 }
+ time words.
+ }
+ }
+ >>
+}
+@end lilypond
+
+@cindex lyrics and tied notes
+@funindex \repeatTie
+
+When a note is tied over into two or more alternative endings a
+tie is used to carry the note into the first alternative ending and
+a @code{\repeatTie} is used in the second and subsequent endings.
+This structure causes difficult alignment problems when lyrics are
+involved and increasing the length of the alternative sections so
+the tied notes are contained wholly within them may give a more
+acceptable result.
+
+The tie creates a melisma into the first alternative, but not into
+the second and subsequent alternatives, so to align the lyrics
+correctly it is necessary to disable the automatic creation of
+melismata over the volta section and insert manual skips.
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff {
+ \time 2/4
+ \new Voice = "melody" {
+ \relative c'' {
+ \set melismaBusyProperties = #'()
+ \repeat volta 2 { b4 b ~}
+ \alternative { { b b } { b \repeatTie c } }
+ \unset melismaBusyProperties
+ c4 c
+ }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ \repeat volta 2 { Here's a __ }
+ \alternative {
+ { \skip 1 verse }
+ { \skip 1 sec }
+ }
+ ond one.
+ }
+ }
+ >>
+}
+@end lilypond
+
+Note that if @code{\unfoldRepeats} is used around a section
+containing @code{\repeatTie}, the @code{\repeatTie} should be
+removed to avoid both types of tie being printed.
+
+When the repeated section has different words a @code{\repeat}
+cannot be used around the lyrics and @code{\skip} commands need to
+be inserted manually, as before.
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff {
+ \time 2/4
+ \new Voice = "melody" {
+ \relative c'' {
+ \repeat volta 2 { b4 b ~}
+ \alternative { { b b } { b \repeatTie c } }
+ c4 c
+ }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ Here's a __ verse.
+ \repeat unfold 2 { \skip 1 }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ Here's one
+ \repeat unfold 2 { \skip 1 }
+ more to sing.
+ }
+ }
+ >>
+}
+@end lilypond
+
+If you wish to show extenders and hyphens into and out of
+alternative sections these must be inserted manually.
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff {
+ \time 2/4
+ \new Voice = "melody" {
+ \relative c'' {
+ \repeat volta 2 { b4 b ~}
+ \alternative { { b b } { b \repeatTie c } }
+ c4 c
+ }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ Here's a __ verse.
+ \repeat unfold 2 { \skip 1 }
+ }
+ }
+ \new Lyrics {
+ \lyricsto "melody" {
+ Here's "a_"
+ \skip 1
+ "_" sec -- ond one.
+ }
+ }
+ >>
+}
+@end lilypond
+
+
+
+@node Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
+
+@cindex divided lyrics
+@cindex lyrics, divided
+
+When just the words and rhythms of the two parts differ with the
+pitches remaining the same, temporarily turning off the automatic
+detection of melismata and indicating the melisma in the lyrics
+may be the appropriate method to use:
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Voice = "melody" {
+ \relative c' {
+ \set melismaBusyProperties = #'()
+ \slurDown
+ \slurDashed
+ e4 e8 ( e ) c4 c |
+ \unset melismaBusyProperties
+ c
+ }
+ }
+ \new Lyrics \lyricsto "melody" {
+ They shall not o -- ver -- come
+ }
+ \new Lyrics \lyricsto "melody" {
+ We will _
+ }
+ >>
+}
+@end lilypond
+
+When both music and words differ it may be better to display
+the differing music and lyrics by naming voice contexts and
+attaching lyrics to those specific contexts:
+
+@lilypond[verbatim,ragged-right,quote]
+\score {
+ <<
+ \new Voice = "melody" {
+ \relative c' {
+ <<
+ {
+ \voiceOne
+ e4 e8 e
+ }
+ \new Voice = "splitpart" {
+ \voiceTwo
+ c4 c
+ }
+ >>
+ \oneVoice
+ c4 c |
+ c
+ }
+ }
+ \new Lyrics \lyricsto "melody" {
+ They shall not o -- ver -- come
+ }
+ \new Lyrics \lyricsto "splitpart" {
+ We will
+ }
+ >>
+}
+@end lilypond
+
+
+@node Stanzas
+@subsection Stanzas
+
+@menu
+* Adding stanza numbers::
+* Adding dynamics marks to stanzas::
+* Adding singers' names to stanzas::
+* Stanzas with different rhythms::
+* Printing stanzas at the end::
+* Printing stanzas at the end in multiple columns::
+@end menu
+
+
+@node Adding stanza numbers
+@unnumberedsubsubsec Adding stanza numbers
+
+@cindex stanza number
+
+Stanza numbers can be added by setting @code{stanza}, e.g.,
+
+@lilypond[quote,ragged-right,verbatim,relative=2]
+\new Voice {
+ \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+ \set stanza = #"1. "
+ Hi, my name is Bert.
+} \addlyrics {
+ \set stanza = #"2. "
+ Oh, ché -- ri, je t'aime
+}
+@end lilypond
+
+
+@noindent
+These numbers are put just before the start of the first syllable.
+
+@c TODO Create and add snippet to show how two lines of a
+@c stanza can be grouped together, along these lines:
+@c (might need improving a bit) -td
+
+@ignore
+leftbrace = \markup { \override #'(font-encoding . fetaBraces) \lookup
+#"brace105" }
+
+stanzaOneOne = {
+ \set stanza = \markup { "1. " \leftbrace }
+ \lyricmode { Child, you're mine and I love you.
+ Lend thine ear to what I say.
+
+ }
+}
+
+stanzaOneThree = {
+% \set stanza = \markup { " "}
+ \lyricmode { Child, I have no great -- er joy
+ Than to have you walk in truth.
+
+ }
+}
+
+\new Voice {
+ \repeat volta 2 { c'8 c' c' c' c' c' c'4
+ c'8 c' c' c' c' c' c'4 }
+} \addlyrics { \stanzaOneOne }
+ \addlyrics { \stanzaOneThree }
+
+@end ignore
+
+@node Adding dynamics marks to stanzas
+@unnumberedsubsubsec Adding dynamics marks to stanzas
+
+Stanzas differing in loudness may be indicated by putting a
+dynamics mark before each stanza. In LilyPond, everything coming in
+front of a stanza goes into the @code{StanzaNumber} object; dynamics marks
+are no different. For technical reasons, you have to set the stanza
+outside @code{\lyricmode}:
+
+@lilypond[quote,ragged-right,verbatim]
+text = {
+ \set stanza = \markup { \dynamic "ff" "1. " }
+ \lyricmode {
+ Big bang
+ }
+}
+
+<<
+ \new Voice = "tune" {
+ \time 3/4
+ g'4 c'2
+ }
+\new Lyrics \lyricsto "tune" \text
+>>
+@end lilypond
+
+@node Adding singers' names to stanzas
+@unnumberedsubsubsec Adding singers' names to stanzas
+
+@cindex singer name
+@cindex name of singer
+
+Names of singers can also be added. They are printed at the start of
+the line, just like instrument names. They are created by setting
+@code{vocalName}. A short version may be entered as @code{shortVocalName}.
+
+@lilypond[ragged-right,quote,verbatim,relative=2]
+\new Voice {
+ \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {