summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMattias EngdegÄrd <mattiase@acm.org>2021-08-13 12:47:39 +0200
committerMattias EngdegÄrd <mattiase@acm.org>2021-08-14 11:00:40 +0200
commit1bfbb2b706db6a7ca9420b27d22a737deccdd5b0 (patch)
treed1b7571cd2295eb79071aaec4855417e437a6739 /doc
parenta3dd5f1216f76d82fbb8f59bf016c2dab714eb72 (diff)
downloademacs-1bfbb2b706db6a7ca9420b27d22a737deccdd5b0.tar.gz
Add font-lock-doc-markup-face (bug#50041)
This face is intended for mark-up syntax and constructs inside text using font-lock-doc-face; ie, documentation comments and strings in programming modes. * lisp/font-lock.el (font-lock-doc-markup-face): New face. * lisp/cus-theme.el (custom-theme--listed-faces): Add it to the list. * doc/lispref/modes.texi (Faces for Font Lock): Document it. * etc/NEWS: Mention it.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/modes.texi10
1 files changed, 9 insertions, 1 deletions
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index d48c9cc1af0..4274810cba5 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -3444,9 +3444,17 @@ for string constants.
@item font-lock-doc-face
@vindex font-lock-doc-face
-for documentation strings in the code. This inherits, by default, from
+for documentation embedded in program code inside specially-formed
+comments or strings. This face inherits, by default, from
@code{font-lock-string-face}.
+@item font-lock-doc-markup-face
+@vindex font-lock-doc-markup-face
+for mark-up elements in text using @code{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 @code{font-lock-constant-face}.
+
@item font-lock-negation-char-face
@vindex font-lock-negation-char-face
for easily-overlooked negation characters.