From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: owner@emacsbugs.donarmstrong.com (Emacs bug Tracking System) Newsgroups: gmane.emacs.bugs Subject: bug#4114: marked as done (23.1; face doc unclear - no explanation of "underlying" face or attribute value) Date: Sat, 15 Aug 2009 21:20:06 +0000 Message-ID: References: <87k514n5h3.fsf@cyd.mit.edu> <01BB332A01B1434DB2186E220990CFEB@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----------=_1250371206-17223-0" X-Trace: ger.gmane.org 1250371658 9796 80.91.229.12 (15 Aug 2009 21:27:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 15 Aug 2009 21:27:38 +0000 (UTC) To: Chong Yidong Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 15 23:27:31 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1McQme-0000Gh-Tb for geb-bug-gnu-emacs@m.gmane.org; Sat, 15 Aug 2009 23:27:29 +0200 Original-Received: from localhost ([127.0.0.1]:59118 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1McQme-0006zm-C4 for geb-bug-gnu-emacs@m.gmane.org; Sat, 15 Aug 2009 17:27:28 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1McQmC-0006mq-QX for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 17:27:01 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1McQm5-0006l3-QI for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 17:26:58 -0400 Original-Received: from [199.232.76.173] (port=56785 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1McQm5-0006kt-5s for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 17:26:53 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:36177) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1McQm4-00026I-Do for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2009 17:26:52 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7FLQnX3018316; Sat, 15 Aug 2009 14:26:50 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n7FLK7gA017270; Sat, 15 Aug 2009 14:20:07 -0700 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: closed 4114 X-Emacs-PR-Package: emacs X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:30219 Archived-At: This is a multi-part message in MIME format... ------------=_1250371206-17223-0 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 Your message dated Sat, 15 Aug 2009 17:15:52 -0400 with message-id <87k514n5h3.fsf@cyd.mit.edu> and subject line Re: 23.1; face doc unclear - no explanation of "underlying= " face or attribute value has caused the Emacs bug report #4114, regarding 23.1; face doc unclear - no explanation of "underlying" face or a= ttribute value to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com immediately.) --=20 4114: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3D4114 Emacs Bug Tracking System Contact owner@emacsbugs.donarmstrong.com with problems ------------=_1250371206-17223-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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)' ------------=_1250371206-17223-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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@emacsbugs.donarmstrong.com 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)) ------------=_1250371206-17223-0--