From 489a38cceda02e62dc50367347930713f4454f95 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vivek=20Das=C2=A0Mohapatra?= Date: Thu, 11 Oct 2018 13:48:47 +0100 Subject: [PATCH 2/3] Document the new menu-bar-scrollbar frame parameter --- doc/lispref/frames.texi | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 2f9bb39886..601749d97e 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -601,6 +601,10 @@ Frame Layout frame unchanged, so the native height of the frame (see below) will change instead. +If the menu bar is drawn by GTK then its behavior when it would grow +wider than the root frame is controlled by the @code{menu-bar-scrollbar} +parameter (@pxref{Layout Parameters}). + @item Tool Bar @cindex internal tool bar @cindex external tool bar @@ -1814,6 +1818,23 @@ Layout Parameters (@pxref{Frame Geometry}) allows to derive whether the menu bar actually occupies one or more lines. +@vindex menu-bar-scrollbar@r{, a frame parameter} +@item menu-bar-scrollbar +The behavior of GTK menu bars when they would otherwise grow wider than +the frame. Valid values are: +@itemize +@item @code{always} - Scrollbar is present, menu bar scrolls when too wide. +@item @code{automatic} - Scrollbar appears when menubar grows too wide. +@item @code{forced-resize} - No scrollbar. Growing menubar forces a frame resize. +@item @code{nil} (or any other value) +@itemize +@item GTK >= 3.16 - No scrollbar. Menu bar is truncated if it grows too wide. +@item GTK < 3,16 - Same behavior as @code{forced-resize}. +@end itemize +@end itemize +It is worth noting that for GTK before 3.16 the scrollbar adds a significant +amount of vertical padding to the menubar: This appears to be unavoidable. + @vindex tool-bar-lines@r{, a frame parameter} @item tool-bar-lines The number of lines to use for the tool bar (@pxref{Tool Bar}). The -- 2.11.0