source file of the GNU LilyPond music typesetter
- (c) 2007 Han-Wen Nienhuys <hanwen@lilypond.org>
+ (c) 2007--2009 Han-Wen Nienhuys <hanwen@lilypond.org>
*/
}
-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);
return fm->self_scm ();
}
-
-