X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Fall-font-metrics-scheme.cc;h=44fb8397c11012d53fc48bda8aca6895331150fa;hb=c77189ccaa4e645850ad61779de7a4c8f3fdbc6f;hp=c74f9596b43ff3b2a9549631215384c7f91da9f6;hpb=14c5f7683efc21f5cd168a713a34b3362f8c6d67;p=lilypond.git

diff --git a/lily/all-font-metrics-scheme.cc b/lily/all-font-metrics-scheme.cc
index c74f9596b4..44fb8397c1 100644
--- a/lily/all-font-metrics-scheme.cc
+++ b/lily/all-font-metrics-scheme.cc
@@ -1,11 +1,21 @@
-/* 
-  all-font-metrics-scheme.cc -- implement bindings for
-  All_font_metrics.
-  
-  source file of the GNU LilyPond music typesetter
-  
-  (c) 2007 Han-Wen Nienhuys <hanwen@lilypond.org>
+/*
+  This file is part of LilyPond, the GNU music typesetter.
+
+  Copyright (C) 2007--2010 Han-Wen Nienhuys <hanwen@lilypond.org>
   
+
+  LilyPond is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  LilyPond is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
 */
 
 #include "all-font-metrics.hh"
@@ -13,7 +23,7 @@
 
 LY_DEFINE (ly_reset_all_fonts, "ly:reset-all-fonts", 0, 0, 0,
 	   (),
-	   "Forget all about previously loaded fonts. ")
+	   "Forget all about previously loaded fonts.")
 {
   delete all_fonts_global;
   all_fonts_global = new All_font_metrics (global_path.to_string ());
@@ -22,15 +32,24 @@ 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);
+  LY_ASSERT_TYPE (scm_is_string, name, 1);
   
-  Font_metric *fm = all_fonts_global->find_font (ly_scm2string (name));
+  string name_str = ly_scm2string (name);
+  Font_metric *fm = all_fonts_global->find_font (name_str);
 
   return fm->self_scm ();
 }
-
-