From fda0eb309b33b2bf078caa33d92c89fcf7cdc880 Mon Sep 17 00:00:00 2001 From: Tim Janik Date: Fri, 17 Aug 2007 09:36:15 +0000 Subject: [PATCH] Clarified activate_time docs. Fri Aug 17 11:36:29 2007 Tim Janik * gtk/gtkmenu.c (gtk_menu_popup): Clarified activate_time docs. svn path=/trunk/; revision=18643 --- ChangeLog | 4 ++++ gtk/gtkmenu.c | 10 ++++++---- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 09f3c33012..0e068f87f7 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Fri Aug 17 11:36:29 2007 Tim Janik + + * gtk/gtkmenu.c (gtk_menu_popup): Clarified activate_time docs. + 2007-08-16 Cody Russell * gdk/win32/cursor.bdf: Committing changes to the source diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c index 6e99ce0bf1..7d44efbfd3 100644 --- a/gtk/gtkmenu.c +++ b/gtk/gtkmenu.c @@ -1251,10 +1251,12 @@ popup_grab_on_window (GdkWindow *window, * a mouse button press, such as a mouse button release or a keypress, * @button should be 0. * - * The @activate_time parameter should be the time stamp of the event that - * initiated the popup. If such an event is not available, use - * gtk_get_current_event_time() instead. - * + * The @activate_time parameter is used to conflict-resolve initiation of + * concurrent requests for mouse/keyboard grab requests. To function + * properly, this needs to be the time stamp of the user event (such as + * a mouse click or key press) that caused the initiation of the popup. + * Only if no such event is available, gtk_get_current_event_time() can + * be used instead. */ void gtk_menu_popup (GtkMenu *menu,