GNU Emacs Manual - Face Customization

Go to the first, previous, next, last section, table of contents.

#### Customizing Faces

In addition to user options, some customization groups also include faces. When you show the contents of a group, both the user options and the faces in the group appear in the customization buffer. Here is an example of how a face looks:

    Custom Changed Face: (sample)
       [State]: this face is unchanged from its standard setting.
    Face used when the customize item has been changed.
    Attributes: [ ] Bold: [toggle] off
                [X] Italic: [toggle] on
                [ ] Underline: [toggle] off
                [ ] Inverse-Video: [toggle] on
                [ ] Foreground: black (sample)
                [ ] Background: white (sample)
                [ ] Stipple:

Each face attribute has its own line. The ``[x]'` field before the attribute name indicates whether the attribute is enabled; ``X'` means that it is. You can enable or disable the attribute by invoking that field. When the attribute is enabled, you can change the attribute value in the usual ways.

On a black-and-white display, the colors you can use for the background are ``black'`, ``white'`, ``gray'`, ``gray1'`, and ``gray3'`. Emacs supports these shades of gray by using background stipple patterns instead of a color.

Setting, saving and resetting a face work like the same operations for options (see section Changing an Option).

A face can specify different appearances for different types of display. For example, a face can make text red on a color display, but use a bold font on a monochrome display. To specify multiple appearances for a face, select ``Show Display Types'` in the menu you get from invoking ``[State]'`.

Another more basic way to set the attributes of a specific face is with `M-x modify-face`. This command reads the name of a face, then reads the attributes one by one. For the color and stipple attributes, the attribute's current value is the default--type just `RET` if you don't want to change that attribute. Type ``none'` if you want to clear out the attribute.

Go to the first, previous, next, last section, table of contents.