Skip to content

GtkApplicationWindow show-menubar documentation inconsistent

In the documentation for the show-menubar property, we see that the default value of the property is FALSE, and furthermore the description says:

If this property is true, the window will display a menubar unless it is shown by the desktop shell. … If false, the window will not display a menubar, regardless of whether the desktop shell is showing it or not.

So, in other words:

  • TRUE → show menubar somewhere (either the desktop shell or the application)
  • FALSE → show the menubar in the desktop shell, or don’t show it at all
  • default is FALSE

However, in the top-level documentation for the GtkApplicationWindow class is this text:

If the desktop environment does not display the menubar, then GtkApplicationWindow will automatically show a menubar for it. This behaviour can be overridden with the GtkApplicationWindow:show-menubar property. If the desktop environment does not display the application menu, then it will automatically be included in the menubar or in the windows client-side decorations.

So, in other words, the default behaviour is claimed to be “show menubar somewhere (either the desktop shell or the application)”.

That’s a contradiction. Experimentation suggests that the default is indeed FALSE.