Index: gtk/gtkwidget.c
===================================================================
--- gtk/gtkwidget.c	(revision 18967)
+++ gtk/gtkwidget.c	(working copy)
@@ -2064,6 +2064,9 @@
    * a menu with clipboard commands. See <xref linkend="checklist-popup-menu"/> 
    * for an example of how to use this signal.
    *
+   * Unlike most other G_SIGNAL_ACTION signals, this signal should be used by 
+   * applications.
+   *
    * Returns: %TRUE if a menu was activated
    */
   widget_signals[POPUP_MENU] =
Index: ChangeLog
===================================================================
--- ChangeLog	(revision 18967)
+++ ChangeLog	(working copy)
@@ -1,3 +1,10 @@
+2007-11-05  Murray Cumming  <murrayc@murrayc.com>
+
+	* gtk/gtkwidget.c: (gtk_widget_class_init):
+	popup-menu signal documentation: Make it clearer that this should 
+	be used by applications and language bindings, unlike most other 
+	G_SIGNAL_ACTION signals. 
+
 2007-11-04  Richard Hult  <richard@imendio.com>
 
 	* gdk/quartz/gdkkeys-quartz.c: (maybe_update_keymap): Make shift
