[gtk+/composite-templates] Bug 680822 â Document return value of GtkWidget::draw

[Juan Pablo Ugarte <jpu src gnome org>]

commit 5bbc7b8fc58e9d694fda3f42ac56a9e35aa6ca61
Author: Philip Withnall <philip tecnocode co uk>
Date:   Mon Jul 30 12:38:59 2012 +0200

    Bug 680822 â Document return value of GtkWidget::draw
    
    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 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index c7a2342..14b53ed 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"),