From unknown Sun Aug 17 09:00:51 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#4114 <4114@debbugs.gnu.org> To: bug#4114 <4114@debbugs.gnu.org> Subject: Status: 23.1; face doc unclear - no explanation of "underlying" face or attribute value Reply-To: bug#4114 <4114@debbugs.gnu.org> Date: Sun, 17 Aug 2025 16:00:51 +0000 retitle 4114 23.1; face doc unclear - no explanation of "underlying" face o= r attribute value reassign 4114 emacs submitter 4114 "Drew Adams" severity 4114 normal thanks From drew.adams@oracle.com Mon Aug 10 22:12:17 2009 Received: (at submit) by emacsbugs.donarmstrong.com; 11 Aug 2009 05:12:17 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.6 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7B5CFIR019198 for ; Mon, 10 Aug 2009 22:12:16 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Majeh-0001yR-5q for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2009 01:12:15 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Majeb-0001x0-ER for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2009 01:12:14 -0400 Received: from [199.232.76.173] (port=37815 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Majeb-0001wx-AW for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2009 01:12:09 -0400 Received: from acsinet12.oracle.com ([141.146.126.234]:47958) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Majea-0001R3-DY for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2009 01:12:08 -0400 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7B5BbSv021693 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 11 Aug 2009 05:11:39 GMT Received: from abhmt005.oracle.com (abhmt005.oracle.com [141.146.116.14]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7B5C51f012578 for ; Tue, 11 Aug 2009 05:12:05 GMT Received: from dradamslap1 (/141.144.161.30) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 10 Aug 2009 22:12:02 -0700 From: "Drew Adams" To: Subject: 23.1; face doc unclear - no explanation of "underlying" face or attribute value Date: Mon, 10 Aug 2009 22:12:01 -0700 Message-ID: <01BB332A01B1434DB2186E220990CFEB@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcoaQkJt4PJTMrRKSRCeifC/dB6fKw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt005.oracle.com [141.146.116.14] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010201.4A80FDA3.0044:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) emacs -Q In (elisp)Face Attributes, things are explained in terms of "underlying" face. But this notion is never introduced or explained. Consequently, the descriptions that refer to this are incomprehensible. This includes the description of :height and :inherit: `:height' Font height--either an integer in units of 1/10 point, or a floating point number specifying the amount by which to scale the height of any underlying face, or a function... `:inherit' The name of a face from which to inherit attributes, or a list of face names. Attributes from inherited faces are merged into the face like an underlying face would be, with higher priority than underlying faces.... Incomprehensible. Similarly, in (elisp)Attribute Functions, "underlying value" is used with no definition/explanation, making the explanation of `merge-face-attribute' incomprehensible: Function: merge-face-attribute attribute value1 value2 If VALUE1 is a relative value for the face attribute ATTRIBUTE, returns it merged with the underlying value VALUE2; otherwise,... Huh? Is "underlying" simply an extra word here (so that it should be removed), or does it really say something about VALUE2 (what)? I have no idea what was intended in any of these passages. FWIW, no such language appears anywhere in the Emacs 20 Elisp manual - is an underlying face or attribute value something new since Emacs 20? If so, define it so you can then use it to explain other things. If not, please clarify what is meant in these passages. Perhaps this use of "underlying" is a translation from some other language? In any case, there is no explanation of what is meant. When you are defining face A, what is its "underlying" face (or faces)? In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' From cyd@stupidchicken.com Sat Aug 15 14:14:55 2009 Received: (at 4114-done) by emacsbugs.donarmstrong.com; 15 Aug 2009 21:14:55 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-1.7 required=4.0 tests=AWL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7FLErA5016300 for <4114-done@emacsbugs.donarmstrong.com>; Sat, 15 Aug 2009 14:14:54 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id 6407F57E21C; Sat, 15 Aug 2009 17:15:52 -0400 (EDT) From: Chong Yidong To: "Drew Adams" Cc: 4114-done@debbugs.gnu.org Subject: Re: 23.1; face doc unclear - no explanation of "underlying" face or attribute value Date: Sat, 15 Aug 2009 17:15:52 -0400 Message-ID: <87k514n5h3.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > In (elisp)Face Attributes, things are explained in terms of > "underlying" face. But this notion is never introduced or explained. Thanks, I've tweaked the text and added a reference to the node Displaying Faces, where the concept is explained. > I have no idea what was intended in any of these passages. Here's an experiment that should make this clear. Go to the default *scratch* buffer and evaluate the following lines, one at a time: ;; Give the comments in this buffer a height of 15. (set-face-attribute 'font-lock-comment-face nil :height 150) ;; Give characters 5 to 8 a height that's 0.9 times that of the ;; underlying face, in this case font-lock-comment-face. (setq ov (make-overlay 5 8)) (overlay-put ov 'face (list :height 0.9)) From drew.adams@oracle.com Sat Aug 15 14:53:08 2009 Received: (at 4114-done) by emacsbugs.donarmstrong.com; 15 Aug 2009 21:53:08 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.6 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from rgminet11.oracle.com (rcsinet11.oracle.com [148.87.113.123]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7FLr6PO022704 for <4114-done@emacsbugs.donarmstrong.com>; Sat, 15 Aug 2009 14:53:08 -0700 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rgminet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7FLrAdO026962 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 15 Aug 2009 21:53:11 GMT Received: from abhmt010.oracle.com (abhmt010.oracle.com [141.146.116.19]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7FLr0ep012960; Sat, 15 Aug 2009 21:53:00 GMT Received: from dradamslap1 (/141.144.88.67) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 15 Aug 2009 14:52:57 -0700 From: "Drew Adams" To: "'Chong Yidong'" Cc: <4114-done@debbugs.gnu.org> References: <87k514n5h3.fsf@cyd.mit.edu> Subject: RE: 23.1; face doc unclear - no explanation of "underlying" face or attribute value Date: Sat, 15 Aug 2009 14:53:20 -0700 Message-ID: <8B962A6F8C9C4120A4B9DB2C95A49217@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87k514n5h3.fsf@cyd.mit.edu> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 Thread-Index: Acod7ZGO1jLKmaMgRDyFYZYdkswOEgAAJyog X-Source-IP: abhmt010.oracle.com [141.146.116.19] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090202.4A872E3A.0058:SCFSTAT5015188,ss=1,fgs=0 > > In (elisp)Face Attributes, things are explained in terms of > > "underlying" face. But this notion is never introduced or explained. > > Thanks, I've tweaked the text and added a reference to the node > Displaying Faces, where the concept is explained. Thanks; that's clearer. However: 1. "Underlying face" is defined as "a face that has a lower priority in the list...". That begs the question, "lower than what"? Lower than some other face, presumably (?), but which one? (This passage is about fonts.) I think we need to specifically speak of a given face underlying another given face (or perhaps underlying a faceless set of face attributes?). 2. Related to #1. It's not clear to me whether there is only one underlying face for a given face/font/attribute-set (?). You say "a face", not "the face", so I guess there can be more than one that has a lower priority. But then you speak of "the underlying face". Probably this text just needs a little more tweaking, but for the moment it is still not clear to me. Also, I think the same kind of clarification (e.g. with an xref) is needed in node Attribute Functions (see `merge-face-attribute'), where it also refers to "underlying". > > I have no idea what was intended in any of these passages. > > Here's an experiment that should make this clear. Go to the default > *scratch* buffer and evaluate the following lines, one at a time: > > ;; Give the comments in this buffer a height of 15. > (set-face-attribute 'font-lock-comment-face nil :height 150) > ;; Give characters 5 to 8 a height that's 0.9 times that of the > ;; underlying face, in this case font-lock-comment-face. > (setq ov (make-overlay 5 8)) > (overlay-put ov 'face (list :height 0.9)) OK, that example seems clear; thanks. In this case, the face that's higher priority is the one set by `overlay-put'. The face that has lower priority is `font-lock-comment-face'. The questions mentioned above are still not clear to me, however. Thx. -- I see that you just now closed this bug. You close bugs too quickly. I don't know if now this reply will even get added to the bug thread, without my having to reopen the bug. IIRC, once a bug is closed, no further feedback is possible. I don't reaslly need the bug reopened in this case, if you will please at least take this feedback into account - I think a little more clarification would help. From cyd@stupidchicken.com Sat Aug 15 15:59:12 2009 Received: (at 4114-done) by emacsbugs.donarmstrong.com; 15 Aug 2009 22:59:13 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-1.3 required=4.0 tests=AWL,FOURLA,MDO_CABLE_TV3 autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7FMxBSp001549 for <4114-done@emacsbugs.donarmstrong.com>; Sat, 15 Aug 2009 15:59:12 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id 3A1DE57E21C; Sat, 15 Aug 2009 19:00:10 -0400 (EDT) From: Chong Yidong To: "Drew Adams" Cc: <4114-done@debbugs.gnu.org> Subject: Re: 23.1; face doc unclear - no explanation of "underlying" face or attribute value References: <87k514n5h3.fsf@cyd.mit.edu> <8B962A6F8C9C4120A4B9DB2C95A49217@us.oracle.com> Date: Sat, 15 Aug 2009 19:00:10 -0400 In-Reply-To: <8B962A6F8C9C4120A4B9DB2C95A49217@us.oracle.com> (Drew Adams's message of "Sat, 15 Aug 2009 14:53:20 -0700") Message-ID: <87ocqglm2t.fsf@cyd.mit.edu> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii "Drew Adams" writes: > 1. "Underlying face" is defined as "a face that has a lower priority > in the list...". That begs the question, "lower than what"? Lower than the face to which this attribute applies. That should be obvious. > 2. Related to #1. It's not clear to me whether there is only one > underlying face for a given face/font/attribute-set (?). You say "a > face", not "the face", so I guess there can be more than one that has > a lower priority. But then you speak of "the underlying face". There's no way to explain this concisely, I'm afraid. The best thing do is to read the Displaying Faces node closely (which is why an xref to that node is probably the best we can do). Basically, Emacs realizes a face by the "stacking" procedure described in that node, searching through the list of applicable faces for each attribute until it finds a fully-specified value. The "relative" values for the height are treated specially. Thus, in the context of that paragraph in the Face Attributes node, the "underlying face" refers to that face, X levels down in the priority list, for which Emacs has found a specified height. > I see that you just now closed this bug. You close bugs too quickly. I > don't know if now this reply will even get added to the bug thread, > without my having to reopen the bug. IIRC, once a bug is closed, no > further feedback is possible. It's still possible, IIUC. From drew.adams@oracle.com Sat Aug 15 16:32:59 2009 Received: (at submit) by emacsbugs.donarmstrong.com; 15 Aug 2009 23:33:00 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.6 required=4.0 tests=AWL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7FNWwSb008014 for ; Sat, 15 Aug 2009 16:32:59 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1McSk5-00069W-W2 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:58 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1McSk1-00067U-5k for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:57 -0400 Received: from [199.232.76.173] (port=43719 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1McSk1-00067G-10 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:53 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:29269) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1McSk0-0002wI-DK for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:52 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7FNXQer027456 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 15 Aug 2009 23:33:27 GMT Received: from abhmt007.oracle.com (abhmt007.oracle.com [141.146.116.16]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7FNXQkx027601 for ; Sat, 15 Aug 2009 23:33:26 GMT Received: from dradamslap1 (/141.144.88.67) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 15 Aug 2009 16:32:46 -0700 From: "Drew Adams" To: Subject: RE: bug#4114; 23.1; face doc unclear - no explanation of "underlying" face or attribute value Date: Sat, 15 Aug 2009 16:33:11 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 Thread-Index: Acod/DV/lyZnTAd3RvelsI/EFf60yAAAghUgAACGDnA= X-Source-IP: abhmt007.oracle.com [141.146.116.16] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4A87459F.001C:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) And of course I forgot to add back bug-gnu-emacs to the cc list. It's a pain having to change the #-done back to bug-gnu-emacs and add back the bug# in the Subject. And we saw what happened when you leave the #-done. -----Original Message----- From: Drew Adams Sent: Saturday, August 15, 2009 4:29 PM To: 'Chong Yidong' Also, did you see this part of my reply? > Also, I think the same kind of clarification (e.g. with an xref) > is needed in node Attribute Functions (see > `merge-face-attribute'), where it also refers to "underlying". From drew.adams@oracle.com Sat Aug 15 16:33:00 2009 Received: (at submit) by emacsbugs.donarmstrong.com; 15 Aug 2009 23:33:00 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.3 required=4.0 tests=AWL,FOURLA,MDO_CABLE_TV3 autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7FNWwpX008013 for ; Sat, 15 Aug 2009 16:32:59 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1McSk5-00069T-Uw for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:58 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1McSk1-00067N-52 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:57 -0400 Received: from [199.232.76.173] (port=43720 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1McSk1-00067H-14 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:53 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:29268) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1McSk0-0002wK-DQ for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 19:32:52 -0400 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7FNXPrQ027450 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 15 Aug 2009 23:33:27 GMT Received: from abhmt007.oracle.com (abhmt007.oracle.com [141.146.116.16]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7FNWmWW017191 for ; Sat, 15 Aug 2009 23:32:49 GMT Received: from dradamslap1 (/141.144.88.67) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 15 Aug 2009 16:32:45 -0700 From: "Drew Adams" To: Subject: RE: bug#4114 - 23.1; face doc unclear - no explanation of "underlying" face or attribute value Date: Sat, 15 Aug 2009 16:33:09 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 Thread-Index: Acod/DV/lyZnTAd3RvelsI/EFf60yAAAjuLAAACK/yA= X-Source-IP: abhmt007.oracle.com [141.146.116.16] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4A87459E.00EC:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) And of course I forgot to add back bug-gnu-emacs to the cc list. It's a pain having to change the #-done back to bug-gnu-emacs and add back the bug# in the Subject. And we saw what happened when you leave the #-done. -----Original Message----- From: Drew Adams Sent: Saturday, August 15, 2009 4:28 PM To: 'Chong Yidong' > > 1. "Underlying face" is defined as "a face that has a lower priority > > in the list...". That begs the question, "lower than what"? > > Lower than the face to which this attribute applies. That should be > obvious. If you read the doc text in question, I think you'll see that that is what is missing: the notion that we are talking about applying an attribute to a particular face (and that there might be other faces (plural) underlying that face.) Anyway, I think a little more clarification would help, but do as you like. > > 2. Related to #1. It's not clear to me whether there is only one > > underlying face for a given face/font/attribute-set (?). You say "a > > face", not "the face", so I guess there can be more than > > one that has a lower priority. But then you speak of "the > > underlying face". > > There's no way to explain this concisely, I'm afraid. I was trying to suggest that the doc is a bit contradictory here. If there can be more than one face that underlies a given face, then that should be said. Then it's OK to speak about one of those faces etc. (not "the underlying face"). > The best thing do is to read the Displaying Faces node closely > (which is why an xref to that node is probably the best we > can do). Basically, Emacs realizes a > face by the "stacking" procedure described in that node, searching > through the list of applicable faces for each attribute until > it finds a fully-specified value. The "relative" values for > the height are treated specially. Thus, in the context of > that paragraph in the Face Attributes node, the "underlying > face" refers to that face, X levels down in the priority > list, for which Emacs has found a specified height. Perhaps just add what you say in the last sentence to the doc? That is, there is one of the underlying faces, for which Emacs has found a specified height. Then you can talk about that face (with the specified height) in the singular. IOW, identify it first, then it is specific enough to talk about. > > I see that you just now closed this bug. You close bugs too > > quickly. I don't know if now this reply will even get added > > to the bug thread, without my having to reopen the bug. > > IIRC, once a bug is closed, no further feedback is possible. > > It's still possible, IIUC. You're apparently right, but problems have come from simply replying, because of the #-done in the cc list. I've removed that manually, and reinserted "bug#4114, but it's easy to forget to do that. From monnier@iro.umontreal.ca Mon Aug 17 08:09:09 2009 Received: (at 4114) by emacsbugs.donarmstrong.com; 17 Aug 2009 15:09:09 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.7 required=4.0 tests=AWL,HAS_BUG_NUMBER autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from ironport2-out.teksavvy.com (ironport2-out.teksavvy.com [206.248.154.182]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7HF97Ge032560 for <4114@emacsbugs.donarmstrong.com>; Mon, 17 Aug 2009 08:09:09 -0700 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AhAFAO0PiUpFpZNo/2dsb2JhbACBUtRlhBkFh0k X-IronPort-AV: E=Sophos;i="4.43,396,1246852800"; d="scan'208";a="43660203" Received: from 69-165-147-104.dsl.teksavvy.com (HELO pastel.home) ([69.165.147.104]) by ironport2-out.teksavvy.com with ESMTP; 17 Aug 2009 11:08:20 -0400 Received: by pastel.home (Postfix, from userid 20848) id 1651082F0; Mon, 17 Aug 2009 11:08:52 -0400 (EDT) From: Stefan Monnier To: Drew Adams Cc: 4114@debbugs.gnu.org Subject: Re: bug#4114: - 23.1; face doc unclear - no explanation of "underlying" face or attribute value Message-ID: References: Date: Mon, 17 Aug 2009 11:08:52 -0400 In-Reply-To: (Drew Adams's message of "Sat, 15 Aug 2009 16:33:09 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > And of course I forgot to add back bug-gnu-emacs to the cc list. > It's a pain having to change the #-done back to bug-gnu-emacs and add > back the bug# in the Subject. Don't do that. Instead, just remove the "-done" part. Stefan From unknown Sun Aug 17 09:00:51 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 15 Sep 2009 14:24:12 +0000 User-Agent: Fakemail v42.6.9 # A New Hope # A long time ago, in a galaxy far, far away # something happened. # # Magically this resulted in the following # action being taken, but this fake control # message doesn't tell you why it happened # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator