(Font selection):

document font-name.

diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index e57ad3e62622e8d4222d8d18f14d8e65ceac91d1..0061a912afb698cb0c376f4092b2ebc66e677042 100644 (file)
--- 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