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/faces.html | 68 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 devdocs/elisp/faces.html (limited to 'devdocs/elisp/faces.html') diff --git a/devdocs/elisp/faces.html b/devdocs/elisp/faces.html new file mode 100644 index 00000000..0244bbb5 --- /dev/null +++ b/devdocs/elisp/faces.html @@ -0,0 +1,68 @@ +

Faces

A face is a collection of graphical attributes for displaying text: font, foreground color, background color, optional underlining, etc. Faces control how Emacs displays text in buffers, as well as other parts of the frame such as the mode line.

One way to represent a face is as a property list of attributes, like (:foreground "red" :weight bold). Such a list is called an anonymous face. For example, you can assign an anonymous face as the value of the face text property, and Emacs will display the underlying text with the specified attributes. See Special Properties.

More commonly, a face is referred to via a face name: a Lisp symbol associated with a set of face attributes25. Named faces are defined using the defface macro (see Defining Faces). Emacs comes with several standard named faces (see Basic Faces).

Some parts of Emacs require named faces (e.g., the functions documented in Attribute Functions). Unless otherwise stated, we will use the term face to refer only to named faces.

Function: facep object +

This function returns a non-nil value if object is a named face: a Lisp symbol or string which serves as a face name. Otherwise, it returns nil.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
• Face Attributes + What is in a face?
• Defining Faces + How to define a face.
• Attribute Functions + Functions to examine and set face attributes.
• Displaying Faces + How Emacs combines the faces specified for a character.
• Face Remapping + Remapping faces to alternative definitions.
• Face Functions + How to define and examine faces.
• Auto Faces + Hook for automatic face assignment.
• Basic Faces + Faces that are defined by default.
• Font Selection + Finding the best available font for a face.
• Font Lookup + Looking up the names of available fonts and information about them.
• Fontsets + A fontset is a collection of fonts that handle a range of character sets.
• Low-Level Font + Lisp representation for character display fonts.
+

+ 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/Faces.html +

+
-- cgit v1.2.3