diff --git a/documentation/migration.html b/documentation/migration.html
index c7c31dba6..e95fc54fd 100644
--- a/documentation/migration.html
+++ b/documentation/migration.html
@@ -110,5 +110,8 @@ If you use the old <TT>label()</TT> methods on an image, the
 widget's <TT>image()</TT> method is called to set the image
 as the label.
 
+<P>Image labels in menu items must still use the old labeltype
+mechanism to preserve source compatibility.
+
 </BODY>
 </HTML>