[gtk+/gtk-3-22] widget: Document signal mnemonic-activate

[Daniel Boles <dboles src gnome org>]

commit f8af23553b37c4a03264651c500f1ba9c1c7c3d0
Author: Daniel Boles <dboles src gnome org>
Date:   Sun Feb 12 15:52:02 2017 +0000

    widget: Document signal mnemonic-activate
    
    Name the extra bool argument, and move the explanatory paragraph from
    the emitting method to the signal, with some minor tweaks to wording.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=778534

 gtk/gtkwidget.c |   11 +++++------
 1 files changed, 5 insertions(+), 6 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index f91f07b..1e5749e 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -2010,7 +2010,10 @@ G_GNUC_END_IGNORE_DEPRECATIONS
   /**
    * GtkWidget::mnemonic-activate:
    * @widget: the object which received the signal.
-   * @arg1:
+   * @group_cycling: %TRUE if there are other widgets with the same mnemonic
+   *
+   * The default handler for this signal activates @widget if @group_cycling
+   * is %FALSE, or just makes @widget grab focus if @group_cycling is %TRUE.
    *
    * Returns: %TRUE to stop other handlers from being invoked for the event.
    * %FALSE to propagate the event further.
@@ -6839,14 +6842,10 @@ _gtk_widget_get_accel_path (GtkWidget *widget,
 /**
  * gtk_widget_mnemonic_activate:
  * @widget: a #GtkWidget
- * @group_cycling:  %TRUE if there are other widgets with the same mnemonic
+ * @group_cycling: %TRUE if there are other widgets with the same mnemonic
  *
  * Emits the #GtkWidget::mnemonic-activate signal.
  *
- * The default handler for this signal activates the @widget if
- * @group_cycling is %FALSE, and just grabs the focus if @group_cycling
- * is %TRUE.
- *
  * Returns: %TRUE if the signal has been handled
  */
 gboolean