Doc-es: various updates.

[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 a3b19e468d2bf4ea6ad990bab60d55fa76fde6df..b29ea4bf4bfc48c885b72d7f7aefff50901752e6 100644 (file)
--- a/lily/all-font-metrics-scheme.cc
+++ b/lily/all-font-metrics-scheme.cc
@@ -1,36 +1,58 @@
-/* 
-  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--2015 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"
 #include "main.hh"
+#include "protected-scm.hh"
+
+All_font_metrics *all_fonts_global = 0;
+Protected_scm all_fonts_global_scm;
 
 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 ());
+  all_fonts_global_scm = all_fonts_global->unprotect ();
 
   return SCM_UNSPECIFIED;
 }
 
-
-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.")
 {
   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 ();
 }
-
-