(doc) bug for menu-bar-mode

[Allan Gottlieb]

This bug report will be sent to the Free Software Foundation,
not to your local site managers!
Please write in English, because the Emacs maintainers do not have
translators to read other languages for them.

Your bug report will be posted to the bug-gnu-emacs@gnu.org mailing list,
and to the gnu.emacs.bug news group.

In GNU Emacs 21.1.1 (i686-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2001-11-24 on allan.gottlieb.pvt
Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: en_US
  locale-coding-system: iso-latin-1
  default-enable-multibyte-characters: t

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

The doc for menu-bar-mode

    menu-bar-mode is an interactive compiled Lisp function in `menu-bar'.
    (menu-bar-mode FLAG)

    Toggle display of a menu bar on each frame.
    This command applies to all frames that exist and frames to be
    created in the future.
    With a numeric argument, if the argument is positive,
    turn on menu bars; otherwise, turn off menu bars.

suggests that (menu-bar-mode) is a toggle, i.e. that FLAG is
optional.  But the flag is not optional.

allan gottlieb


Recent input:
<help-echo> <help-echo> <help-echo> <help-echo> <help-echo> 
<help-echo> <help-echo> <help-echo> <help-echo> <help-echo> 
<help-echo> <help-echo> <help-echo> <help-echo> <switch-frame> 
C-x b * s c r <tab> <return> <help-echo> <help-echo> 
<help-echo> <help-echo> C-c b <switch-frame> <down-mouse-1> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <mouse-movement> 
<mouse-movement> <mouse-movement> <drag-mouse-1> <help-echo> 
<help-echo> <help-echo> <help-echo> <help-echo> <help-echo> 
<help-echo> <menu-bar> <help-menu> <report-emacs-bug> 
C-g <down-mouse-3> <mouse-3> <help-echo> C-c C-c <switch-frame> 
<switch-frame> <help-echo> <help-echo> <help-echo> 
<help-echo> <help-echo> <help-echo> <menu-bar> <help-menu> 
<report-emacs-bug>

Recent messages:
Mark set
Type C-x 4 b RET to restore the other window.  C-M-v to scroll the help.
Auto-saving...
Mark set [2 times]
Loading emacsbug...done
byte-code: Quit
Sending...
Wrote /home/gottlieb/Mail/MAIL/84127
Sending...done