summaryrefslogtreecommitdiff
path: root/lisp
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2022-04-28 17:53:36 +0300
committerEli Zaretskii <eliz@gnu.org>2022-04-28 17:53:36 +0300
commit3b6338c8c351cce721f2f1aa115cadc401179d5c (patch)
tree379ecf8cd236b8e7948c41917aba181332da19c6 /lisp
parent37234157437228174a626fa10353f377179dc46e (diff)
downloademacs-3b6338c8c351cce721f2f1aa115cadc401179d5c.tar.gz
emacs-3b6338c8c351cce721f2f1aa115cadc401179d5c.tar.bz2
emacs-3b6338c8c351cce721f2f1aa115cadc401179d5c.zip
Improve documentation of font- and face-related attribute functions
* lisp/faces.el (face-attribute): * src/xfaces.c (Fx_family_fonts): * src/font.c (Ffont_get, Ffont_put): Improve and clarify the doc strings. * doc/lispref/display.texi (Low-Level Font): Document the :type attribute of a font. Improve documentation of 'font-get' and 'font-put'. (Attribute Functions): Add cross-reference to the description of face attributes.
Diffstat (limited to 'lisp')
-rw-r--r--lisp/faces.el4
1 files changed, 4 insertions, 0 deletions
diff --git a/lisp/faces.el b/lisp/faces.el
index 1d21a216224..3bd1e5db6f8 100644
--- a/lisp/faces.el
+++ b/lisp/faces.el
@@ -448,6 +448,10 @@ of FACE on FRAME."
(defun face-attribute (face attribute &optional frame inherit)
"Return the value of FACE's ATTRIBUTE on FRAME.
+
+See `set-face-attribute' for the list of supported attributes
+and their meanings and allowed values.
+
If the optional argument FRAME is given, report on face FACE in that frame.
If FRAME is t, report on the defaults for face FACE (for new frames).
If FRAME is omitted or nil, use the selected frame.