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 e65d19befe808724e7e91000bbfade2701382980..0b949d24f6161754b91fce0cd70fe6bf56b40689 100644 (file)
--- 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>