GNU bug report logs - #55086
28.1; Improve doc of set-fontset-font

Previous Next

Package: emacs;

Reported by: Howard Melman <hmelman <at> gmail.com>

Date: Sat, 23 Apr 2022 21:52:02 UTC

Severity: minor

Found in version 28.1

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Howard Melman <hmelman <at> gmail.com>
To: GNU Emacs <bug-gnu-emacs <at> gnu.org>
Subject: 28.1; Improve doc of set-fontset-font
Date: Sat, 23 Apr 2022 17:51:21 -0400

The eldoc string for set-fontset-font in Emacs 28 is

    (NAME TARGET FONT-SPEC &optional FRAME ADD)

I found NAME and TARGET to be unhelpfully generic.  The
docstring does say that name is the name of a fontset and
that TARGET is about characters.

The elisp manual names the params as:

    Function: set-fontset-font name character font-spec &optional frame add

character is an improvement but it should be plural.

I think they should be the same in both places and
this would be clearer:

    (FONTSET CHARACTERS FONT-SPEC &optional FRAME ADD)

Howard
This bug report was last modified 3 years and 28 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.