From unknown Mon Aug 18 14:21:38 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#9564 <9564@debbugs.gnu.org> To: bug#9564 <9564@debbugs.gnu.org> Subject: Status: 23.3; doc of `face-list' Reply-To: bug#9564 <9564@debbugs.gnu.org> Date: Mon, 18 Aug 2025 21:21:38 +0000 retitle 9564 23.3; doc of `face-list' reassign 9564 emacs submitter 9564 "Drew Adams" severity 9564 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Sep 20 13:41:27 2011 Received: (at submit) by debbugs.gnu.org; 20 Sep 2011 17:41:27 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R64Jz-0000FX-ED for submit@debbugs.gnu.org; Tue, 20 Sep 2011 13:41:27 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R64Jx-0000FO-CV for submit@debbugs.gnu.org; Tue, 20 Sep 2011 13:41:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1R64Ex-0002hk-G0 for submit@debbugs.gnu.org; Tue, 20 Sep 2011 13:36:17 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:56466) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R64Ex-0002hg-Ec for submit@debbugs.gnu.org; Tue, 20 Sep 2011 13:36:15 -0400 Received: from eggs.gnu.org ([140.186.70.92]:46234) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R64Ew-0001ZE-0P for bug-gnu-emacs@gnu.org; Tue, 20 Sep 2011 13:36:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1R64Ev-0002hF-2P for bug-gnu-emacs@gnu.org; Tue, 20 Sep 2011 13:36:13 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:26661) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R64Eu-0002gr-Ri for bug-gnu-emacs@gnu.org; Tue, 20 Sep 2011 13:36:13 -0400 Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p8KHZgMT003029 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 20 Sep 2011 17:36:09 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p8KHWOx7009328 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 20 Sep 2011 17:32:24 GMT Received: from abhmt110.oracle.com (abhmt110.oracle.com [141.146.116.62]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p8KHWI4d014119 for ; Tue, 20 Sep 2011 12:32:19 -0500 Received: from dradamslap1 (/10.159.34.188) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 20 Sep 2011 10:32:18 -0700 From: "Drew Adams" To: Subject: 23.3; doc of `face-list' Date: Tue, 20 Sep 2011 10:32:17 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acx3uz4yK1/1nP9RQR2Q4f0KjEDjTg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090206.4E78CF09.017B,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) Both doc string and Elisp manual say that `face-list' returns a list of face names. This is incorrect or at least misleading. A "name" value in Emacs typically refers to a string value. The doc should say clearly that the list elements are face _symbols_, not face "names". In GNU Emacs 23.3.1 (i386-mingw-nt5.1.2600) of 2011-03-10 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt --cflags -Ic:/imagesupport/include' From debbugs-submit-bounces@debbugs.gnu.org Tue Sep 20 21:34:34 2011 Received: (at 9564-done) by debbugs.gnu.org; 21 Sep 2011 01:34:34 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R6Bhq-0000zW-Dq for submit@debbugs.gnu.org; Tue, 20 Sep 2011 21:34:34 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.183] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R6Bhn-0000zN-CS for 9564-done@debbugs.gnu.org; Tue, 20 Sep 2011 21:34:32 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAOw9eU5FpZ7x/2dsb2JhbABCp2J5gVMBAQQBViMFCws0EhQYDSSICrMihn0EoFGERA X-IronPort-AV: E=Sophos;i="4.68,414,1312171200"; d="scan'208";a="137576600" Received: from 69-165-158-241.dsl.teksavvy.com (HELO pastel.home) ([69.165.158.241]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 20 Sep 2011 21:34:18 -0400 Received: by pastel.home (Postfix, from userid 20848) id 639FE58F15; Tue, 20 Sep 2011 21:34:18 -0400 (EDT) From: Stefan Monnier To: "Drew Adams" Subject: Re: bug#9564: 23.3; doc of `face-list' Message-ID: References: Date: Tue, 20 Sep 2011 21:34:18 -0400 In-Reply-To: (Drew Adams's message of "Tue, 20 Sep 2011 10:32:17 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 9564-done Cc: 9564-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) > Both doc string and Elisp manual say that `face-list' returns a list of > face names. This is incorrect or at least misleading. A "name" value > in Emacs typically refers to a string value. The doc should say clearly > that the list elements are face _symbols_, not face "names". Indeed, thank you. Actually, they're just faces. And faces happen to be represented by symbols. Should be fixed now, Stefan From debbugs-submit-bounces@debbugs.gnu.org Tue Sep 20 21:52:56 2011 Received: (at 9564-done) by debbugs.gnu.org; 21 Sep 2011 01:52:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R6Bzb-0001Po-Bn for submit@debbugs.gnu.org; Tue, 20 Sep 2011 21:52:56 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R6BzZ-0001Pf-AW for 9564-done@debbugs.gnu.org; Tue, 20 Sep 2011 21:52:54 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p8L1qbx0020969 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 21 Sep 2011 01:52:39 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p8L1qbm0021743 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 21 Sep 2011 01:52:37 GMT Received: from abhmt120.oracle.com (abhmt120.oracle.com [141.146.116.72]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p8L1qVq0024091; Tue, 20 Sep 2011 20:52:31 -0500 Received: from dradamslap1 (/10.159.34.188) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 20 Sep 2011 18:52:31 -0700 From: "Drew Adams" To: "'Stefan Monnier'" References: Subject: RE: bug#9564: 23.3; doc of `face-list' Date: Tue, 20 Sep 2011 18:52:30 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Acx3/po9qJNILM5pQ3KUD3q/QgJwswAAgskA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A02020B.4E794368.001D:SCFMA922111,ss=1,re=-4.000,fgs=0 X-Spam-Score: -6.2 (------) X-Debbugs-Envelope-To: 9564-done Cc: 9564-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) > > Both doc string and Elisp manual say that `face-list' > > returns a list of face names. This is incorrect or at > > least misleading. A "name" value in Emacs typically > > refers to a string value. The doc should say clearly > > that the list elements are face _symbols_, not face "names". > > Indeed, thank you. Actually, they're just faces. And faces happen to > be represented by symbols. Should be fixed now, Well, yes, at one level faces are symbols - just like characters are whole numbers. But at another level it can be useful to distinguish the two (conceptually). And we do so. In several places we speak of "face symbols". I think that general helps clarity rather than hurting it, but yes, at some point users (e.g., programmers) need to understand that faces are symbols. Another advantage in using that terminology is that while all faces are symbols, not all symbols are faces. Those that are can reasonably be called "face symbols" (as we do now, in other places). Anyway, thanks for the quick fix. From unknown Mon Aug 18 14:21:38 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 19 Oct 2011 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator