release: 1.5.47

[lilypond.git] / lily / custos.cc

diff --git a/lily/custos.cc b/lily/custos.cc
index 29c32f699684ab4859f5e93c692b3beb5c3e0ce1..5fc7266b18023bc998dc3b8c04ac7d04fff8f454 100644 (file)
--- a/lily/custos.cc
+++ b/lily/custos.cc
@@ -9,7 +9,6 @@
 /* TODO:
 
  - merge create_ledger_line () and Note_head::create_ledger_line ()
- 
 
  - rewrite create_ledger_line () to support short and thin ledger lines
 
@@ -146,6 +145,12 @@ Custos::brew_molecule (SCM smob)
   if (gh_symbol_p (scm_style))
     {
       String style = ly_scm2string (scm_symbol_to_string (scm_style));
+
+      /*
+       DOCME:
+       
+       Why would we want it differently? What's the meaning of adjust ?
+       */
       bool adjust =
        to_boolean (me->get_grob_property ("adjust-if-on-staffline"));
 
@@ -207,3 +212,20 @@ Custos::has_interface (Grob*m)
 {
   return m && m->has_interface (ly_symbol2scm ("custos-interface"));
 }
+
+
+ADD_INTERFACE (Custos, "custos-interface",
+  "A custos is a staff context symbol that appears at the end of a
+  staff line with monophonic musical contents (i.e. with a single
+  voice).  It anticipates the pitch of the first note of the following
+  line and thus helps the player or singer to manage line breaks
+  during performance, thus enhancing readability of a score.
+
+  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.
+
+[TODO: add to glossary]",
+  "style adjust-if-on-staffline neutral-position");