-
-LY_DEFINE (ly_font_load, "ly:font-load", 1, 0, 0,
- (SCM name),
- "Load the font @var{name}. ")
+LY_DEFINE (ly_system_font_load, "ly:system-font-load", 1, 0, 0,
+ (SCM 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 Emmentaler-Brace 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.")