comparison lispref/display.texi @ 90199:bb71c6cf2009

Revision: [e-mail]--gnu-2005/emacs--unicode--0--patch-67 Merge from emacs--cvs-trunk--0 Patches applied: * emacs--cvs-trunk--0 (patch 447-458) - Update from CVS - Update from CVS: lisp/subr.el (add-to-ordered-list): Doc fix. - Merge from gnus--rel--5.10 * gnus--rel--5.10 (patch 83-85) - Merge from emacs--cvs-trunk--0 - Update from CVS

90198:97f6c3a96df1

particular parts of the text or the frame.

@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
same meaning in all frames.  But you can arrange to give a particular
face name a special meaning in one frame if you wish.

@subsection Defining Faces

  The way to define a new face is with @code{defface}.  This creates a
kind of customization item (@pxref{Customization}) which the user can
customize using the Customization buffer (@pxref{Easy Customization,,,
emacs, The GNU Emacs Manual}).  

@defmac defface face spec doc [keyword value]...
This declares @var{face} as a customizable face that defaults
according to @var{spec}.  You should not quote the symbol @var{face},
and it should not end in @samp{-face} (that would be redundant).  The

90199:bb71c6cf2009

particular parts of the text or the frame.

@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 symbols that name 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
same meaning in all frames.  But you can arrange to give a particular
face name a special meaning in one frame if you wish.

@subsection Defining Faces

  The way to define a new face is with @code{defface}.  This creates a
kind of customization item (@pxref{Customization}) which the user can
customize using the Customization buffer (@pxref{Easy Customization,,,
emacs, The GNU Emacs Manual}).

@defmac defface face spec doc [keyword value]...
This declares @var{face} as a customizable face that defaults
according to @var{spec}.  You should not quote the symbol @var{face},
and it should not end in @samp{-face} (that would be redundant).  The