www.delorie.com/gnu/docs/elisp-manual-21/elisp_638.html   search  
Buy the book!

GNU Emacs Lisp Reference Manual

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

38.11.7 Functions for Working with Faces

Here are additional functions for creating and working with faces.

Function: make-face name
This function defines a new face named name, initially with all attributes nil. It does nothing if there is already a face named name.

Function: face-list
This function returns a list of all defined face names.

Function: copy-face old-face new-name &optional frame new-frame
This function defines the face new-name as a copy of the existing face named old-face. It creates the face new-name if that doesn't already exist.

If the optional argument frame is given, this function applies only to that frame. Otherwise it applies to each frame individually, copying attributes from old-face in each frame to new-face in the same frame.

If the optional argument new-frame is given, then copy-face copies the attributes of old-face in frame to new-name in new-frame.

Function: face-id face
This function returns the face number of face face.

Function: face-documentation face
This function returns the documentation string of face face, or nil if none was specified for it.

Function: face-equal face1 face2 &optional frame
This returns t if the faces face1 and face2 have the same attributes for display.

Function: face-differs-from-default-p face &optional frame
This returns t if the face face displays differently from the default face. A face is considered to be "the same" as the default face if each attribute is either the same as that of the default face, or unspecified (meaning to inherit from the default).

  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2003   by The Free Software Foundation     Updated Jun 2003