gtk: port missing array annotations from Vala bindings

https://bugzilla.gnome.org/show_bug.cgi?id=730745

gtk/deprecated/gtkcolorsel.h

@@ -47,16 +47,24 @@ typedef struct _GtkColorSelection       GtkColorSelection;
 typedef struct _GtkColorSelectionPrivate  GtkColorSelectionPrivate;
 typedef struct _GtkColorSelectionClass  GtkColorSelectionClass;
 
+/**
+ * GtkColorSelectionChangePaletteFunc:
+ * @colors: (array length=n_colors): Array of colors
+ * @n_colors: Number of colors in the array
+ *
+ * Deprecated: 3.4
+ */
 typedef void (* GtkColorSelectionChangePaletteFunc) (const GdkColor    *colors,
                                                      gint               n_colors);
 
 /**
  * GtkColorSelectionChangePaletteWithScreenFunc:
  * @screen:
- * @colors:
+ * @colors: (array length=n_colors): Array of colors
- * @n_colors:
+ * @n_colors: Number of colors in the array
  *
  * Since: 2.2
+ * Deprecated: 3.4
  */
 typedef void (* GtkColorSelectionChangePaletteWithScreenFunc) (GdkScreen         *screen,
 							       const GdkColor    *colors,

gtk/gtkbindings.h

@@ -126,7 +126,7 @@ struct _GtkBindingArg
  * @next: implementation detail
  * @signal_name: the action signal to be emitted
  * @n_args: number of arguments specified for the signal
- * @args: the arguments specified for the signal
+ * @args: (array length=n_args): the arguments specified for the signal
  *
  * A GtkBindingSignal stores the necessary information to
  * activate a widget in response to a key press via a signal

gtk/gtkimcontextsimple.c

@@ -1213,7 +1213,7 @@ gtk_im_context_simple_get_preedit_string (GtkIMContext   *context,
 /**
  * gtk_im_context_simple_add_table: (skip)
  * @context_simple: A #GtkIMContextSimple
- * @data: the table 
+ * @data: (array): the table
  * @max_seq_len: Maximum length of a sequence in the table
  *               (cannot be greater than #GTK_MAX_COMPOSE_LEN)
  * @n_seqs: number of sequences in the table

gtk/gtkrecentmanager.h

@@ -58,7 +58,8 @@ typedef struct _GtkRecentManagerPrivate GtkRecentManagerPrivate;
  *   “%f” and “%u” escape characters which will be expanded
  *   to the resource file path and URI respectively when the command line
  *   is retrieved;
- * @groups: a vector of strings containing groups names;
+ * @groups: (array zero-terminated=1): a vector of strings containing
+ *   groups names;
  * @is_private: whether this resource should be displayed only by the
  *   applications that have registered it or not.
  *

gtk/gtkselection.c

@@ -1214,7 +1214,8 @@ gtk_selection_data_get_format (const GtkSelectionData *selection_data)
 
 /**
  * gtk_selection_data_get_data: (skip)
- * @selection_data: a pointer to a #GtkSelectionData-struct.
+ * @selection_data: (array) (element-type guint8): a pointer to a
+ *   #GtkSelectionData-struct.
  *
  * Retrieves the raw data of the selection.
  *

gtk/gtktextbufferrichtext.h

@@ -55,7 +55,7 @@ typedef guint8 * (* GtkTextBufferSerializeFunc)   (GtkTextBuffer     *register_b
  * @register_buffer: the #GtkTextBuffer the format is registered with
  * @content_buffer: the #GtkTextBuffer to deserialize into
  * @iter: insertion point for the deserialized text
- * @data: data to deserialize
+ * @data: (array length=length): data to deserialize
  * @length: length of @data
  * @create_tags: %TRUE if deserializing may create tags
  * @user_data: user data that was specified when registering the format

gtk/gtktreemodel.c

@@ -2544,7 +2544,7 @@ gtk_tree_row_reference_deleted (GObject     *proxy,
  * @proxy: a #GObject
  * @path: the parent path of the reordered signal
  * @iter: the iter pointing to the parent of the reordered
- * @new_order: the new order of rows
+ * @new_order: (array): the new order of rows
  *
  * Lets a set of row reference created by
  * gtk_tree_row_reference_new_proxy() know that the