diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 21e71de682..e9c1b8ff72 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2004-01-22  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/migrating-checklist.sgml: Point to GtkEntry as an example of
+	a widget that uses a custom function to position its popup menu.
+
 2004-01-22  Federico Mena Quintero  <federico@ximian.com>
 
 	* gtk/migrating-checklist.sgml: New chapter with a "Migration
diff --git a/docs/reference/gtk/migrating-checklist.sgml b/docs/reference/gtk/migrating-checklist.sgml
index 51a1e9b316..fb6b167c38 100644
--- a/docs/reference/gtk/migrating-checklist.sgml
+++ b/docs/reference/gtk/migrating-checklist.sgml
@@ -127,7 +127,8 @@ my_widget_popup_menu_handler (GtkWidget *widget)
 	in the case where the <parameter>event</parameter> is
 	<constant>NULL</constant>.  This function should compute the
 	desired position for a menu when it is invoked through the
-	keyboard.
+	keyboard.  For example, <xref linkend="GtkEntry"/> aligns the
+	top edge of its popup menu with the bottom edge of the entry.
       </para>
     </note>
   </section>