From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/elisp/face-functions.html | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 devdocs/elisp/face-functions.html (limited to 'devdocs/elisp/face-functions.html') diff --git a/devdocs/elisp/face-functions.html b/devdocs/elisp/face-functions.html new file mode 100644 index 00000000..38ba4fac --- /dev/null +++ b/devdocs/elisp/face-functions.html @@ -0,0 +1,20 @@ +

Functions for Working with Faces

Here are additional functions for creating and working with faces.

Function: face-list +

This function returns a list of all defined face names.

+
Function: face-id face +

This function returns the face number of face face. This is a number that uniquely identifies a face at low levels within Emacs. It is seldom necessary to refer to a face by its face number. However, functions that manipulate glyphs, such as make-glyph-code and glyph-face (see Glyphs) access the face numbers internally. Note that the face number is stored as the value of the face property of the face symbol, so we recommend not to set that property of a face to any value of your own.

+
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 non-nil if the face face displays differently from the default face.

+

A face alias provides an equivalent name for a face. You can define a face alias by giving the alias symbol the face-alias property, with a value of the target face name. The following example makes modeline an alias for the mode-line face. 

(put 'modeline 'face-alias 'mode-line)
+
+
Macro: define-obsolete-face-alias obsolete-face current-face when +

This macro defines obsolete-face as an alias for current-face, and also marks it as obsolete, indicating that it may be removed in future. when should be a string indicating when obsolete-face was made obsolete (usually a version number string).

+
+

+ Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
+ https://www.gnu.org/software/emacs/manual/html_node/elisp/Face-Functions.html +

+
-- cgit v1.2.3