From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#27246: 24.5; doc of `face-spec-set' Date: Sun, 4 Jun 2017 22:43:34 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1496641453 20658 195.159.176.226 (5 Jun 2017 05:44:13 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 5 Jun 2017 05:44:13 +0000 (UTC) To: 27246@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 05 07:44:06 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dHko9-0004tY-Qg for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Jun 2017 07:44:06 +0200 Original-Received: from localhost ([::1]:59689 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dHkoF-0004CV-4D for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Jun 2017 01:44:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41137) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dHko9-0004CE-8a for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:44:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dHko6-0002i1-5a for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:44:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53720) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dHko6-0002ht-20 for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:44:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dHko5-0008GT-PM for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:44:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 05 Jun 2017 05:44:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 27246 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.149664143231746 (code B ref -1); Mon, 05 Jun 2017 05:44:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Jun 2017 05:43:52 +0000 Original-Received: from localhost ([127.0.0.1]:56397 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dHknv-0008Fw-QH for submit@debbugs.gnu.org; Mon, 05 Jun 2017 01:43:52 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:50125) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dHknt-0008Fk-SZ for submit@debbugs.gnu.org; Mon, 05 Jun 2017 01:43:50 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dHknn-0002X9-RS for submit@debbugs.gnu.org; Mon, 05 Jun 2017 01:43:44 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:55205) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dHknn-0002We-PL for submit@debbugs.gnu.org; Mon, 05 Jun 2017 01:43:43 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41096) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dHknm-0004Bq-Mq for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:43:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dHknj-0002Ss-Jb for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:43:42 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:37650) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dHknj-0002SA-A3 for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 01:43:39 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v555havm000598 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 5 Jun 2017 05:43:37 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v555habT012791 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 5 Jun 2017 05:43:36 GMT Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v555hZ2L013064 for ; Mon, 5 Jun 2017 05:43:36 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6767.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:133282 Archived-At: 1. The doc string and (elisp ) `Defining Faces' do not agree about argument SPEC-TYPE when its value is not one of the special values documented. The doc string says: Any other value means not to set any spec, but to run the function for its other effects. Huh? What "other effects"? Not clear, but we can guess (and looking at the code confirms) that what is hinted at is perhaps this: This function also defines FACE as a valid face name if it is not already one, and (re)calculates its attributes on existing frames. But the Elisp manual says instead: Any other value of SPEC-TYPE is reserved for internal use. IOW, the doc string tells us to use another SPEC-TYPE value to get the effect of defining a face and (re)calculating its attributes on existing frames. But the Elisp manual tells us NOT to use any other SPEC-TYPE value, because other values are reserved for internal use. 2. I also find this part unclear: Doc string: nil or `face-override-spec' means the override spec (which is usually what you want if calling this function outside of Custom code); Manual: If [SPEC-TYPE] is nil or `face-override-spec', this function sets the "override spec", which overrides over all other face specs on FACE. "if calling this function outside of Custom code"? What does that mean for users? Anyway, both of those descriptions are unclear to me. ("other face specs on FACE"? Does that mean the default (`defface') spec plus the customized spec plus the saved custom spec? And it's not clear here what those are, either.) In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D3D/c/usr --host=3D3Di686-pc-mingw32'