diff options
Diffstat (limited to 'gtk/gtkmenu.c')
| -rw-r--r-- | gtk/gtkmenu.c | 10 |
1 files changed, 6 insertions, 4 deletions
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, |