]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/ancient.itely
[doc] Try to omit leading # if not necessary.
[lilypond.git] / Documentation / notation / ancient.itely
index c2a4c072c59ee41a656235f398c2362a4d61894e..fe835fd077a41a19c6415da7536d34f607ff3a4c 100644 (file)
@@ -8,7 +8,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.14.0"
 
 
 @node Ancient notation
@@ -62,6 +62,23 @@ notation,
 @item @ref{Ligatures}.
 @end itemize
 
+@seealso
+Music Glossary:
+@rglos{custos},
+@rglos{ligature},
+@rglos{mensural notation}.
+
+Notation Reference:
+@ref{Mensural note heads},
+@ref{Mensural accidentals and key signatures},
+@ref{Mensural rests},
+@ref{Gregorian clefs},
+@ref{Mensural flags},
+@ref{Mensural time signatures},
+@ref{Custodes},
+@ref{Divisiones},
+@ref{Ligatures}.
+
 
 @node Overview of the supported styles
 @subsection Overview of the supported styles
@@ -84,7 +101,7 @@ such as the quilisma and the oriscus.
 used in the Medicaea (or Ratisbona) editions which were used prior
 to the Solesmes editions.  The most significant differences from
 the @emph{Vaticana} style are the clefs, which have
-downward-slanted strokes, and the noteheads, which are square and
+downward-slanted strokes, and the note heads, which are square and
 regular.
 
 @cindex Ratisbona, Editio
@@ -104,13 +121,13 @@ renaissance manuscripts and prints of mensural music:
 @itemize
 @item The @emph{Mensural} style most closely resembles the
 writing style used in late-medieval and early renaissance
-manuscripts, with its small and narrow, diamond-shaped noteheads
+manuscripts, with its small and narrow, diamond-shaped note heads
 and its rests which approach a hand-drawn style.
 
 @cindex mensural
 
 @item The @emph{Neomensural} style is a modernized and
-stylized version of the former: the noteheads are broader and the
+stylized version of the former: the note heads are broader and the
 rests are made up of straight lines.  This style is particularly
 suited, e.g., for incipits of transcribed pieces of mensural
 music.
@@ -128,7 +145,7 @@ larger note heads than the other mensural styles.
 
 @emph{Baroque} and @emph{Classical} are not complete styles
 but differ from the default style only in some details: certain
-noteheads (Baroque) and the quarter rest (Classical).
+note heads (Baroque) and the quarter rest (Classical).
 
 Only the mensural style has alternatives for all aspects of the
 notation.  Thus, there are no rests or flags in the Gregorian
@@ -136,10 +153,15 @@ styles, since these signs are not used in plainchant notation, and
 the Petrucci style has no flags or accidentals of its own.
 
 Each element of the notation can be changed independently of the
-others, so that one can use mensural flags, petrucci noteheads,
+others, so that one can use mensural flags, petrucci note heads,
 classical rests and vaticana clefs in the same piece, if one
 wishes.
 
+@seealso
+Music Glossary:
+@rglos{mensural notation},
+@rglos{flag}.
+
 
 @node Ancient notation---common features
 @subsection Ancient notation---common features
@@ -169,6 +191,14 @@ and @code{MensuralStaff}.  See further
 @item @ref{Mensural contexts}.
 @end itemize
 
+@seealso
+Music Glossary:
+@rglos{mensural notation}.
+
+Notation Reference:
+@ref{Gregorian chant contexts},
+@ref{Mensural contexts}.
+
 
 @node Ligatures
 @unnumberedsubsubsec Ligatures
@@ -204,16 +234,18 @@ mensural ligatures are supported for mensural music, and with
 certain limitations).  To use any of these styles, the default
 @code{Ligature_bracket_engraver} has to be replaced with one of the
 specialized ligature engravers in the @code{Voice} context,
-as explained in @ref{White mensural ligatures} and @ref{Gregorian
-square neume ligatures}.
-
+as explained in @ref{White mensural ligatures} and
+@ref{Gregorian square neume ligatures}.
 
-@c @seealso
-@c TODO: nothing here yet ...
+@seealso
+Music Glossary:
+@rglos{ligature}.
 
+Notation Reference:
+@ref{White mensural ligatures},
+@ref{Gregorian square neume ligatures}.
 
 @knownissues
-
 Ligatures need special spacing that has not yet been implemented.  As
 a result, there is too much space between ligatures most of the time,
 and line breaking often is unsatisfactory.  Also, lyrics do not
@@ -222,12 +254,12 @@ correctly align with ligatures.
 Accidentals must not be printed within a ligature, but instead need to
 be collected and printed in front of it.
 
-The syntax still uses the deprecated infix style @code{\[ music expr
-\]}.  For consistency reasons, it will eventually be changed to
-postfix style @code{note\[ ... note\]}.
+The syntax still uses the deprecated infix style
+@code{\[ music expr \]}.  For consistency reasons, it will eventually
+be changed to postfix style @code{note\[ ... note\]}.
 
 @c Alternatively, the file
-@c @file{gregorian@/-init@/.ly} can be included; it provides a scheme
+@c @file{gregorian-init.ly} can be included; it provides a scheme
 @c function
 @c @example
 @c \ligature @var{music expr}
@@ -244,9 +276,9 @@ postfix style @code{note\[ ... note\]}.
 @cindex custos
 @cindex custodes
 
-A @emph{custos} (plural: @emph{custodes}; Latin word for @qq{guard}) is a
-symbol that appears at the end of a staff.  It anticipates the pitch
-of the first note of the following line, thus helping the performer
+A @emph{custos} (plural: @emph{custodes}; Latin word for @qq{guard})
+is a symbol that appears at the end of a staff.  It anticipates the
+pitch of the first note of the following line, thus helping the performer
 to manage line breaks during performance.
 
 Custodes were frequently used in music notation until the
@@ -303,8 +335,10 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
 }
 @end lilypond
 
-
 @seealso
+Music Glossary:
+@rglos{custos}.
+
 Internals Reference:
 @rinternals{Custos}.
 
@@ -318,6 +352,13 @@ Snippets:
 There is limited support for figured bass notation from the
 Baroque period; see @ref{Figured bass}.
 
+@seealso
+Music Glossary:
+@rglos{figured bass}.
+
+Notation Reference:
+@ref{Figured bass}.
+
 
 @node Typesetting mensural music
 @subsection Typesetting mensural music
@@ -368,8 +409,9 @@ entering the chant, as the following excerpt demonstrates:
 @end lilypond
 
 
-@c @seealso
-@c TODO: nothing here yet ...
+@seealso
+Music Glossary:
+@rglos{mensural notation}.
 
 
 @node Mensural clefs
@@ -457,12 +499,14 @@ petrucci style C clefs, for use on different staff lines
 @end lilypond
 
 @item
-petrucci style F clef
+petrucci style F clefs, for use on different staff lines
+(the example shows the 3rd staff line F clef)
 @tab
-@code{petrucci-f}
+@code{petrucci-f3}, @code{petrucci-f4},@*
+@code{petrucci-f5}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "petrucci-f"
+  \clef "petrucci-f3"
   \override NoteHead #'style = #'mensural
   c
 @end lilypond
@@ -479,14 +523,16 @@ petrucci style G clef
 @end lilypond
 @end multitable
 
-
 @seealso
+Music Glossary:
+@rglos{mensural notation},
+@rglos{clef}.
+
 Notation Reference:
 @ref{Clef}.
 
 
 @knownissues
-
 The mensural g clef is mapped to the Petrucci g clef.
 
 
@@ -496,11 +542,10 @@ The mensural g clef is mapped to the Petrucci g clef.
 @cindex mensuration sign
 @cindex time signatures
 
-There is limited support for mensuration signs (which are similar to, but
-not exactly the same as time signatures).  The glyphs are hard-wired to
-particular time fractions.  In other words, to get a particular mensuration
-sign with the @code{\time n/m} command, @code{n} and @code{m} have to be
-chosen according to the following table
+There is limited support for mensuration signs (which are similar to,
+but not exactly the same as time signatures).  The glyphs are hard-wired
+to particular time fractions.  In other words, to get a particular mensuration sign with the @code{\time n/m} command, @code{n} and
+@code{m} have to be chosen according to the following table
 
 @lilypond[quote,ragged-right]
 \layout {
@@ -577,18 +622,21 @@ differences in style:
 }
 @end lilypond
 
-
-@seealso
-Notation Reference:
 @ref{Time signature}, gives a general introduction to
 the use of time signatures.
 
+@seealso
+Music Glossary:
+@rglos{mensural notation}.
 
-@knownissues
+Notation Reference:
+@ref{Time signature}.
 
-Ratios of note durations do not change with the time signature.  For
-example, the ratio of 1@tie{}breve = 3@tie{}semibreves (@emph{tempus
-perfectum}) must be made by hand, by setting
+@knownissues
+Ratios of note durations cannot change with the time signature,
+as those are not constant.  For
+example, the ratio of 1@tie{}breve = 3@tie{}semibreves
+(@emph{tempus perfectum}) can be made by hand, by setting
 
 @example
 breveTP = #(ly:make-duration -1 0 3 2)
@@ -609,26 +657,39 @@ Use @code{\markup @{\musicglyph #"timesig.mensural68alt" @}} instead.
 
 @cindex note heads, ancient
 
-For ancient notation, a note head style other than the @code{default} style
-may be chosen.  This is accomplished by setting the @code{style} property of
-the @code{NoteHead} object to @code{baroque}, @code{neomensural},
-@code{mensural} or @code{petrucci}.
+For ancient notation, a note head style other than the
+@code{default} style may be chosen.  This is accomplished by setting
+the @code{style} property of the @code{NoteHead} object to
+@code{baroque}, @code{neomensural}, @code{mensural},
+@code{petrucci}, @code{blackpetrucci} or @code{semipetrucci}.
 
 The @code{baroque} style differs from the @code{default} style by:
 
 @itemize
-@item Providing a @code{maxima} notehead, and
+@item Providing a @code{maxima} note head, and
 @item Using a square shape for @code{\breve} note heads.
 @end itemize
 
-The @code{neomensural}, @code{mensural}, and @code{petrucci} styles differ from
-the @code{baroque} style by:
+The @code{neomensural}, @code{mensural}, and @code{petrucci} styles
+differ from the @code{baroque} style by:
 
 @itemize
-@item Using rhomboidal heads for semibreves and all smaller durations, and
+@item Using rhomboidal heads for semibreves and all smaller durations,
+and
 @item Centering the stems on the note heads.
 @end itemize
 
+The @code{blackpetrucci} style produces note heads usable in black
+mensural notation or coloratio sections in white mensural notation.
+Because note head style does not influence flag count, in
+this style a semiminima should be notated as @code{a8*2}, not
+@code{a4}, otherwise it will look like a minima.
+The multiplyer can be different if coloratio is used e.g. to notate
+triplets.
+
+Use @code{semipetrucci} style to draw half-colored
+note heads (breves, longas and maximas).
+
 
 The following example demonstrates the @code{petrucci} style:
 
@@ -640,13 +701,25 @@ The following example demonstrates the @code{petrucci} style:
 \autoBeamOff
 \override NoteHead #'style = #'petrucci
 a'\maxima a'\longa a'\breve a'1 a'2 a'4 a'8 a'16 a'
-
+\override NoteHead #'style = #'semipetrucci
+a'\breve*5/6
+\override NoteHead #'style = #'blackpetrucci
+a'8*4/3 a'
+\override NoteHead #'style = #'petrucci
+a'\longa
 @end lilypond
 
 
+@ref{Note head styles}, gives an overview of all available note head
+styles.
+
 @seealso
+Music Glossary:
+@rglos{mensural notation},
+@rglos{note head}.
+
 Notation Reference:
-@ref{Note head styles}, gives an overview of all available note head styles.
+@ref{Note head styles}.
 
 
 @node Mensural flags
@@ -677,12 +750,13 @@ There is no particular flag style for neo-mensural or Petrucci notation.
 There are no flags in Gregorian chant notation.
 
 
-@c @seealso
-@c TODO: nothing here yet ...
+@seealso
+Music Glossary:
+@rglos{mensural notation},
+@rglos{flag}.
 
 
 @knownissues
-
 The attachment of ancient flags to stems is slightly off.
 @c due to a change in early 2.3.x.
 
@@ -699,7 +773,7 @@ scope for mensural notation).
 @cindex rests, ancient
 
 Use the @code{style} property of grob @code{Rest} to select
-ancient rests.   Supported styles are @code{classical},
+ancient rests.  Supported styles are @code{classical},
 @code{neomensural}, and @code{mensural}.  @code{classical} differs
 from the @code{default} style only in that the quarter rest looks
 like a horizontally mirrored 8th rest.  The @code{mensural} and
@@ -723,12 +797,22 @@ 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 @rlsr{Ancient notation} for a chart of all rests.
-
 @seealso
+Music Glossary:
+@rglos{mensural notation}.
+
 Notation Reference:
-@ref{Rests}, gives a general introduction into the use of
-rests.
+@ref{Rests}.
+
+Snippets:
+@rlsr{Ancient notation}.
+
+
+@knownissues
+The glyph for the maxima rest in mensural style is actually a perfect
+longa rest; use two (or three) longa rests to print a maxima rest.
+Longa rests are not grouped automatically, so have to be done manually by
+using pitched rests.
 
 
 @node Mensural accidentals and key signatures
@@ -742,27 +826,11 @@ different from the default style.  If called for, the natural sign
 will be taken from the @code{vaticana} style.
 
 @lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \textLengthOn
-  s^\markup {
-    \column {
-      "mensural"
-      \line { " " \musicglyph #"accidentals.mensural-1"
-        " " \musicglyph #"accidentals.mensural1" }
-    }
-  }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
+\markup {
+  \column {
+    "mensural"
+    \line { " " \musicglyph #"accidentals.mensural-1"
+      " " \musicglyph #"accidentals.mensural1" }
   }
 }
 @end lilypond
@@ -774,12 +842,18 @@ The style for accidentals and key signatures is controlled by the
 @code{\override Staff.Accidental #'glyph-name-alist =
 #alteration-mensural-glyph-name-alist}
 
-
 @seealso
+Music Glossary:
+@rglos{mensural notation},
+@rglos{Pitch names},
+@rglos{accidental},
+@rglos{key signature}.
+
 Notation Reference:
-@ref{Pitches}, @ref{Accidentals}, and @ref{Automatic accidentals}, give a
-general introduction of the use of accidentals.  @ref{Key signature}, gives
-a general introduction of the use of key signatures.
+@ref{Pitches},
+@ref{Accidentals},
+@ref{Automatic accidentals},
+@ref{Key signature}.
 
 Internals Reference:
 @rinternals{KeySignature}.
@@ -808,11 +882,11 @@ fis gis
 ais bis
 @end lilypond
 
-This will treat @emph{every} subsequent accidental as @emph{musica
-ficta} until it is unset with @code{\set suggestAccidentals =
-##f}.  A more practical way is to use @code{\once \set
-suggestAccidentals = ##t}, which can even be defined as a
-convenient shorthand:
+This will treat @emph{every} subsequent accidental as
+@emph{musica ficta} until it is unset with
+@code{\set suggestAccidentals = ##f}.  A more practical way is to
+use @code{\once \set suggestAccidentals = ##t}, which can even be
+defined as a convenient shorthand:
 
 @lilypond[quote,verbatim]
 ficta = { \once \set suggestAccidentals = ##t }
@@ -862,6 +936,13 @@ that the full musical information of the ligature is known internally.
 This is not only required for correct MIDI output, but also allows for
 automatic transcription of the ligatures.
 
+At certain places two consecutive notes can be represented either as
+two squares or as an oblique parallelogram (flexa shape).  In such
+cases the default is the two squares, but a flexa can be required by
+setting the @code{ligature-flexa} property of the @emph{second} note
+head.  The length of a flexa can be set by the note head property
+@code{flexa-width}.
+
 For example,
 
 @c @example
@@ -880,11 +961,14 @@ For example,
   \transpose c c' {
     \set Score.timing = ##f
     \set Score.defaultBarType = "empty"
-    \override NoteHead #'style = #'neomensural
-    \override Staff.TimeSignature #'style = #'neomensural
+    \override NoteHead #'style = #'petrucci
+    \override Staff.TimeSignature #'style = #'mensural
     \clef "petrucci-g"
     \[ c'\maxima g \]
-    \[ d\longa c\breve f e d \]
+    \[ d\longa
+       \override NoteHead #'ligature-flexa = ##t
+       \once \override NoteHead #'flexa-width = #3.2
+       c\breve f e d \]
     \[ c'\maxima d'\longa \]
     \[ e'1 a g\breve \]
   }
@@ -906,25 +990,30 @@ to the following
 \transpose c c' {
   \set Score.timing = ##f
   \set Score.defaultBarType = "empty"
-  \override NoteHead #'style = #'neomensural
-  \override Staff.TimeSignature #'style = #'neomensural
+  \override NoteHead #'style = #'petrucci
+  \override Staff.TimeSignature #'style = #'mensural
   \clef "petrucci-g"
   \[ c'\maxima g \]
-  \[ d\longa c\breve f e d \]
+  \[ d\longa
+     \override NoteHead #'ligature-flexa = ##t
+     \once \override NoteHead #'flexa-width = #3.2
+     c\breve f e d \]
   \[ c'\maxima d'\longa \]
   \[ e'1 a g\breve \]
 }
 @end lilypond
 
+@seealso
+Music Glossary:
+@rglos{ligature}.
 
-@c @seealso
-@c TODO: nothing here yet ...
-
+Notation Reference:
+@ref{Gregorian square neume ligatures},
+@ref{Ligatures}.
 
 @knownissues
-
 Horizontal spacing of ligatures is poor.
-
+Accidentals may collide with previous notes.
 
 @node Typesetting Gregorian chant
 @subsection Typesetting Gregorian chant
@@ -945,9 +1034,15 @@ proper note heads, so there is no need to explicitly set the note
 head style.  Still, the note head style can be set, e.g., to
 @code{vaticana_punctum} to produce punctum neumes.  Similarly, the
 @code{Mensural_ligature_engraver} automatically assembles
-mensural ligatures.  See @ref{Ligatures}, for how ligature
-engravers work.
+mensural ligatures.
 
+@seealso
+Music Glossary:
+@rglos{ligature}.
+
+Notation Reference:
+@ref{White mensural ligatures},
+@ref{Ligatures}.
 
 @node Gregorian chant contexts
 @unnumberedsubsubsec Gregorian chant contexts
@@ -1120,6 +1215,9 @@ hufnagel style combined do/fa clef
 
 
 @seealso
+Music Glossary:
+@rglos{clef}.
+
 Notation Reference:
 @ref{Clef}.
 
@@ -1133,35 +1231,19 @@ Notation Reference:
 Accidentals for the three different Gregorian styles are available:
 
 @lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \textLengthOn
-  s^\markup {
-    \column {
-      "vaticana"
-      \line { " " \musicglyph #"accidentals.vaticana-1"
-        " " \musicglyph #"accidentals.vaticana0" }
-    }
-    \column {
-      "medicaea"
-      \line { " " \musicglyph #"accidentals.medicaea-1" }
-    }
-    \column {
-      "hufnagel"
-      \line { " " \musicglyph #"accidentals.hufnagel-1" }
-    }
+\markup {
+  \column {
+    "vaticana"
+    \line { " " \musicglyph #"accidentals.vaticana-1"
+      " " \musicglyph #"accidentals.vaticana0" }
   }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
+  \column {
+    "medicaea"
+    \line { " " \musicglyph #"accidentals.medicaea-1" }
+  }
+  \column {
+    "hufnagel"
+    \line { " " \musicglyph #"accidentals.hufnagel-1" }
   }
 }
 @end lilypond
@@ -1182,10 +1264,15 @@ The style for accidentals and key signatures is controlled by the
 
 
 @seealso
+Music Glossary:
+@rglos{accidental},
+@rglos{key signature}.
+
 Notation Reference:
-@ref{Pitches}, @ref{Accidentals}, and @ref{Automatic accidentals}, give a
-general introduction of the use of accidentals.  @ref{Key signature}, gives
-a general introduction of the use of key signatures.
+@ref{Pitches},
+@ref{Accidentals},
+@ref{Automatic accidentals},
+@ref{Key signature}.
 
 Internals Reference:
 @rinternals{KeySignature}.
@@ -1203,19 +1290,20 @@ There are no rests in Gregorian chant notation; instead, it uses
 
 A @emph{divisio} (plural: @emph{divisiones}; Latin word for
 @q{division}) is a staff context symbol that is used to indicate
-the phrase and section structure of Gregorian music.  The musical meaning of
-@emph{divisio minima}, @emph{divisio maior}, and @emph{divisio maxima}
-can be characterized as short, medium, and long pause, somewhat like
-the breathmarks from @ref{Breath marks}.  The @emph{finalis} sign not
-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 @file{gregorian@/.ly}.  It
+the phrase and section structure of Gregorian music.  The musical
+meaning of @emph{divisio minima}, @emph{divisio maior}, and
+@emph{divisio maxima} can be characterized as short, medium, and
+long pause, somewhat like the breath marks from @ref{Breath marks}.
+The  @emph{finalis} sign not 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 @file{gregorian.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, @file{gregorian@/.ly} also defines @code{\virgula} and
+Therefore, @file{gregorian.ly} also defines @code{\virgula} and
 @code{\caesura}
 
 @lilypond[quote,ragged-right]
@@ -1265,6 +1353,17 @@ Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
 @code{\finalis}.
 @endpredefined
 
+@seealso
+Music Glossary:
+@rglos{caesura},
+@rglos{divisio}.
+
+Notation Reference:
+@ref{Breath marks}.
+
+Installed Files:
+@file{gregorian.ly}.
+
 
 @node Gregorian articulation signs
 @unnumberedsubsubsec Gregorian articulation signs
@@ -1273,8 +1372,8 @@ Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
 
 In addition to the standard articulation signs described in
 section @ref{Articulations and ornamentations}, articulation signs
-specifically designed for use with notation in @emph{Editio
-Vaticana} style are provided.
+specifically designed for use with notation in
+@emph{Editio Vaticana} style are provided.
 
 @lilypond[quote,ragged-right,verbatim]
 \include "gregorian.ly"
@@ -1293,6 +1392,10 @@ Vaticana} style are provided.
 @end lilypond
 
 
+@seealso
+Notation Reference:
+@ref{Articulations and ornamentations}.
+
 Snippets:
 @rlsr{Ancient notation}.
 
@@ -1306,7 +1409,6 @@ Internals Reference:
 
 
 @knownissues
-
 Some articulations are vertically placed too closely to the
 corresponding note heads.
 
@@ -1358,7 +1460,7 @@ still lacking, such as (among others) horizontal alignment of multiple
 ligatures, lyrics alignment, and proper handling of accidentals.
 
 The support for Gregorian neumes is enabled by @code{\include}ing
-"gregorian.ly" at the beginning of the file.  This makes available
+@file{gregorian.ly} at the beginning of the file.  This makes available
 a number of extra commands to produce the neume symbols used in
 plainchant notation.
 
@@ -1449,7 +1551,7 @@ Another main category of notes in Gregorian chant is the so-called
 liquescent neumes.  They are used under certain circumstances at
 the end of a syllable which ends in a @q{liquescent} letter, i.e.
 the sounding consonants that can hold a tone (the nasals, l, r, v,
-j, and their diphtong equivalents).  Thus, the liquescent neumes
+j, and their diphthong equivalents).  Thus, the liquescent neumes
 are never used alone (although some of them can be produced), and
 they always fall at the end of a ligature.
 
@@ -1457,11 +1559,11 @@ Liquescent neumes are represented graphically in two different,
 more or less interchangeable ways: with a smaller note or by
 @q{twisting} the main note upwards or downwards.  The first is
 produced by making a regular @code{pes} or @code{flexa} and
-modifying the shape of the second note: @code{\[ a \pes \deminutum
-b \] }, the second by modifying the shape of a single-note neume
-with @code{\auctum} and one of the direction markers
-@code{\descendens} or @code{\ascendens}, e.g., @code{ \[ \auctum
-\descendens a \] }.
+modifying the shape of the second note:
+@code{\[ a \pes \deminutum b \] }, the second by modifying the shape
+of a single-note neume with @code{\auctum} and one of the direction
+markers @code{\descendens} or @code{\ascendens}, e.g.,
+@code{ \[ \auctum \descendens a \] }.
 
 @noindent
 Special signs
@@ -1488,11 +1590,11 @@ ligature, and usually falls on a half-tone step, but it is
 perfectly possible, although incorrect, to make a single-note
 quilisma.
 
-In addition to the note signs, gregorian.ly also defines the
+In addition to the note signs, @file{gregorian.ly} also defines the
 commands @code{\versus}, @code{\responsum}, @code{\ij},
 @code{\iij}, @code{\IJ}, and @code{\IIJ}, that will produce the
 corresponding characters, e.g., for use in lyrics, as section
-markers, etc.  These commands use special unicode characters and
+markers, etc.  These commands use special Unicode characters and
 will only work if a font is used which supports them.
 
 
@@ -1501,9 +1603,9 @@ will only work if a font is used which supports them.
 The following table shows a limited, but still representative pool
 of Gregorian ligatures, together with the code fragments that
 produce the ligatures.  The table is based on the extended neumes
-table of the 2nd volume of the Antiphonale Romanum (@emph{Liber
-Hymnarius}), published 1983 by the monks of Solesmes.  The first
-column gives the name of the ligature, with the main form in
+table of the 2nd volume of the Antiphonale Romanum
+(@emph{Liber Hymnarius}), published 1983 by the monks of Solesmes.
+The first column gives the name of the ligature, with the main form in
 boldface and the liquescent forms in italics.  The third column
 shows the code fragment that produces this ligature, using
 @code{g}, @code{a}, and @code{b} as example pitches.
@@ -2277,20 +2379,26 @@ to a head, but not both to the same head.
 
 @funindex \pes
 @funindex \flexa
+
 Two adjacent heads can be tied together with the @code{\pes} and
 @code{\flexa} infix commands for a rising and falling line of melody,
 respectively.
 
 @funindex \augmentum
+
 Use the unary music function @code{\augmentum} to add augmentum dots.
 
+@seealso
+Music Glossary:
+@rglos{ligature}.
 
-@c @seealso
-@c TODO: nothing here yet ...
+Notation Reference:
+@ref{Gregorian square neume ligatures},
+@ref{White mensural ligatures},
+@ref{Ligatures}.
 
 
 @knownissues
-
 When an @code{\augmentum} dot appears at the end of the last staff
 within a ligature, it is sometimes vertically placed wrong.  As a
 workaround, add an additional skip note (e.g., @code{s8}) as last note
@@ -2406,7 +2514,7 @@ In many cases, @code{\set Score.timing = ##f} will give good
 results.  Another alternative is to use @code{\CadenzaOn} and
 @code{\CadenzaOff}.
 
-To remove the barlines, the radical approach is to @code{\remove}
+To remove the bar lines, the radical approach is to @code{\remove}
 the Bar_engraver from the Staff context.  Again, one may want to
 use @code{\override BarLine #'transparent = ##t} instead, if an
 occasional barline is wanted.
@@ -2492,14 +2600,14 @@ syllable groups clearly apart, usually also the subdivisions of a
 longer melisma.  One way to achieve this is to use a fixed
 @code{\time}, e.g., 1/4, and let each syllable or note group fill
 one of these measures, with the help of tuplets or shorter
-durations.  If the barlines and all other rhythmical indications
-are made transparent, and the space around the barlines is
+durations.  If the bar lines and all other rhythmical indications
+are made transparent, and the space around the bar lines is
 increased, this will give a fairly good representation in modern
 notation of the original.
 
 To avoid that syllables of different width (such as @qq{-ri} and
 @qq{-rum}) spread the syllable note groups unevenly apart, the
-@code{#'X-extent} property of the @code{LyricText} object may be
+@code{'X-extent} property of the @code{LyricText} object may be
 set to a fixed value.  Another, more cumbersome way would be to
 add the syllables as @code{\markup} elements.  If further
 adjustments are necessary, this can be easily done with
@@ -2564,10 +2672,10 @@ TBC
 
 @c TODO Add text
 @c try Till Rettig
-@c Add example of white noteheads:
-@c In the french baroque some composers used white noteheads in slow pieces,
+@c Add example of white note heads:
+@c In the french baroque some composers used white note heads in slow pieces,
 @c mainly in 3/2-time.  A quarter looks there like a eighth with a white
-@c notehead.  (Franz-Rudolf Kuhnen)
+@c note head.  (Franz-Rudolf Kuhnen)
 
 @c TODO Add example of this:
 @c I was referring to e.g. notated a8. a16, which should, if I
@@ -2576,7 +2684,7 @@ TBC
 @c staff as an hint to performers.  (Karl Hammer)
 
 
-TBC
+@c TBC
 
 
 @c @seealso