Run `make grand-replace'.

[lilypond.git] / lily / all-font-metrics-scheme.cc

diff --git a/lily/all-font-metrics-scheme.cc b/lily/all-font-metrics-scheme.cc
index 685ec537e6ef8c005dcd30efcfa6a70466342be5..517b5a8725f04d81685f32421710001b2fb9f794 100644 (file)
--- a/lily/all-font-metrics-scheme.cc
+++ b/lily/all-font-metrics-scheme.cc
@@ -4,7 +4,7 @@
   
   source file of the GNU LilyPond music typesetter
   
-  (c) 2007 Han-Wen Nienhuys <hanwen@lilypond.org>
+  (c) 2007--2008 Han-Wen Nienhuys <hanwen@lilypond.org>
   
 */
 
@@ -22,9 +22,19 @@ LY_DEFINE (ly_reset_all_fonts, "ly:reset-all-fonts", 0, 0, 0,
 }
 
 
-LY_DEFINE (ly_font_load, "ly:font-load", 1, 0, 0,
+LY_DEFINE (ly_system_font_load, "ly:system-font-load", 1, 0, 0,
           (SCM name),
-          "Load the font @var{name}.")
+          "Load the OpenType system font @file{@var{name}.otf}."
+          "  Fonts loaded with this command must contain three"
+          " additional SFNT font tables called @code{LILC},"
+          " @code{LILF}, and @code{LILY}, needed for typesetting"
+          " musical elements.  Currently, only the Emmentaler and"
+          " the Aybabtu fonts fulfill these requirements.\n"
+          "\n"
+          "Note that only @code{ly:font-get-glyph} and derived"
+          " code (like @code{\\lookup}) can access glyphs from"
+          " the system fonts; text strings are handled exclusively"
+          " via the Pango interface.")
 {
   LY_ASSERT_TYPE (scm_is_string, name, 1);
   
@@ -33,5 +43,3 @@ LY_DEFINE (ly_font_load, "ly:font-load", 1, 0, 0,
 
   return fm->self_scm ();
 }
-
-