X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fancient.itely;h=b673c586254644d6d5c0d3a4b24d14de491e7ce7;hb=32a34dcef0c0041c6d62677487a380b5c8b85712;hp=bb7404d32708129a787f556ff9a2951478b79e95;hpb=f41973ff763d5972a85995b6d40c864281ec6714;p=lilypond.git

diff --git a/Documentation/notation/ancient.itely b/Documentation/notation/ancient.itely
index bb7404d327..b673c58625 100644
--- a/Documentation/notation/ancient.itely
+++ b/Documentation/notation/ancient.itely
@@ -8,7 +8,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.14.0"
+@c \version "2.16.0"
 
 
 @node Ancient notation
@@ -28,15 +28,16 @@
 * 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
@@ -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
@@ -408,7 +408,6 @@ entering the chant, as the following excerpt demonstrates:
 }
 @end lilypond
 
-
 @seealso
 Music Glossary:
 @rglos{mensural notation}.
@@ -446,7 +445,7 @@ 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
   c
@@ -457,7 +456,7 @@ mensural F clef
 @tab
 @code{mensural-f}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-f"
   \override NoteHead #'style = #'mensural
   c
@@ -468,7 +467,7 @@ mensural G clef
 @tab
 @code{mensural-g}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-g"
   \override NoteHead #'style = #'mensural
   c
@@ -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,7 +491,7 @@ 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
   c
@@ -505,7 +504,7 @@ 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
   c
@@ -516,7 +515,7 @@ 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
   c
@@ -531,7 +530,6 @@ Music Glossary:
 Notation Reference:
 @ref{Clef}.
 
-
 @knownissues
 The mensural g clef is mapped to the Petrucci g clef.
 
@@ -598,7 +596,7 @@ 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
 
@@ -732,7 +730,7 @@ select ancient flags.  Besides the @code{default} flag style,
 only the @code{mensural} style is supported.
 
 @lilypond[quote,fragment,ragged-right,verbatim]
-\override Stem #'flag-style = #'mensural
+\override Flag #'style = #'mensural
 \override Stem #'thickness = #1.0
 \override NoteHead #'style = #'mensural
 \autoBeamOff
@@ -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.
@@ -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},
@@ -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,11 +1109,12 @@ Editio Vaticana style do clef
 @code{vaticana-do1}, @code{vaticana-do2},@*
 @code{vaticana-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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
@@ -1126,11 +1125,12 @@ Editio Vaticana style fa clef
 @tab
 @code{vaticana-fa1}, @code{vaticana-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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
@@ -1142,11 +1142,12 @@ Editio Medicaea style do clef
 @code{medicaea-do1}, @code{medicaea-do2},@*
 @code{medicaea-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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
@@ -1157,11 +1158,12 @@ Editio Medicaea style fa clef
 @tab
 @code{medicaea-fa1}, @code{medicaea-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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
@@ -1173,11 +1175,12 @@ hufnagel style do clef
 @code{hufnagel-do1}, @code{hufnagel-do2},@*
 @code{hufnagel-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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
@@ -1188,11 +1191,12 @@ hufnagel style fa clef
 @tab
 @code{hufnagel-fa1}, @code{hufnagel-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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
@@ -1203,17 +1207,17 @@ hufnagel style combined do/fa clef
 @tab
 @code{hufnagel-do-fa}
 @tab
-@lilypond[fragment,relative=1,notime]
+@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}.
@@ -1252,16 +1256,17 @@ As shown, not all accidentals are supported by each style.  When
 trying to access an unsupported accidental, LilyPond will switch to a
 different style.
 
-@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@c @lilypondfile[verbatim,quote,texidoc,doctitle]
 @c {ancient-accidentals.ly}
 
 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:
@@ -1362,7 +1367,7 @@ Notation Reference:
 @ref{Breath marks}.
 
 Installed Files:
-@file{gregorian.ly}.
+@file{ly/gregorian.ly}.
 
 
 @node Gregorian articulation signs
@@ -1391,7 +1396,6 @@ specifically designed for use with notation in
 }
 @end lilypond
 
-
 @seealso
 Notation Reference:
 @ref{Articulations and ornamentations}.
@@ -1407,7 +1411,6 @@ Internals Reference:
 @rinternals{ScriptEvent},
 @rinternals{Script_engraver}.
 
-
 @knownissues
 Some articulations are vertically placed too closely to the
 corresponding note heads.
@@ -1435,7 +1438,6 @@ note that you can say @code{\augmentum @{a g@}} as a shortcut for
 }
 @end lilypond
 
-
 @seealso
 Notation Reference:
 @ref{Breath marks}.
@@ -2397,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
@@ -2408,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 "kievan"
+    }
+    \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 "kievan"}.
+
+@lilypond[quote,relative=1,notime,verbatim]
+  \clef "kievan-do"
+  \override NoteHead #'style = #'kievan
+  c \bar "kievan"
+@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
@@ -2446,7 +2603,6 @@ same source.
 @c use snippet Transcription-of-ancient-music-with-incipit
 TBC
 
-
 @c @seealso
 @c ... and reference to other sections ...
 
@@ -2462,7 +2618,7 @@ syncopated notes at bar lines, while still providing the
 orientation aids that bar lines give.
 
 
-@lilypondfile[verbatim,lilyquote,texidoc]
+@lilypondfile[verbatim,quote,texidoc]
 {mensurstriche-layout-bar-lines-between-the-staves.ly}
 
 @c This simple setup will take care of the
@@ -2471,7 +2627,6 @@ orientation aids that bar lines give.
 @c from lsr and -user
 @c TBC
 
-
 @c @seealso
 @c ... and reference to other sections ...
 
@@ -2501,7 +2656,9 @@ 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).
+#'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.
 
@@ -2549,6 +2706,7 @@ verba = \lyricmode {
       \remove "Time_signature_engraver"
       \remove "Bar_engraver"
       \override Stem #'transparent = ##t
+      \override Flag #'transparent = ##t
     }
   }
 }
@@ -2567,7 +2725,8 @@ chant = \relative c' {
   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
+  \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
 }
@@ -2588,6 +2747,7 @@ verba = \lyricmode {
       \remove "Time_signature_engraver"
       \override BarLine #'transparent = ##t
       \override Stem #'transparent = ##t
+      \override Flag #'transparent = ##t
     }
   }
 }
@@ -2607,7 +2767,7 @@ 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
@@ -2638,6 +2798,7 @@ spirLyr = \lyricmode {
       \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
@@ -2689,4 +2850,3 @@ TBC
 
 @c @seealso
 @c ... and reference to other sections ...
-