From: Robert Pluim <rpluim@gmail.com>
Date: Sun, 11 Oct 2020 01:49:37 +0000 (+0200)
Subject: Fix the documentation of char-displayable-p
X-Git-Tag: emacs-28.0.90~5692
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7db2879a81e21749ed9f0808fc25d48ce22939e6;p=emacs.git

Fix the documentation of char-displayable-p

* doc/lispref/display.texi (Fontsets): Make the documentation of
char-displayable-p less incorrect (bug#35230).
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index d2e6cad6c45..5b4b6720af2 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -3668,12 +3668,16 @@ the charset @code{japanese-jisx0208}.
 @end defun
 
 @defun char-displayable-p char
-This function returns @code{t} if Emacs ought to be able to display
-@var{char}.  More precisely, if the selected frame's fontset has a
-font to display the character set that @var{char} belongs to.
+This function returns non-@code{nil} if Emacs ought to be able to
+display @var{char}.  Or more precisely, if the selected frame's fontset
+has a font to display the character set that @var{char} belongs to.
 
 Fontsets can specify a font on a per-character basis; when the fontset
 does that, this function's value may not be accurate.
+
+This function may return non-@code{nil} even when there is no font
+available, since it also checks whether the coding system for the text
+terminal can encode the character (@pxref{Terminal Coding}).
 @end defun
 
 @node Low-Level Font