DO NOT REPLY TO THIS MESSAGE.  INSTEAD, POST ANY RESPONSES TO THE LINK BELOW.

[STR New]

Link:         https://www.fltk.org/str.php?L3317
Version:      1.3-feature
Assigned To:  greg.ercolano

I looked at the docs, and we do have a paragraph about the need for calling
update():

"""
Changes to the menu state are immediately visible in the menubar when they
are made using member functions of the Fl_Sys_Menu_Bar class. Other changes
(e.g., by a call to Fl_Menu_Item::set()) should be followed by a call to
update() to be visible in the menubar across all platforms. macOS global
variable fl_sys_menu_bar points to the unique, current system menu bar.
"""

I think though that it'd be easily missed among the other paragraphs.
Perhaps a separate CAVEATS section that covers bullet items of exactly what
is different about Fl_Sys_Menu_Bar from Fl_Menu_Bar, so that someone
switching from one to the other can quickly glean concerns.


Link:         https://www.fltk.org/str.php?L3317