diff --git a/lispref/display.texi b/lispref/display.texi index 2243a1e6899..6af7b8f19cd 100644 --- a/lispref/display.texi +++ b/lispref/display.texi @@ -2523,6 +2523,17 @@ This returns non-@code{nil} if the face @var{face} displays differently from the default face. @end defun +@cindex face alias +A @dfn{face alias} provides an equivalent name for a face. You can +define a face alias by giving the alias symbol the @code{face-alias} +property, with a value of the target face name. The following example +makes @code{modeline} an alias for the @code{mode-line} face. + +@example +(put 'modeline 'face-alias 'mode-line) +@end example + + @node Auto Faces @subsection Automatic Face Assignment @cindex automatic face assignment