Mercurial > emacs

comparison lispref/display.texi @ 63134:ca65a2108220

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(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 83cd1166073d
children 99e9892a51d9 173dee4e2611
comparison
equal deleted inserted replaced
63133:2244564c10de 63134:ca65a2108220
1793 @subsection Defining Faces 1793 @subsection Defining Faces
1794 1794
1795 The way to define a new face is with @code{defface}. This creates a 1795 The way to define a new face is with @code{defface}. This creates a
1796 kind of customization item (@pxref{Customization}) which the user can 1796 kind of customization item (@pxref{Customization}) which the user can
1797 customize using the Customization buffer (@pxref{Easy Customization,,, 1797 customize using the Customization buffer (@pxref{Easy Customization,,,
1798 emacs, The GNU Emacs Manual}). 1798 emacs, The GNU Emacs Manual}).
1799 1799
1800 @defmac defface face spec doc [keyword value]... 1800 @defmac defface face spec doc [keyword value]...
1801 This declares @var{face} as a customizable face that defaults according 1801 This declares @var{face} as a customizable face that defaults
1802 to @var{spec}. You should not quote the symbol @var{face}. The 1802 according to @var{spec}. You should not quote the symbol @var{face},
1803 and it should not end in @samp{-face} (that would be redundant). The
1803 argument @var{doc} specifies the face documentation. The keywords you 1804 argument @var{doc} specifies the face documentation. The keywords you
1804 can use in @code{defface} are the same ones that are meaningful in both 1805 can use in @code{defface} are the same as in @code{defgroup} and
1805 @code{defgroup} and @code{defcustom} (@pxref{Common Keywords}). 1806 @code{defcustom} (@pxref{Common Keywords}).
1806 1807
1807 When @code{defface} executes, it defines the face according to 1808 When @code{defface} executes, it defines the face according to
1808 @var{spec}, then uses any customizations that were read from the 1809 @var{spec}, then uses any customizations that were read from the
1809 init file (@pxref{Init File}) to override that specification. 1810 init file (@pxref{Init File}) to override that specification.
1810 1811