From: Matthias Clasen <mclasen@redhat.com>
Date: Thu, 7 Feb 2019 18:12:07 +0000 (-0500)
Subject: migration guide: Mention --3to4
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~21^2~761^2~2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=edd3f28a1d7713d77fa5267c8453b2001b79437f;p=gtk4.git

migration guide: Mention --3to4
---

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index c5e9ef148c..4fbafaa6a8 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -329,6 +329,17 @@
       </para>
     </section>
 
+    <section>
+      <title>Adapt to GtkStack API changes</title>
+      <para>
+        The GtkStack child properties have been converted into child meta object.
+        Instead of gtk_container_child_set (stack, child, …), you can now use
+        g_object_set (gtk_stack_get_page (stack, child), …). In .ui files, the
+        GtkStackPage objects must be created explicitly, and take the child widget
+        as property. gtk4-builder-tool can help with this conversion.
+      </para>
+    </section>
+
     <section>
       <title>Adapt to GtkStyleContext API changes</title>
       <para>
@@ -574,6 +585,14 @@
       </para>
     </section>
 
+    <section>
+      <title>Convert .ui files</title>
+      <para>
+        The simplify command of gtk4-builder-tool has gained a --3to4 option, which
+        can help with some of the required changes in .ui files, such as converting
+        child properties to child meta objects.
+      </para>
+    </section>
   </section>
 
 </chapter>