Documented explicitely that geometry requests from mapped slaves (panes) are ignored by the panedwindow widgetbug_1714535fff

1 files changed, 9 insertions, 0 deletions

diff --git a/doc/panedwindow.n b/doc/panedwindow.n
index a686ce1..53a7238 100644
--- a/doc/panedwindow.n
+++ b/doc/panedwindow.n
@@ -283,6 +283,15 @@ adjusted.
 When a pane is resized from outside (e.g. it is packed to expand and
 fill, and the containing toplevel is resized), space is added to the final
 (rightmost or bottommost) pane in the window.
+.PP
+Unlike slave windows managed by e.g. pack or grid, the panes managed by a
+panedwindow do not change width or height to accomodate changes in the
+requested widths or heights of the panes, once these have become mapped.
+Therefore it may be advisable, particularly when creating layouts
+interactively, to not add a pane to the panedwindow widget until after the
+geometry requests of that pane has been finalized (i.e., all components of
+the pane inserted, all options affecting geometry set to their proper
+values, etc.).
 .SH "SEE ALSO"
 ttk::panedwindow(n)
 .SH KEYWORDS