www.delorie.com/gnu/docs/elisp-manual-21/elisp_631.html

search

	Buy the book!

GNU Emacs Lisp Reference Manual

38.11 Faces

A face is a named collection of graphical attributes: font family, foreground color, background color, optional underlining, and many others. Faces are used in Emacs to control the style of display of particular parts of the text or the frame.

Each face has its own face number, which distinguishes faces at low levels within Emacs. However, for most purposes, you refer to faces in Lisp programs by their names.

Function: facep object

This function returns t if object is a face name symbol (or if it is a vector of the kind used internally to record face data). It returns nil otherwise.

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.

38.11.1 Standard Faces		The faces Emacs normally comes with.
38.11.2 Defining Faces		How to define a face with defface.
38.11.3 Face Attributes		What is in a face?
38.11.4 Face Attribute Functions		Functions to examine and set face attributes.
38.11.5 Merging Faces for Display		How Emacs combines the faces specified for a character.
38.11.6 Font Selection		Finding the best available font for a face.
38.11.7 Functions for Working with Faces		How to define and examine faces.
38.11.8 Automatic Face Assignment		Hook for automatic face assignment.
38.11.9 Looking Up Fonts		Looking up the names of available fonts and information about them.
38.11.10 Fontsets		A fontset is a collection of fonts that handle a range of character sets.