gtk: Add missing return annotations

gtk/gtkaccelgroup.c

@@ -505,6 +505,8 @@ out:
  *
  * If the parse operation fails, @accelerator_key and @accelerator_mods will
  * be set to 0 (zero).
+ *
+ * Returns: whether parsing succeeded
  */
 gboolean
 gtk_accelerator_parse (const char      *accelerator,

gtk/gtkeditable.c

@@ -1231,6 +1231,8 @@ gtk_editable_delegate_get_property (GObject    *object,
  * delegate the %GTK_ACCESSIBLE_ROLE_TEXT_BOX role, or you can
  * change your tree to allow this function to work.
  *
+ * Returns: the accessible platform state of the delegate
+ *
  * Since: 4.10
  */
 gboolean

gtk/gtkeventcontrollerkey.c

@@ -237,6 +237,8 @@ gtk_event_controller_key_class_init (GtkEventControllerKeyClass *klass)
    *   pointer buttons.
    *
    * Emitted whenever the state of modifier keys and pointer buttons change.
+   *
+   * Returns: whether to ignore modifiers
    */
   signals[MODIFIERS] =
     g_signal_new (I_("modifiers"),

gtk/gtkpaned.c

@@ -558,6 +558,8 @@ gtk_paned_class_init (GtkPanedClass *class)
    * This is a [keybinding signal](class.SignalAction.html).
    *
    * The default binding is <kbd>F6</kbd>.
+   *
+   * Returns: whether the behavior was cycled
    */
   signals [CYCLE_CHILD_FOCUS] =
     g_signal_new (I_("cycle-child-focus"),
@@ -582,6 +584,8 @@ gtk_paned_class_init (GtkPanedClass *class)
    * This is a [keybinding signal](class.SignalAction.html).
    *
    * The default binding is <kbd>Tab</kbd>.
+   *
+   * Return: whether handle focus was toggled
    */
   signals [TOGGLE_HANDLE_FOCUS] =
     g_signal_new (I_("toggle-handle-focus"),
@@ -603,6 +607,8 @@ gtk_paned_class_init (GtkPanedClass *class)
    * Emitted to move the handle with key bindings.
    *
    * This is a [keybinding signal](class.SignalAction.html).
+   *
+   * Returns: whether the handle was moved
    */
   signals[MOVE_HANDLE] =
     g_signal_new (I_("move-handle"),
@@ -628,6 +634,8 @@ gtk_paned_class_init (GtkPanedClass *class)
    * This is a [keybinding signal](class.SignalAction.html).
    *
    * The default binding for this signal is <kbd>F8</kbd>.
+   *
+   * Returns: whether the behavior was cycled
    */
   signals [CYCLE_HANDLE_FOCUS] =
     g_signal_new (I_("cycle-handle-focus"),
@@ -653,6 +661,8 @@ gtk_paned_class_init (GtkPanedClass *class)
    *
    * The default binding for this signal is <kbd>Return</kbd> or
    * <kbd>Space</kbd>.
+   *
+   * Returns: whether the position was accepted
    */
   signals [ACCEPT_POSITION] =
     g_signal_new (I_("accept-position"),
@@ -679,6 +689,8 @@ gtk_paned_class_init (GtkPanedClass *class)
    * This is a [keybinding signal](class.SignalAction.html).
    *
    * The default binding for this signal is <kbd>Escape</kbd>.
+   *
+   * Returns: whether the position was canceled
    */
   signals [CANCEL_POSITION] =
     g_signal_new (I_("cancel-position"),

gtk/gtkscrolledwindow.c

@@ -776,6 +776,8 @@ gtk_scrolled_window_class_init (GtkScrolledWindowClass *class)
    *
    * The horizontal or vertical adjustment is updated which triggers a
    * signal that the scrolled window’s child may listen to and scroll itself.
+   *
+   * Returns: whether the scroll happened
    */
   signals[SCROLL_CHILD] =
     g_signal_new (I_("scroll-child"),

gtk/gtktext.c

@@ -6876,6 +6876,8 @@ gtk_text_set_input_purpose (GtkText         *self,
  * @self: a `GtkText`
  *
  * Gets the input purpose of the `GtkText`.
+ *
+ * Returns: the input purpose
  */
 GtkInputPurpose
 gtk_text_get_input_purpose (GtkText *self)
@@ -6925,6 +6927,8 @@ gtk_text_set_input_hints (GtkText       *self,
  * @self: a `GtkText`
  *
  * Gets the input hints of the `GtkText`.
+ *
+ * Returns: the input hints
  */
 GtkInputHints
 gtk_text_get_input_hints (GtkText *self)

gtk/gtktextview.c

@@ -10058,6 +10058,8 @@ gtk_text_view_set_input_purpose (GtkTextView     *text_view,
  * @text_view: a `GtkTextView`
  *
  * Gets the `input-purpose` of the `GtkTextView`.
+ *
+ * Returns: the input purpose
  */
 GtkInputPurpose
 gtk_text_view_get_input_purpose (GtkTextView *text_view)
@@ -10106,6 +10108,8 @@ gtk_text_view_set_input_hints (GtkTextView   *text_view,
  * @text_view: a `GtkTextView`
  *
  * Gets the `input-hints` of the `GtkTextView`.
+ *
+ * Returns: the input hints
  */
 GtkInputHints
 gtk_text_view_get_input_hints (GtkTextView *text_view)