From: Kenichi Handa <handa@gnu.org>
Date: Mon, 17 Jun 2013 15:04:50 +0000 (+0900)
Subject: display.texi (Face Attributes): Refer to "Low-Level font" (not "Font Selection")... 
X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~2016^2~76
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3da95318a7a8f69b6319cf6ae5a0529d85bb53fd;p=emacs.git

display.texi (Face Attributes): Refer to "Low-Level font" (not "Font Selection") in the explanation of :font attribute.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index e14f7543443..27515b6c87b 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2013-06-17  Kenichi Handa  <handa@gnu.org>
+
+	* display.texi (Face Attributes): Refer to "Low-Level font" (not
+	"Font Selection") in the explanation of :font attribute.
+
 2013-06-13  Stefan Monnier  <monnier@iro.umontreal.ca>
 
 	* loading.texi (Hooks for Loading): Don't document after-load-alist.
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 4adcfdf8f4f..4ad22898046 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2126,7 +2126,8 @@ used automatically to handle certain shades of gray.
 
 @item :font
 The font used to display the face.  Its value should be a font object.
-@xref{Font Selection}, for information about font objects.
+@xref{Low-Level Font}, for information about font objects, font specs,
+and font entities.
 
 When specifying this attribute using @code{set-face-attribute}
 (@pxref{Attribute Functions}), you may also supply a font spec, a font
@@ -3260,7 +3261,9 @@ to @var{value}.
 properties are intermediate between a font object and a font spec:
 like a font object, and unlike a font spec, it refers to a single,
 specific font.  Unlike a font object, creating a font entity does not
-load the contents of that font into computer memory.
+load the contents of that font into computer memory.  Emacs may open
+multiple font objects of different sizes from a single font entity
+referring to a scalable font.
 
 @defun find-font font-spec &optional frame
 This function returns a font entity that best matches the font spec