GNU bug report logs - #38710
26.3; (elisp) `Fond and Color Parameters'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 38710 in the body.
You can then email your comments to 38710 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; (elisp) `Fond and Color Parameters'
Date: Sun, 22 Dec 2019 11:46:15 -0800 (PST)

Compare the descriptions of `foreground-color' and `background-color':

'foreground-color'
     The color to use for the image of a character.  It is equivalent to
     the ':foreground' attribute of the 'default' face.

'background-color'
     The color to use for the background of characters.  It is
     equivalent to the ':background' attribute of the 'default' face.

The latter is OK.  The former talks about "the image of a character",
which is unclear and misleading.  Certainly this has nothing to do with
other uses of "image" in the context of Emacs, and the phrase is
undefined here.

Please consider using language for foreground similar to what is used
for background, or make the former description clear in some other way.

(If you really want to keep the form of the description and just replace
"image" there then maybe use something like "grapheme" or "figure" or
"appearance" or "representation" or "form".  But "image" is misleading
here.)

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.17763
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 38710 <at> debbugs.gnu.org
Subject: Re: bug#38710: 26.3; (elisp) `Fond and Color Parameters'
Date: Sat, 30 Jan 2021 07:59:51 +0100

Drew Adams <drew.adams <at> oracle.com> writes:

> The latter is OK.  The former talks about "the image of a character",
> which is unclear and misleading.  Certainly this has nothing to do with
> other uses of "image" in the context of Emacs, and the phrase is
> undefined here.

Yup.  Now fixed in Emacs 28.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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