From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 22 May 2020 22:46:51 +0000 (-0400)
Subject: docs: Mention app menus in the migration guide
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~16^2~123^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=1038b9b8a1b88473d526bfad2c0890ff8af06923;p=gtk4.git

docs: Mention app menus in the migration guide
---

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index e65d19befe..0b949d24f6 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -245,6 +245,17 @@
         the amount of work you have to do at the time of the switch.
       </para>
     </section>
+
+    <section>
+      <title>Stop using app menus</title>
+      <para>
+        GNOME has stopped using exported app menus some time ago, and GTK 4 is
+        dropping the GtkApplication APIs that are related to app menus. If you
+        want to transparently support menubars on OS X, you can integrate the
+        items from your app menu into your menubar, and keep using
+        gtk_application_set_menubar().
+      </para>
+    </section>
   </section>
 
   <section>