From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 26 Sep 2001 19:21:00 +0000 (+0000)
Subject: Document problems with bad specifications of the default fontset.
X-Git-Tag: emacs-21.1~150
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e9a52cfeb5a68beb88e1a9530213dcd4e2f1ed74;p=emacs.git

Document problems with bad specifications of the default fontset.
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index df8592ca5a4..5c8c8fbfdd7 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -893,6 +893,26 @@ functions, one each for every macro.  Here's an example:
 Then replace all references to UPDATE_SYNTAX_TABLE_FORWARD in syntax.c
 with a call to the function update_syntax_table_forward.
 
+* Emacs fails to start, complaining about missing fonts.
+
+A typical error message might be something like
+
+  No fonts match `-*-fixed-medium-r-*--6-*-*-*-*-*-iso8859-1'
+
+This happens because some X resource specifies a bad font family for
+Emacs to use.  The possible places where this specification might be
+are:
+
+  - in your ~/.Xdefaults file
+
+  - client-side X resource file, such as  ~/Emacs or
+    /usr/X11R6/lib/app-defaults/Emacs or
+    /usr/X11R6/lib/X11/app-defaults/Emacs
+
+One of these files might have bad or malformed specification of a
+fontset that Emacs should use.  To fix the problem, you need to find
+the problematic line(s) and correct them.
+
 * Emacs 20 and later fails to load Lisp files at startup.
 
 The typical error message might be like this: