GNU bug report logs - #35230
char-displayable-p return code is conflictingly documented

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Robert Pluim <rpluim <at> gmail.com>
Cc: 35230 <at> debbugs.gnu.org
Subject: bug#35230: char-displayable-p return code is conflictingly documented
Date: Sun, 14 Apr 2019 17:10:14 +0300

> From: Robert Pluim <rpluim <at> gmail.com>
> Cc: 35230 <at> debbugs.gnu.org
> Date: Sun, 14 Apr 2019 11:51:36 +0200
> 
>  @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}.  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 if the coding system for the text
> +terminal can encode the character.
>  @end defun

Thanks.  I think we should tell more about the testing of text
terminal capabilities, because otherwise the reference to terminal
encoding comes out of the blue without being mentioned anywhere else,
since the preceding text talks only about fonts and fontsets,
i.e. only about GUI frames.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.