From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: datatypes in Elisp Info: mention "things" for which there is no "thing" datatype - e.g. faces Date: Fri, 24 Jun 2005 16:22:26 -0500 (CDT) Message-ID: <200506242122.j5OLMQS10976@raven.dms.auburn.edu> References: <200506241841.j5OIfXp09629@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1119648354 20742 80.91.229.2 (24 Jun 2005 21:25:54 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 24 Jun 2005 21:25:54 +0000 (UTC) Cc: snogglethorpe@gmail.com, drew.adams@oracle.com, miles@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jun 24 23:25:53 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DlvgJ-0001L0-A7 for ged-emacs-devel@m.gmane.org; Fri, 24 Jun 2005 23:25:47 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dlvha-0003Hs-3t for ged-emacs-devel@m.gmane.org; Fri, 24 Jun 2005 17:27:06 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Dlvgv-00031x-TL for emacs-devel@gnu.org; Fri, 24 Jun 2005 17:26:26 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Dlvgt-00030L-Ld for emacs-devel@gnu.org; Fri, 24 Jun 2005 17:26:23 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dlvgs-0002zP-Cx for emacs-devel@gnu.org; Fri, 24 Jun 2005 17:26:22 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DlviI-0005J3-Rh; Fri, 24 Jun 2005 17:27:51 -0400 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id j5OLO5CK006178; Fri, 24 Jun 2005 16:24:05 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id j5OLMQS10976; Fri, 24 Jun 2005 16:22:26 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org In-reply-to: <200506241841.j5OIfXp09629@raven.dms.auburn.edu> (message from Luc Teirlinck on Fri, 24 Jun 2005 13:41:33 -0500 (CDT)) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:39459 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39459 For purposes of this discussion, note that facep is not a type predicate, because it returns t for face names (strings or symbols) as well as for internal face objects. I noticed that the docs for facep are not very clear on this. I propose the following doc changes, which I could install if desired: ===File ~/faces.el-diff===================================== *** faces.el 23 Jun 2005 16:53:05 -0500 1.324 --- faces.el 24 Jun 2005 13:47:03 -0500 *************** *** 204,210 **** ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (defun facep (face) ! "Return non-nil if FACE is a face name." (internal-lisp-face-p face)) --- 204,213 ---- ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (defun facep (face) ! "Return non-nil if FACE is a face name or internal face object. ! Return nil otherwise. A face name can be a string or a symbol. ! An internal face object is a vector of the kind used internally ! to record face data." (internal-lisp-face-p face)) ============================================================ ===File ~/display.texi-diff================================= *** display.texi 23 Jun 2005 20:49:48 -0500 1.169 --- display.texi 24 Jun 2005 14:00:28 -0500 *************** *** 1628,1639 **** @cindex face id Each face has its own @dfn{face number}, which distinguishes faces at low levels within Emacs. However, for most purposes, you refer to ! faces in Lisp programs by their names. @defun facep object ! This function returns @code{t} if @var{object} is a face name symbol (or ! if it is a vector of the kind used internally to record face data). It ! returns @code{nil} otherwise. @end defun Each face name is meaningful for all frames, and by default it has the --- 1628,1639 ---- @cindex face id Each face has its own @dfn{face number}, which distinguishes faces at low levels within Emacs. However, for most purposes, you refer to ! faces in Lisp programs by the symbol that names them. @defun facep object ! This function returns @code{t} if @var{object} is a face name string ! or symbol (or if it is a vector of the kind used internally to record ! face data). It returns @code{nil} otherwise. @end defun Each face name is meaningful for all frames, and by default it has the ============================================================