From: Han-Wen Nienhuys <hanwen@xs4all.nl>
Date: Wed, 13 Apr 2005 14:47:00 +0000 (+0000)
Subject: (Font selection):
X-Git-Tag: release/2.5.19~9
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a6e39f72ace58150c2b380492ad8698f17deed0f;p=lilypond.git

(Font selection):
document font-name.
---

diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index e57ad3e626..0061a912af 100644
--- a/Documentation/user/changing-defaults.itely
+++ b/Documentation/user/changing-defaults.itely
@@ -1361,11 +1361,9 @@ closest to the desired size.  The standard font size (for
 @code{font-size} equals 0), depends on the standard staff height.  For
 a 20pt staff, a 10pt font is selected.
 
-The @code{font-size} mechanism does not work for fonts selected
-through @code{font-name}.  These may be scaled with
-@code{font-magnification}.  The @code{font-size} property can only be
-set on layout objects that use fonts; these are the ones supporting
-the @internalsref{font-interface} layout interface.
+The @code{font-size} property can only be set on layout objects that
+use fonts. These are the ones supporting the
+@internalsref{font-interface} layout interface.
 
 @refcommands
 
@@ -1425,22 +1423,29 @@ several font series for each font family and shape.  Choices are
 @end itemize
 
 Fonts selected in the way sketched above come from a predefined style
-sheet.
+sheet. If you want to use a font from outside the style sheet, 
+then set the 
+@code{font-name} property, 
 
-The font used for printing a object can be selected by setting
-@code{font-name}, e.g.,
-@example
-\override Staff.TimeSignature
-    #'font-name = #"cmr17"
-@end example
+@lilypond[fragment,verbatim]
+{
+  \override Staff.TimeSignature #'font-name = #"Times"
+  \override Staff.TimeSignature #'font-size = #2
+  \time 3/4
+  c'1_\markup {
+    \override #'(font-name . "Utopia Bold")
+      { This text is in Utopia Bold }
+  }
+}
+@end lilypond
 
 @noindent
-Any font can be used, as long as it is available to @TeX{}.  Possible
-fonts include foreign fonts or fonts that do not belong to the
-Computer Modern font family.  The size of fonts selected in this way
-can be changed with the @code{font-magnification} property.  For
-example, @code{2.0} blows up all letters by a factor 2 in both
-directions.
+Any font can be used, as long as it is available to Pango/FontConfig.
+
+The size of the font may be set with the @code{font-size}
+property. The resulting size is taken relative to the
+@code{text-font-size} as defined in the @code{\layout} block.
+
 
 @cindex font size
 @cindex font magnification