]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/notation.itely
use usescons for using scons.
[lilypond.git] / Documentation / user / notation.itely
index 6e463b197c6002ad41c0ae15e0a64c60590b2fb8..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
@@ -698,6 +708,18 @@ score by scanning for failed bar checks and incorrect durations.  To
 speed up this process, you can use @code{skipTypesetting}, described
 in the next section.
 
+It is also possible to redefine the meaning of @code{|}. This is done
+by assigning a music expression to @code{pipeSymbol},
+
+@lilypond
+pipeSymbol = \bar "||"
+
+\score {
+    \notes  { c'2 c'2 | c'2 c'2 | }
+}
+@end lilypond 
+
+
 @node Skipping corrected music
 @subsection Skipping corrected music
 
@@ -725,7 +747,7 @@ by replacing the @internalsref{Note_heads_engraver} by the
 In the following examples, notes crossing the bar line are split and tied.
 
 
-@lilypond[quote,fragment,verbatim,relative=2,raggedright]
+@lilypond[quote,fragment,verbatim,relative=1,raggedright]
 \new Voice \with {
   \remove "Note_heads_engraver"
   \consists "Completion_heads_engraver"
@@ -1022,7 +1044,7 @@ measure is subdivided in 2, 2, 2 and 3. This is passed to
   }
   \paper {
     \context {
-      \StaffContext
+      \Staff
       \consists "Measure_grouping_engraver"
     }
   }
@@ -1069,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
@@ -1082,7 +1106,6 @@ off. Empty bar lines,
 indicate where line breaks can occur.
 
 
-
 @refcommands
 
 @cindex @code{\cadenzaOn}
@@ -1158,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
@@ -1194,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 } >>
@@ -1232,8 +1257,8 @@ The command @code{\oneVoice} will revert back to the normal setting.
 Normally, note heads with a different number of dots are not merged, but
 when  the object property @code{merge-differently-dotted} is set in
 the @internalsref{NoteCollision} object, they are merged
-@lilypond[quote,verbatim,fragment,raggedright]
-\relative c'' \context Voice << {
+@lilypond[quote,verbatim,fragment,raggedright,relative=2]
+\context Voice << {
   g8 g8 
   \override Staff.NoteCollision  
     #'merge-differently-dotted = ##t
@@ -1243,7 +1268,7 @@ the @internalsref{NoteCollision} object, they are merged
 
 Similarly, you can merge half note heads with eighth notes, by setting
 @code{merge-differently-headed}
-@lilypond[quote,fragment,relative=3,verbatim]
+@lilypond[quote,fragment,relative=2,verbatim]
 \context Voice << {
   c8 c4.
   \override Staff.NoteCollision
@@ -1251,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 >>
@@ -1326,7 +1351,7 @@ notation (see @ref{Clusters}).
 Beams are used to group short notes into chunks that are aligned with
 the metrum. They are inserted automatically
 
-@lilypond[quote,fragment,verbatim,relative=3]
+@lilypond[quote,fragment,verbatim,relative=2]
 \time 2/4 c8 c c c \time 6/8 c c c c8. c16  c8
 @end lilypond
 
@@ -1337,7 +1362,7 @@ that differ from the defaults.
 Individual notes may be marked with @code{\noBeam}, to prevent them
 from being beamed
 
-@lilypond[quote,fragment,verbatim,relative=3]
+@lilypond[quote,fragment,verbatim,relative=2]
 \time 2/4 c8 c\noBeam c c
 @end lilypond
 
@@ -1416,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
 
@@ -1424,6 +1454,8 @@ behavior can be changed by setting @code{allowBeamBreak}.
 Automatically kneed cross-staff beams cannot be used together with
 hidden staves.
 
+Beams do not avoid collisions with symbols around the notes, such as
+texts and accidentals.
 
 
 
@@ -1929,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
 
@@ -2063,10 +2095,10 @@ of the chord by adding them after the pitches
 @end lilypond
 
 @noindent
-In this case, setting @code{fingeringOrientations} will put  fingerings next
+iIn this case, setting @code{fingeringOrientations} will put  fingerings next
 to note heads
 
-@lilypond[quote,verbatim,raggedright,fragment,relative=2]
+@lilypond[quote,verbatim,raggedright,fragment,relative=1]
 \set fingeringOrientations = #'(left down)
 <c-1 es-2 g-4 bes-5 > 4
 \set fingeringOrientations = #'(up right down)
@@ -2145,7 +2177,7 @@ They are entered with the commands @code{\acciaccatura} and
 @cindex appoggiatura
 @cindex acciaccatura
 
-@lilypond[quote,relative=3,verbatim,fragment]
+@lilypond[quote,relative=2,verbatim,fragment]
 b4 \acciaccatura d8 c4 \appoggiatura e8 d4
 \acciaccatura { g16[ f] } e4
 @end lilypond
@@ -2153,7 +2185,8 @@ b4 \acciaccatura d8 c4 \appoggiatura e8 d4
 Both are special forms of the @code{\grace} command. By prefixing this
 keyword to a music expression, a new one is formed, which will be
 printed in a smaller font and takes up no logical time in a measure.
-@lilypond[quote,relative=3,verbatim,fragment]
+
+@lilypond[quote,relative=2,verbatim,fragment]
 c4 \grace c16 c4
 \grace { c16[ d16] } c2 c4
 @end lilypond
@@ -2192,7 +2225,7 @@ The placement of grace notes is synchronized between different staves.
 In the following example, there are two sixteenth graces notes for
 every eighth grace note
 
-@lilypond[quote,relative=3,verbatim,fragment] 
+@lilypond[quote,relative=2,verbatim,fragment] 
 << \new Staff { e4 \grace { c16[ d e f] } e4 }
    \new Staff { c'4 \grace { g8[ b] } c4 } >>
 @end lilypond
@@ -2202,7 +2235,7 @@ every eighth grace note
 If you want to end a note with a grace, the standard trick is to put
 the grace notes after a ``space note''
 
-@lilypond[quote,fragment,verbatim,relative=3]
+@lilypond[quote,fragment,verbatim,relative=2]
 \context Voice {
   << { d1^\trill ( }
      { s2 \grace { c16[ d] } } >>
@@ -2240,7 +2273,7 @@ direction for this grace, so stems do not always point up.
 
 @example
 \new Staff @{
-   #(add-grace-property "Voice" Stem direction '())
+   #(add-grace-property 'Voice 'Stem 'direction '())
    @dots{}
 @}
 @end example
@@ -2267,7 +2300,7 @@ Grace note synchronization can also lead to surprises. Staff notation,
 such as key signatures, bar lines, etc. are also synchronized. Take
 care when you mix staves with grace notes and staves without, for example,
 
-@lilypond[quote,relative=3,verbatim,fragment]
+@lilypond[quote,relative=2,verbatim,fragment]
 << \new Staff { e4 \bar "|:" \grace c16 d4 }
    \new Staff { c4  \bar "|:"  d4 } >>
 @end lilypond
@@ -2375,7 +2408,7 @@ example
 You can also use a text saying @emph{cresc.} instead of hairpins. Here
 is an example how to do it
 
-@lilypond[quote,fragment,relative=3,verbatim]
+@lilypond[quote,fragment,relative=2,verbatim]
 \setTextCresc
 c \< d e f\!
 \setHairpinCresc
@@ -2513,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
@@ -2530,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
 
@@ -2539,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
@@ -2570,7 +2613,7 @@ alphabetic characters. Or,
   stops a running volta bracket
 @end table
 
-@lilypond[quote,verbatim,fragment,relative=3]
+@lilypond[quote,verbatim,fragment,relative=2]
 c4
   \set Score.repeatCommands = #'((volta "93") end-repeat)
 c4 c4
@@ -2661,9 +2704,8 @@ Patterns of a one and two measures are replaced by percent-like signs,
 patterns that divide the measure length are replaced by slashes
 
 @lilypond[quote,verbatim,raggedright]
-\context Voice { \repeat  "percent" 4  { c'4 }
-  \repeat "percent" 2 { c'2 es'2 f'4 fis'4 g'4 c''4 }
-}
+\repeat  "percent" 4  { c'4 }
+\repeat "percent" 2 { c'2 es'2 f'4 fis'4 g'4 c''4 }
 @end lilypond
 
 @seealso
@@ -2721,8 +2763,7 @@ an abbreviated name, and both be used in input files
   hihat hh bassdrum bd
 @end example
 @lilypond[quote,raggedright]
-        \new DrumStaff \drums {   hihat hh bassdrum bd
- }
+\new DrumStaff \drums { hihat hh bassdrum bd }
 @end lilypond
 
 The complete list of drum names is in the init file
@@ -2763,10 +2804,10 @@ polyphonic notation, described in @ref{Polyphony}, can also be used if
 the @internalsref{DrumVoices} are instantiated by hand first. For example, 
 
 @lilypond[quote,fragment,verbatim] 
-\drums \new DrumStaff <<
+\new DrumStaff <<
   \context DrumVoice = "1" {  s1 *2 }
   \context DrumVoice = "2" {  s1 *2 }
-  {
+  \drums {
     bd4 sn4 bd4 sn4
     <<
       { \repeat unfold 16 hh16 }
@@ -2804,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
 }}}
@@ -2995,12 +3036,28 @@ require arcane command incantations. See
 
 Voices can switch automatically between the top and the bottom
 staff. The syntax for this is
+
+@quotation
 @example
-  \autochange \context Voice @{ @dots{}@var{music}@dots{} @}
+\autochange \context Voice @{ @dots{}@var{music}@dots{} @}
 @end example
+@end quotation
+
+@noindent
 The two staves of the piano staff must be named @code{up} and
 @code{down}.
 
+A @code{\relative} section that is outside of @code{\autochange} has
+no effect on the pitches of @var{music}, so, if necessary, put
+@code{\relative} inside @code{\autochange} like
+
+@quotation
+@example
+\autochange \relative @dots{} \new Voice @dots{}
+@end example
+@end quotation
+
+
 The autochanger switches on basis of pitch (middle C is the turning
 point), and it looks ahead skipping over rests to switch in
 advance. Here is a practical example
@@ -3035,6 +3092,14 @@ The staff switches often do not end up in optimal places. For high
 quality output, staff switches should be specified manually.
 
 
+@code{\autochange} cannot be inside @code{\times}. 
+
+Internally, the @code{\partcombine} interprets both arguments as
+@code{Voice}s named @code{one} and @code{two}, and then decides when
+the parts can be combined. Consequently, if the arguments switch to
+differently named @internalsref{Voice} contexts, the events in those
+will be ignored.
+
 
 @node Manual staff switches
 @subsection Manual staff switches
@@ -3051,9 +3116,28 @@ Voices can be switched between staves manually, using the following command
 The string @var{staffname} is the name of the staff. It switches the
 current voice from its current staff to the Staff called
 @var{staffname}. Typically @var{staffname} is @code{"up"} or
-@code{"down"}.
+@code{"down"}. The @context{Staff} referred to must already exist, so
+usually the setup for a score will start with a setup of the staves,
+
+@example
+  <<
+  \context Staff = up @{
+    \skip 1 * 10  %@emph{ keep staff alive}
+    @}
+  \context Staff = down @{
+    \skip 1 * 10  %@emph{idem}
+    @}
+  >>
+@end example 
 
 
+and the @context{Voice} is inserted afterwards
+
+@example
+  \context Staff = down
+    \new Voice @{ @dots{} \change Staff = up @dots{} @}
+@end example
+
 
 @node Pedals
 @subsection Pedals
@@ -3081,7 +3165,7 @@ information.
 Pedals can also be indicated by a sequence of brackets, by setting the 
 @code{pedalSustainStyle} property to @code{bracket} objects
 
-@lilypond[quote,fragment,verbatim,relative=3]
+@lilypond[quote,fragment,verbatim,relative=2]
 \set Staff.pedalSustainStyle = #'bracket
 c\sustainDown d e
 b\sustainUp\sustainDown
@@ -3092,7 +3176,7 @@ A third style of pedal notation is a mixture of text and brackets,
 obtained by setting the @code{pedalSustainStyle} style property to
 @code{mixed}
 
-@lilypond[quote,fragment,verbatim,relative=3]
+@lilypond[quote,fragment,verbatim,relative=2]
 \set Staff.pedalSustainStyle = #'mixed
 c\sustainDown d e
 b\sustainUp\sustainDown
@@ -3103,7 +3187,7 @@ The default `*Ped.' style for sustain and damper pedals corresponds to
 style @code{#'text}. The sostenuto pedal uses @code{mixed} style by
 default.
 
-@lilypond[quote,fragment,verbatim,relative=3]
+@lilypond[quote,fragment,verbatim,relative=2]
 c\sostenutoDown d e c, f g a\sostenutoUp
 @end lilypond
 
@@ -3113,7 +3197,7 @@ For fine-tuning of the appearance of a pedal bracket, the properties
 @internalsref{PianoPedalBracket} in the Program reference)  can be modified.  For example, the
 bracket may be extended to the end of the note head
 
-@lilypond[quote,fragment,verbatim]
+@lilypond[quote,fragment,verbatim,relative=2]
 \override Staff.PianoPedalBracket  
    #'shorten-pair = #'(0 . -1.0)
 c\sostenutoDown d e c, f g a\sostenutoUp
@@ -3231,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::                
@@ -3249,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
@@ -3286,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
 
@@ -3329,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{}
@@ -3344,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
@@ -3410,6 +3530,37 @@ be tuned with the property @code{melismaBusyProperties}. See
 @internalsref{Melisma_translator} in the program reference for more
 information.
 
+Lyrics can also be entered without @code{\lyricsto}. In this case the
+durations of each syllable must be entered explicitly, for example,
+
+@verbatim
+  play2 the4 game2.
+  sink2 or4 swim2.  
+@end verbatim
+
+Alignment to a melody can be specified with the @code{associatedVoice}
+property,
+
+@verbatim
+  \set associatedVoice = #"melody"
+@end verbatim 
+
+Here is an example demonstrating manual lyric durations,
+
+@lilypond[relative=1,verbatim,fragment]
+<< \context Voice = melody {
+     \time 3/4
+     c2 e4 g2.
+  } 
+  \new Lyrics \lyrics {
+    \set associatedVoice = #"melody"
+    play2 the4 game2.
+  }  >>
+@end lilypond
+
+
+
+
 When multiple stanzas are put on the same melody, it can happen that
 two stanzas have melismata in different locations. This can be
 remedied by switching off melismata for one
@@ -3450,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
 
@@ -3486,11 +3639,11 @@ The complete example is shown here
     \notes \relative c'' \context Voice = duet {
       \time 3/4
        g2 e4 a2 f4 g2. }
-    \lyrics <<
-      \lyricsto "duet" \new Lyrics {
+    <<
+      \lyricsto "duet" \new Lyrics \lyrics {
         \set vocalName = "Bert"
         Hi, my name is Bert. }
-      \lyricsto "duet" \new Lyrics {
+      \lyricsto "duet" \new Lyrics \lyrics {
         \set vocalName = "Ernie"
         Ooooo, ch\'e -- ri, je t'aime. }
     >>
@@ -3504,11 +3657,11 @@ The complete example is shown here
 
 Stanza numbers can be added by setting @code{stanza}, e.g.
 
-@lilypond[quote,verbatim,relative=3]
+@lilypond[quote,verbatim,relative=2]
 <<
   \context Voice = duet {
     \time 3/4 g2 e4 a2 f4 g2. }
-   \lyrics \lyricsto "duet" \new Lyrics {
+    \lyricsto "duet" \new Lyrics \lyrics {
      \set stanza = "1. "
      Hi, my name is Bert. }
 >>
@@ -3527,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
@@ -3566,7 +3701,7 @@ for example,
 @example
   \paper @{
     \context @{
-      \VoiceContext
+      \Voice
       \consists Ambitus_engraver
     @}
   @}
@@ -3587,7 +3722,7 @@ This results in the following output
   >>
   \paper {
     \context {
-      \StaffContext
+      \Staff
       \consists Ambitus_engraver
     }
   }
@@ -3618,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
@@ -3647,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
@@ -3834,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]
@@ -4199,7 +4338,7 @@ and @internalsref{Staff}.@code{instr}. This will print a string before
 the start of the staff. For the first start, @code{instrument} is
 used, for the next ones @code{instr} is used.
 
-@lilypond[quote,verbatim,raggedright,relative=3]
+@lilypond[quote,verbatim,raggedright,relative=1]
 \set Staff.instrument = "Ploink "
 \set Staff.instr = "Plk "
 c1
@@ -4219,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}.
@@ -4235,8 +4377,8 @@ the name to avoid a collision.
 @cindex transposition of pitches
 @cindex @code{\transpose}
 
-A music expression can be transposed with @code{\transpose}.  The syntax
-is
+A music expression can be transposed with @code{\transpose}.  The
+syntax is
 @example
 \transpose @var{from} @var{to} @var{musicexpr}
 @end example
@@ -4304,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.
 
@@ -4418,23 +4560,34 @@ places where the two parts differ, they are typeset as separate
 voices, and stem directions are set automatically.  Also, solo and
 @emph{a due} parts are identified and can be marked.
 
-
 The syntax for part combining is
 
 @example
   \partcombine @var{musicexpr1} @var{musicexpr2}
 @end example
 
-The music expressions will be interpreted as @internalsref{Voice} contexts.
+The music expressions will be interpreted as @internalsref{Voice}
+contexts. If using relative octaves, @code{\relative} should be
+specified for both music expressions, i.e.
+
+@example
+\partcombine \relative @dots{}  @var{musicexpr1}
+  \relative @dots{} @var{musicexpr2}
+@end example
+
+@noindent
+A @code{\relative} section that is outside of @code{\partcombine} has
+no effect on the pitches of @var{musicexpr1} and @var{musicexpr2}.
+
 
 The following example demonstrates the basic functionality of the part
 combiner: putting parts on one staff, and setting stem directions and
 polyphony
 
-@lilypond[quote,verbatim,raggedright,fragment,relative=2]
+@lilypond[quote,verbatim,raggedright,fragment]
 \new Staff \partcombine
-  { g g a( b) c c r r }
-  { g g r4 r e e g g }
+  \relative g' { g g a( b) c c r r }
+  \relative g' { g g r4 r e e g g }
 @end lilypond
 
 The first @code{g} appears only once, although it was
@@ -4451,8 +4604,8 @@ may set the property @code{soloADue} to false
 \new Staff <<
   \set Staff.soloADue = ##f
   \partcombine
-  { g a( b) r }
-  { g r4 r f }
+    \relative g' { g a( b) r }
+    \relative g' { g r4 r f }
 >>
 @end lilypond
 
@@ -4469,7 +4622,9 @@ In @code{soloADue} mode, when the two voices play the same notes on and
 off, the part combiner may typeset @code{a2} more than once in a
 measure.
 
-@code{\partcombine} can not be inside @code{\times}. 
+@code{\partcombine} cannot be inside @code{\times}. 
+
+@code{\partcombine} cannot be inside @code{\relative}. 
 
 Internally, the @code{\partcombine} interprets both arguments as
 @code{Voice}s named @code{one} and @code{two}, and then decides when
@@ -4560,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
@@ -4790,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"
@@ -5157,7 +5312,7 @@ following table
        indent = 0.0
        raggedright = ##t
        \context {
-           \StaffContext
+           \Staff
            \remove Staff_symbol_engraver
            \remove Clef_engraver
            \remove Time_signature_engraver
@@ -5229,7 +5384,7 @@ as shown in the following example
 @example
 \paper @{
   \context @{
-     \StaffContext
+     \Staff
      \consists Custos_engraver
      Custos \override #'style = #'mensural
   @}
@@ -5248,7 +5403,7 @@ The result looks like this
     }
     \paper {
        \context {
-           \StaffContext
+           \Staff
            \consists Custos_engraver
        }
     }
@@ -5401,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
         @}
@@ -5442,7 +5597,7 @@ For example,
     }
     \paper {
         \context {
-            \VoiceContext
+            \Voice
             \remove Ligature_bracket_engraver
             \consists Mensural_ligature_engraver
         }
@@ -5530,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
@@ -5543,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
@@ -5572,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
@@ -5585,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
@@ -5606,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
@@ -5619,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
@@ -5643,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
@@ -5656,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
@@ -5682,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
@@ -5695,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
@@ -5716,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
@@ -5729,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
@@ -5754,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
@@ -5767,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
@@ -5793,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
@@ -5806,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
@@ -5831,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
@@ -5844,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
@@ -5865,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
@@ -5878,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
@@ -5902,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
@@ -5915,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
@@ -5940,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
@@ -5953,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
@@ -5974,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
@@ -5987,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
@@ -6011,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
@@ -6024,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
@@ -6045,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
@@ -6058,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
@@ -6083,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
@@ -6096,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
@@ -6117,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
@@ -6130,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
@@ -6155,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
@@ -6168,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
@@ -6189,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
@@ -6202,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
@@ -6227,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
@@ -6240,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
@@ -6261,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
@@ -6274,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
@@ -6295,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
@@ -6308,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
@@ -6332,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
@@ -6345,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
@@ -6366,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
@@ -6379,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
@@ -6400,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
@@ -6413,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
@@ -6437,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
@@ -6450,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
@@ -6471,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
@@ -6484,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
@@ -6505,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
@@ -6518,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
@@ -6542,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
@@ -6555,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
@@ -6576,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
@@ -6589,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
@@ -6610,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
@@ -6623,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
@@ -6647,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
@@ -6660,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
@@ -6681,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
@@ -6694,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
@@ -6715,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
@@ -6728,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
@@ -6752,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
@@ -6765,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
@@ -6786,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
@@ -6799,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
@@ -6824,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
@@ -6837,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
@@ -7266,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
@@ -7438,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::