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 d929e0947e1933b8df908f253faae684e7e95508..7336fdc8f4735575852171bb49645ddcce008398 100644 (file)
--- 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