From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 6 Nov 2021 17:52:30 +0000 (+0100)
Subject: Add an example to the display-supports-face-attributes-p doc string
X-Git-Tag: emacs-29.0.90~3671^2~185
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=cf9d85c1ea3c8b6eda9e2f388c14c1a02576ea8c;p=emacs.git

Add an example to the display-supports-face-attributes-p doc string

* src/xfaces.c (Fdisplay_supports_face_attributes_p): Add an example.
---

diff --git a/src/xfaces.c b/src/xfaces.c
index 22f37222c38..a8cbf347904 100644
--- a/src/xfaces.c
+++ b/src/xfaces.c
@@ -5373,6 +5373,10 @@ DEFUN ("display-supports-face-attributes-p",
 The optional argument DISPLAY can be a display name, a frame, or
 nil (meaning the selected frame's display).
 
+For instance, to check whether the display supports underlining:
+
+  (display-supports-face-attributes-p \\='(:underline t))
+
 The definition of `supported' is somewhat heuristic, but basically means
 that a face containing all the attributes in ATTRIBUTES, when merged
 with the default face for display, can be represented in a way that's