diff --git a/docs/reference/gtk/migrating-3xtoy.xml b/docs/reference/gtk/migrating-3xtoy.xml
index f140a4a876..1040c1234a 100644
--- a/docs/reference/gtk/migrating-3xtoy.xml
+++ b/docs/reference/gtk/migrating-3xtoy.xml
@@ -433,5 +433,11 @@
       layout of those children to change, if they unintentionally had hexpand
       set before.
     </para>
+
+    <para>
+      The behavior of the expand flag in #GtkTables #GtkAttachOptions has been
+       changed to (again) match the behavior in #GtkBox and in GTK+ 2.x. These
+       options don't cause the table itself to expand.
+    </para>
   </section>
 </chapter>