GNU bug report logs - #43383
26.3; `toggle-menu-bar-mode-from-frame'

Previous Next

Full log

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 43383 <at> debbugs.gnu.org
Subject: Re: bug#43383: 26.3; `toggle-menu-bar-mode-from-frame'
Date: Mon, 14 Sep 2020 17:42:49 +0300

> Date: Sun, 13 Sep 2020 20:58:16 +0000 (UTC)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> I don't understand the doc string:
> 
>  Toggle menu bar on or off, based on the status of the current frame.
>  See `menu-bar-mode' for more information.

Yes, the doc string "needs work".

> What's more, the doc string tells you to see the doc string of
> `menu-bar-mode'.  But that doesn't explain anything more about
> `toggle-menu-bar-mode-from-frame', e.g., how it differs from
> `menu-bar-mode'.  It's not even mentioned there.
> 
> What is this command - what's its use case?

If you set the menu-bar-lines parameter of a frame to zero, but don't
turn off menu-bar-mode, the menu bar will not be displayed.  In that
situation, "M-x menu-bar-mode RET" will do the exact opposite of what
you want, whereas this command, when invoked from the menu popped up
by C-mouse-3, will do what you expect.  That's the use case.

Previous Next

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