From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#53664: 26.3; Doc of the font of a given face Date: Mon, 31 Jan 2022 19:41:05 +0200 Message-ID: <83fsp3951q.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="10843"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 53664-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Jan 31 18:49:50 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nEaoI-0002eS-F3 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 31 Jan 2022 18:49:50 +0100 Original-Received: from localhost ([::1]:59748 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nEaoH-00079l-3Q for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 31 Jan 2022 12:49:49 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:58986) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEagl-0007ij-2r for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 12:42:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47764) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nEagk-0004r7-Mt for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 12:42:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nEagk-0001Wd-Gt for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 12:42:02 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Mon, 31 Jan 2022 17:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 53664 X-GNU-PR-Package: emacs Mail-Followup-To: 53664@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 53664-done@debbugs.gnu.org id=D53664.16436508795769 (code D ref 53664); Mon, 31 Jan 2022 17:42:02 +0000 Original-Received: (at 53664-done) by debbugs.gnu.org; 31 Jan 2022 17:41:19 +0000 Original-Received: from localhost ([127.0.0.1]:40661 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nEag2-0001Ux-Sr for submit@debbugs.gnu.org; Mon, 31 Jan 2022 12:41:19 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:52158) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nEag1-0001Ud-Ia for 53664-done@debbugs.gnu.org; Mon, 31 Jan 2022 12:41:18 -0500 Original-Received: from [2001:470:142:3::e] (port=52048 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEafu-0004mt-M5; Mon, 31 Jan 2022 12:41:12 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=ggcHJi2a5iQBMicCuOwLcmZ2LRb7FRZ2gspiEruX1Is=; b=XxwS4qU5fL8s HBhJ+W0HcSiqnVSA4gHrbJV+ouviZ9SL6ADlthNF8rwhAV8SW7TmAK/83tfwPox/cfiGp0SsGG5Y0 +RoqnxiWi3KetLHt4UDJ4KTjh2VW67+a6wlC8ivuUQ7cKSifk0nC+oZnUMb6Af6vb1OqqHa/qqtG6 h7/DxdNXBcom2lQCV6G6A+abq6Q4Nf625gJBgk5NZdhhwGoGgoSOgwXyoPmfmfhpuxPk+z3yPkoP1 ADxgH2d/Hu+zXAvTimUbOs7u4CuUIu58eG32kF2lQ8oXb8qGBO3jJM3AaP8u3dgsQWwJ/msCBxC7Q WeNenz1aqnHw6jgDPqghDw==; Original-Received: from [87.69.77.57] (port=4931 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEafs-0008G5-MI; Mon, 31 Jan 2022 12:41:10 -0500 In-Reply-To: (message from Drew Adams on Mon, 31 Jan 2022 15:57:23 +0000) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:225707 Archived-At: > From: Drew Adams > Date: Mon, 31 Jan 2022 15:57:23 +0000 > > The Elisp manual doc about the font(s) of a given face is clear, if you > read it carefully and completely. But it could be a bit more clear, in > particular when it comes to a face having more than one font. Note: A face always has more than one font: if the user didn't specify a fontset, Emacs will use the default fontset for characters that cannot be displayed by the face's font. > The description of function `face-font'says that the same face can use > different fonts for different chars, but it starts by talking about "the > font": > > This function returns the name of the font of face FACE. > ^^^^^^^^ > > ... the font name used for CHARACTER. > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > > That first sentence can mislead. Maybe say something like "the font of > FACE for a given character, or for all characters if its :font attribute > is not a fontset"? The description of the function in the manual is quite short, and we expect the readers to read it in its entirety, not just the first sentence. It is customary in our documentation to start with describing the default behavior, and only go into the details of non-default one later -- this usually makes the description clearer and easier to understand for the usual case. So I didn't make the first sentence fuzzier, but instead fixed the description of how CHARACTER arg is used (because it was inaccurate). > The description doesn't say anything about fontsets currently. Maybe it > should, to make the relation clear here. Maybe we could add something > like this? > > The name of FACE can be different for different chars if the :font > attribute for FACE is a fontset. That is incorrect: fontsets don't affect face names. Maybe you meant FONT instead of FACE, but then this just repeats what the documentation already says in other words. > Other parts of the doc about faces: > > ':font' > The font used to display the face. > ^^^^^^^^ > Its value should be a font object or a fontset. > > It might help to put that info in the first line: > > The font or fontset used to display the face. I'd rather not go there. What exactly happens when you specify a fontset for the :font attribute is complicated, and doesn't really do what you think it does. I did add there a note that if the value is a font, it's for ASCII characters. > The description of `set-face-font' says that it sets the :font > attribute, which is correct, and if you consult the doc for that > attribute you find that the value could be a fontset. But it might > help if the description of `set-face-font' said something like this: > > This sets the :font attribute of FACE to FONT, which is a font or a > fontset. I don't want to advertise this possibility, it wasn't supposed to be used by applications. And with that, I'm closing this bug report.