diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index 1992d4c3b9..2c2e773ab7 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -3497,7 +3497,7 @@ gtk_text_view_get_cursor_visible (GtkTextView *text_view) * * This function should be called in response to user input * (e.g. from derived classes that override the textview's - * #GtkWidget::key-press-event handler). + * event handlers). */ void gtk_text_view_reset_cursor_blink (GtkTextView *text_view) @@ -8288,7 +8288,7 @@ gtk_text_view_preedit_changed_handler (GtkIMContext *context, /* Keypress events are passed to input method even if cursor position is * not editable; so beep here if it's multi-key input sequence, input - * method will be reset in key-press-event handler. + * method will be reset in when the event is handled by GTK+. */ gtk_im_context_get_preedit_string (context, &str, &attrs, &cursor_pos); diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 96c7145aa6..57e52d0091 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -1703,17 +1703,12 @@ gtk_widget_class_init (GtkWidgetClass *klass) * @widget: the object which received the signal. * @event: the #GdkEvent which triggered this signal * - * The GTK+ main loop will emit three signals for each GDK event delivered - * to a widget: one generic ::event signal, another, more specific, - * signal that matches the type of event delivered (e.g. - * #GtkWidget::key-press-event) and finally a generic - * #GtkWidget::event-after signal. + * The GTK+ main loop will emit this signal for each GDK event delivered + * to a widget. * * Returns: %TRUE to stop other handlers from being invoked for the event * and to cancel the emission of the second specific ::event signal. - * %FALSE to propagate the event further and to allow the emission of - * the second signal. The ::event-after signal is emitted regardless of - * the return value. + * %FALSE to propagate the event further. */ widget_signals[EVENT] = g_signal_new (I_("event"), diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index 63561c0454..66bbcb2e4b 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -188,11 +188,8 @@ struct _GtkWidget * @focus: * @move_focus: Signal emitted when a change of focus is requested * @keynav_failed: Signal emitted if keyboard navigation fails. - * @event: The GTK+ main loop will emit three signals for each GDK - * event delivered to a widget: one generic ::event signal, another, - * more specific, signal that matches the type of event delivered - * (e.g. "key-press-event") and finally a generic "event-after" - * signal. + * @event: The GTK+ main loop will emit this signal for each GDK + * event delivered to a widget. * @key_press_event: Signal emitted when a key is pressed. * @key_release_event: Signal is emitted when a key is released. * @drag_begin: Signal emitted on the drag source when a drag is