]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/notation.itely
* buildscripts/mf-to-table.py (write_fontlist): Improve formatting
[lilypond.git] / Documentation / user / notation.itely
index c000743bbd6826613bff0d78b6f365340192e288..6c1756acfed4f9076bf1758233e3fbabda399b92 100644 (file)
@@ -1,4 +1,4 @@
-@c Note: -*-texinfo-*-
+@c -*- coding: latin-1; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 
 @c A menu is needed before every deeper *section nesting of @node's; run
@@ -85,7 +85,7 @@ names.  The notes are specified by the letters @code{a} through
 to @code{b}.  The pitch @code{c} is an octave below middle C and the
 letters span the octave above that C
 
-@lilypond[fragment,verbatim,noindent]
+@lilypond[quote,fragment,verbatim]
 \clef bass
 a,4 b, c d e f g a b c' d' e' \clef treble f' g' a' b' c''
 @end lilypond
@@ -236,9 +236,10 @@ must be done with multi-measure rests.  They are discussed in
 
 
 A rest's vertical position may be explicitly specified by entering a
-note with the @code{\rest} keyword appended.  This makes manual
-formatting in polyphonic music easier.  Automatic rest collision
-formatting will leave these rests alone
+note with the @code{\rest} keyword appended, the rest will be placed at
+the note's place.  This makes manual formatting in polyphonic music
+easier.  Automatic rest collision formatting will leave these rests
+alone
 
 @lilypond[fragment,quote,raggedright,verbatim]
 a'4\rest d'4\rest
@@ -305,11 +306,12 @@ Program reference: @internalsref{SkipEvent}, @internalsref{SkipMusic}.
 @cindex @code{\maxima}
 
 
-In Note, Chord, and Lyrics mode, durations are designated by numbers
-and dots: durations are entered as their reciprocal values.  For example,
-a quarter note is entered using a @code{4} (since it is a 1/4 note), while
-a half note is entered using a @code{2} (since it is a 1/2 note).  For notes
-longer than a whole you must use variables
+In Note, Chord, and Lyrics mode, durations are designated by numbers and
+dots: durations are entered as their reciprocal values.  For example, a
+quarter note is entered using a @code{4} (since it is a 1/4 note), while
+a half note is entered using a @code{2} (since it is a 1/2 note).  For
+notes longer than a whole you must use the variables @code{\longa} and
+@code{\breve}
 
 @example 
 c'\breve  
@@ -318,7 +320,7 @@ r\longa r\breve
 r1 r2 r4 r8 r16 r32 r64 r64 
 @end example 
 
-@lilypond[quote,noindent]
+@lilypond[quote]
 \score {
  \relative c'' {
     a\breve*1/2  \autoBeamOff
@@ -328,7 +330,7 @@ r1 r2 r4 r8 r16 r32 r64 r64
     r\longa*1/4 r\breve  *1/2
     r1 r2 r4 r8 r16 r32 r64 r64 
   }
-  \paper {
+  \layout {
     raggedright = ##t
     \context {
       \Staff
@@ -346,9 +348,7 @@ If the duration is omitted then it is set to the previously entered
 duration.  The default for the first note is a quarter note.
 
 @lilypond[quote,raggedright,verbatim,fragment]
-{
-a a a2 a a4 a a1 a
-} 
+{ a a a2 a a4 a a1 a } 
 @end lilypond
 
 
@@ -557,13 +557,13 @@ User manual: @ref{Changing context properties on the fly} for the
 
 Program reference: @internalsref{TupletBracket}, and @internalsref{TimeScaledMusic}.
 
-Examples: @inputfileref{input/regression,tuplet-nest.ly}.
+Examples: @inputfileref{input/@/regression,tuplet@/-nest@/.ly}.
 
 @refbugs
 
 Nested tuplets are not formatted automatically.  In this case, outer
 tuplet brackets should be moved manually, which is demonstrated in
-@inputfileref{input/regression,tuplet-nest.ly}.
+@inputfileref{input/@/regression,tuplet@/-nest@/.ly}.
 
 
 
@@ -605,11 +605,14 @@ larger: a single error puts the rest of the piece off by one octave
 
 @cindex @code{\relative}
 @example
-  \relative @var{startpitch} @var{musicexpr}
+\relative @var{startpitch} @var{musicexpr}
 @end example
+
+@noindent
 or
+
 @example
-  \relative @var{musicexpr}
+\relative @var{musicexpr}
 @end example
  
 The octave of notes that appear in @var{musicexpr} are calculated as
@@ -799,7 +802,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=1,raggedright]
+@lilypond[quote,fragment,verbatim,relative=1,linewidth=12\cm]
 \new Voice \with {
   \remove "Note_heads_engraver"
   \consists "Completion_heads_engraver"
@@ -821,7 +824,7 @@ not insert tuplets.
 
 @seealso
 
-Examples: @inputfileref{input/regression,completion-heads.ly}.
+Examples: @inputfileref{input/@/regression,completion@/-heads@/.ly}.
 
 @noindent
 
@@ -869,8 +872,8 @@ staff symbol.
 
 Program reference: @internalsref{StaffSymbol}.
 
-Examples: @inputfileref{input/test,staff-lines.ly},
-@inputfileref{input/test,staff-size.ly}.
+Examples: @inputfileref{input/@/test,staff@/-lines@/.ly},
+@inputfileref{input/@/test,staff@/-size@/.ly}.
 
 @refbugs
 
@@ -884,9 +887,9 @@ exactly on the bar line.
 
 @cindex @code{\key}
 
-The key signature indicates the scale in which a piece is played.  It
-is denoted by a set of alterations (flats or sharps) at the start of
-the staff.
+The key signature indicates the tonality in which a piece is played.  It
+is denoted by a set of alterations (flats or sharps) at the start of the
+staff.
 
 
 Setting or changing the key signature is done with the @code{\key}
@@ -999,7 +1002,7 @@ This command is equivalent to setting @code{clefGlyph},
 when any of these properties are changed.  The following example shows
 possibilities when setting properties manually.
 
-@lilypond[raggedright,verbatim]
+@lilypond[quote,raggedright,verbatim]
 {
   \set Staff.clefGlyph = #"clefs-F"
   \set Staff.clefPosition = #2
@@ -1064,8 +1067,8 @@ The @code{set-octavation} function also takes -1 (for 8va bassa) and 2
 
 Program reference: @internalsref{OttavaBracket}.
 
-Examples: @inputfileref{input/regression,ottava.ly},
-@inputfileref{input/regression,ottava-broken.ly}.
+Examples: @inputfileref{input/@/regression,ottava@/.ly},
+@inputfileref{input/@/regression,ottava@/-broken@/.ly}.
 
 @refbugs
 
@@ -1134,7 +1137,7 @@ measure is subdivided in 2, 2, 2 and 3.  This is passed to
     #(set-time-signature 5 8 '(3 2))
     a4. g4
   }
-  \paper {
+  \layout {
     \context {
       \Staff
       \consists "Measure_grouping_engraver"
@@ -1302,7 +1305,7 @@ Program reference: @internalsref{BarLine} (created at
 
 
 
-Examples: @inputfileref{input/test,bar-lines.ly},
+Examples: @inputfileref{input/@/test,bar@/-lines@/.ly},
 
 
 @node Time administration
@@ -1521,11 +1524,11 @@ Program reference: the objects responsible for resolving collisions are
 @internalsref{NoteCollision} and @internalsref{RestCollision}.
 
 Examples: 
-@inputfileref{input/regression,collision-dots.ly},
-@inputfileref{input/regression,collision-head-chords.ly},
-@inputfileref{input/regression,collision-heads.ly},
-@inputfileref{input/regression,collision-mesh.ly}, and
-@inputfileref{input/regression,collisions.ly}.
+@inputfileref{input/@/regression,collision@/-dots@/.ly},
+@inputfileref{input/@/regression,collision@/-head-chords@/.ly},
+@inputfileref{input/@/regression,collision@/-heads@/.ly},
+@inputfileref{input/@/regression,collision@/-mesh@/.ly}, and
+@inputfileref{input/@/regression,collisions@/.ly}.
 
 
 @refbugs
@@ -1624,7 +1627,7 @@ all 16th or shorter beams at beat positions, as defined by the
 @code{beatLength} property.
 
 
-@lilypond[fragment,raggedright,quote,relative=2,verbatim,noindent]
+@lilypond[fragment,quote,relative=2,verbatim]
 c16[ c c c c c c c]
 \set subdivideBeams = ##t
 c16[ c c c c c c c]
@@ -1681,7 +1684,7 @@ In normal time signatures, automatic beams can start on any note but can
 only end in a few positions within the measure: beams can end on a beat,
 or at durations specified by the properties in
 @code{autoBeamSettings}.  The defaults for @code{autoBeamSettings}
-are defined in @file{scm/auto-beam.scm}.
+are defined in @file{scm/@/auto@/-beam@/.scm}.
 
 The value of @code{autoBeamSettings} is changed with two functions,
 @example
@@ -2097,7 +2100,7 @@ any markup text.  For example,
 Program reference: @internalsref{BreathingSign},
 @internalsref{BreathingSignEvent}.
 
-Examples: @inputfileref{input/regression,breathing-sign.ly}.
+Examples: @inputfileref{input/@/regression,breathing@/-sign@/.ly}.
 
 
 @node Metronome marks
@@ -2113,7 +2116,7 @@ Metronome settings can be entered as follows
 @end example
 
 In the MIDI output, they are interpreted as a tempo change.  In the
-paper output, a metronome marking is printed
+layout output, a metronome marking is printed
 @cindex @code{\tempo}
 @lilypond[quote,raggedright,verbatim,fragment]
   \tempo 8.=120 c''1
@@ -2191,7 +2194,7 @@ properties
 Internals @internalsref{TextSpanEvent},
 @internalsref{TextSpanner}.
 
-Examples: @inputfileref{input/regression,text-spanner.ly}.
+Examples: @inputfileref{input/@/regression,text@/-spanner@/.ly}.
 
 
 @node Analysis brackets
@@ -2215,7 +2218,7 @@ to @internalsref{Staff} context.  A bracket is started with
     c4\startGroup
     c4\stopGroup\stopGroup
   }
-  \paper {
+  \layout {
     \context {
       \Staff \consists "Horizontal_bracket_engraver"
 }}}
@@ -2226,7 +2229,7 @@ to @internalsref{Staff} context.  A bracket is started with
 Program reference: @internalsref{HorizontalBracket},
 @internalsref{NoteGroupingEvent}.
 
-Examples: @inputfileref{input/regression,note-group-bracket.ly}. 
+Examples: @inputfileref{input/@/regression,note@/-group@/-bracket@/.ly}. 
 
 
 @node Articulations
@@ -2245,7 +2248,7 @@ articulation.  They are demonstrated here
 @lilypondfile[quote,raggedright]{script-abbreviations.ly}
 
 The meanings of these shorthands can be changed.  See
-@file{ly/script-init.ly} for examples.
+@file{ly/@/script@/-init@/.ly} for examples.
 
 
 The script is automatically placed, but the direction can be forced as
@@ -2418,7 +2421,7 @@ very close to note heads in monophonic music,
 
 Program reference: @internalsref{FingerEvent}, and @internalsref{Fingering}.
 
-Examples: @inputfileref{input/regression,finger-chords.ly}.
+Examples: @inputfileref{input/@/regression,finger@/-chords@/.ly}.
 
 
 
@@ -2553,7 +2556,7 @@ Another option is to change the variables @code{startGraceMusic},
 @code{stopGraceMusic}, @code{startAcciaccaturaMusic},
 @code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic},
 @code{stopAppoggiaturaMusic}.  More information is in the file
-@file{ly/grace-init.ly}.
+@file{ly/@/grace@/-init@/.ly}.
 
 
 @seealso
@@ -2605,7 +2608,7 @@ c\glissando c'
 
 Program reference: @internalsref{Glissando}, and @internalsref{GlissandoEvent}.
 
-Example files: @file{input/regression/glissando.ly}.
+Example files: @file{input/@/regression/@/glissando@/.ly}.
 
  
 
@@ -2756,7 +2759,7 @@ for repeats with alternatives.  These are not played in MIDI output by default.
 @item fold
 Alternative endings are written stacked.  This has limited use but may be
 used to typeset two lines of lyrics in songs with repeats, see
-@inputfileref{input,star-spangled-banner.ly}.
+@inputfileref{input,star-spangled-banner@/.ly}.
 @end ignore
 
 @c tremolo, beamed
@@ -2838,8 +2841,8 @@ Examples:
 
 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}
+property @inputfileref{input/@/regression,volta@/-multi@/-staff@/.ly},
+@inputfileref{input/@/regression,volta@/-chord@/-names@/.ly}
 
 
 @refbugs
@@ -2879,7 +2882,7 @@ in the MIDI output.  This is achieved by applying the
 @code{\unfoldrepeats} music function.  This functions changes all
 repeats to unfold repeats.
 
-@lilypond[verbatim,raggedright,fragment]
+@lilypond[verbatim,fragment,linewidth]
 \unfoldrepeats {
   \repeat tremolo 8 {c'32 e' }
   \repeat percent 2 { c''8 d'' }
@@ -2900,7 +2903,7 @@ percent repeats).  For example,
 @example
   \score @{
       @var{..music..}
-      \paper @{ .. @}
+      \layout @{ .. @}
   @} 
   \score @{
       \unfoldrepeats @var{..music..}
@@ -2979,8 +2982,8 @@ Program reference: tremolo beams are @internalsref{Beam} objects.  Single stem
 tremolos are @internalsref{StemTremolo} objects.  The music expression is
 @internalsref{TremoloEvent}.
 
-Example files: @inputfileref{input/regression,chord-tremolo.ly},
-@inputfileref{input/regression,stem-tremolo.ly}.
+Example files: @inputfileref{input/@/regression,chord@/-tremolo@/.ly},
+@inputfileref{input/@/regression,stem@/-tremolo@/.ly}.
 
 @node Tremolo subdivisions
 @subsection Tremolo subdivisions
@@ -3068,7 +3071,7 @@ staff are squashed, and the staff itself has a single line
 
 Program reference: @internalsref{RhythmicStaff}.
 
-Examples: @inputfileref{input/regression,rhythmic-staff.ly}.
+Examples: @inputfileref{input/@/regression,rhythmic@/-staff@/.ly}.
 
 
 @node Entering percussion
@@ -3090,7 +3093,7 @@ in input files
 @end lilypond
 
 The complete list of drum names is in the init file
-@file{ly/drumpitch-init.ly}.
+@file{ly/@/drumpitch@/-init@/.ly}.
 @c TODO: properly document this.
 
 @seealso
@@ -3148,7 +3151,7 @@ The following variables have been predefined
 @item drums-style
 This is the default.  It typesets a typical drum kit on a five-line staff
 
-@lilypond[quote,raggedright,noindent]
+@lilypond[quote,raggedright]
 nam = \lyricmode { cymc cyms cymr hh hhc hho hhho hhp cb hc
     bd sn ss tomh tommh tomml toml tomfh tomfl }
 mus = \drummode  { cymc cyms cymr hh | hhc hho hhho hhp | \break cb hc
@@ -3163,7 +3166,7 @@ mus = \drummode  { cymc cyms cymr hh | hhc hho hhho hhp | \break cb hc
     } \mus
         \context Lyrics \nam 
     >>
-    \paper {
+    \layout {
     %% need to do this, because of indented @itemize
     linewidth= 9 \cm 
     \context { \Score
@@ -3294,7 +3297,7 @@ down = \drummode { bd4 sn bd toml8 toml }
 
 @seealso
 
-Init files: @file{ly/drumpitch-init.ly}.
+Init files: @file{ly/@/drumpitch@/-init@/.ly}.
 
 Program reference: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
 
@@ -3335,7 +3338,7 @@ Dynamics are not centered, but workarounds do exist.  See the
 The distance between the two staves is the same for all systems in the
 score.  It is possible to override this per system, but it does require
 an arcane command incantation.  See
-@inputfileref{input/test,piano-staff-distance.ly}.
+@inputfileref{input/@/test,piano@/-staff@/-distance@/.ly}.
 
 
 @node Automatic staff changes
@@ -3826,7 +3829,7 @@ Program reference: @internalsref{HyphenEvent},
 @internalsref{ExtenderEvent}, @internalsref{LyricHyphen}, and
 @internalsref{LyricExtender}
 
-Examples: @inputfileref{input/test,lyric-hyphen-retain.ly}.
+Examples: @inputfileref{input/@/test,lyric@/-hyphen@/-retain@/.ly}.
 
 
 
@@ -3977,10 +3980,10 @@ Program reference: @internalsref{LyricCombineMusic},
 @internalsref{Lyrics}, @internalsref{Melisma_translator}.
 
 Examples: @ref{Small ensembles},
-@inputfileref{input/regression,lyric-combine-new.ly},
+@inputfileref{input/@/regression,lyric@/-combine@/-new@/.ly},
 @c TODO: make separate section for melismata 
-@inputfileref{input/test,lyrics-melisma-variants.ly}.
-@inputfileref{input/test,lyrics-melisma-faster.ly}.
+@inputfileref{input/@/test,lyrics@/-melisma@/-variants@/.ly}.
+@inputfileref{input/@/test,lyrics@/-melisma@/-faster@/.ly}.
  
 @refbugs
 
@@ -4195,7 +4198,7 @@ minimum and maximum pitch.  To print such ambits, add the
 for example,
 
 @example
-  \paper @{
+  \layout @{
     \context @{
       \Voice
       \consists Ambitus_engraver
@@ -4206,7 +4209,7 @@ for example,
 This results in the following output
 
 @lilypond[quote,raggedright]
-\paper {
+\layout {
   \context {
     \Staff
     \consists Ambitus_engraver
@@ -4261,7 +4264,7 @@ Program reference: @internalsref{Ambitus},
 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
 @internalsref{AmbitusAccidental}.
 
-Examples:  @inputfileref{input/regression,ambitus.ly}.
+Examples:  @inputfileref{input/@/regression,ambitus@/.ly}.
 
 @refbugs
 
@@ -4340,7 +4343,7 @@ e16 fis gis a b4
 \set TabStaff.minimumFret = #8
 e16 fis gis a b4
 @end example
-@lilypond[quote,noindent,raggedright]
+@lilypond[quote,raggedright]
 frag =  {
   \key e \major
   e16 fis gis a b4
@@ -4408,6 +4411,7 @@ This section discusses issues that arise when writing popular music.
 * Chord names::                 
 * Chords mode::                 
 * Printing chord names::        
+* Fret diagrams::               
 * Improvisation::               
 @end menu
 
@@ -4415,10 +4419,10 @@ This section discusses issues that arise when writing popular music.
 @subsection Chord names
 @cindex Chords
 
-LilyPond has support for both printing chord names.  Chords may be
-entered in musical chord notation, i.e. @code{< .. >}, but they can
-also be entered by name.  Internally, the chords are represented as a
-set of pitches, so they can be transposed
+LilyPond has support for printing chord names.  Chords may be entered
+in musical chord notation, i.e. @code{< .. >}, but they can also be
+entered by name.  Internally, the chords are represented as a set of
+pitches, so they can be transposed
 
 
 @lilypond[quote,raggedright,verbatim,raggedright]
@@ -4431,8 +4435,8 @@ twoWays = \transpose c c' {
   <f bes d'>
 }
 
-  << \context ChordNames \twoWays
-     \context Voice \twoWays >> 
+<< \context ChordNames \twoWays
+   \context Voice \twoWays >> 
 @end lilypond
 
 This example also shows that the chord printing routines do not try to
@@ -4455,7 +4459,7 @@ In chord mode sets of pitches (chords) are entered with normal note
 names.  A chord is entered by the root, which is entered like a
 normal pitch
 
-@lilypond[quote,raggedright,fragment,verbatim,relative=2]
+@lilypond[quote,raggedright,fragment,verbatim]
   \chordmode { es4. d8 c2 }
 @end lilypond
 
@@ -4640,8 +4644,29 @@ following properties
 @cindex @code{chordNameExceptions}
 @item chordNameExceptions
 This is a list that contains the chords that have special formatting.
-For an example of tuning this property, see
-@inputfileref{input/regression,chord-name-exceptions.ly}.
+
+The exceptions list should be encoded as encoded as
+@verbatim
+       @{ <c f g bes>1 \markup @{ \\super \"7\" \"wahh\" @} @}
+@end verbatim
+
+To get this information into @code{chordNameExceptions} takes a little
+manoeuvring. The following code transforms @code{chExceptionMusic}
+(which is a sequential music) into a list of exceptions.
+@example
+       (sequential-music-to-chord-exceptions chExceptionMusic #t)
+@end example
+Then,
+@example
+(append
+ (sequential-music-to-chord-exceptions chExceptionMusic #t)
+ ignatzekExceptions)
+@end example
+adds the new exceptions to the default ones, which are defined in
+@file{ly/@/chord@/-modifier@/-init@/.ly}.
+
+For an example of tuning this property, see also
+@inputfileref{input/@/regression,chord@/-name@/-exceptions@/.ly}.
 @cindex exceptions, chord names.
 
 
@@ -4650,7 +4675,7 @@ For an example of tuning this property, see
 This property contains the markup object used for the 7th step, when
 it is major.  Predefined options are @code{whiteTriangleMarkup} and
 @code{blackTriangleMarkup}.  See
-@inputfileref{input/regression,chord-name-major7.ly} for an example.
+@inputfileref{input/@/regression,chord@/-name@/-major7@/.ly} for an example.
 
 @cindex @code{chordNameSeparator}
 @item chordNameSeparator
@@ -4686,13 +4711,13 @@ The predefined variables @code{\germanChords},
 @code{\semiGermanChords} set these variables.  The effect is
 demonstrated here,
 
-@lilypondfile[raggedright,]{chord-names-german.ly}
+@lilypondfile[raggedright]{chord-names-german.ly}
 
 There are also two other chord name schemes implemented: an alternate
 Jazz chord notation, and a systematic scheme called Banter chords.  The
 alternate jazz notation is also shown on the chart in @ref{Chord name
 chart}.  Turning on these styles is described in the input file
-@inputfileref{input/test,chord-names-jazz.ly}.
+@inputfileref{input/@/test,chord@/-names@/-jazz@/.ly}.
 
 @cindex Banter
 @cindex jazz chords
@@ -4711,13 +4736,14 @@ chart}.  Turning on these styles is described in the input file
 
 @seealso
 
-Examples: @inputfileref{input/regression,chord-name-major7.ly},
-@inputfileref{input/regression,chord-name-exceptions.ly},
-@inputfileref{input/test,chord-names-jazz.ly},
-@inputfileref{input/test,chords-without-melody.ly}.
+Examples: @inputfileref{input/@/regression,chord@/-name@/-major7@/.ly},
+@inputfileref{input/@/regression,chord@/-name@/-exceptions@/.ly},
+@inputfileref{input/@/test,chord@/-names@/-jazz@/.ly},
+@inputfileref{input/@/test,chords@/-without@/-melody@/.ly}.
 
 
-Init files: @file{scm/chords-ignatzek.scm}, and @file{scm/chord-entry.scm}.
+Init files: @file{scm/@/chords@/-ignatzek@/.scm}, and
+@file{scm/@/chord@/-entry@/.scm}.
 
 
 @refbugs
@@ -4728,6 +4754,55 @@ may result in strange chord names when chords are entered with the
 @code{< .. >} syntax.
 
 
+@node Fret diagrams
+@subsection Fret diagrams
+@cindex fret diagrams
+@cindex chord diagrams
+
+Fret diagrams can be added to music as a markup to the desired note. The
+markup contains information about the desired fret diagram, as shown in the
+following example
+
+@lilypond[verbatim, raggedright, quote]
+\context Voice {
+  d' ^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  d' d' d'
+  fis' ^\markup \override #'(size . 0.75) {
+    \override #'(finger-code . below-string) {
+      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
+                               (place-fret 5 4 3) (place-fret 4 4 4)
+                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 1 2 1))
+    }
+  }
+  fis' fis' fis'
+  c' ^\markup  \override #'(dot-radius . 0.35) {
+    \override #'(finger-code . in-dot) {
+      \override #'(dot-color . white) {
+        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
+      }
+    }
+  }
+  c' c' c'
+}
+@end lilypond
+
+
+There are three different fret-diagram markup interfaces: standard, terse,
+and verbose.  The three interfaces produce equivalent markups, but have
+varying amounts of information in the markup string.  Details about the
+markup interfaces are found at @ref{Overview of text markup commands}. 
+
+You can set a number of graphical properties according to your preference.
+Details about the property interface to fret diagrams are found at 
+@internalsref{fret-diagram-interface}.
+
+
+@seealso
+
+Examples: @inputfileref{input/@/test,fret@/-diagram@/.ly}
+
+
 @node Improvisation
 @subsection Improvisation
 
@@ -4926,7 +5001,7 @@ few measures, it is set to function that produces a boxed number.
 }
 @end lilypond
 
-The file @file{scm/translation-functions.scm} contains the definitions
+The file @file{scm/@/translation@/-functions@/.scm} contains the definitions
 of @code{format-mark-numbers} (the default format) and
 @code{format-mark-letters}.  These can be used as inspiration for other
 formatting functions.
@@ -4966,14 +5041,14 @@ behavior
 
 Program reference: @internalsref{MarkEvent}, @internalsref{RehearsalMark}.
 
-Init files: @file{scm/translation-functions.scm} contains the
+Init files: @file{scm/@/translation@/-functions@/.scm} contains the
 definition of @code{format-mark-numbers} and
 @code{format-mark-letters}.  They can be used as inspiration for other
 formatting functions.
 
-Examples: @inputfileref{input/regression,rehearsal-mark-letter.ly},
+Examples: @inputfileref{input/@/regression,rehearsal@/-mark@/-letter@/.ly},
 
-@inputfileref{input/regression,rehearsal-mark-number.ly}.
+@inputfileref{input/@/regression,rehearsal@/-mark@/-number@/.ly}.
 
 
 @node Bar numbers
@@ -4991,16 +5066,29 @@ is normally updated automatically for every measure.
 Bar numbers can be typeset at regular intervals instead of at the
 beginning of each line.  This is illustrated in the following example,
 whose source is available as
-@inputfileref{input/test,bar-number-regular-interval.ly}
+@inputfileref{input/@/test,bar@/-number@/-regular@/-interval@/.ly}
 
 @lilypondfile[raggedright,quote]{bar-number-regular-interval.ly}
 
+Bar numbers can be manually changed by setting the
+@code{Staff.currentBarNumber} property
+
+@c fragproblem?  -gp
+@lilypond[raggedright,quote]
+\relative c' {
+  \repeat unfold 4 {c4 c c c} \break
+  \set Score.currentBarNumber = #50
+  \repeat unfold 4 {c4 c c c}
+}
+@end lilypond
+
 @seealso
 
 Program reference: @internalsref{BarNumber}.
 
-Examples: @inputfileref{input/test,bar-number-every-five-reset.ly},
-and @inputfileref{input/test,bar-number-regular-interval.ly}.
+Examples:
+@inputfileref{input/@/test,bar@/-number@/-every@/-five@/-reset@/.ly},
+and @inputfileref{input/@/test,bar@/-number@/-regular@/-interval@/.ly}.
 
 @refbugs
 
@@ -5039,7 +5127,7 @@ names, for example
 @end lilypond
 
 For longer instrument names, it may be useful to increase the
-@code{indent} setting in the @code{\paper} block.
+@code{indent} setting in the @code{\layout} block.
 
 @seealso
 
@@ -5219,16 +5307,15 @@ rest, use @code{MultiMeasureRest.expand-limit}.
 @cindex fermata on multi-measure rest
 
 Texts can be added to multi-measure rests by using the
-@var{note}-@code{markup} syntax (see @ref{Text markup}).  In this case, the number is
-replaced.  If you need both texts and the number, you must add the
-number by hand.  A variable (@code{\fermataMarkup}) is provided for
+@var{note}-@code{markup} syntax (see @ref{Text markup}).  
+A variable (@code{\fermataMarkup}) is provided for
 adding fermatas
 
 
 @lilypond[quote,raggedright,verbatim,fragment]
   \set Score.skipBars = ##t
   \time 3/4
-  R2.*10^\markup { \number 10 }_\markup { "Ad lib" }
+  R2.*10^\markup { "Ad lib" }
   R2.^\fermataMarkup
 @end lilypond
 
@@ -5382,7 +5469,7 @@ in this example disappears in the second line
 
 
 @lilypond[quote,raggedright,verbatim]
-\paper {
+\layout {
   \context { \RemoveEmptyStaffContext }
 }
 
@@ -5400,7 +5487,7 @@ removed from the first system too, set @code{remove-first} to false in
 
 Another application is making ossia sections, i.e. alternative
 melodies on a separate piece of staff, with help of a Frenched
-staff.  See @inputfileref{input/test,ossia.ly} for an example.
+staff.  See @inputfileref{input/@/test,ossia@/.ly} for an example.
 
 
 @node Different editions from one source
@@ -5439,8 +5526,8 @@ to an articulation, for example,
 
 This defines a note with a conditional fingering indication.
 
-By applying the @code{\keepWithTag} command, tagged expressions
-can be filtered.  For example,
+By applying the @code{\keepWithTag} and @code{\removeWithTag}
+commands, tagged expressions can be filtered.  For example,
 @example
 <<
   @var{the music}
@@ -5459,9 +5546,11 @@ of symbols, for example,
   \tag #'(original-part transposed-part) @dots{}
 @end example
 
+
+
 @seealso
 
-Examples: @inputfileref{input/regression,tag-filter.ly}.
+Examples: @inputfileref{input/@/regression,tag@/-filter@/.ly}.
 
 @refbugs
 
@@ -5537,7 +5626,8 @@ rests of the cued voice end up in the @code{\quote}.
 Setting
 
 @example
-  \set Staff.quotedEventTypes = #'(note-event articulation-event dynamic-event)  
+\set Staff.quotedEventTypes =
+       #'(note-event articulation-event dynamic-event)  
 @end example
 
 @noindent
@@ -5550,13 +5640,14 @@ Only the contents of the first @internalsref{Voice} occurring in an
 @var{music} can not contain @code{\new} and @code{\context Voice}
 statements that would switch to a different Voice.
 
+Quoting grace notes is broken and can even cause LilyPond to crash.
 
 @seealso
 
 In this manual: @ref{Instrument transpositions}.
 
-Examples: @inputfileref{input/regression,quote.ly}
-@inputfileref{input/regression,quote-transposition.ly}
+Examples: @inputfileref{input/@/regression,quote@/.ly}
+@inputfileref{input/@/regression,quote@/-transposition@/.ly}
 
 Program reference: @internalsref{QuoteMusic}.
 
@@ -5757,7 +5848,7 @@ engravers work.
 
 @seealso
 
-Examples: @inputfileref{input/regression,note-head-style.ly} gives an
+Examples: @inputfileref{input/@/regression,note@/-head@/-style@/.ly} gives an
 overview over all available note head styles.
 
 
@@ -5796,7 +5887,7 @@ select ancient accidentals.   Supported styles are
     >
   }
 }
-\paper {
+\layout {
   interscoreline = 1
   \context { \Score \remove "Bar_number_engraver" }
   \context { \Staff
@@ -5813,7 +5904,7 @@ select ancient accidentals.   Supported styles are
 As shown, not all accidentals are supported by each style.  When
 trying to access an unsupported accidental, LilyPond will switch to a
 different style, as demonstrated in
-@inputfileref{input/test,ancient-accidentals.ly}.
+@inputfileref{input/@/test,ancient@/-accidentals@/.ly}.
 
 Similarly to local accidentals, the style of the key signature can be
 controlled by the @code{style} property of the
@@ -5828,7 +5919,7 @@ the use of key signatures.
 
 Program reference: @internalsref{KeySignature}.
 
-Examples: @inputfileref{input/test,ancient-accidentals.ly}.
+Examples: @inputfileref{input/@/test,ancient@/-accidentals@/.ly}.
 
 @node Ancient rests
 @subsection Ancient rests
@@ -5855,7 +5946,7 @@ The following example demonstrates the @code{neomensural} style
 
 There are no 32th and 64th rests specifically for the mensural or
 neo-mensural style.  Instead, the rests from the default style will be
-taken.  See @inputfileref{input/test,rests.ly} for a chart of all
+taken.  See @inputfileref{input/@/test,rests@/.ly} for a chart of all
 rests.
 
 There are no rests in Gregorian Chant notation; instead, it uses
@@ -5883,128 +5974,153 @@ arbitrary line, as described in @ref{Clef}.  The note printed to the
 right side of each clef in the example column denotes the @code{c'}
 with respect to that clef.
 
-@multitable @columnfractions   .4 .4 .2
-
+@multitable @columnfractions .4 .4 .2
 @item
-@b{Description} @tab
-@b{Supported Clefs} @tab
+@b{Description}
+@tab
+@b{Supported Clefs}
+@tab
 @b{Example}
 
 @item
-modern style mensural C clef @tab
-@code{neomensural-c1}, @code{neomensural-c2},
-@code{neomensural-c3}, @code{neomensural-c4} @tab
-@lilypond[fragment,raggedright,quote,relative=1,notime]
+modern style mensural C clef
+@tab
+@code{neomensural-c1}, @code{neomensural-c2},@*
+@code{neomensural-c3}, @code{neomensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "neomensural-c2" c
 @end lilypond
 
 @item
 petrucci style mensural C clefs, for use on different staff lines
-(the examples shows the 2nd staff line C clef).
-
+(the examples shows the 2nd staff line C clef)
 @tab
-@code{petrucci-c1}
-@code{petrucci-c2}
-@code{petrucci-c3}
-@code{petrucci-c4}
+@code{petrucci-c1}, @code{petrucci-c2},@*
+@code{petrucci-c3}, @code{petrucci-c4},@*
 @code{petrucci-c5}
-
 @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+@lilypond[fragment,relative=1,notime]
   \clef "petrucci-c2" c
 @end lilypond
 
 @item
-petrucci style mensural F clef @tab
-@code{petrucci-f} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+petrucci style mensural F clef
+@tab
+@code{petrucci-f}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "petrucci-f" c
 @end lilypond
 
 @item
-petrucci style mensural G clef @tab
-@code{petrucci-g} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+petrucci style mensural G clef
+@tab
+@code{petrucci-g}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "petrucci-g" c
 @end lilypond
 
 @item
-historic style mensural C clef @tab
-@code{mensural-c1}, @code{mensural-c2}, @code{mensural-c3},
-@code{mensural-c4} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+historic style mensural C clef
+@tab
+@code{mensural-c1}, @code{mensural-c2},@*
+@code{mensural-c3}, @code{mensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "mensural-c2" c
 @end lilypond
 
 @item
-historic style mensural F clef @tab
-@code{mensural-f} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+historic style mensural F clef
+@tab
+@code{mensural-f}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "mensural-f" c
 @end lilypond
 
 @item
-historic style mensural G clef @tab
-@code{mensural-g} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+historic style mensural G clef
+@tab
+@code{mensural-g}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "mensural-g" c
 @end lilypond
 
 @item
-Editio Vaticana style do clef @tab
-@code{vaticana-do1}, @code{vaticana-do2}, @code{vaticana-do3} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+Editio Vaticana style do clef
+@tab
+@code{vaticana-do1}, @code{vaticana-do2},@*
+@code{vaticana-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol   #'line-count = #4
   \clef "vaticana-do2" c
 @end lilypond
 
 @item
-Editio Vaticana style fa clef @tab
-@code{vaticana-fa1}, @code{vaticana-fa2} @tab
-@lilypond[quote,relative=1,notime,indent=0.0\mm,fragment]
+Editio Vaticana style fa clef
+@tab
+@code{vaticana-fa1}, @code{vaticana-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol   #'line-count = #4
   \clef "vaticana-fa2" c
 @end lilypond
 
 @item
-Editio Medicaea style do clef @tab
-@code{medicaea-do1}, @code{medicaea-do2}, @code{medicaea-do3} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+Editio Medicaea style do clef
+@tab
+@code{medicaea-do1}, @code{medicaea-do2},@*
+@code{medicaea-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol   #'line-count = #4
   \clef "medicaea-do2" c
 @end lilypond
 
 @item
-Editio Medicaea style fa clef @tab
-@code{medicaea-fa1}, @code{medicaea-fa2} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+Editio Medicaea style fa clef
+@tab
+@code{medicaea-fa1}, @code{medicaea-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol   #'line-count = #4
   \clef "medicaea-fa2" c
 @end lilypond
 
 @item
-historic style hufnagel do clef @tab
-@code{hufnagel-do1}, @code{hufnagel-do2}, @code{hufnagel-do3} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+historic style hufnagel do clef
+@tab
+@code{hufnagel-do1}, @code{hufnagel-do2},@*
+@code{hufnagel-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol   #'line-count = #4
   \clef "hufnagel-do2" c
 @end lilypond
 
 @item
-historic style hufnagel fa clef @tab
-@code{hufnagel-fa1}, @code{hufnagel-fa2} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+historic style hufnagel fa clef
+@tab
+@code{hufnagel-fa1}, @code{hufnagel-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol   #'line-count = #4
   \clef "hufnagel-fa2" c
 @end lilypond
 
 @item
-historic style hufnagel combined do/fa clef @tab
-@code{hufnagel-do-fa} @tab
-@lilypond[fragment,quote,relative=1,notime,indent=0.0\mm]
+historic style hufnagel combined do/fa clef
+@tab
+@code{hufnagel-do-fa}
+@tab
+@lilypond[fragment,relative=1,notime]
   \clef "hufnagel-do-fa" c
 @end lilypond
-
 @end multitable
 
 
@@ -6084,7 +6200,7 @@ command, @code{n} and @code{m} have to be chosen according to the
 following table
 
 @lilypond[quote,raggedright]
-\paper {
+\layout {
   indent = 0.0
   \context { \Staff
     \remove Staff_symbol_engraver
@@ -6191,7 +6307,7 @@ In addition to the standard articulation signs described in section
 provided.  These are specifically designed for use with notation in
 Editio Vaticana style.
 
-@lilypond[quote,raggedright,verbatim,noindent]
+@lilypond[quote,raggedright,verbatim]
 \include "gregorian-init.ly"
 \score {
   \context VaticanaVoice {
@@ -6230,11 +6346,11 @@ like the @emph{editio vaticana}.  There are different custos glyphs
 used in different flavors of notational style.
 
 For typesetting custodes, just put a @internalsref{Custos_engraver} into the
-@internalsref{Staff} context when declaring the @code{\paper} block,
+@internalsref{Staff} context when declaring the @code{\layout} block,
 as shown in the following example
 
 @example
-\paper @{
+\layout @{
   \context @{
     \Staff
     \consists Custos_engraver
@@ -6253,7 +6369,7 @@ The result looks like this
   \break
   g'
 }
-\paper {
+\layout {
   \context { \Staff \consists Custos_engraver }
   }
 }
@@ -6289,7 +6405,7 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel} and
 
 Program reference: @internalsref{Custos}.
 
-Examples: @inputfileref{input/regression,custos.ly}.
+Examples: @inputfileref{input/@/regression,custos@/.ly}.
 
 
 @node Divisiones
@@ -6309,12 +6425,12 @@ only marks the end of a chant, but is also frequently used within a
 single antiphonal/responsorial chant to mark the end of each section.
 
 
-To use divisiones, include the file @code{gregorian-init.ly}.  It
+To use divisiones, include the file @file{gregorian@/-init@/.ly}.  It
 contains definitions that you can apply by just inserting
 @code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima},
 and @code{\finalis} at proper places in the input.  Some editions use
 @emph{virgula} or @emph{caesura} instead of divisio minima.
-Therefore, @code{gregorian-init.ly} also defines @code{\virgula} and
+Therefore, @file{gregorian@/-init@/.ly} also defines @code{\virgula} and
 @code{\caesura}
 
 @lilypondfile[quote,raggedright]{divisiones.ly}
@@ -6340,7 +6456,7 @@ In this manual: @ref{Breath marks}.
 
 Program reference: @internalsref{BreathingSign}, @internalsref{BreathingSignEvent}.
 
-Examples: @inputfileref{input/test,divisiones.ly}.
+Examples: @inputfileref{input/@/test,divisiones@/.ly}.
 
 @node Ligatures
 @subsection Ligatures
@@ -6401,13 +6517,13 @@ Augmentum dots within ligatures are not handled correctly.
 
 There is limited support for white mensural ligatures.  
 
-To engrave white mensural ligatures, in the paper block the
+To engrave white mensural ligatures, in the layout block the
 @internalsref{Mensural_ligature_engraver} has to be put into the
 @internalsref{Voice} context, and remove the
 @internalsref{Ligature_bracket_engraver}
 
 @example
-\paper @{
+\layout @{
   \context @{
     \Voice
     \remove Ligature_bracket_engraver
@@ -6448,7 +6564,7 @@ For example,
     s4
     \[ e1 f1 a\breve g\longa \]
   }
-  \paper {
+  \layout {
     \context {
       \Voice
       \remove Ligature_bracket_engraver
@@ -6500,12 +6616,21 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
 @multitable @columnfractions .4 .2 .2 .2
 
 @item
-@b{Neuma aut@*Neumarum Elementa} @tab
-@b{Figurae@*Rectae} @tab
-@b{Figurae@*Liquescentes Auctae} @tab
-@b{Figurae@*Liquescentes Deminutae}
+@b{Neuma aut@*
+Neumarum Elementa}
+@tab
+@b{Figurae@*
+Rectae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Auctae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Deminutae}
 
-@c TODO: \paper block is identical in all of the below examples.
+@c TODO: \layout block is identical in all of the below examples.
 @c Therefore, it should somehow be included rather than duplicated all
 @c the time. --jr
 
@@ -6518,7 +6643,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
 @item
 @code{1. Punctum}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.5\cm]
+@lilypond[staffsize=26,linewidth=1.5\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6530,10 +6655,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \inclinatum b \]
     \noBreak s^\markup {"b"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=2.5\cm]
+@lilypond[staffsize=26,linewidth=2.5\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6549,10 +6674,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \inclinatum \auctum b \]
     \noBreak s^\markup {"e"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6560,13 +6685,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \inclinatum \deminutum b \]
     \noBreak s^\markup {"f"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{2. Virga}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6574,7 +6699,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \virga b \]
     \noBreak s^\markup {"g"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 @tab
@@ -6582,7 +6707,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
 @item
 @code{3. Apostropha vel Stropha}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6590,10 +6715,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \stropha b \]
     \noBreak s^\markup {"h"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6601,14 +6726,14 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \stropha \auctum b \]
     \noBreak s^\markup {"i"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 
 @item
 @code{4. Oriscus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6616,7 +6741,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \oriscus b \]
     \noBreak s^\markup {"j"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 @tab
@@ -6624,7 +6749,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
 @item
 @code{5. Clivis vel Flexa}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6632,10 +6757,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ b \flexa g \]
     s^\markup {"k"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=2.0\cm]
+@lilypond[staffsize=26,linewidth=2.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6647,10 +6772,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ b \flexa \auctum \ascendens g \]
     \noBreak s^\markup {"m"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6658,13 +6783,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ b \flexa \deminutum g \]
     s^\markup {"n"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{6. Podatus vel Pes}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6672,10 +6797,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \pes b \]
     s^\markup {"o"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=2.0\cm]
+@lilypond[staffsize=26,linewidth=2.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6687,10 +6812,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \pes \auctum \ascendens b \]
     \noBreak s^\markup {"q"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6698,13 +6823,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \pes \deminutum b \]
     s^\markup {"r"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{7. Pes Quassus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6712,10 +6837,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \oriscus g \pes \virga b \]
     s^\markup {"s"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6723,14 +6848,14 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \oriscus g \pes \auctum \descendens b \]
     s^\markup {"t"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 
 @item
 @code{8. Quilisma Pes}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6738,10 +6863,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \quilisma g \pes b \]
     s^\markup {"u"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6749,14 +6874,14 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \quilisma g \pes \auctum \descendens b \]
     s^\markup {"v"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 
 @item
 @code{9. Podatus Initio Debilis}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6764,10 +6889,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \deminutum g \pes b \]
     s^\markup {"w"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6775,14 +6900,14 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \deminutum g \pes \auctum \descendens b \]
     s^\markup {"x"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 
 @item
 @code{10. Torculus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6790,10 +6915,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ a \pes b \flexa g \]
     s^\markup {"y"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6801,10 +6926,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ a \pes b \flexa \auctum \descendens g \]
     s^\markup {"z"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6812,13 +6937,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ a \pes b \flexa \deminutum g \]
     s^\markup {"A"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{11. Torculus Initio Debilis}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6826,10 +6951,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \deminutum a \pes b \flexa g \]
     s^\markup {"B"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6837,10 +6962,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \deminutum a \pes b \flexa \auctum \descendens g \]
     s^\markup {"C"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6848,13 +6973,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \deminutum a \pes b \flexa \deminutum g \]
     s^\markup {"D"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{12. Porrectus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6862,10 +6987,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ a \flexa g \pes b \]
     s^\markup {"E"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6873,10 +6998,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ a \flexa g \pes \auctum \descendens b \]
     s^\markup {"F"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6884,13 +7009,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ a \flexa g \pes \deminutum b \]
     s^\markup {"G"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{13. Climacus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6898,11 +7023,11 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \virga b \inclinatum a \inclinatum g \]
     s^\markup {"H"}
   }
-  \paper { \neumeDemoPaper }
+  \layout { \neumeDemoLayout }
 }
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6910,10 +7035,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \virga b \inclinatum a \inclinatum \auctum g \]
     s^\markup {"I"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6921,13 +7046,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \virga b \inclinatum a \inclinatum \deminutum g \]
     s^\markup {"J"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{14. Scandicus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6935,10 +7060,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \pes a \virga b \]
     s^\markup {"K"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6946,10 +7071,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \pes a \pes \auctum \descendens b \]
     s^\markup {"L"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6957,13 +7082,13 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \pes a \pes \deminutum b \]
     s^\markup {"M"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 
 @item
 @code{15. Salicus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6971,10 +7096,10 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \oriscus a \pes \virga b \]
     s^\markup {"N"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6982,14 +7107,14 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ g \oriscus a \pes \auctum \descendens b \]
     s^\markup {"O"}
   }
-\paper { \neumeDemoPaper }}
+\layout { \neumeDemoLayout }}
 @end lilypond
 @tab
 
 @item
 @code{16. Trigonus}
 @tab
-@lilypond[quote,noindent,staffsize=26,nofragment,linewidth=1.0\cm]
+@lilypond[staffsize=26,linewidth=1.0\cm]
 \include "gregorian-init.ly"
 \score {
   \transpose c c' {
@@ -6997,7 +7122,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
     \[ \stropha b \stropha b \stropha a \]
     s^\markup {"P"}
   }
-  \paper { \neumeDemoPaper }
+  \layout { \neumeDemoLayout }
 }
 @end lilypond
 @tab
@@ -7026,223 +7151,321 @@ above table it refers.  The second column gives the name of the
 ligature.  The third column shows the code fragment that produces this
 ligature, using @code{g}, @code{a} and @code{b} as example pitches.
 
-@multitable @columnfractions .1 .4 .5
-
+@multitable @columnfractions .02 .31 .67
 @item
-@b{#} @tab
-@b{Name} @tab
+@b{#}
+@tab
+@b{Name}
+@tab
 @b{Input Language}
 
 @item
-a @tab
-Punctum @tab
+a
+@tab
+Punctum
+@tab
 @code{\[ b \]}
 
 @item
-b @tab
-Punctum Inclinatum @tab
+b
+@tab
+Punctum Inclinatum
+@tab
 @code{\[ \inclinatum b \]}
 
 @item
-c @tab
-Punctum Auctum Ascendens @tab
+c
+@tab
+Punctum Auctum@*
+Ascendens
+@tab
 @code{\[ \auctum \ascendens b \]}
 
 @item
-d @tab
-Punctum Auctum Descendens @tab
+d
+@tab
+Punctum Auctum@*
+Descendens
+@tab
 @code{\[ \auctum \descendens b \]}
 
 @item
-e @tab
-Punctum Inclinatum Auctum @tab
+e
+@tab
+Punctum Inclinatum@*
+Auctum
+@tab
 @code{\[ \inclinatum \auctum b \]}
 
 @item
-f @tab
-Punctum Inclinatum Parvum @tab
+f
+@tab
+Punctum Inclinatum@*
+Parvum @tab
 @code{\[ \inclinatum \deminutum b \]}
 
 @item
-g @tab
-Virga @tab
+g
+@tab
+Virga
+@tab
 @code{\[ \virga b \]}
 
 @item
-h @tab
-Stropha @tab
+h
+@tab
+Stropha
+@tab
 @code{\[ \stropha b \]}
 
 @item
-i @tab
-Stropha Aucta @tab
+i
+@tab
+Stropha Aucta
+@tab
 @code{\[ \stropha \auctum b \]}
 
 @item
-j @tab
-Oriscus @tab
+j
+@tab
+Oriscus
+@tab
 @code{\[ \oriscus b \]}
 
 @item
-k @tab
-Clivis vel Flexa @tab
+k
+@tab
+Clivis vel Flexa
+@tab
 @code{\[ b \flexa g \]}
 
 @item
-l @tab
-Clivis Aucta Descendens @tab
+l
+@tab
+Clivis Aucta@*
+Descendens
+@tab
 @code{\[ b \flexa \auctum \descendens g \]}
 
 @item
-m @tab
-Clivis Aucta Ascendens @tab
+m
+@tab
+Clivis Aucta@*
+Ascendens
+@tab
 @code{\[ b \flexa \auctum \ascendens g \]}
 
 @item
-n @tab
-Cephalicus @tab
+n
+@tab
+Cephalicus
+@tab
 @code{\[ b \flexa \deminutum g \]}
 
 @item
-o @tab
-Podatus vel Pes @tab
+o
+@tab
+Podatus vel Pes
+@tab
 @code{\[ g \pes b \]}
 
 @item
-p @tab
-Pes Auctus Descendens @tab
+p
+@tab
+Pes Auctus@*
+Descendens
+@tab
 @code{\[ g \pes \auctum \descendens b \]}
 
 @item
-q @tab
-Pes Auctus Ascendens @tab
+q
+@tab
+Pes Auctus@*
+Ascendens
+@tab
 @code{\[ g \pes \auctum \ascendens b \]}
 
 @item
-r @tab
-Epiphonus @tab
+r
+@tab
+Epiphonus
+@tab
 @code{\[ g \pes \deminutum b \]}
 
 @item
-s @tab
-Pes Quassus @tab
+s
+@tab
+Pes Quassus
+@tab
 @code{\[ \oriscus g \pes \virga b \]}
 
 @item
-t @tab
-Pes Quassus Auctus Descendens @tab
+t
+@tab
+Pes Quassus@*
+Auctus Descendens @tab
 @code{\[ \oriscus g \pes \auctum \descendens b \]}
 
 @item
-u @tab
-Quilisma Pes @tab
+u
+@tab
+Quilisma Pes
+@tab
 @code{\[ \quilisma g \pes b \]}
 
 @item
-v @tab
-Quilisma Pes Auctus Descendens @tab
+v
+@tab
+Quilisma Pes@*
+Auctus Descendens
+@tab
 @code{\[ \quilisma g \pes \auctum \descendens b \]}
 
 @item
-w @tab
-Pes Initio Debilis @tab
+w
+@tab
+Pes Initio Debilis
+@tab
 @code{\[ \deminutum g \pes b \]}
 
 @item
-x @tab
-Pes Auctus Descendens Initio Debilis @tab
+x
+@tab
+Pes Auctus Descendens@*
+Initio Debilis
+@tab
 @code{\[ \deminutum g \pes \auctum \descendens b \]}
 
 @item
-y @tab
-Torculus @tab
+y
+@tab
+Torculus
+@tab
 @code{\[ a \pes b \flexa g \]}
 
 @item
-z @tab
-Torculus Auctus Descendens @tab
+z
+@tab
+Torculus Auctus@*
+Descendens
+@tab
 @code{\[ a \pes b \flexa \auctum \descendens g \]}
 
 @item
-A @tab
-Torculus Deminutus @tab
+A
+@tab
+Torculus Deminutus
+@tab
 @code{\[ a \pes b \flexa \deminutum g \]}
 
 @item
-B @tab
-Torculus Initio Debilis @tab
+B
+@tab
+Torculus Initio Debilis
+@tab
 @code{\[ \deminutum a \pes b \flexa g \]}
 
 @item
-C @tab
-Torculus Auctus Descendens Initio Debilis @tab
+C
+@tab
+Torculus Auctus@*
+Descendens Initio Debilis
+@tab
 @code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
 
 @item
-D @tab
-Torculus Deminutus Initio Debilis @tab
+D
+@tab
+Torculus Deminutus@*
+Initio Debilis
+@tab
 @code{\[ \deminutum a \pes b \flexa \deminutum g \]}
 
 @item
-E @tab
-Porrectus @tab
+E
+@tab
+Porrectus
+@tab
 @code{\[ a \flexa g \pes b \]}
 
 @item
-F @tab
-Porrectus Auctus Descendens @tab
+F
+@tab
+Porrectus Auctus@*
+Descendens
+@tab
 @code{\[ a \flexa g \pes \auctum \descendens b \]}
 
 @item
-G @tab
-Porrectus Deminutus @tab
+G
+@tab
+Porrectus Deminutus
+@tab
 @code{\[ a \flexa g \pes \deminutum b \]}
 
 @item
-H @tab
-Climacus @tab
+H
+@tab
+Climacus
+@tab
 @code{\[ \virga b \inclinatum a \inclinatum g \]}
 
 @item
-I @tab
-Climacus Auctus @tab
+I
+@tab
+Climacus Auctus
+@tab
 @code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
 
 @item
-J @tab
-Climacus Deminutus @tab
+J
+@tab
+Climacus Deminutus
+@tab
 @code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
 
 @item
-K @tab
-Scandicus @tab
+K
+@tab
+Scandicus
+@tab
 @code{\[ g \pes a \virga b \]}
 
 @item
-L @tab
-Scandicus Auctus Descendens @tab
+L
+@tab
+Scandicus Auctus@*
+Descendens
+@tab
 @code{\[ g \pes a \pes \auctum \descendens b \]}
 
 @item
-M @tab
-Scandicus Deminutus @tab
+M
+@tab
+Scandicus Deminutus
+@tab
 @code{\[ g \pes a \pes \deminutum b \]}
 
 @item
-N @tab
-Salicus @tab
+N
+@tab
+Salicus
+@tab
 @code{\[ g \oriscus a \pes \virga b \]}
 
 @item
-O @tab
-Salicus Auctus Descendens @tab
+O
+@tab
+Salicus Auctus Descendens
+@tab
 @code{\[ g \oriscus a \pes \auctum \descendens b \]}
 
 @item
-P @tab
-Trigonus @tab
+P
+@tab
+Trigonus
+@tab
 @code{\[ \stropha b \stropha b \stropha a \]}
-
 @end multitable
 
 @refcommands
@@ -7293,7 +7516,7 @@ initialize all relevant context properties and grob properties to
 proper values, so you can immediately go ahead entering the chant, as
 the following excerpt demonstrates
 
-@lilypond[quote,raggedright,verbatim,noindent]
+@lilypond[quote,raggedright,verbatim]
 \include "gregorian-init.ly"
 \score {
   <<
@@ -7328,7 +7551,7 @@ style.  These contexts initialize all relevant context properties and
 grob properties to proper values, so you can immediately go ahead
 entering the chant, as the following excerpt demonstrates
 
-@lilypond[quote,raggedright,verbatim,noindent]
+@lilypond[quote,raggedright,verbatim]
 \score {
   <<
     \context MensuralVoice = "discantus" \transpose c c' {
@@ -7477,7 +7700,7 @@ moving the @internalsref{Timing_engraver} to @internalsref{Staff}
 context.
 
 @verbatim
-\paper{
+\layout{
   \context{ \Score \remove "Timing_engraver" }
   \context{ \Staff \consists "Timing_engraver" }
 }       
@@ -7503,7 +7726,7 @@ Now, each staff has its own time signature.
 @end verbatim
 
 @lilypond[quote,raggedright]
-\paper{
+\layout{
   \context{ \Score \remove "Timing_engraver" }
   \context{ \Staff \consists "Timing_engraver" }
 }       
@@ -7590,7 +7813,7 @@ chords, e.g.
 @end lilypond
 
 The following example (from
-@inputfileref{input/regression,cluster.ly}) shows what the result
+@inputfileref{input/@/regression,cluster@/.ly}) shows what the result
 looks like
 
 @lilypondfile[raggedright,quote]{cluster.ly}
@@ -7606,7 +7829,7 @@ Program reference: @internalsref{ClusterSpanner},
 @internalsref{Cluster_spanner_engraver}, and
 @internalsref{ClusterNoteEvent}.
 
-Examples: @inputfileref{input/regression,cluster.ly}.
+Examples: @inputfileref{input/@/regression,cluster@/.ly}.
 
 @refbugs
 
@@ -7689,7 +7912,7 @@ teaching tools in addition to great musical scores.
 
 @menu
 * Balloon help::                
-* Blank music paper::           
+* Blank music sheet::           
 * Hidden notes::     
 * Easy Notation note heads::    
 @end menu
@@ -7724,15 +7947,15 @@ the object.  In the above example, the text ``heads or tails?'' ends
 
 Program reference: @internalsref{text-balloon-interface}.
 
-Examples: @inputfileref{input/regression,balloon.ly}.
+Examples: @inputfileref{input/@/regression,balloon@/.ly}.
 
 
 
 
-@node Blank music paper
-@subsection Blank music paper
+@node Blank music sheet
+@subsection Blank music sheet
 
-A blank music paper can be produced also by using invisible notes, and
+A blank music sheet can be produced also by using invisible notes, and
 removing @code{Bar_number_engraver}.