[GI] Mark unintrospectable constructs as (skip)

Also adds 'Rename to:' annotation to some constructs replacing the
skipped ones.

gdk/gdk.c

@@ -707,7 +707,7 @@ gdk_threads_init (void)
 }
 
 /**
- * gdk_threads_set_lock_functions:
+ * gdk_threads_set_lock_functions: (skip)
  * @enter_fn:   function called to guard GDK
  * @leave_fn: function called to release the guard
  *
@@ -827,6 +827,7 @@ gdk_threads_dispatch_free (gpointer data)
  * Return value: the ID (greater than 0) of the event source.
  *
  * Since: 2.12
+ * Rename to: gdk_threads_add_idle
  */
 guint
 gdk_threads_add_idle_full (gint           priority,
@@ -850,7 +851,7 @@ gdk_threads_add_idle_full (gint           priority,
 }
 
 /**
- * gdk_threads_add_idle:
+ * gdk_threads_add_idle: (skip)
  * @function: function to call
  * @data:     data to pass to @function
  *
@@ -929,6 +930,7 @@ gdk_threads_add_idle (GSourceFunc    function,
  * Return value: the ID (greater than 0) of the event source.
  * 
  * Since: 2.12
+ * Rename to: gdk_threads_add_timeout
  */
 guint
 gdk_threads_add_timeout_full (gint           priority,
@@ -954,7 +956,7 @@ gdk_threads_add_timeout_full (gint           priority,
 }
 
 /**
- * gdk_threads_add_timeout:
+ * gdk_threads_add_timeout: (skip)
  * @interval: the time between calls to the function, in milliseconds
  *             (1/1000ths of a second)
  * @function: function to call
@@ -995,6 +997,7 @@ gdk_threads_add_timeout (guint       interval,
  *  Return value: the ID (greater than 0) of the event source.
  * 
  * Since: 2.14
+ * Rename to: gdk_threads_add_timeout_seconds
  */
 guint
 gdk_threads_add_timeout_seconds_full (gint           priority,
@@ -1020,7 +1023,7 @@ gdk_threads_add_timeout_seconds_full (gint           priority,
 }
 
 /**
- * gdk_threads_add_timeout_seconds:
+ * gdk_threads_add_timeout_seconds: (skip)
  * @interval: the time between calls to the function, in seconds
  * @function: function to call
  * @data:     data to pass to @function

gdk/gdkdevice.c

@@ -377,7 +377,7 @@ gdk_device_get_property (GObject    *object,
 }
 
 /**
- * gdk_device_get_state:
+ * gdk_device_get_state: (skip)
  * @device: a #GdkDevice.
  * @window: a #GdkWindow.
  * @axes: an array of doubles to store the values of the axes of @device in,
@@ -493,7 +493,7 @@ gdk_device_get_window_at_position (GdkDevice  *device,
 }
 
 /**
- * gdk_device_get_history:
+ * gdk_device_get_history: (skip)
  * @device: a #GdkDevice
  * @window: the window with respect to which which the event coordinates will be reported
  * @start: starting timestamp for range of events to return
@@ -1024,9 +1024,9 @@ gdk_device_list_axes (GdkDevice *device)
 }
 
 /**
- * gdk_device_get_axis_value:
+ * gdk_device_get_axis_value: (skip)
  * @device: a pointer #GdkDevice.
- * @axes: pointer to an array of axes
+ * @axes: (array): pointer to an array of axes
  * @axis_label: #GdkAtom with the axis label.
  * @value: location to store the found value.
  *
@@ -1071,11 +1071,11 @@ gdk_device_get_axis_value (GdkDevice *device,
 }
 
 /**
- * gdk_device_get_axis:
+ * gdk_device_get_axis: (skip)
  * @device: a #GdkDevice
- * @axes: pointer to an array of axes
+ * @axes: (array): pointer to an array of axes
  * @use: the use to look for
- * @value: location to store the found value.
+ * @value: (out): location to store the found value.
  *
  * Interprets an array of double as axis values for a given device,
  * and locates the value in the array for a given axis use.

gdk/gdkdisplay.c

@@ -1695,7 +1695,7 @@ gdk_event_send_client_message_for_display (GdkDisplay     *display,
 }
 
 /**
- * gdk_display_add_client_message_filter:
+ * gdk_display_add_client_message_filter: (skip)
  * @display: a #GdkDisplay for which this message filter applies
  * @message_type: the type of ClientMessage events to receive.
  *   This will be checked against the @message_type field
@@ -1719,7 +1719,7 @@ gdk_display_add_client_message_filter (GdkDisplay   *display,
 }
 
 /**
- * gdk_add_client_message_filter:
+ * gdk_add_client_message_filter: (skip)
  * @message_type: the type of ClientMessage events to receive. This will be
  *     checked against the <structfield>message_type</structfield> field of the
  *     XClientMessage event struct.

gdk/gdkpango.c

@@ -190,11 +190,13 @@ layout_iter_get_line_clip_region (PangoLayoutIter *iter,
 }
 
 /**
- * gdk_pango_layout_line_get_clip_region:
+ * gdk_pango_layout_line_get_clip_region: (skip)
  * @line: a #PangoLayoutLine 
  * @x_origin: X pixel where you intend to draw the layout line with this clip
  * @y_origin: baseline pixel where you intend to draw the layout line with this clip
- * @index_ranges: array of byte indexes into the layout, where even members of array are start indexes and odd elements are end indexes
+ * @index_ranges: (array): array of byte indexes into the layout,
+ *     where even members of array are start indexes and odd elements
+ *     are end indexes
  * @n_ranges: number of ranges in @index_ranges, i.e. half the size of @index_ranges
  * 
  * Obtains a clip region which contains the areas where the given
@@ -239,7 +241,7 @@ gdk_pango_layout_line_get_clip_region (PangoLayoutLine *line,
 }
 
 /**
- * gdk_pango_layout_get_clip_region:
+ * gdk_pango_layout_get_clip_region: (skip)
  * @layout: a #PangoLayout 
  * @x_origin: X pixel where you intend to draw the layout with this clip
  * @y_origin: Y pixel where you intend to draw the layout with this clip

gdk/gdkselection.c

@@ -226,7 +226,7 @@ gdk_selection_send_notify_for_display (GdkDisplay       *display,
 }
 
 /**
- * gdk_selection_property_get:
+ * gdk_selection_property_get: (skip)
  * @requestor: the window on which the data is stored
  * @data: location to store a pointer to the retrieved data.
        If the retrieval failed, %NULL we be stored here, otherwise, it

gdk/gdkwindow.c

@@ -2411,7 +2411,7 @@ gdk_window_peek_children (GdkWindow *window)
 }
 
 /**
- * gdk_window_add_filter:
+ * gdk_window_add_filter: (skip)
  * @window: a #GdkWindow
  * @function: filter callback
  * @data: data to pass to filter callback
@@ -2472,7 +2472,7 @@ gdk_window_add_filter (GdkWindow     *window,
 }
 
 /**
- * gdk_window_remove_filter:
+ * gdk_window_remove_filter: (skip)
  * @window: a #GdkWindow
  * @function: previously-added filter function
  * @data: user data for previously-added filter function
@@ -10896,7 +10896,7 @@ gdk_property_get (GdkWindow  *window,
 }
 
 /**
- * gdk_property_change:
+ * gdk_property_change: (skip)
  * @window: a #GdkWindow
  * @property: the property to change
  * @type: the new type for the property. If @mode is

gtk/gtkactiongroup.c

@@ -1003,9 +1003,9 @@ gtk_action_group_list_actions (GtkActionGroup *action_group)
 
 
 /**
- * gtk_action_group_add_actions:
+ * gtk_action_group_add_actions: (skip)
  * @action_group: the action group
- * @entries: an array of action descriptions
+ * @entries: (array length=n_entries): an array of action descriptions
  * @n_entries: the number of entries
  * @user_data: data to pass to the action callbacks
  *
@@ -1054,9 +1054,9 @@ shared_data_unref (gpointer data)
 
 
 /**
- * gtk_action_group_add_actions_full:
+ * gtk_action_group_add_actions_full: (skip)
  * @action_group: the action group
- * @entries: an array of action descriptions
+ * @entries: (array length=n_entries): an array of action descriptions
  * @n_entries: the number of entries
  * @user_data: data to pass to the action callbacks
  * @destroy: destroy notification callback for @user_data
@@ -1134,9 +1134,9 @@ gtk_action_group_add_actions_full (GtkActionGroup       *action_group,
 }
 
 /**
- * gtk_action_group_add_toggle_actions:
+ * gtk_action_group_add_toggle_actions: (skip)
  * @action_group: the action group
- * @entries: an array of toggle action descriptions
+ * @entries: (array length=n_entries): an array of toggle action descriptions
  * @n_entries: the number of entries
  * @user_data: data to pass to the action callbacks
  *
@@ -1162,9 +1162,9 @@ gtk_action_group_add_toggle_actions (GtkActionGroup             *action_group,
 
 
 /**
- * gtk_action_group_add_toggle_actions_full:
+ * gtk_action_group_add_toggle_actions_full: (skip)
  * @action_group: the action group
- * @entries: an array of toggle action descriptions
+ * @entries: (array length=n_entries): an array of toggle action descriptions
  * @n_entries: the number of entries
  * @user_data: data to pass to the action callbacks
  * @destroy: destroy notification callback for @user_data
@@ -1243,9 +1243,9 @@ gtk_action_group_add_toggle_actions_full (GtkActionGroup             *action_gro
 }
 
 /**
- * gtk_action_group_add_radio_actions:
+ * gtk_action_group_add_radio_actions: (skip)
  * @action_group: the action group
- * @entries: an array of radio action descriptions
+ * @entries: (array length=n_entries): an array of radio action descriptions
  * @n_entries: the number of entries
  * @value: the value of the action to activate initially, or -1 if
  *   no action should be activated
@@ -1276,9 +1276,9 @@ gtk_action_group_add_radio_actions (GtkActionGroup            *action_group,
 }
 
 /**
- * gtk_action_group_add_radio_actions_full:
+ * gtk_action_group_add_radio_actions_full: (skip)
  * @action_group: the action group
- * @entries: an array of radio action descriptions
+ * @entries: (array length=n_entries): an array of radio action descriptions
  * @n_entries: the number of entries
  * @value: the value of the action to activate initially, or -1 if
  *   no action should be activated

gtk/gtkbindings.c

@@ -577,13 +577,13 @@ gtk_binding_entry_activate (GtkBindingEntry *entry,
 }
 
 /**
- * gtk_binding_set_new:
+ * gtk_binding_set_new: (skip)
  * @set_name: unique name of this binding set
  *
  * GTK+ maintains a global list of binding sets. Each binding set has
  * a unique name which needs to be specified upon creation.
  *
- * Return value: new binding set
+ * Return value: (transfer full): new binding set
  */
 GtkBindingSet*
 gtk_binding_set_new (const gchar *set_name)
@@ -607,14 +607,15 @@ gtk_binding_set_new (const gchar *set_name)
 }
 
 /**
- * gtk_binding_set_by_class:
+ * gtk_binding_set_by_class: (skip)
  * @object_class: a valid #GObject class
  *
  * This function returns the binding set named after the type name of
  * the passed in class structure. New binding sets are created on
  * demand by this function.
  *
- * Return value: the binding set corresponding to @object_class
+ * Return value: (transfer full): the binding set corresponding to
+ *     @object_class
  */
 GtkBindingSet*
 gtk_binding_set_by_class (gpointer object_class)

gtk/gtkclipboard.c

@@ -565,10 +565,10 @@ gtk_clipboard_set_contents (GtkClipboard         *clipboard,
 }
 
 /**
- * gtk_clipboard_set_with_data:
+ * gtk_clipboard_set_with_data: (skip)
  * @clipboard: a #GtkClipboard
- * @targets: array containing information about the available forms for the
- *     clipboard data
+ * @targets: (array length=n_targets): array containing information
+ *     about the available forms for the clipboard data
  * @n_targets: number of elements in @targets
  * @get_func: (scope async): function to call to get the actual clipboard data
  * @clear_func: (scope async): when the clipboard contents are set again,
@@ -602,10 +602,10 @@ gtk_clipboard_set_with_data (GtkClipboard          *clipboard,
 }
 
 /**
- * gtk_clipboard_set_with_owner:
+ * gtk_clipboard_set_with_owner: (skip)
  * @clipboard: a #GtkClipboard
- * @targets: array containing information about the available forms for
- *     the clipboard data
+ * @targets: (array length=n_targets): array containing information
+ *     about the available forms for the clipboard data
  * @n_targets: number of elements in @targets
  * @get_func: (scope async): function to call to get the actual clipboard data
  * @clear_func: (scope async): when the clipboard contents are set again,

gtk/gtkcolorsel.c

@@ -3013,7 +3013,7 @@ gtk_color_selection_palette_to_string (const GdkColor *colors,
 }
 
 /**
- * gtk_color_selection_set_change_palette_with_screen_hook:
+ * gtk_color_selection_set_change_palette_with_screen_hook: (skip)
  * @func: a function to call when the custom palette needs saving.
  * 
  * Installs a global function to be called whenever the user tries to

gtk/gtkcombobox.c

@@ -4944,7 +4944,7 @@ gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box)
 }
 
 /**
- * gtk_combo_box_get_row_separator_func:
+ * gtk_combo_box_get_row_separator_func: (skip)
  * @combo_box: a #GtkComboBox
  *
  * Returns the current row separator function.

gtk/gtkimcontextsimple.c

@@ -1132,7 +1132,7 @@ gtk_im_context_simple_get_preedit_string (GtkIMContext   *context,
 }
 
 /**
- * gtk_im_context_simple_add_table:
+ * gtk_im_context_simple_add_table: (skip)
  * @context_simple: A #GtkIMContextSimple
  * @data: the table 
  * @max_seq_len: Maximum length of a sequence in the table

gtk/gtkliststore.c

@@ -304,6 +304,7 @@ gtk_list_store_new (gint n_columns,
  * Non-vararg creation function.  Used primarily by language bindings.
  *
  * Return value: (transfer none): a new #GtkListStore
+ * Rename to: gtk_list_store_new
  **/
 GtkListStore *
 gtk_list_store_newv (gint   n_columns,
@@ -920,6 +921,7 @@ gtk_list_store_set_valist_internal (GtkListStore *list_store,
  * change is not known until run-time.
  *
  * Since: 2.12
+ * Rename to: gtk_list_store_set
  */
 void
 gtk_list_store_set_valuesv (GtkListStore *list_store,
@@ -1531,7 +1533,7 @@ gtk_list_store_reorder_func (GSequenceIter *a,
 }
   
 /**
- * gtk_list_store_reorder:
+ * gtk_list_store_reorder: (skip)
  * @store: A #GtkListStore.
  * @new_order: (array): an array of integers mapping the new position of each child
  *      to its old position before the re-ordering,

gtk/gtkmain.c

@@ -935,7 +935,7 @@ gtk_set_debug_flags (guint flags)
 }
 
 /**
- * gtk_get_option_group:
+ * gtk_get_option_group: (skip)
  * @open_default_display: whether to open the default display
  *     when parsing the commandline arguments
  *
@@ -2299,7 +2299,7 @@ gtk_device_grab_remove (GtkWidget *widget,
 }
 
 /**
- * gtk_key_snooper_install:
+ * gtk_key_snooper_install: (skip)
  * @snooper: a #GtkKeySnoopFunc
  * @func_data: data to pass to @snooper
  *

gtk/gtkmenu.c

@@ -1184,10 +1184,10 @@ attach_widget_screen_changed (GtkWidget *attach_widget,
 }
 
 /**
- * gtk_menu_attach_to_widget:
+ * gtk_menu_attach_to_widget: (skip)
  * @menu: a #GtkMenu
  * @attach_widget: the #GtkWidget that the menu will be attached to
- * @detacher: the user supplied callback functions that will be called
+ * @detacher: the user supplied callback function that will be called
  *            when the menu calls gtk_menu_detach()
  *
  * Attaches the menu to the widget and provides a callback function
@@ -1737,15 +1737,15 @@ gtk_menu_popup_for_device (GtkMenu             *menu,
 }
 
 /**
- * gtk_menu_popup:
- * @menu: a #GtkMenu.
+ * gtk_menu_popup: (skip)
+ * @menu: a #GtkMenu
  * @parent_menu_shell: (allow-none): the menu shell containing the
  *     triggering menu item, or %NULL
  * @parent_menu_item: (allow-none): the menu item whose activation
  *     triggered the popup, or %NULL
  * @func: (allow-none): a user supplied function used to position
  *     the menu, or %NULL
- * @data: (allow-none): user supplied data to be passed to @func.
+ * @data: user supplied data to be passed to @func.
  * @button: the mouse button which was pressed to initiate the event.
  * @activate_time: the time at which the activation event occurred.
  *

gtk/gtkrc.c

@@ -888,7 +888,7 @@ gtk_rc_get_style_by_paths (GtkSettings *settings,
 }
 
 /**
- * gtk_rc_scanner_new:
+ * gtk_rc_scanner_new: (skip)
  *
  * Deprecated:3.0: Use #GtkCssProvider instead
  */

gtk/gtkstock.c

@@ -260,7 +260,7 @@ gtk_stock_list_ids (void)
 }
 
 /**
- * gtk_stock_item_copy:
+ * gtk_stock_item_copy: (skip)
  * @item: a #GtkStockItem
  * 
  * Copies a stock item, mostly useful for language bindings and not in applications.

gtk/gtkstyle.c

@@ -864,7 +864,7 @@ gtk_style_has_context (GtkStyle *style)
 }
 
 /**
- * gtk_style_attach:
+ * gtk_style_attach: (skip)
  * @style: a #GtkStyle.
  * @window: a #GdkWindow.
  *

gtk/gtkstyleproperties.c

@@ -406,7 +406,7 @@ property_node_lookup (GQuark quark)
 /* Property registration functions */
 
 /**
- * gtk_style_properties_register_property:
+ * gtk_style_properties_register_property: (skip)
  * @parse_func: parsing function to use, or %NULL
  * @pspec: the #GParamSpec for the new property
  *
@@ -457,10 +457,10 @@ gtk_style_properties_register_property (GtkStylePropertyParser  parse_func,
 }
 
 /**
- * gtk_style_properties_lookup_property:
+ * gtk_style_properties_lookup_property: (skip)
  * @property_name: property name to look up
  * @parse_func: (out): return location for the parse function
- * @pspec: (out): return location for the #GParamSpec
+ * @pspec: (out) (transfer none): return location for the #GParamSpec
  *
  * Returns %TRUE if a property has been registered, if @pspec or
  * @parse_func are not %NULL, the #GParamSpec and parsing function

gtk/gtkthemingengine.c

@@ -329,7 +329,7 @@ _gtk_theming_engine_set_context (GtkThemingEngine *engine,
 }
 
 /**
- * gtk_theming_engine_register_property:
+ * gtk_theming_engine_register_property: (skip)
  * @name_space: namespace for the property name
  * @parse_func: parsing function to use, or %NULL
  * @pspec: the #GParamSpec for the new property

gtk/gtktreemodel.c

@@ -421,7 +421,7 @@ gtk_tree_model_base_init (gpointer g_class)
                        row_deleted_params);
 
       /**
-       * GtkTreeModel::rows-reordered:
+       * GtkTreeModel::rows-reordered: (skip)
        * @tree_model: the #GtkTreeModel on which the signal is emitted
        * @path: a #GtkTreePath identifying the tree node whose children
        *     have been reordered
@@ -784,7 +784,7 @@ gtk_tree_path_get_depth (GtkTreePath *path)
 }
 
 /**
- * gtk_tree_path_get_indices:
+ * gtk_tree_path_get_indices: (skip)
  * @path: a #GtkTreePath
  *
  * Returns the current indices of @path.
@@ -1825,7 +1825,7 @@ gtk_tree_model_row_deleted (GtkTreeModel *tree_model,
 }
 
 /**
- * gtk_tree_model_rows_reordered:
+ * gtk_tree_model_rows_reordered: (skip)
  * @tree_model: a #GtkTreeModel
  * @path: a #GtkTreePath pointing to the tree node whose children
  *     have been reordered
@@ -2431,7 +2431,7 @@ gtk_tree_row_reference_deleted (GObject     *proxy,
 }
 
 /**
- * gtk_tree_row_reference_reordered:
+ * gtk_tree_row_reference_reordered: (skip)
  * @proxy: a #GObject
  * @path: the parent path of the reordered signal
  * @iter: the iter pointing to the parent of the reordered

gtk/gtktreestore.c

@@ -354,6 +354,7 @@ gtk_tree_store_new (gint n_columns,
  * Non vararg creation function.  Used primarily by language bindings.
  *
  * Return value: (transfer full): a new #GtkTreeStore
+ * Rename to: gtk_tree_store_new
  **/
 GtkTreeStore *
 gtk_tree_store_newv (gint   n_columns,
@@ -1084,6 +1085,7 @@ gtk_tree_store_set_valist_internal (GtkTreeStore *tree_store,
  * the number of columns to change is not known until run-time.
  *
  * Since: 2.12
+ * Rename to: gtk_tree_store_set
  **/
 void
 gtk_tree_store_set_valuesv (GtkTreeStore *tree_store,
@@ -1585,6 +1587,7 @@ gtk_tree_store_insert_with_values (GtkTreeStore *tree_store,
  * function is mainly intended for language bindings.
  *
  * Since: 2.10
+ * Rename to: gtk_tree_store_insert_with_values
  */
 void
 gtk_tree_store_insert_with_valuesv (GtkTreeStore *tree_store,
@@ -2245,7 +2248,7 @@ gtk_tree_store_reorder_func (gconstpointer a,
 }
 
 /**
- * gtk_tree_store_reorder:
+ * gtk_tree_store_reorder: (skip)
  * @tree_store: A #GtkTreeStore.
  * @parent: A #GtkTreeIter.
  * @new_order: (array): an array of integers mapping the new position of each child

gtk/gtktreeview.c

@@ -14779,7 +14779,7 @@ gtk_tree_view_set_search_column (GtkTreeView *tree_view,
 }
 
 /**
- * gtk_tree_view_get_search_equal_func:
+ * gtk_tree_view_get_search_equal_func: (skip)
  * @tree_view: A #GtkTreeView
  *
  * Returns the compare function currently in use.
@@ -14946,7 +14946,7 @@ gtk_tree_view_set_search_position_func (GtkTreeView                   *tree_view
 }
 
 /**
- * gtk_tree_view_get_search_position_func:
+ * gtk_tree_view_get_search_position_func: (skip)
  * @tree_view: A #GtkTreeView
  *
  * Returns the positioning function currently in use.
@@ -15796,7 +15796,7 @@ gtk_tree_view_is_rubber_banding_active (GtkTreeView *tree_view)
 }
 
 /**
- * gtk_tree_view_get_row_separator_func:
+ * gtk_tree_view_get_row_separator_func: (skip)
  * @tree_view: a #GtkTreeView
  * 
  * Returns the current row separator function.

gtk/gtkwidget.c

@@ -11459,7 +11459,7 @@ gtk_widget_input_shape_combine_region (GtkWidget *widget,
  */
 
 /**
- * gtk_widget_class_install_style_property_parser:
+ * gtk_widget_class_install_style_property_parser: (skip)
  * @klass: a #GtkWidgetClass
  * @pspec: the #GParamSpec for the style property
  * @parser: the parser for the style property