Mercurial > emacs
changeset 63134:ca65a2108220
(Defining Faces): Explain that face name should not end in `-face'.
| author | Richard M. Stallman <rms@gnu.org> |
|---|---|
| date | Wed, 08 Jun 2005 15:33:10 +0000 |
| parents | 2244564c10de |
| children | ade1be8b63fd |
| files | lispref/display.texi |
| diffstat | 1 files changed, 6 insertions(+), 5 deletions(-) [+] |
line wrap: on
line diff
--- a/lispref/display.texi Wed Jun 08 15:32:01 2005 +0000 +++ b/lispref/display.texi Wed Jun 08 15:33:10 2005 +0000 @@ -1795,14 +1795,15 @@ 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}). +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}. The +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 argument @var{doc} specifies the face documentation. The keywords you -can use in @code{defface} are the same ones that are meaningful in both -@code{defgroup} and @code{defcustom} (@pxref{Common Keywords}). +can use in @code{defface} are the same as in @code{defgroup} and +@code{defcustom} (@pxref{Common Keywords}). When @code{defface} executes, it defines the face according to @var{spec}, then uses any customizations that were read from the