by examining the simplest method, and gradually increase complexity.
@menu
-* Setting simple songs::
-* Entering lyrics::
+* Simple lyrics::
* Aligning lyrics to a melody::
-* Working with lyrics and variables::
+* Vocals and variables::
* Flexibility in placement::
-* Spacing lyrics::
+* Spacing vocals::
* More about stanzas::
-* Other vocal issues::
@end menu
-@commonprop
+@snippets
Checking to make sure that text scripts and lyrics are within the margins is
a relatively large computational task. To speed up processing, lilypond does
\override Score.PaperColumn #'keep-inside-line = ##t
@end example
-To make lyrics avoid barlines as well, use
+To make lyrics avoid bar lines as well, use
+
@example
\layout @{
\context @{
@}
@end example
+
+@node Simple lyrics
+@subsection Simple lyrics
+
+@menu
+* Setting simple songs::
+* Entering lyrics::
+@end menu
+
@node Setting simple songs
-@subsection Setting simple songs
+@subsubsection Setting simple songs
@cindex \addlyrics
@node Entering lyrics
-@subsection Entering lyrics
+@subsubsection Entering lyrics
@cindex lyrics
@funindex \lyricmode
simply insert the characters directly into the input file and save
it with utf-8 encoding. See @ref{Text encoding}, for more info.
+FIXME: quotes.
+
@lilypond[quote,ragged-right,fragment,verbatim]
\relative { e4 f e d e f e2 }
\addlyrics { He said: “Let my peo ple goâ€\9d. }
Internals Reference: @internalsref{LyricText}, @internalsref{LyricSpace}.
-
@node Aligning lyrics to a melody
@subsection Aligning lyrics to a melody
@end menu
@node Automatic syllable durations
-@unnumberedsubsubsec Automatic syllable durations
+@subsubsection Automatic syllable durations
@cindex automatic syllable durations
@cindex lyrics and melodies
@end example
@node Another way of entering lyrics
-@unnumberedsubsubsec Another way of entering lyrics
+@subsubsection Another way of entering lyrics
Lyrics can also be entered without @code{\addlyrics} or
@code{\lyricsto}. In this case,
@node Assigning more than one syllable to a single note
-@unnumberedsubsubsec Assigning more than one syllable to a single note
+@subsubsection Assigning more than one syllable to a single note
@funindex _
@node More than one note on a single syllable
-@unnumberedsubsubsec More than one note on a single syllable
+@subsubsection More than one note on a single syllable
@cindex melisma
@cindex melismata
@rlearning{Vocal ensembles}.
-@refcommands
+@predefined
@code{\melisma}, @code{\melismaEnd}
@funindex \melismaEnd
Internals Reference: @internalsref{Melisma_translator}.
-@lsr{vocal,lyric@/-combine.ly}.
+@c @lsr{vocal,lyric@/-combine.ly}.
-@refbugs
+@knownissues
Melismata are not detected automatically, and extender lines must be
inserted by hand.
@node Extenders and hyphens
-@unnumberedsubsubsec Extenders and hyphens
+@subsubsection Extenders and hyphens
@cindex melisma
@cindex extender
+@c leave this as samp. -gp
Melismata are indicated with a horizontal line centered between a syllable
and the next one. Such a line is called an extender line, and it is entered
as @samp{ __ } (note the spaces before and after the two underscore
@cindex hyphens
+@c leave this as samp. -gp
Centered hyphens are entered as @samp{ -- } between syllables of a same word
(note the spaces before and after the two hyphen characters). The hyphen
will be centered between the syllables, and its length will be adjusted
depending on the space between the syllables.
-In tighly engraved music, hyphens can be removed. Whether this
+In tightly engraved music, hyphens can be removed. Whether this
happens can be controlled with the @code{minimum-distance} (minimum
distance between two syllables) and the @code{minimum-length}
(threshold below which hyphens are removed).
@internalsref{LyricHyphen}
+@node Vocals and variables
+@subsection Vocals and variables
+
+@menu
+* Working with lyrics and variables::
+@end menu
+
@node Working with lyrics and variables
-@subsection Working with lyrics and variables
+@subsubsection Working with lyrics and variables
+
@cindex lyrics, variables
To define variables containing lyrics, the function @code{\lyricmode}
@node Lyrics to multiple notes of a melisma
-@unnumberedsubsubsec Lyrics to multiple notes of a melisma
+@subsubsection Lyrics to multiple notes of a melisma
One possibility is that the text has a melisma in one stanza, but
multiple syllables in another one. One solution is to make the faster
@node Divisi lyrics
-@unnumberedsubsubsec Divisi lyrics
+@subsubsection Divisi lyrics
You can display alternate (or divisi) lyrics by naming voice
contexts and attaching lyrics to those specific contexts.
@node Switching the melody associated with a lyrics line
-@unnumberedsubsubsec Switching the melody associated with a lyrics line
+@subsubsection Switching the melody associated with a lyrics line
More complex variations in text underlay are possible. It is possible
to switch the melody for a line of lyrics during the text. This is
@node Lyrics independent of notes
-@unnumberedsubsubsec Lyrics independent of notes
+@subsubsection Lyrics independent of notes
In some complex vocal music, it may be desirable to place
lyrics completely independently of notes. Music defined
@end lilypond
+@node Spacing vocals
+@subsection Spacing vocals
+
+@menu
+* Spacing lyrics::
+@end menu
+
@node Spacing lyrics
-@subsection Spacing lyrics
+@subsubsection Spacing lyrics
@cindex Spacing lyrics
@cindex Lyrics, increasing space between
@node More about stanzas
@subsection More about stanzas
+@menu
+* Adding stanza numbers ::
+* Adding dynamics marks::
+* Adding singer names::
+* Printing stanzas at the end ::
+* Printing stanzas at the end in multiple columns ::
+@end menu
+
+
+@node Adding stanza numbers
+@subsubsection Adding stanza numbers
+
@cindex stanza number
-@unnumberedsubsubsec Adding stanza numbers
Stanza numbers can be added by setting @code{stanza}, e.g.,
These numbers are put just before the start of the first syllable.
-@unnumberedsubsubsec Adding dynamics marks
+@node Adding dynamics marks
+@subsubsection Adding dynamics marks
Stanzas differing in loudness may be indicated by putting a
-dynamics mark before each stanza. In Lilypond, everthing coming in
+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}:
>>
@end lilypond
+@node Adding singer names
+@subsubsection Adding singer names
+
@cindex singer name
@cindex name of singer
-@unnumberedsubsubsec Adding singer names
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
@end lilypond
-@unnumberedsubsubsec Printing stanzas at the end
+@node Printing stanzas at the end
+@subsubsection Printing stanzas at the end
Sometimes it is appropriate to have one stanza set
to the music, and the rest added in verse form at
@end lilypond
-@unnumberedsubsubsec Printing stanzas at the end in multiple columns
+@node Printing stanzas at the end in multiple columns
+@subsubsection Printing stanzas at the end in multiple columns
When a piece of music has many verses, they are often printed in
multiple columns across the page. An outdented verse number often
Internals Reference: @internalsref{LyricText}, @internalsref{StanzaNumber},
@internalsref{VocalName}.
-
-
-@node Other vocal issues
-@subsection Other vocal issues
-
+@c TODO: stick elsewhere
@ignore
+@n ode Other vocal issues
+@s ubsection Other vocal issues
+
yeah, I'm giving up somewhat by stuffing a bunch of things in
here. But at least they're in the manual now; it's easier to
move them around in the manual once they're already here.
Besides, if users complain about everything stuffed in here, I
can ask them for specific instructions about where to move these
examples, and that might get them more involved in the docs. -gp
-@end ignore
+
@q{Parlato} is spoken without pitch but still with rhythm; it is
-notated by cross noteheads. This is demonstrated in
-@ref{Special noteheads}.
+notated by cross note heads. This is demonstrated in
+@ref{Special note heads}.
+@end ignore