GNU Info

(emacs)Face Customization

---

Next: Specific Customization Prev: Changing an Option Up: Easy Customization

---

Enter node , (file) or (file)node

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) [Hide]
        [State]: this face is unchanged from its standard setting.
     Parent groups: [Custom Magic Faces]
     Attributes: [ ] Font family: [Value Menu] *
                 [ ] Width: [Value Menu] *
                 [ ] Height: [Value Menu] *
                 [ ] Weight: [Value Menu] *
                 [ ] Slant: [Value Menu] *
                 [ ] Underline: [Value Menu] *
                 [ ] Overline: [Value Menu] *
                 [ ] Strike-through: [Value Menu] *
                 [ ] Box around text: [Value Menu] *
                 [ ] Inverse-video: [Value Menu] *
                 [X] Foreground: [Value Menu] Color: white       (sample)
                 [X] Background: [Value Menu] Color: blue        (sample)
                 [ ] Stipple: [Value Menu] *
                 [ ] Inherit:

   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 (Note: 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 all display specs' 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.