Document Kievan ligature engraver (issue 7382060)

[aleksandr . andreev]

Reviewers: ,

Message:
Please review.

Description:
Document Kievan ligature engraver

Adds subsection about Kievan ligatures to ancient notation section of
notation manual.

Please review this at https://codereview.appspot.com/7382060/

Affected files:
  M Documentation/notation/ancient.itely


Index: Documentation/notation/ancient.itely
diff --git a/Documentation/notation/ancient.itely  
b/Documentation/notation/ancient.itely
index  
6d122875f89150dab9d5c01540fa84b51b092ebd..0f3c9a7f70e7d4ea254b7cb3907aab785ca12c6d  
100644
--- a/Documentation/notation/ancient.itely
+++ b/Documentation/notation/ancient.itely
@@ -2416,6 +2416,7 @@ with head prefixes in arbitrary order.
 * Kievan notes::
 * Kievan accidentals::
 * Kievan bar line::
+* Kievan melismata::
 @end menu

 @node Kievan contexts
@@ -2569,6 +2570,63 @@ It can be invoked as @code{\bar "k"}.
 @ref{Bars},
 @ref{The Feta font}

address@hidden Kievan melismata
address@hidden Kievan melismata
+
address@hidden Ligatures
+
+Notes within a Kievan melisma are usually placed close to each other
+and the melismata separated by whitespace. This is done to allow
+the chanter to quickly identify the melodic structures of Znamenny
+chant. In LilyPond, melismata are treated as ligatures and the
+spacing is implemented by the @code{Kievan_ligature_engraver}.
+
+When the @code{KievanVoice} and @code{KievanStaff} contexts are used,
+the @code{Kievan_ligature_engraver} is enabled by default. In other
+contexts, it can be invoked by replacing the  
@code{Ligature_bracket_engraver}
+with the @code{Kievan_ligature_engraver} in the layout block:
+
address@hidden
+\layout @{
+  \context @{
+    \Voice
+    \remove "Ligature_bracket_engraver"
+    \consists "Kievan_ligature_engraver"
+  @}
address@hidden
address@hidden example
+
+The spacing between the notes within a Kievan ligature can be controlled
+by setting the @code{padding} property of the @code{KievanLigature}.
+
+The following example demonstrates the use of Kievan ligatures:
+
address@hidden,ragged-right,verbatim]
+\score {
+  <<
+    \new KievanVoice = "melody" \transpose c c' {
+      \cadenzaOn
+       e2 \[ e4( d4 ) \] \[ c4( d e  d ) \] e1 \bar "k"
+    }
+    \new Lyrics \lyricsto "melody" {
+      Га -- врі -- и -- лу
+    }
+  >>
+}
address@hidden lilypond
+
address@hidden
+Music Glossary:
address@hidden
+
+Notation Reference:
address@hidden mensural ligatures},
address@hidden square neume ligatures},
address@hidden
+
address@hidden
+Horizontal spacing of ligatures is poor.
+
 @node Working with ancient music---scenarios and solutions
 @subsection Working with ancient music---scenarios and solutions