From 49765c38a54d7f9a19682ba973e7f5c8a001a29e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timm=20B=C3=A4der?= <mail@baedert.org>
Date: Sat, 29 Dec 2018 09:53:16 +0100
Subject: [PATCH] migration guide: Add a paragraph about GtkBox's pack-type

---
 docs/reference/gtk/migrating-3to4.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index fcb430adad..111f6f6975 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -193,6 +193,17 @@
       </para>
     </section>
 
+    <section>
+      <title>Stop using GtkBox's pack-type child property</title>
+      <para>
+        In order to improve performance and simplify the widget, GtkBox lost its
+        'pack-type' child property. In GTK+4, every GtkBox instance has a simple
+        list of child widgets that it allocates from start to end.
+        The old behavior of pack-type=END can be emulated by simply making the
+        box child in the center hexpand and right-align the ones at the end.
+      </para>
+    </section>
+
   </section>
 
   <section>