GNU bug report logs - #21303
25.0.50; incorrect doc string for `menu-set-font'

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#21303: closed (25.0.50; incorrect doc string for `menu-set-font')
Date: Fri, 21 Aug 2015 13:35:03 +0000

[Message part 1 (text/plain, inline)]

Your message dated Fri, 21 Aug 2015 16:34:23 +0300
with message-id <83r3mwix40.fsf <at> gnu.org>
and subject line Re: bug#21303: 25.0.50; incorrect doc string for `menu-set-font'
has caused the debbugs.gnu.org bug report #21303,
regarding 25.0.50; incorrect doc string for `menu-set-font'
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
21303: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=21303
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; incorrect doc string for `menu-set-font'
Date: Thu, 20 Aug 2015 08:39:49 -0700 (PDT)

`C-h k' and choose `Set Default Font' from menu-bar menu `Options'.

The doc string says "Interactively select a font and make it the default
on all existing frames."

This is wrong.  The most important thing this command does is set the
font as the default for all FUTURE frames.  The doc string gives the
impression that it sets the default font only for the EXISTING frames.

Perhaps someone misread the doc string of `set-frame-font' when writing
the doc string of `menu-set-font', seeing only that arg FRAMES = t means
"all existing graphical frames".

The most important part of the behavior (and the doc string) of
`set-frame-font' is that a non-nil FRAME arg "alter[s] the user's
Customization settings as though the font-related attributes of the
`default' face had been "set in this session", so that the font is
applied to future frames."
^^^^^^^^^^^^^^^^^^^^^^^^

Users of `menu-set-font' should have this info, above all.


In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2015-07-31 on LEG570
Bzr revision: 8d332aeccab2208e6c6bd434738565e6abf12043
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --host=i686-pc-mingw32 --enable-checking=yes,glyphs'

[Message part 3 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 21303-done <at> debbugs.gnu.org
Subject: Re: bug#21303: 25.0.50; incorrect doc string for `menu-set-font'
Date: Fri, 21 Aug 2015 16:34:23 +0300

> Date: Thu, 20 Aug 2015 08:39:49 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> `C-h k' and choose `Set Default Font' from menu-bar menu `Options'.
> 
> The doc string says "Interactively select a font and make it the default
> on all existing frames."
> 
> This is wrong.  The most important thing this command does is set the
> font as the default for all FUTURE frames.  The doc string gives the
> impression that it sets the default font only for the EXISTING frames.

Thanks, fixed.

Previous Next

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