diff --git a/docs/reference/gtk/migrating-2to3.xml b/docs/reference/gtk/migrating-2to3.xml
index 81fa827bc1..121c44879c 100644
--- a/docs/reference/gtk/migrating-2to3.xml
+++ b/docs/reference/gtk/migrating-2to3.xml
@@ -662,6 +662,18 @@ gtk_arrow_draw (GtkWidget *widget,
     </para>
   </section>
 
+  <section>
+    <title>Resize grips</title>
+
+    <para>
+     The resize grip functionality has been moved from #GtkStatusbar
+     to #GtkWindow. Any window can now have resize grips, regardless whether
+     it has a statusbar or not. The functions
+     gtk_statusbar_set_has_resize_grip() and gtk_statusbar_get_has_resize_grip()
+     have disappeared, and instead there are now
+     gtk_window_set_has_resize_grip() and gtk_window_get_has_resize_grip().
+  </section>
+
   <section>
     <title>Prevent mixed linkage</title>
     <para>