Re: datatypes in Elisp Info: mention "things" for which there is no "thing" datatype - e.g. faces

[Luc Teirlinck]

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
============================================================