Mercurial > emacs
comparison lispref/display.texi @ 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 | 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 |