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

Faces for Font Lock

Font Lock mode can highlight using any face, but Emacs defines several faces specifically for Font Lock to use to highlight text. These Font Lock faces are listed below. They can also be used by major modes for syntactic highlighting outside of Font Lock mode (see Major Mode Conventions).

Each of these symbols is both a face name, and a variable whose default value is the symbol itself. Thus, the default value of font-lock-comment-face is font-lock-comment-face.

The faces are listed with descriptions of their typical usage, and in order of greater to lesser prominence. If a mode’s syntactic categories do not fit well with the usage descriptions, the faces can be assigned using the ordering as a guide.

font-lock-warning-face
+

for a construct that is peculiar (e.g., an unescaped confusable quote in an Emacs Lisp symbol like ‘‘foo’), or that greatly changes the meaning of other text, like ‘;;;###autoload’ in Emacs Lisp and ‘#error’ in C.

font-lock-function-name-face
+

for the name of a function being defined or declared.

font-lock-variable-name-face
+

for the name of a variable being defined or declared.

font-lock-keyword-face
+

for a keyword with special syntactic significance, like ‘for’ and ‘if’ in C.

font-lock-comment-face
+

for comments.

font-lock-comment-delimiter-face
+

for comments delimiters, like ‘/*’ and ‘*/’ in C. On most terminals, this inherits from font-lock-comment-face.

font-lock-type-face
+

for the names of user-defined data types.

font-lock-constant-face
+

for the names of constants, like ‘NULL’ in C.

font-lock-builtin-face
+

for the names of built-in functions.

font-lock-preprocessor-face
+

for preprocessor commands. This inherits, by default, from font-lock-builtin-face.

font-lock-string-face
+

for string constants.

font-lock-doc-face
+

for documentation embedded in program code inside specially-formed comments or strings. This face inherits, by default, from font-lock-string-face.

font-lock-doc-markup-face
+

for mark-up elements in text using font-lock-doc-face. It is typically used for the mark-up constructs in documentation embedded in program code, following conventions such as Haddock, Javadoc or Doxygen. This face inherits, by default, from font-lock-constant-face.

font-lock-negation-char-face
+

for easily-overlooked negation characters.

+
+

+ 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-for-Font-Lock.html +

+
-- cgit v1.2.3