[gtk+/gtk-3-22] FlowBox: Explain how to avoid inflated min size

[Daniel Boles <dboles src gnome org>]

commit 26104a30a582f62086c6a5410d2aaee6a4c3ff7f
Author: Daniel Boles <dboles src gnome org>
Date:   Tue Sep 12 22:48:58 2017 +0100

    FlowBox: Explain how to avoid inflated min size
    
    along the orthogonal orientation. It seems a FlowBox on its own can only
    handle being shrunk along its main orientation. The orthogonal requests
    a huge min size – reserving what it would need if the main orientation
    got its min size, which would flow all children in 1 line orthogonally.
    
    Adding it to a ScrolledWindow (any policy) enables free shrinking, so
    size_allocate() can reflow how users in this situation probably expect.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=787021

 gtk/gtkflowbox.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkflowbox.c b/gtk/gtkflowbox.c
index e9e2504..3f204b9 100644
--- a/gtk/gtkflowbox.c
+++ b/gtk/gtkflowbox.c
@@ -41,6 +41,10 @@
  * Reducing the height will require more columns, so a larger width will
  * be requested.
  *
+ * The size request of a GtkFlowBox alone may not be what you expect; if you
+ * need to be able to shrink it along both axes and dynamically reflow its
+ * children, you may have to wrap it in a #GtkScrolledWindow to enable that.
+ *
  * The children of a GtkFlowBox can be dynamically sorted and filtered.
  *
  * Although a GtkFlowBox must have only #GtkFlowBoxChild children,