From 3e489ed804902c927d51601037003547fa941d89 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Thu, 4 Dec 2025 10:27:29 +0200 Subject: [PATCH] ; * src/font.c (Flist_fonts): Doc fix. --- src/font.c | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/src/font.c b/src/font.c index eebc33a1eab..99053dbdbcb 100644 --- a/src/font.c +++ b/src/font.c @@ -4346,12 +4346,15 @@ See also `font-get' for KEYs that have special meanings. */) } DEFUN ("list-fonts", Flist_fonts, Slist_fonts, 1, 4, 0, - doc: /* List available fonts matching FONT-SPEC on the current frame. -Optional 2nd argument FRAME specifies the target frame. + doc: /* List available fonts matching FONT-SPEC on FRAME. +If FRAME is nil or omitted, it defaults to the selected frame, Optional 3rd argument NUM, if non-nil, limits the number of returned fonts. Optional 4th argument PREFER, if non-nil, is a font-spec to control the order of the returned list. Fonts are sorted by -how close they are to PREFER. */) +how close they are to PREFER. + +The return value is a list of font-entity objects describing available +fonts which match FONT-SPEC. */) (Lisp_Object font_spec, Lisp_Object frame, Lisp_Object num, Lisp_Object prefer) { struct frame *f = decode_live_frame (frame);