From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#35230: char-displayable-p return code is conflictingly documented Date: Sun, 14 Apr 2019 17:10:14 +0300 Message-ID: <83bm18k795.fsf@gnu.org> References: <837ebzmlnf.fsf@gnu.org> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="252017"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35230@debbugs.gnu.org To: Robert Pluim Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 14 16:11:29 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hFfqz-0013SL-4S for geb-bug-gnu-emacs@m.gmane.org; Sun, 14 Apr 2019 16:11:29 +0200 Original-Received: from localhost ([127.0.0.1]:36213 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hFfqy-0002PN-4V for geb-bug-gnu-emacs@m.gmane.org; Sun, 14 Apr 2019 10:11:28 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:44042) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hFfqa-0002BU-Ck for bug-gnu-emacs@gnu.org; Sun, 14 Apr 2019 10:11:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hFfqY-0001Ey-6W for bug-gnu-emacs@gnu.org; Sun, 14 Apr 2019 10:11:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47547) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hFfqX-0001EJ-Vx for bug-gnu-emacs@gnu.org; Sun, 14 Apr 2019 10:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hFfqX-0003AE-Mq for bug-gnu-emacs@gnu.org; Sun, 14 Apr 2019 10:11:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 14 Apr 2019 14:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35230 X-GNU-PR-Package: emacs Original-Received: via spool by 35230-submit@debbugs.gnu.org id=B35230.155525103312123 (code B ref 35230); Sun, 14 Apr 2019 14:11:01 +0000 Original-Received: (at 35230) by debbugs.gnu.org; 14 Apr 2019 14:10:33 +0000 Original-Received: from localhost ([127.0.0.1]:32856 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hFfq4-00039T-RN for submit@debbugs.gnu.org; Sun, 14 Apr 2019 10:10:33 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:57772) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hFfq2-00039E-ES for 35230@debbugs.gnu.org; Sun, 14 Apr 2019 10:10:30 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:39709) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hFfpx-0000iq-8z; Sun, 14 Apr 2019 10:10:25 -0400 Original-Received: from [176.228.60.248] (port=4326 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hFfpw-00022n-3N; Sun, 14 Apr 2019 10:10:24 -0400 In-reply-to: (message from Robert Pluim on Sun, 14 Apr 2019 11:51:36 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:157625 Archived-At: > From: Robert Pluim > Cc: 35230@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.