From f92a092bac8ff4664ab6944c3493bf61d7974bd9 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Mon, 30 Jul 2012 12:38:59 +0200 Subject: [PATCH] =?UTF-8?q?Bug=20680822=20=E2=80=94=20Document=20return=20?= =?UTF-8?q?value=20of=20GtkWidget::draw?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Document the boolean accumulator used by GtkWidget::draw and a few other GtkWidget signals. Closes: https://bugzilla.gnome.org/show_bug.cgi?id=680822 --- gtk/gtkwidget.c | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index c7a2342b3b..14b53ed30b 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -1721,6 +1721,9 @@ gtk_widget_class_init (GtkWidgetClass *klass) * restore it. The signal emission takes care of calling cairo_save() * before and cairo_restore() after invoking the handler. * + * Returns: %TRUE to stop other handlers from being invoked for the event. + % %FALSE to propagate the event further. + * * Since: 3.0 */ widget_signals[DRAW] = @@ -1739,6 +1742,9 @@ gtk_widget_class_init (GtkWidgetClass *klass) * GtkWidget::mnemonic-activate: * @widget: the object which received the signal. * @arg1: + * + * Returns: %TRUE to stop other handlers from being invoked for the event. + * %FALSE to propagate the event further. */ widget_signals[MNEMONIC_ACTIVATE] = g_signal_new (I_("mnemonic-activate"), @@ -3037,6 +3043,9 @@ gtk_widget_class_init (GtkWidgetClass *klass) * GtkWidget::show-help: * @widget: the object which received the signal. * @help_type: + * + * Returns: %TRUE to stop other handlers from being invoked for the event. + * %FALSE to propagate the event further. */ widget_signals[SHOW_HELP] = g_signal_new (I_("show-help"),