From 83c7e62a3047d6d0e951b51d5114608ba735945a Mon Sep 17 00:00:00 2001
From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 30 May 2015 15:59:39 +0300
Subject: [PATCH] Document 'face-ignored-fonts'

* doc/emacs/mule.texi (Modifying Fontsets): Document
face-ignored-fonts.  (Bug#20628)
---
 doc/emacs/mule.texi | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index d929e0947e..7336fdc8f4 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
-- 
2.39.2