[gtk+] Drop uses of @returns syntax

[Matthias Clasen <matthiasc src gnome org>]

commit 781471815200701ebc5e1f60cd1baa5460def784
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Nov 21 13:12:58 2011 -0500

    Drop uses of @returns syntax

 gtk/gtkrange.c  |    5 +++--
 gtk/gtkwidget.c |    6 ++++--
 2 files changed, 7 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c
index 4595759..ca7390f 100644
--- a/gtk/gtkrange.c
+++ b/gtk/gtkrange.c
@@ -377,8 +377,6 @@ gtk_range_class_init (GtkRangeClass *class)
    * @range: the #GtkRange that received the signal
    * @scroll: the type of scroll action that was performed
    * @value: the new value resulting from the scroll action
-   * @returns: %TRUE to prevent other handlers from being invoked for the
-   * signal, %FALSE to propagate the signal further
    *
    * The #GtkRange::change-value signal is emitted when a scroll action is
    * performed on a range.  It allows an application to determine the
@@ -396,6 +394,9 @@ gtk_range_class_init (GtkRangeClass *class)
    * It is not possible to use delayed update policies in an overridden
    * #GtkRange::change-value handler.
    *
+   * Returns: %TRUE to prevent other handlers from being invoked for
+   *     the signal, %FALSE to propagate the signal further
+   *
    * Since: 2.6
    */
   signals[CHANGE_VALUE] =
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 107fa47..0babbbb 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -2524,7 +2524,6 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * @x: the x coordinate of the current cursor position
    * @y: the y coordinate of the current cursor position
    * @time: the timestamp of the motion event
-   * @returns: whether the cursor position is in a drop zone
    *
    * The drag-motion signal is emitted on the drop site when the user
    * moves the cursor over the widget during a drag. The signal handler
@@ -2609,6 +2608,8 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    *    }
    * }
    * ]|
+   *
+   * Returns: whether the cursor position is in a drop zone
    */
   widget_signals[DRAG_MOTION] =
     g_signal_new (I_("drag-motion"),
@@ -2630,7 +2631,6 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * @x: the x coordinate of the current cursor position
    * @y: the y coordinate of the current cursor position
    * @time: the timestamp of the motion event
-   * @returns: whether the cursor position is in a drop zone
    *
    * The ::drag-drop signal is emitted on the drop site when the user drops
    * the data onto the widget. The signal handler must determine whether
@@ -2642,6 +2642,8 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * directly or in a #GtkWidget::drag-data-received handler which gets
    * triggered by calling gtk_drag_get_data() to receive the data for one
    * or more of the supported targets.
+   *
+   * Returns: whether the cursor position is in a drop zone
    */
   widget_signals[DRAG_DROP] =
     g_signal_new (I_("drag-drop"),