[PATCH] Docu

[Juergen Reuter]

Hi!

Below is a small documentation patch.  Unfortunately, I had not enough
time to compile 1.3.129 (it takes hours on my machine); so the patch
is untested.

Greetings,
            Juergen

--- refman.itely.orig   Thu Feb  8 19:50:51 2001
+++ refman.itely        Mon Feb 12 03:56:19 2001
@@ -41,6 +41,7 @@
 * Lyrics::                      
 * Chords::                      
 * Writing parts::               
+* Custodes::                    
 * Page layout::                 
 * Sound::                       
 * Music entry::                 
@@ -663,8 +664,48 @@
 
 Supported clef-names include 
 
-[todo]
address@hidden @bullet
address@hidden treble, violin, G, G2: G clef on 2nd line
address@hidden french: G clef on 1st line
address@hidden soprano: C clef on 1st line
address@hidden mezzosoprano: C clef on 2nd line
address@hidden alto: C clef on 3rd line
address@hidden tenor: C clef on 4th line
address@hidden baritone: C clef on 5th line
address@hidden varbaritone: F clef on 3rd line
address@hidden bass, F: F clef on 4th line
address@hidden subbass: F clef on 5th line
address@hidden percussion: percussion clef
address@hidden itemize
 
+[todo: ancient clefs]
+
+Supported associated symbols (for Staff.clefGlyph) are:
+
address@hidden @bullet
address@hidden clefs-C: modern style C clef
address@hidden clefs-F: modern style F clef
address@hidden clefs-G: modern style G clef
address@hidden clefs-vaticana_do: Editio Vaticana style do clef
address@hidden clefs-vaticana_fa: Editio Vaticana style fa clef
address@hidden clefs-medicaea_do: Editio Medicaea style do clef
address@hidden clefs-medicaea_fa: Editio Medicaea style fa clef
address@hidden clefs-mensural1_c: modern style mensural C clef
address@hidden clefs-mensural2_c: historic style small mensural C clef
address@hidden clefs-mensural3_c: historic style big mensural C clef
address@hidden clefs-mensural1_f: historic style traditional mensural F clef
address@hidden clefs-mensural2_f: historic style new mensural F clef
address@hidden clefs-mensural_g: historic style mensural G clef
address@hidden clefs-hufnagel_do: historic style hufnagel do clef
address@hidden clefs-hufnagel_fa: historic style hufnagel fa clef
address@hidden clefs-hufnagel_do_fa: historic style hufnagel combined do/fa clef
address@hidden clefs-percussion: modern style percussion clef
address@hidden itemize
+
address@hidden style} means "as is typeset in current editions".
address@hidden style} means "as was typeset or written in contemporary
+historic editions".  @emph{Editio XXX style} means "as is/was printed in
+Editio XXX".
 
 @c .  {Time signature}
 @node Time signature
@@ -2271,6 +2312,67 @@
 
 @cindex condensing rests
 
address@hidden . {Custodes}
address@hidden Custodes
address@hidden Custodes
address@hidden Custos
address@hidden Custodes
+
+A @emph{custos} (plural: @emph{custodes}; latin word for "guard") is a
+staff context symbol that appears at the end of a staff line.  It
+anticipates the pitch of the first note(s) of the following line and
+thus helps the player or singer to manage line breaks during
+performance, thus enhancing readability of a score.
+
address@hidden
address@hidden
+
+\score {
+  \notes { c'1 d' e' d' \break c' d' e' d' }
+  \paper {
+    \translator {
+      \StaffContext
+      \consists Custos_engraver;
+      Custos \override #'style = #'mensural;
+    }
+  }
+}
+
address@hidden lilypond
address@hidden quotation
+
+Custodes were frequently used in music notation until the 16th century.
+There were different appearences for different notation styles.
+Nowadays, they have survived only in special forms of musical notation
+such as via the editio vaticana dating back to the beginning of the 20th
+century.
+
+For typesetting custodes, just put a @code{Custos_engraver} into the
address@hidden when declaring the @code{\paper} block.  In this
+block, you can also globally control the appearance of the custos symbol
+by setting the custos @code{style} property.  Currently supported styles
+are @code{vaticana}, @code{medicaea}, @code{hufnagel} and
address@hidden
+
address@hidden
+\paper {
+  \translator {
+      \StaffContext
+      \consists Custos_engraver;
+      Custos \override #'style = #'mensural;
+  }
+}
address@hidden quotation
+
+The property can also be set locally, for example in a @code{\notes}
+block:
+
address@hidden
+\notes {
+  \property Staff.Custos \override #'style = #'vaticana
+  c'1 d' e' d' \break c' d' e' d'
+}
address@hidden quotation
 
 @c . {Page layout}
 @node Page layout