From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 30 May 2015 12:59:39 +0000 (+0300)
Subject: Document 'face-ignored-fonts'
X-Git-Tag: emacs-25.0.90~1917
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=83c7e62a3047d6d0e951b51d5114608ba735945a;p=emacs.git

Document 'face-ignored-fonts'

* doc/emacs/mule.texi (Modifying Fontsets): Document
face-ignored-fonts.  (Bug#20628)
---

diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index d929e0947e1..7336fdc8f47 100644
--- a/doc/emacs/mule.texi
+++ b/doc/emacs/mule.texi
@@ -1555,6 +1555,20 @@ used.  Some examples are:
 
 @end example
 
+@cindex ignore font
+@cindex fonts, how to ignore
+@vindex face-ignored-fonts
+  Some fonts installed on your system might be broken, or produce
+unpleasant results for characters for which they are used, and you may
+wish to instruct Emacs to completely ignore them while searching for a
+suitable font required to display a character.  You can do that by
+adding the offending fonts to the value of @code{face-ignored-fonts}
+variable, which is a list.  Here's an example to put in your
+@file{~/.emacs}:
+
+@example
+(add-to-list 'face-ignored-fonts "Some Bad Font")
+@end example
 
 @node Undisplayable Characters
 @section Undisplayable Characters