]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/ancient.itely
Rerun scripts/auxiliar/update-with-convert-ly.sh
[lilypond.git] / Documentation / notation / ancient.itely
index b9ff936dfee01cc7f609fae57a4377c5c1c0898b..0d948c77610f02f2f4b16e87ebcc04c507668428 100644 (file)
@@ -8,7 +8,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.14.0"
+@c \version "2.17.6"
 
 
 @node Ancient notation
 * Ancient notation---common features::
 * Typesetting mensural music::
 * Typesetting Gregorian chant::
+* Typesetting Kievan square notation::
 * Working with ancient music---scenarios and solutions::
 @end menu
 
 
 Support for ancient notation includes features for mensural
-notation and Gregorian chant notation.  These features can be
-accessed either by modifying style properties of graphical objects
-such as note heads and rests, or by using one of the pre-defined
-contexts for mensural or Gregorian notation.
+notation, Gregorian chant notation, and Kievan square notation.
+These features can be accessed either by modifying style
+properties of graphical objects such as note heads and rests,
+or by using one of the pre-defined contexts for these styles.
 
 Many graphical objects, such as note heads and flags, accidentals,
 time signatures, and rests, provide a @code{style} property, which
@@ -83,7 +84,6 @@ Notation Reference:
 @node Overview of the supported styles
 @subsection Overview of the supported styles
 
-
 Three styles are available for typesetting Gregorian chant:
 
 @itemize
@@ -303,8 +303,8 @@ desired, as shown in the following example:
   \layout {
     \context {
       \Staff
-      \consists Custos_engraver
-      \override Custos #'style = #'mensural
+      \consists "Custos_engraver"
+      \override Custos.style = #'mensural
     }
   }
 }
@@ -339,12 +339,12 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
 Music Glossary:
 @rglos{custos}.
 
-Internals Reference:
-@rinternals{Custos}.
-
 Snippets:
 @rlsr{Ancient notation}.
 
+Internals Reference:
+@rinternals{Custos}.
+
 
 @node Figured bass support
 @unnumberedsubsubsec Figured bass support
@@ -392,7 +392,7 @@ entering the chant, as the following excerpt demonstrates:
 \score {
   <<
     \new MensuralVoice = "discantus" \transpose c c' {
-      \override Score.BarNumber #'transparent = ##t {
+      \override Score.BarNumber.transparent = ##t {
         c'1\melisma bes a g\melismaEnd
         f\breve
         \[ f1\melisma a c'\breve d'\melismaEnd \]
@@ -408,7 +408,6 @@ entering the chant, as the following excerpt demonstrates:
 }
 @end lilypond
 
-
 @seealso
 Music Glossary:
 @rglos{mensural notation}.
@@ -446,9 +445,9 @@ mensural C clef
 @code{mensural-c1}, @code{mensural-c2},@*
 @code{mensural-c3}, @code{mensural-c4}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-c2"
-  \override NoteHead #'style = #'mensural
+  \override NoteHead.style = #'mensural
   c
 @end lilypond
 
@@ -457,9 +456,9 @@ mensural F clef
 @tab
 @code{mensural-f}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-f"
-  \override NoteHead #'style = #'mensural
+  \override NoteHead.style = #'mensural
   c
 @end lilypond
 
@@ -468,9 +467,9 @@ mensural G clef
 @tab
 @code{mensural-g}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-g"
-  \override NoteHead #'style = #'mensural
+  \override NoteHead.style = #'mensural
   c
 @end lilypond
 
@@ -480,7 +479,7 @@ neomensural C clef
 @code{neomensural-c1}, @code{neomensural-c2},@*
 @code{neomensural-c3}, @code{neomensural-c4}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "neomensural-c2" c
 @end lilypond
 
@@ -492,9 +491,9 @@ petrucci style C clefs, for use on different staff lines
 @code{petrucci-c3}, @code{petrucci-c4},@*
 @code{petrucci-c5}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "petrucci-c2"
-  \override NoteHead #'style = #'mensural
+  \override NoteHead.style = #'mensural
   c
 @end lilypond
 
@@ -505,9 +504,9 @@ petrucci style F clefs, for use on different staff lines
 @code{petrucci-f3}, @code{petrucci-f4},@*
 @code{petrucci-f5}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "petrucci-f3"
-  \override NoteHead #'style = #'mensural
+  \override NoteHead.style = #'mensural
   c
 @end lilypond
 
@@ -516,9 +515,9 @@ petrucci style G clef
 @tab
 @code{petrucci-g}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "petrucci-g"
-  \override NoteHead #'style = #'mensural
+  \override NoteHead.style = #'mensural
   c
 @end lilypond
 @end multitable
@@ -531,7 +530,6 @@ Music Glossary:
 Notation Reference:
 @ref{Clef}.
 
-
 @knownissues
 The mensural g clef is mapped to the Petrucci g clef.
 
@@ -552,9 +550,9 @@ to particular time fractions.  In other words, to get a particular mensuration s
   indent = 0.0
   \context {
     \Staff
-    \remove Staff_symbol_engraver
-    \remove Clef_engraver
-    \remove Time_signature_engraver
+    \remove "Staff_symbol_engraver"
+    \remove "Clef_engraver"
+    \remove "Time_signature_engraver"
   }
 }
 {
@@ -598,25 +596,25 @@ to select ancient time signatures.  Supported styles are
 @code{neomensural} style.  The following examples show the
 differences in style:
 
-@lilypond[ragged-right,fragment,relative=1,quote]
+@lilypond[ragged-right,relative=1,quote]
 {
   \textLengthOn
 
   \time 2/2
   c1^\markup { \hspace #-2.0 \typewriter default }
 
-  \override Staff.TimeSignature #'style = #'numbered
+  \override Staff.TimeSignature.style = #'numbered
   \time 2/2
   c1^\markup { \hspace #-2.0 \typewriter numbered }
 
-  \override Staff.TimeSignature #'style = #'mensural
+  \override Staff.TimeSignature.style = #'mensural
   \time 2/2
   c1^\markup { \hspace #-2.0 \typewriter mensural }
 
-  \override Staff.TimeSignature #'style = #'neomensural
+  \override Staff.TimeSignature.style = #'neomensural
   \time 2/2
   c1^\markup { \hspace #-2.0 \typewriter neomensural }
-  \override Staff.TimeSignature #'style = #'single-digit
+  \override Staff.TimeSignature.style = #'single-digit
   \time 2/2
   c1^\markup { \hspace #-2.0 \typewriter single-digit }
 }
@@ -699,13 +697,13 @@ The following example demonstrates the @code{petrucci} style:
 @lilypond[quote,fragment,ragged-right,verbatim]
 \set Score.skipBars = ##t
 \autoBeamOff
-\override NoteHead #'style = #'petrucci
+\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
+\override NoteHead.style = #'semipetrucci
 a'\breve*5/6
-\override NoteHead #'style = #'blackpetrucci
+\override NoteHead.style = #'blackpetrucci
 a'8*4/3 a'
-\override NoteHead #'style = #'petrucci
+\override NoteHead.style = #'petrucci
 a'\longa
 @end lilypond
 
@@ -732,9 +730,9 @@ select ancient flags.  Besides the @code{default} flag style,
 only the @code{mensural} style is supported.
 
 @lilypond[quote,fragment,ragged-right,verbatim]
-\override Flag #'style = #'mensural
-\override Stem #'thickness = #1.0
-\override NoteHead #'style = #'mensural
+\override Flag.style = #'mensural
+\override Stem.thickness = #1.0
+\override NoteHead.style = #'mensural
 \autoBeamOff
 c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
 c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
@@ -749,13 +747,11 @@ There is no particular flag style for neo-mensural or Petrucci notation.
 @c music, the default flag style should be used.
 There are no flags in Gregorian chant notation.
 
-
 @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.
@@ -785,11 +781,11 @@ The following example demonstrates the @code{mensural} and
 
 @lilypond[quote,fragment,ragged-right,verbatim]
 \set Score.skipBars = ##t
-\override Rest #'style = #'classical
+\override Rest.style = #'classical
 r\longa^"classical" r\breve r1 r2 r4 r8 r16 s \break
-\override Rest #'style = #'mensural
+\override Rest.style = #'mensural
 r\longa^"mensural" r\breve r1 r2 r4 r8 r16 s \break
-\override Rest #'style = #'neomensural
+\override Rest.style = #'neomensural
 r\longa^"neomensural" r\breve r1 r2 r4 r8 r16
 @end lilypond
 
@@ -807,7 +803,6 @@ Notation Reference:
 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.
@@ -839,8 +834,10 @@ The style for accidentals and key signatures is controlled by the
 @code{glyph-name-alist} property of the grobs @code{Accidental} and
 @code{KeySignature}, respectively; e.g.:
 
-@code{\override Staff.Accidental #'glyph-name-alist =
-#alteration-mensural-glyph-name-alist}
+@example
+\override Staff.Accidental.glyph-name-alist =
+  #alteration-mensural-glyph-name-alist
+@end example
 
 @seealso
 Music Glossary:
@@ -876,7 +873,7 @@ switched on by setting @code{suggestAccidentals} to true.
 
 @funindex suggestAccidentals
 
-@lilypond[verbatim,fragment,relative=1]
+@lilypond[verbatim,relative=1]
 fis gis
 \set suggestAccidentals = ##t
 ais bis
@@ -898,7 +895,6 @@ ficta = { \once \set suggestAccidentals = ##t }
 }
 @end lilypond
 
-
 @seealso
 Internals Reference:
 @rinternals{Accidental_engraver},
@@ -922,8 +918,8 @@ context:
 \layout @{
   \context @{
     \Voice
-    \remove Ligature_bracket_engraver
-    \consists Mensural_ligature_engraver
+    \remove "Ligature_bracket_engraver"
+    \consists "Mensural_ligature_engraver"
   @}
 @}
 @end example
@@ -947,9 +943,9 @@ For example,
 
 @c @example
 @c \set Score.timing = ##f
-@c \set Score.defaultBarType = "empty"
-@c \override NoteHead #'style = #'neomensural
-@c \override Staff.TimeSignature #'style = #'neomensural
+@c \set Score.defaultBarType = "-"
+@c \override NoteHead.style = #'neomensural
+@c \override Staff.TimeSignature.style = #'neomensural
 @c \clef "petrucci-g"
 @c \[ c'\maxima g \]
 @c \[ d\longa c\breve f e d \]
@@ -960,14 +956,14 @@ For example,
 \score {
   \transpose c c' {
     \set Score.timing = ##f
-    \set Score.defaultBarType = "empty"
-    \override NoteHead #'style = #'petrucci
-    \override Staff.TimeSignature #'style = #'mensural
+    \set Score.defaultBarType = "-"
+    \override NoteHead.style = #'petrucci
+    \override Staff.TimeSignature.style = #'mensural
     \clef "petrucci-g"
     \[ c'\maxima g \]
     \[ d\longa
-       \override NoteHead #'ligature-flexa = ##t
-       \once \override NoteHead #'flexa-width = #3.2
+       \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 \]
@@ -975,8 +971,8 @@ For example,
   \layout {
     \context {
       \Voice
-      \remove Ligature_bracket_engraver
-      \consists Mensural_ligature_engraver
+      \remove "Ligature_bracket_engraver"
+      \consists "Mensural_ligature_engraver"
     }
   }
 }
@@ -989,14 +985,14 @@ to the following
 @lilypond[quote,ragged-right]
 \transpose c c' {
   \set Score.timing = ##f
-  \set Score.defaultBarType = "empty"
-  \override NoteHead #'style = #'petrucci
-  \override Staff.TimeSignature #'style = #'mensural
+  \set Score.defaultBarType = "-"
+  \override NoteHead.style = #'petrucci
+  \override Staff.TimeSignature.style = #'mensural
   \clef "petrucci-g"
   \[ c'\maxima g \]
   \[ d\longa
-     \override NoteHead #'ligature-flexa = ##t
-     \once \override NoteHead #'flexa-width = #3.2
+     \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 \]
@@ -1015,6 +1011,7 @@ Notation Reference:
 Horizontal spacing of ligatures is poor.
 Accidentals may collide with previous notes.
 
+
 @node Typesetting Gregorian chant
 @subsection Typesetting Gregorian chant
 
@@ -1044,6 +1041,7 @@ Notation Reference:
 @ref{White mensural ligatures},
 @ref{Ligatures}.
 
+
 @node Gregorian chant contexts
 @unnumberedsubsubsec Gregorian chant contexts
 
@@ -1111,13 +1109,13 @@ Editio Vaticana style do clef
 @code{vaticana-do1}, @code{vaticana-do2},@*
 @code{vaticana-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.line-count = #4
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'vaticana.punctum
   \clef "vaticana-do2"
   c
 @end lilypond
@@ -1127,13 +1125,13 @@ Editio Vaticana style fa clef
 @tab
 @code{vaticana-fa1}, @code{vaticana-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.line-count = #4
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'vaticana.punctum
   \clef "vaticana-fa2"
   c
 @end lilypond
@@ -1144,13 +1142,13 @@ Editio Medicaea style do clef
 @code{medicaea-do1}, @code{medicaea-do2},@*
 @code{medicaea-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.line-count = #4
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'medicaea.punctum
   \clef "medicaea-do2"
   c
 @end lilypond
@@ -1160,13 +1158,13 @@ Editio Medicaea style fa clef
 @tab
 @code{medicaea-fa1}, @code{medicaea-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.line-count = #4
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'medicaea.punctum
   \clef "medicaea-fa2"
   c
 @end lilypond
@@ -1177,13 +1175,13 @@ hufnagel style do clef
 @code{hufnagel-do1}, @code{hufnagel-do2},@*
 @code{hufnagel-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.line-count = #4
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'hufnagel.punctum
   \clef "hufnagel-do2"
   c
 @end lilypond
@@ -1193,13 +1191,13 @@ hufnagel style fa clef
 @tab
 @code{hufnagel-fa1}, @code{hufnagel-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.line-count = #4
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'hufnagel.punctum
   \clef "hufnagel-fa2"
   c
 @end lilypond
@@ -1209,18 +1207,17 @@ hufnagel style combined do/fa clef
 @tab
 @code{hufnagel-do-fa}
 @tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override Voice.Flag #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
+@lilypond[relative=1,notime]
+  \override Staff.StaffSymbol.color = #red
+  \override Staff.LedgerLineSpanner.color = #red
+  \override Voice.Stem.transparent = ##t
+  \override Voice.Flag.transparent = ##t
+  \override NoteHead.style = #'hufnagel.punctum
   \clef "hufnagel-do-fa"
   c
 @end lilypond
 @end multitable
 
-
 @seealso
 Music Glossary:
 @rglos{clef}.
@@ -1266,9 +1263,10 @@ The style for accidentals and key signatures is controlled by the
 @code{glyph-name-alist} property of the grobs @code{Accidental} and
 @code{KeySignature}, respectively; e.g.:
 
-@code{\override Staff.Accidental #'glyph-name-alist =
-#alteration-mensural-glyph-name-alist}
-
+@example
+\override Staff.Accidental.glyph-name-alist =
+  #alteration-mensural-glyph-name-alist
+@end example
 
 @seealso
 Music Glossary:
@@ -1318,7 +1316,7 @@ Therefore, @file{gregorian.ly} also defines @code{\virgula} and
 \score {
   <<
     \context VaticanaVoice {
-      \override TextScript  #'padding = #3
+      \override TextScript.padding = #3
       g a g
       s^\markup { "divisio minima" }
       \divisioMinima
@@ -1369,7 +1367,7 @@ Notation Reference:
 @ref{Breath marks}.
 
 Installed Files:
-@file{gregorian.ly}.
+@file{ly/gregorian.ly}.
 
 
 @node Gregorian articulation signs
@@ -1386,9 +1384,9 @@ specifically designed for use with notation in
 \include "gregorian.ly"
 \score {
   \new VaticanaVoice {
-    \override TextScript #'font-family = #'typewriter
-    \override TextScript #'font-shape = #'upright
-    \override Script #'padding = #-0.1
+    \override TextScript.font-family = #'typewriter
+    \override TextScript.font-shape = #'upright
+    \override Script.padding = #-0.1
     a\ictus_"ictus " \bar "" \break
     a\circulus_"circulus " \bar "" \break
     a\semicirculus_"semicirculus " \bar "" \break
@@ -1398,7 +1396,6 @@ specifically designed for use with notation in
 }
 @end lilypond
 
-
 @seealso
 Notation Reference:
 @ref{Articulations and ornamentations}.
@@ -1414,7 +1411,6 @@ Internals Reference:
 @rinternals{ScriptEvent},
 @rinternals{Script_engraver}.
 
-
 @knownissues
 Some articulations are vertically placed too closely to the
 corresponding note heads.
@@ -1442,7 +1438,6 @@ note that you can say @code{\augmentum @{a g@}} as a shortcut for
 }
 @end lilypond
 
-
 @seealso
 Notation Reference:
 @ref{Breath marks}.
@@ -2404,7 +2399,6 @@ Notation Reference:
 @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
@@ -2415,6 +2409,162 @@ of the staff.
 unary music function, such that @code{\augmentum} can be intermixed
 with head prefixes in arbitrary order.
 
+@node Typesetting Kievan square notation
+@subsection Typesetting Kievan square notation
+
+@menu
+* Kievan contexts::
+* Kievan clefs::
+* Kievan note heads::
+* Kievan accidentals::
+* Kievan bar line::
+@end menu
+
+@node Kievan contexts
+@unnumberedsubsubsec Kievan contexts
+
+@cindex KievanVoiceContext
+@cindex KievanStaffContext
+
+As with Mensural and Gregorian notation, the predefined
+@code{KievanVoice} and @code{KievanStaff} contexts can be used
+to engrave a piece in square notation.  These contexts initialize
+all relevant context properties and grob properties to proper
+values, so you can immediately go ahead entering the chant:
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  <<
+    \new KievanVoice = "melody" \transpose c c' {
+      \cadenzaOn
+       c4 c c c c2 b,\longa
+       \bar "k"
+    }
+    \new Lyrics \lyricsto "melody" {
+      Го -- спо -- ди по -- ми -- луй.
+    }
+  >>
+}
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation}.
+
+@knownissues
+LilyPond supports Kievan notation of the Synodal style, as used in
+the corpus of chantbooks printed by the Russian Holy Synod in the
+1910's and recently reprinted by the Moscow Patriarchate Publishing
+House.  LilyPond does not support the older (less common) forms of
+Kievan notation that were used in Galicia to notate Rusyn plainchant.
+
+@node Kievan clefs
+@unnumberedsubsubsec Kievan clefs
+
+@cindex clefs
+
+There is only one clef used in Kievan notation (the Tse-fa-ut Clef).
+It is used to indicate the position of @code{c}:
+
+@lilypond[quote,relative=1,notime,verbatim]
+  \clef "kievan-do"
+  \override NoteHead.style = #'kievan
+  c
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation},
+@rglos{clef}.
+
+Notation Reference:
+@ref{Clef}.
+
+@node Kievan note heads
+@unnumberedsubsubsec Kievan note heads
+
+@cindex note heads, ancient
+
+For Kievan square notation, the appropriate note head style needs
+to be chosen.  This is accomplished by setting the @code{style}
+property of the @code{NoteHead} object to @code{kievan}.
+
+The Kievan final note, which usually comes at the end of a piece
+of music, may be selected by setting the duration to
+@code{\longa}.  The Kievan recitative mark, used to indicate
+the chanting of several syllables on one note, may be selected by
+setting the duration to @code{\breve}.  The following example
+demonstrates the various Kievan note heads:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\autoBeamOff
+\cadenzaOn
+\override NoteHead.style = #'kievan
+b'1 b'2 b'4 b'8 b'\breve b'\longa
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation},
+@rglos{note head}.
+
+Notation Reference:
+@ref{Note head styles}.
+
+@knownissues
+LilyPond automatically determines if the stem up or stem down
+form of a note is drawn.  When setting chant in square notation,
+however, it is customary to have the stems point in the same
+direction within a single melisma.  This can be done manually by
+setting the @code{direction} property of the @code{Stem} object.
+
+@node Kievan accidentals
+@unnumberedsubsubsec Kievan accidentals
+
+@cindex accidentals
+
+The @code{kievan} style for accidentals is selected with the
+@code{glyph-name-alist} property of the grob @code{Accidental}.
+The @code{kievan} style provides a sharp and a flat sign
+different from the default style.  There is no natural sign
+in Kievan notation.  The sharp sign is not used in Synodal music
+but may occur in earlier manuscripts.  It has been included
+primarily for the sake of compatibility.
+
+@lilypond[quote,relative=1,notime,verbatim]
+\clef "kievan-do"
+\override NoteHead.style = #'kievan
+\override Accidental.glyph-name-alist =
+ #alteration-kievan-glyph-name-alist
+bes' dis,
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation},
+@rglos{accidental}.
+
+Notation Reference:
+@ref{Accidentals},
+@ref{Automatic accidentals},
+@ref{The Feta font}
+
+@node Kievan bar line
+@unnumberedsubsubsec Kievan bar line
+
+A decorative figure is commonly placed at the end of a piece of
+Kievan notation, which may be called the Kievan final bar line.
+It can be invoked as @code{\bar "k"}.
+
+@lilypond[quote,relative=1,notime,verbatim]
+  \clef "kievan-do"
+  \override NoteHead.style = #'kievan
+  c \bar "k"
+@end lilypond
+
+@seealso
+@ref{Bars},
+@ref{The Feta font}
 
 @node Working with ancient music---scenarios and solutions
 @subsection Working with ancient music---scenarios and solutions
@@ -2453,7 +2603,6 @@ same source.
 @c use snippet Transcription-of-ancient-music-with-incipit
 TBC
 
-
 @c @seealso
 @c ... and reference to other sections ...
 
@@ -2478,7 +2627,6 @@ orientation aids that bar lines give.
 @c from lsr and -user
 @c TBC
 
-
 @c @seealso
 @c ... and reference to other sections ...
 
@@ -2505,11 +2653,10 @@ the @code{Stem_engraver} from the Voice context:
 However, in some transcription styles, stems are used
 occasionally, for example to indicate the transition from a
 single-tone recitative to a fixed melodic gesture.  In these cases,
-one can use either @code{\override Stem #'transparent = ##t} or
-@code{\override Stem #'length = #0} instead, and restore the stem
-when needed with the corresponding @code{\once \override Stem
-#'transparent = ##f} (see example below).  When using stems that
-carry flags, make sure to set @code{\override Flag #'transparent
+one can use either @code{\override Stem.transparent = ##t} or
+@code{\override Stem.length = #0} instead, and restore the stem
+when needed with the corresponding @code{\once \override Stem.transparent = ##f} (see example below).  When using stems that
+carry flags, make sure to set @code{\override Flag.transparent
 = ##t} as well.
 
 @b{Timing.} For unmetered chant, there are several alternatives.
@@ -2525,7 +2672,7 @@ results.  Another alternative is to use @code{\CadenzaOn} and
 
 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
+use @code{\override BarLine.transparent = ##t} instead, if an
 occasional barline is wanted.
 
 A common type of transcription is recitativic chant where the
@@ -2542,9 +2689,9 @@ chant = \relative c' {
 }
 
 verba = \lyricmode {
-  \once \override LyricText #'self-alignment-X = #-1
+  \once \override LyricText.self-alignment-X = #-1
   "Noctem quietam et" fi -- nem per -- fec -- tum
-  \once \override LyricText #'self-alignment-X = #-1
+  \once \override LyricText.self-alignment-X = #-1
   "concedat nobis Dominus" om -- ni -- po -- tens.
 }
 \score {
@@ -2557,7 +2704,8 @@ verba = \lyricmode {
       \Staff
       \remove "Time_signature_engraver"
       \remove "Bar_engraver"
-      \override Stem #'transparent = ##t
+      \override Stem.transparent = ##t
+      \override Flag.transparent = ##t
     }
   }
 }
@@ -2573,12 +2721,13 @@ score, here in combination with changing stem visibility:
 chant = \relative c' {
   \clef "G_8"
   \set Score.timing = ##f
-  c\breve \override NoteHead #'transparent = ##t  c c c c c
-  \revert NoteHead #'transparent
-  \override Stem #'transparent = ##f \stemUp c4 b4 a
-  \override Stem #'transparent = ##t c2 c4  \divisioMaior
-  c\breve \override NoteHead #'transparent = ##t c c c c c c c
-  \revert NoteHead #'transparent c4 c f, f \finalis
+  c\breve \override NoteHead.transparent = ##t  c c c c c
+  \revert NoteHead.transparent
+  \override Stem.transparent = ##f \stemUp c4 b4 a
+  \override Stem.transparent = ##t
+  \override Flag.transparent = ##t c2 c4  \divisioMaior
+  c\breve \override NoteHead.transparent = ##t c c c c c c c
+  \revert NoteHead.transparent c4 c f, f \finalis
 }
 
 verba = \lyricmode {
@@ -2595,8 +2744,9 @@ verba = \lyricmode {
     \context {
       \Staff
       \remove "Time_signature_engraver"
-      \override BarLine #'transparent = ##t
-      \override Stem #'transparent = ##t
+      \override BarLine.transparent = ##t
+      \override Stem.transparent = ##t
+      \override Flag.transparent = ##t
     }
   }
 }
@@ -2625,7 +2775,7 @@ adjustments are necessary, this can be easily done with
 @lilypond[verbatim,quote]
 spiritus = \relative c' {
   \time 1/4
-  \override Lyrics.LyricText #'X-extent  = #'(0 . 3)
+  \override Lyrics.LyricText.X-extent  = #'(0 . 3)
   d4 \times 2/3 { f8 a g } g a a4 g f8 e
   d4 f8 g g8 d f g a g f4 g8 a a4  s
   \times 2/3 { g8 f d } e f g a g4
@@ -2645,12 +2795,12 @@ spirLyr = \lyricmode {
     \context {
       \Staff
       \remove "Time_signature_engraver"
-      \override BarLine #'X-extent = #'(-1 . 1)
-      \override Stem #'transparent = ##t
-      \override Flag #'transparent = ##t
-      \override Beam #'transparent = ##t
-      \override BarLine #'transparent = ##t
-      \override TupletNumber #'transparent = ##t
+      \override BarLine.X-extent = #'(-1 . 1)
+      \override Stem.transparent = ##t
+      \override Flag.transparent = ##t
+      \override Beam.transparent = ##t
+      \override BarLine.transparent = ##t
+      \override TupletNumber.transparent = ##t
     }
   }
 }
@@ -2699,4 +2849,3 @@ TBC
 
 @c @seealso
 @c ... and reference to other sections ...
-