]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/notation.itely
use usescons for using scons.
[lilypond.git] / Documentation / user / notation.itely
index 067b51b20c26ede20bd06516f6135a566159cde8..74fa827f560ad070ba83bb3ab9a775ebcfb75c4a 100644 (file)
@@ -233,6 +233,8 @@ note with the @code{\rest} keyword appended. This makes manual
 formatting in polyphonic music easier.  Rest collision testing will
 leave these rests alone
 
+@cindex @code{\rest}
 @lilypond[quote,raggedright,verbatim]
 a'4\rest d'4\rest
 @end lilypond
@@ -292,6 +294,9 @@ Program reference: @internalsref{SkipEvent}, @internalsref{SkipMusic}.
 
 
 @cindex duration
+@cindex @code{\longa}
+@cindex @code{\breve}
+@cindex @code{\maxima}
 
 
 In Note, Chord, and Lyrics mode, durations are designated by numbers
@@ -318,7 +323,7 @@ r1 r2 r4 r8 r16 r32 r64 r64
   \paper {
     raggedright = ##t
     \context {
-      \StaffContext
+      \Staff
         \remove "Clef_engraver"
         \override StaffSymbol #'transparent = ##t 
         \override TimeSignature #'transparent = ##t
@@ -511,6 +516,10 @@ instead.
 
 @seealso
 
+User manual: @ref{Changing context properties on the fly} for the
+@code{\set} command.
+
+
 Program reference: @internalsref{TupletBracket}, and @internalsref{TimeScaledMusic}.
 
 Examples: @inputfileref{input/regression,tuplet-nest.ly}.
@@ -603,7 +612,7 @@ to determine the first note of the next chord
 @cindex @code{\notes}
 
 The pitch after the @code{\relative} contains a note name.  To parse
-the note name as a pitch, it must surrounded by @code{\notes}
+the note name as a pitch, it must be surrounded by @code{\notes}
 
 The relative conversion will not affect @code{\transpose},
 @code{\chords} or @code{\relative} sections in its argument.  If you
@@ -629,13 +638,14 @@ following notes.
 
 
 
-There is also a syntax that is separate from the notes.
+There is also a syntax that is separate from the notes. The syntax
+
 @example
 \octave @var{pitch}
 @end example
 
-This checks that @var{pitch} (without octave) yields @var{pitch} (with
-octave) in \relative mode. If not, a warning is printed, and the
+This checks that @var{pitch} (without quotes) yields @var{pitch} (with
+quotes) in \relative mode. If not, a warning is printed, and the
 octave is corrected, for example, the first check is passed
 successfully.  The second check fails with an error message.  The
 octave is adjusted so the following notes are in the correct octave
@@ -1034,7 +1044,7 @@ measure is subdivided in 2, 2, 2 and 3. This is passed to
   }
   \paper {
     \context {
-      \StaffContext
+      \Staff
       \consists "Measure_grouping_engraver"
     }
   }
@@ -1081,6 +1091,8 @@ indicating how much of the measure has passed at this point.
 @node Unmetered music
 @subsection Unmetered music
 
+@cindex @code{\bar}
+
 Bar lines and bar numbers are calculated automatically. For unmetered
 music (e.g. cadenzas), this is not desirable.  By setting
 @code{Score.timing} to false, this automatic timing can be switched
@@ -1094,7 +1106,6 @@ off. Empty bar lines,
 indicate where line breaks can occur.
 
 
-
 @refcommands
 
 @cindex @code{\cadenzaOn}
@@ -1170,7 +1181,7 @@ The command @code{\bar }@var{bartype} is a short cut for doing
 is set to a string, a bar line of that type is created.
 
 @cindex whichBar
-@cindex repeatCommands
+@cindex @code{repeatCommands}
 @cindex defaultBarType
 
 You are encouraged to use @code{\repeat} for repetitions.  See
@@ -1206,6 +1217,8 @@ The easiest way to enter fragments with more than one voice on a staff
 is to split chords using the separator @code{\\}.  You can use it for
 small, short-lived voices or for single chords
 
+@cindex @code{\\}
+
 @lilypond[quote,verbatim,fragment]
 \context Staff \relative c'' {
   c4 << { f d e  } \\ { b c2 } >>
@@ -1263,8 +1276,8 @@ Similarly, you can merge half note heads with eighth notes, by setting
 c8 c4. } \\ { c2 c2 } >>
 @end lilypond
 
-LilyPond also vertically shifts rests that are opposite of a stem
-
+LilyPond also vertically shifts rests that are opposite of a stem,
+for example
 
 @lilypond[quote,raggedright,fragment,verbatim]
 \context Voice << c''4 \\  r4 >>
@@ -1428,6 +1441,11 @@ behavior can be changed by setting @code{allowBeamBreak}.
 @cindex auto-knee-gap
 
 
+@seealso
+
+User manual: @ref{Changing context properties on the fly} for the
+@code{\set} command
+
 
 @refbugs
 
@@ -1943,7 +1961,7 @@ To use this, add the @internalsref{Horizontal_bracket_engraver} to
   }
   \paper {
     \context {
-      \StaffContext \consists "Horizontal_bracket_engraver"
+      \Staff \consists "Horizontal_bracket_engraver"
 }}}
 @end lilypond
 
@@ -2528,6 +2546,13 @@ c1
 }
 @end lilypond
 
+@seealso
+
+Brackets for the repeat are normally only printed over the topmost
+staff. This can be adjusted by setting the @code{voltaOnThisStaff}
+property @inputfileref{input/regression,volta-multi-staff.ly},
+@inputfileref{input/regression,volta-chord-names.ly}
+
 @refbugs
 
 A nested repeat like
@@ -2545,6 +2570,16 @@ having the @code{\alternative} belong to the inner @code{\repeat}.
 For clarity, it is advisable to use braces in such situations.
 @cindex ambiguity
 
+
+
+Timing information is not remembered at the start of an alternative,
+so after a repeat timing information must be reset by hand, for
+example by setting @code{Score.measurePosition} or entering
+@code{\partial}.  Similarly, slurs or ties are also not repeated.
+
+
+
+
 @node Repeats and MIDI
 @subsection Repeats and MIDI
 
@@ -2554,13 +2589,6 @@ For instructions on how to expand repeats for MIDI output, see the
 example file @inputfileref{input/test,unfold-all-repeats.ly}.
 
 
-@refbugs
-
-Timing information is not remembered at the start of an alternative,
-so after a repeat timing information must be reset by hand, for
-example by setting @code{Score.measurePosition} or entering
-@code{\partial}.  Similarly, slurs or ties are also not repeated.
-
 
 @node Manual repeat commands
 @subsection Manual repeat commands
@@ -2817,7 +2845,7 @@ mus = \drums  { cymc cyms cymr hh | hhc hho hhho hhp | \break cb hc
     \paper {
     %% need to do this, because of indented @itemize
     linewidth= 9 \cm 
-    \context { \ScoreContext
+    \context { \Score
     \override LyricText #'font-family = #'typewriter
     \override BarNumber #'transparent =##T
 }}}
@@ -3287,9 +3315,42 @@ The associated object is @internalsref{VoiceFollower}.
 @node Vocal music
 @section Vocal music
 
-This section discusses how to enter and print lyrics.
+
+The easiest way to add lyrics to a melody, is by appending
+
+
+@cindex \newlyrics
+@example
+  \newlyrics @{ @var{the lyrics} @} 
+@end example
+
+to a melody. Here is an example,
+
+@lilypond[raggedright,verbatim]
+  \relative { \time 3/4 c2 e4 g2. }
+  \newlyrics { play the game } 
+@end lilypond
+
+More stanzas can be added by adding more
+@code{\newlyrics} sections 
+
+@lilypond[raggedright,verbatim]
+  \relative { \time 3/4 c2 e4 g2. }
+  \newlyrics { play the game } 
+  \newlyrics { speel het spel } 
+  \newlyrics { joue le jeu } 
+@end lilypond
+
+The @code{\newlyrics} keyword has three functions: it interprets the
+following words as texts instead of notes, it sets up a context for
+printing texts (the @code{Lyrics} context), and it couples the melody
+with the lyrics, so the durations of both are aligned.
+
+These three functions can be controlled separately, and that is what
+the following sections are about.
 
 @menu
+* Easy lyrics entry
 * Entering lyrics::             
 * The Lyrics context::          
 * More stanzas::                
@@ -3305,9 +3366,9 @@ This section discusses how to enter and print lyrics.
 @cindex punctuation
 
 Lyrics are entered in a special input mode. This mode is is introduced
-by the keyword @code{\lyrics}.  In this mode you can enter lyrics, with
-punctuation and accents without any hassle.  Syllables are entered like
-notes, but with pitches replaced by text.  For example,
+by the keyword @code{\lyrics}.  In this mode you can enter lyrics,
+with punctuation and accents without any hassle.  Syllables are
+entered like notes, but with pitches replaced by text.  For example,
 @example
   \lyrics @{ Twin-4 kle4 twin- kle litt- le star2 @}
 @end example
@@ -3342,16 +3403,18 @@ property commands
 Any @code{_} character which appears in an unquoted word is converted
 to a space.  This provides a mechanism for introducing spaces into words
 without using quotes.  Quoted words can also be used in Lyrics mode to
-specify words that cannot be written with the above rules
+specify words that cannot be written with the above rules. The
+following example incorporates double quotes
 
 @example
   \lyrics @{ He said: "\"Let" my peo ple "go\"" @}
 @end example
-However, at least for english texts, you should use 
+
+This example is slightly academic, since it gives better looking
+results to use matched single quotes, @code{``} and @code{''}
 @example
   \lyrics @{ He said: ``Let my peo ple go'' @}
 @end example
-to get the correct shape of the starting and ending quote.
 
 @cindex hyphens
 
@@ -3385,6 +3448,7 @@ The definition of lyrics mode is too complex.
 @node The Lyrics context
 @subsection  The Lyrics context
 
+
 Lyrics are printed by interpreting them in a @internalsref{Lyrics} context
 @example
  \context Lyrics \lyrics @dots{}
@@ -3400,7 +3464,7 @@ automatically.  In this case, it is no longer necessary to enter the
 correct duration for each syllable.  This is achieved by combining the
 melody and the lyrics with the @code{\lyricsto} expression
 @example
-\lyricsto @var{name} \new Lyrics @dots{} 
+\lyricsto @var{name} \new Lyrics \lyrics @dots{} 
 @end example
 
 This aligns the lyrics to the
@@ -3537,6 +3601,8 @@ linked. This can be achieved either by using @code{\lyricsto} or by
 setting corresponding names for both contexts. The latter is explained
 in @ref{More stanzas}.
 
+@c TODO: document \new Staff << Voice \lyricsto >> bug
+
 @node More stanzas
 @subsection More stanzas
 
@@ -3614,24 +3680,6 @@ Program reference: Layout objects @internalsref{LyricText} and
 @internalsref{VocalName}.  Music expressions
 @internalsref{LyricEvent}.
 
-@refbugs
-
-@cindex ambiguity
-
-Input for lyrics introduces a syntactical ambiguity
-@example 
-foo = bar 
-@end example 
-
-@noindent
-is interpreted as assigning a string identifier @code{\foo} such that
-it contains @code{"bar"}.  However, it could also be interpreted as
-making or a music identifier @code{\foo} containing the syllable
-`bar'.  The force the latter interpretation, use
-@example
-foo = \lyrics bar4
-@end example
 
 
 @node Ambitus
@@ -3653,7 +3701,7 @@ for example,
 @example
   \paper @{
     \context @{
-      \VoiceContext
+      \Voice
       \consists Ambitus_engraver
     @}
   @}
@@ -3674,7 +3722,7 @@ This results in the following output
   >>
   \paper {
     \context {
-      \StaffContext
+      \Staff
       \consists Ambitus_engraver
     }
   }
@@ -3705,6 +3753,9 @@ ambitus.
 @node Tablatures
 @section Tablatures
 
+@cindex tablature
+@cindex guitar tablature
+
 Tablature notation is used for notating music for plucked string
 instruments.  It notates pitches not by using note heads, but by
 indicating on which string and fret a note must be played.  LilyPond
@@ -3734,6 +3785,7 @@ are printed as tablature, by using @internalsref{TabStaff} and
 @end lilypond
 
 @cindex minimumFret
+@cindex fret
 
 When no string is specified, the first string that does not give a
 fret number less than @code{minimumFret} is selected. The default
@@ -3921,7 +3973,7 @@ Modifiers can be mixed with additions
 @cindex @code{m}
 
 Since an unaltered 11 does not sound good when combined with an
-unaltered 13, the 11 is removed in this case (unless it is added
+unaltered 3, the 11 is removed in this case (unless it is added
 explicitly)
 @c
 @lilypond[quote,fragment,verbatim]
@@ -4306,6 +4358,9 @@ names, for example
 }
 @end lilypond
 
+For longer instrument names, it may be useful to increase the
+@code{indent} setting in the @code{\paper} block.
+
 @seealso
 
 Program reference: @internalsref{InstrumentName}.
@@ -4391,7 +4446,7 @@ The transposition is entered after the keyword @code{\transposition}
   \transposition bes   %%  B-flat clarinet
 @end example
 
-This command sets the property @code{instrumentTuning}. The value of
+This command sets the property @code{instrumentTransposition}. The value of
 this property is used for MIDI output and quotations.  It does not
 affect how notes are printed in the current staff.
 
@@ -4660,8 +4715,8 @@ filtered. For example,
 @example
 \simultaneous @{
   @var{the music}
-  \apply #(remove-tag 'score) @var{the music}
-  \apply #(remove-tag 'part) @var{the music}
+  \applymusic #(remove-tag 'score) @var{the music}
+  \applymusic #(remove-tag 'part) @var{the music}
 @}
 @end example
 would yield
@@ -4890,11 +4945,11 @@ select ancient accidentals.   Supported styles are
         raggedright = ##t 
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context{
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \remove "Time_signature_engraver"
@@ -5257,7 +5312,7 @@ following table
        indent = 0.0
        raggedright = ##t
        \context {
-           \StaffContext
+           \Staff
            \remove Staff_symbol_engraver
            \remove Clef_engraver
            \remove Time_signature_engraver
@@ -5329,7 +5384,7 @@ as shown in the following example
 @example
 \paper @{
   \context @{
-     \StaffContext
+     \Staff
      \consists Custos_engraver
      Custos \override #'style = #'mensural
   @}
@@ -5348,7 +5403,7 @@ The result looks like this
     }
     \paper {
        \context {
-           \StaffContext
+           \Staff
            \consists Custos_engraver
        }
     }
@@ -5501,7 +5556,7 @@ To engrave white mensural ligatures, in the paper block the
 @example
     \paper @{
         \context @{
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Mensural_ligature_engraver
         @}
@@ -5542,7 +5597,7 @@ For example,
     }
     \paper {
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Mensural_ligature_engraver
         }
@@ -5630,11 +5685,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5643,7 +5698,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5672,11 +5727,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5685,7 +5740,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5706,11 +5761,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5719,7 +5774,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5743,11 +5798,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5756,7 +5811,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5782,11 +5837,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5795,7 +5850,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5816,11 +5871,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5829,7 +5884,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5854,11 +5909,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5867,7 +5922,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5893,11 +5948,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5906,7 +5961,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5931,11 +5986,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5944,7 +5999,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -5965,11 +6020,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -5978,7 +6033,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6002,11 +6057,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6015,7 +6070,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6040,11 +6095,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6053,7 +6108,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6074,11 +6129,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6087,7 +6142,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6111,11 +6166,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6124,7 +6179,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6145,11 +6200,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6158,7 +6213,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6183,11 +6238,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6196,7 +6251,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6217,11 +6272,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6230,7 +6285,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6255,11 +6310,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6268,7 +6323,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6289,11 +6344,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6302,7 +6357,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6327,11 +6382,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6340,7 +6395,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6361,11 +6416,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6374,7 +6429,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6395,11 +6450,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6408,7 +6463,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6432,11 +6487,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6445,7 +6500,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6466,11 +6521,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6479,7 +6534,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6500,11 +6555,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6513,7 +6568,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6537,11 +6592,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6550,7 +6605,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6571,11 +6626,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6584,7 +6639,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6605,11 +6660,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6618,7 +6673,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6642,11 +6697,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6655,7 +6710,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6676,11 +6731,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6689,7 +6744,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6710,11 +6765,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6723,7 +6778,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6747,11 +6802,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6760,7 +6815,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6781,11 +6836,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6794,7 +6849,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6815,11 +6870,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6828,7 +6883,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6852,11 +6907,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6865,7 +6920,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6886,11 +6941,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \paper {
         interscoreline = 1
         \context {
-            \ScoreContext
+            \Score
             \remove "Bar_number_engraver"
         }
         \context {
-            \StaffContext
+            \Staff
             \remove "Clef_engraver"
             \remove "Key_engraver"
             \override StaffSymbol #'transparent = ##t
@@ -6899,7 +6954,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
             minimumVerticalExtent = ##f
         }
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Vaticana_ligature_engraver
             \override NoteHead #'style = #'vaticana_punctum
@@ -6924,11 +6979,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
   \paper {
     interscoreline = 1
     \context {
-      \ScoreContext
+      \Score
       \remove "Bar_number_engraver"
     }
     \context {
-      \StaffContext
+      \Staff
       \remove "Clef_engraver"
       \remove "Key_engraver"
       \override StaffSymbol #'transparent = ##t
@@ -6937,7 +6992,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
       minimumVerticalExtent = ##f
     }
     \context {
-      \VoiceContext
+      \Voice
       \remove Ligature_bracket_engraver
       \consists Vaticana_ligature_engraver
       \override NoteHead #'style = #'vaticana_punctum
@@ -7366,7 +7421,7 @@ applying the function @code{notes-to-clusters} to a sequence of
 chords, e.g.
 @c
 @lilypond[quote,relative=2,verbatim]
-\apply #notes-to-clusters {  <c e > <b f'>  }
+\applymusic #notes-to-clusters {  <c e > <b f'>  }
 @end lilypond
 
 The following example (from
@@ -7538,6 +7593,10 @@ The MIDI output allocates a channel for each Staff, and one for global
 settings.  Hence, the MIDI file should not have more than 15 staves
 (or 14 if you do not use drums). Other staves will remain silent.
 
+Not all MIDI players correctly handle tempo change in the MIDI
+output. Players that are known to work include
+@uref{timidity,http://timidity.sourceforge.net/}
+
 
 @menu
 * MIDI block::