summaryrefslogtreecommitdiff
path: root/lisp/faces.el
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2019-11-01 18:32:29 +0100
committerLars Ingebrigtsen <larsi@gnus.org>2019-11-01 18:32:29 +0100
commita8b87446656af0395864b7aaa697a4e04bcc1218 (patch)
treed94d993e844281fb56f5253b5b95096d9e846b37 /lisp/faces.el
parenteda98211e31ed969823c1048b3cde635e08eebe5 (diff)
downloademacs-a8b87446656af0395864b7aaa697a4e04bcc1218.tar.gz
set-face-font doc string update
* lisp/faces.el (set-face-font): Mention what the string formats are (bug#14647).
Diffstat (limited to 'lisp/faces.el')
-rw-r--r--lisp/faces.el4
1 files changed, 4 insertions, 0 deletions
diff --git a/lisp/faces.el b/lisp/faces.el
index 2779197804b..75753ecefc9 100644
--- a/lisp/faces.el
+++ b/lisp/faces.el
@@ -888,6 +888,10 @@ Use `set-face-attribute' for finer control of font weight and slant."
(defun set-face-font (face font &optional frame)
"Change font-related attributes of FACE to those of FONT (a string).
+The format of the font varies based on the font system in used,
+but it can commonly be an X logical font description (XLFD)
+string, or a simpler XFD string like \"courier:size=10\".
+
FRAME nil or not specified means change face on all frames.
This sets the attributes `:family', `:foundry', `:width',
`:height', `:weight', and `:slant'. When called interactively,