[gtk+/gi-annotations: 30/31] Update GI annotations in 'Theming in GTK+'

From: Pavel Holejsovsky <pholejs src gnome org>
To: commits-list gnome org
Cc:
Subject: [gtk+/gi-annotations: 30/31] Update GI annotations in 'Theming in GTK+'
Date: Mon, 17 Jan 2011 05:53:21 +0000 (UTC)
commit 80ff77294baeaa5e7aaf8b4f6aebc722e54f2abd
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Sun Jan 16 08:36:05 2011 +0100

    Update GI annotations in 'Theming in GTK+'

 gtk/gtkcssprovider.c     |    2 +-
 gtk/gtkiconfactory.c     |   10 +++---
 gtk/gtkicontheme.c       |   68 +++++++++++++++++++++++++---------------------
 gtk/gtknumerableicon.c   |    4 +-
 gtk/gtkrc.c              |   48 +++++++++++++++++---------------
 gtk/gtkstyle.c           |    6 ++--
 gtk/gtkstylecontext.c    |   11 ++++---
 gtk/gtkstyleproperties.c |   10 +++---
 gtk/gtkstyleprovider.c   |    5 ++-
 gtk/gtkthemingengine.c   |   17 ++++++-----
 gtk/gtkwidgetpath.c      |   12 ++++----
 11 files changed, 103 insertions(+), 90 deletions(-)
---
diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index 7461fbf..43383d0 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -3446,7 +3446,7 @@ gtk_css_provider_load_from_data (GtkCssProvider  *css_provider,
  * gtk_css_provider_load_from_file:
  * @css_provider: a #GtkCssProvider
  * @file: #GFile pointing to a file to load
- * @error: (out) (allow-none): return location for a #GError, or %NULL
+ * @error: return location for a #GError, or %NULL
  *
  * Loads the data contained in @file into @css_provider, making it
  * clear any previously loaded information.
diff --git a/gtk/gtkiconfactory.c b/gtk/gtkiconfactory.c
index 4674449..a890a46 100644
--- a/gtk/gtkiconfactory.c
+++ b/gtk/gtkiconfactory.c
@@ -251,7 +251,7 @@ gtk_icon_factory_add (GtkIconFactory *factory,
  * widget that will display the icon, instead of using this
  * function directly, so that themes are taken into account.
  *
- * Return value: icon set of @stock_id.
+ * Return value: (transfer none): icon set of @stock_id.
  */
 GtkIconSet *
 gtk_icon_factory_lookup (GtkIconFactory *factory,
@@ -330,7 +330,7 @@ _gtk_icon_factory_ensure_default_icons (void)
  * using this function directly, so that themes are taken into
  * account.
  *
- * Return value: a #GtkIconSet, or %NULL
+ * Return value: (transfer none): a #GtkIconSet, or %NULL
  */
 GtkIconSet *
 gtk_icon_factory_lookup_default (const gchar *stock_id)
@@ -2018,7 +2018,7 @@ icon_source_clear (GtkIconSource *source)
 /**
  * gtk_icon_source_set_filename:
  * @source: a #GtkIconSource
- * @filename: image file to use
+ * @filename: (type filename): image file to use
  *
  * Sets the name of an image file to use as a base image when creating
  * icon variants for #GtkIconSet. The filename must be absolute.
@@ -2106,8 +2106,8 @@ gtk_icon_source_set_pixbuf (GtkIconSource *source,
  * filename is not a copy, and should not be modified or expected to
  * persist beyond the lifetime of the icon source.
  *
- * Return value: image filename. This string must not be modified
- * or freed.
+ * Return value: (type filename): image filename. This string must not
+ * be modified or freed.
  */
 G_CONST_RETURN gchar*
 gtk_icon_source_get_filename (const GtkIconSource *source)
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 7a32269..475b40d 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -688,7 +688,8 @@ gtk_icon_theme_finalize (GObject *object)
 /**
  * gtk_icon_theme_set_search_path:
  * @icon_theme: a #GtkIconTheme
- * @path: array of directories that are searched for icon themes
+ * @path: (array length=n_elements) (element-type filename): array of
+ *     directories that are searched for icon themes
  * @n_elements: number of elements in @path.
  * 
  * Sets the search path for the icon theme object. When looking
@@ -737,7 +738,9 @@ gtk_icon_theme_set_search_path (GtkIconTheme *icon_theme,
 /**
  * gtk_icon_theme_get_search_path:
  * @icon_theme: a #GtkIconTheme
- * @path: (allow-none) (array length=n_elements) (out): location to store a list of icon theme path directories or %NULL
+
+ * @path: (allow-none) (array length=n_elements) (element-type filename) (out):
+ *        location to store a list of icon theme path directories or %NULL .
  *        The stored value should be freed with g_strfreev().
  * @n_elements: location to store number of elements
  *              in @path, or %NULL
@@ -773,7 +776,7 @@ gtk_icon_theme_get_search_path (GtkIconTheme      *icon_theme,
 /**
  * gtk_icon_theme_append_search_path:
  * @icon_theme: a #GtkIconTheme
- * @path: directory name to append to the icon path
+ * @path: (type filename): directory name to append to the icon path
  * 
  * Appends a directory to the search path. 
  * See gtk_icon_theme_set_search_path(). 
@@ -802,7 +805,7 @@ gtk_icon_theme_append_search_path (GtkIconTheme *icon_theme,
 /**
  * gtk_icon_theme_prepend_search_path:
  * @icon_theme: a #GtkIconTheme
- * @path: directory name to prepend to the icon path
+ * @path: (type filename): directory name to prepend to the icon path
  * 
  * Prepends a directory to the search path. 
  * See gtk_icon_theme_set_search_path().
@@ -835,8 +838,8 @@ gtk_icon_theme_prepend_search_path (GtkIconTheme *icon_theme,
 /**
  * gtk_icon_theme_set_custom_theme:
  * @icon_theme: a #GtkIconTheme
- * @theme_name: name of icon theme to use instead of configured theme,
- *   or %NULL to unset a previously set custom theme
+ * @theme_name: (allow-none): name of icon theme to use instead of
+ *   configured theme, or %NULL to unset a previously set custom theme
  * 
  * Sets the name of the icon theme that the #GtkIconTheme object uses
  * overriding system configuration. This function cannot be called
@@ -1438,7 +1441,8 @@ gtk_icon_theme_lookup_icon (GtkIconTheme       *icon_theme,
 /**
  * gtk_icon_theme_choose_icon:
  * @icon_theme: a #GtkIconTheme
- * @icon_names: %NULL-terminated array of icon names to lookup
+ * @icon_names: (array zero-terminated=1): %NULL-terminated array of
+ *     icon names to lookup
  * @size: desired icon size
  * @flags: flags modifying the behavior of the icon lookup
  * 
@@ -1614,9 +1618,9 @@ add_size (gpointer  key,
  * that the icon is available in a scalable format. The array 
  * is zero-terminated.
  * 
- * Return value: An newly allocated array describing the sizes at
- * which the icon is available. The array should be freed with g_free()
- * when it is no longer needed.
+ * Return value: (array zero-terminated=1): An newly allocated array
+ * describing the sizes at which the icon is available. The array
+ * should be freed with g_free() when it is no longer needed.
  *
  * Since: 2.6
  **/
@@ -1720,8 +1724,8 @@ add_key_to_list (gpointer  key,
 /**
  * gtk_icon_theme_list_icons:
  * @icon_theme: a #GtkIconTheme
- * @context: a string identifying a particular type of icon,
- *           or %NULL to list all icons.
+ * @context: (allow-none): a string identifying a particular type of
+ *           icon, or %NULL to list all icons.
  * 
  * Lists the icons in the current icon theme. Only a subset
  * of the icons can be listed by providing a context string.
@@ -1729,10 +1733,10 @@ add_key_to_list (gpointer  key,
  * but will typically include such values as "Applications" and
  * "MimeTypes".
  *
- * Return value: (element-type utf8) (transfer none): a #GList list holding the names of all the
- *  icons in the theme. You must first free each element
- *  in the list with g_free(), then free the list itself
- *  with g_list_free().
+ * Return value: (element-type utf8) (transfer full): a #GList list
+ *  holding the names of all the icons in the theme. You must first
+ *  free each element in the list with g_free(), then free the list
+ *  itself with g_list_free().
  *
  * Since: 2.4
  **/
@@ -1791,10 +1795,10 @@ gtk_icon_theme_list_icons (GtkIconTheme *icon_theme,
  * Gets the list of contexts available within the current
  * hierarchy of icon themes
  *
- * Return value: (element-type utf8) (transfer full): a #GList list holding the names of all the
- *  contexts in the theme. You must first free each element
- *  in the list with g_free(), then free the list itself
- *  with g_list_free().
+ * Return value: (element-type utf8) (transfer full): a #GList list
+ *  holding the names of all the contexts in the theme. You must first
+ *  free each element in the list with g_free(), then free the list
+ *  itself with g_list_free().
  *
  * Since: 2.12
  **/
@@ -2697,10 +2701,9 @@ gtk_icon_info_get_base_size (GtkIconInfo *icon_info)
  * no filename if a builtin icon is returned; in this
  * case, you should use gtk_icon_info_get_builtin_pixbuf().
  * 
- * Return value: the filename for the icon, or %NULL
- *  if gtk_icon_info_get_builtin_pixbuf() should
- *  be used instead. The return value is owned by
- *  GTK+ and should not be modified or freed.
+ * Return value: (type filename): the filename for the icon, or %NULL
+ *  if gtk_icon_info_get_builtin_pixbuf() should be used instead. The
+ *  return value is owned by GTK+ and should not be modified or freed.
  *
  * Since: 2.4
  **/
@@ -3163,8 +3166,9 @@ _gtk_icon_info_load_symbolic_internal (GtkIconInfo  *icon_info,
  *     of the icon or %NULL to use the default color
  * @error_color: (allow-none): a #GdkRGBA representing the error color
  *     of the icon or %NULL to use the default color (allow-none)
- * @was_symbolic: (allow-none): a #gboolean, returns whether the loaded icon
- *     was a symbolic one and whether the @fg color was applied to it.
+ * @was_symbolic: (out) (allow-none): a #gboolean, returns whether the
+ *     loaded icon was a symbolic one and whether the @fg color was
+ *     applied to it.
  * @error: (allow-none): location to store error information on failure,
  *     or %NULL.
  *
@@ -3246,8 +3250,9 @@ gtk_icon_info_load_symbolic (GtkIconInfo  *icon_info,
  * gtk_icon_info_load_symbolic_for_context:
  * @icon_info: a #GtkIconInfo
  * @context: a #GtkStyleContext
- * @was_symbolic: (allow-none): a #gboolean, returns whether the loaded icon
- *     was a symbolic one and whether the @fg color was applied to it.
+ * @was_symbolic: (out) (allow-none): a #gboolean, returns whether the
+ *     loaded icon was a symbolic one and whether the @fg color was
+ *     applied to it.
  * @error: (allow-none): location to store error information on failure,
  *     or %NULL.
  *
@@ -3327,8 +3332,9 @@ gtk_icon_info_load_symbolic_for_context (GtkIconInfo      *icon_info,
  * @icon_info: a #GtkIconInfo
  * @style: a #GtkStyle to take the colors from
  * @state: the widget state to use for colors
- * @was_symbolic: (allow-none): a #gboolean, returns whether the loaded icon
- *     was a symbolic one and whether the @fg color was applied to it.
+ * @was_symbolic: (out) (allow-none): a #gboolean, returns whether the
+ *     loaded icon was a symbolic one and whether the @fg color was
+ *     applied to it.
  * @error: (allow-none): location to store error information on failure,
  *     or %NULL.
  *
@@ -3462,7 +3468,7 @@ icon_info_scale_point (GtkIconInfo  *icon_info,
 /**
  * gtk_icon_info_get_embedded_rect:
  * @icon_info: a #GtkIconInfo
- * @rectangle: #GdkRectangle in which to store embedded
+ * @rectangle: (out): #GdkRectangle in which to store embedded
  *   rectangle coordinates; coordinates are only stored
  *   when this function returns %TRUE.
  *
diff --git a/gtk/gtknumerableicon.c b/gtk/gtknumerableicon.c
index 2522102..adb1cc6 100644
--- a/gtk/gtknumerableicon.c
+++ b/gtk/gtknumerableicon.c
@@ -1008,7 +1008,7 @@ gtk_numerable_icon_get_background_icon_name (GtkNumerableIcon *self)
  *
  * Creates a new unthemed #GtkNumerableIcon.
  *
- * Returns: a new #GIcon
+ * Returns: (transfer full): a new #GIcon
  *
  * Since: 3.0
  */
@@ -1031,7 +1031,7 @@ gtk_numerable_icon_new (GIcon *base_icon)
  * to the passed #GtkStyleContext. This is a convenience constructor
  * that calls gtk_numerable_icon_set_style_context() internally.
  *
- * Returns: a new #GIcon
+ * Returns: (transfer full): a new #GIcon
  *
  * Since: 3.0
  */
diff --git a/gtk/gtkrc.c b/gtk/gtkrc.c
index 5e37a56..fa5789b 100644
--- a/gtk/gtkrc.c
+++ b/gtk/gtkrc.c
@@ -250,8 +250,8 @@ gtk_rc_make_default_dir (const gchar *type)
 
 /**
  * gtk_rc_get_im_module_path:
- * @returns: a newly-allocated string containing the path in which to 
- *    look for IM modules.
+ * @returns: (type filename): a newly-allocated string containing the
+ *    path in which to look for IM modules.
  *
  * Obtains the path in which to look for IM modules. See the documentation
  * of the <link linkend="im-module-path"><envar>GTK_PATH</envar></link>
@@ -271,8 +271,8 @@ gtk_rc_get_im_module_path (void)
 
 /**
  * gtk_rc_get_im_module_file:
- * @returns: a newly-allocated string containing the name of the file
- * listing the IM modules available for loading
+ * @returns: (type filename): a newly-allocated string containing the
+ *    name of the file listing the IM modules available for loading
  *
  * Obtains the path to the IM modules file. See the documentation
  * of the <link linkend="im-module-file"><envar>GTK_IM_MODULE_FILE</envar></link>
@@ -322,7 +322,7 @@ gtk_rc_get_theme_dir (void)
  * see the docs for <envar>GTK_PATH</envar> in
  * <xref linkend="gtk-running"/>.
  * 
- * return value: the directory. (Must be freed with g_free())
+ * return value: (type filename): the directory. (Must be freed with g_free())
  **/
 gchar *
 gtk_rc_get_module_dir (void)
@@ -332,8 +332,8 @@ gtk_rc_get_module_dir (void)
 
 /**
  * gtk_rc_add_default_file:
- * @filename: the pathname to the file. If @filename is not absolute, it
- *    is searched in the current directory.
+ * @filename: (type filename): the pathname to the file. If @filename
+ *    is not absolute, it is searched in the current directory.
  *
  * Adds a file to the list of files to be parsed at the
  * end of gtk_init().
@@ -347,7 +347,8 @@ gtk_rc_add_default_file (const gchar *filename)
 
 /**
  * gtk_rc_set_default_files:
- * @filenames: A %NULL-terminated list of filenames.
+ * @filenames: (array zero-terminated=1) (element-type filename): A
+ *     %NULL-terminated list of filenames.
  *
  * Sets the list of files that GTK+ will read at the
  * end of gtk_init().
@@ -365,9 +366,10 @@ gtk_rc_set_default_files (gchar **filenames)
  * Retrieves the current list of RC files that will be parsed
  * at the end of gtk_init().
  *
- * Return value: (transfer none): A %NULL-terminated array of filenames.
- *     This memory is owned by GTK+ and must not be freed by the application.
- *     If you want to store this information, you should make a copy.
+ * Return value: (transfer none) (array zero-terminated=1) (element-type filename):
+ *      A %NULL-terminated array of filenames.  This memory is owned
+ *     by GTK+ and must not be freed by the application.  If you want
+ *     to store this information, you should make a copy.
  *
  * Deprecated:3.0: Use #GtkStyleContext instead
  **/
@@ -751,9 +753,9 @@ gtk_rc_reparse_all (void)
  * created styles, so a new style may not be
  * created.)
  *
- * Returns: the resulting style. No refcount is added
- *   to the returned style, so if you want to save this
- *   style around, you should add a reference yourself.
+ * Returns: (transfer none): the resulting style. No refcount is added
+ *   to the returned style, so if you want to save this style around,
+ *   you should add a reference yourself.
  *
  * Deprecated:3.0: Use #GtkStyleContext instead
  **/
@@ -886,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
  */
@@ -936,7 +938,7 @@ lookup_color (GtkRcStyle *style,
  * If the file is not found, it outputs a warning message using
  * g_warning() and returns %NULL.
  *
- * Return value: the filename. 
+ * Return value: (type filename): the filename. 
  **/
 gchar*
 gtk_rc_find_pixmap_in_path (GtkSettings  *settings,
@@ -955,8 +957,8 @@ gtk_rc_find_pixmap_in_path (GtkSettings  *settings,
  * Searches for a theme engine in the GTK+ search path. This function
  * is not useful for applications and should not be used.
  * 
- * Return value: The filename, if found (must be freed with g_free()),
- *   otherwise %NULL.
+ * Return value: (type filename): The filename, if found (must be
+ *   freed with g_free()), otherwise %NULL.
  **/
 gchar*
 gtk_rc_find_module_in_path (const gchar *module_file)
@@ -967,7 +969,7 @@ gtk_rc_find_module_in_path (const gchar *module_file)
 /**
  * gtk_rc_parse_state:
  * @scanner:
- * @state:
+ * @state: (out):
  *
  * Deprecated:3.0: Use #GtkCssProvider instead
  */
@@ -1025,7 +1027,7 @@ gtk_rc_parse_state (GScanner	 *scanner,
 /**
  * gtk_rc_parse_priority:
  * @scanner:
- * @priority:
+ * @priority: (out):
  *
  * Deprecated:3.0: Use #GtkCssProvider instead
  */
@@ -1082,7 +1084,8 @@ gtk_rc_parse_priority (GScanner	           *scanner,
 /**
  * gtk_rc_parse_color:
  * @scanner: a #GScanner
- * @color: a pointer to a #GdkColor structure in which to store the result
+ * @color: (out): a pointer to a #GdkColor structure in which to store
+ *     the result
  *
  * Parses a color in the <link linkend="color=format">format</link> expected
  * in a RC file. 
@@ -1106,7 +1109,8 @@ gtk_rc_parse_color (GScanner *scanner,
  * gtk_rc_parse_color_full:
  * @scanner: a #GScanner
  * @style: (allow-none): a #GtkRcStyle, or %NULL
- * @color: a pointer to a #GdkColor structure in which to store the result
+ * @color: (out): a pointer to a #GdkColor structure in which to store
+ *     the result
  *
  * Parses a color in the <link linkend="color=format">format</link> expected
  * in a RC file. If @style is not %NULL, it will be consulted to resolve
diff --git a/gtk/gtkstyle.c b/gtk/gtkstyle.c
index 9fd3bfb..a73ebf0 100644
--- a/gtk/gtkstyle.c
+++ b/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.
  *
@@ -919,7 +919,7 @@ gtk_style_detach (GtkStyle *style)
  * and the default icon factory, returning an icon set if found,
  * otherwise %NULL.
  *
- * Return value: icon set of @stock_id
+ * Return value: (transfer none): icon set of @stock_id
  *
  * Deprecated:3.0: Use gtk_style_context_lookup_icon_set() instead
  */
@@ -944,7 +944,7 @@ gtk_style_lookup_icon_set (GtkStyle   *style,
  * gtk_style_lookup_color:
  * @style: a #GtkStyle
  * @color_name: the name of the logical color to look up
- * @color: the #GdkColor to fill in
+ * @color: (out): the #GdkColor to fill in
  *
  * Looks up @color_name in the style's logical color mappings,
  * filling in @color and returning %TRUE if found, otherwise
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index e36bef4..b0d33cc 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -1441,7 +1441,7 @@ gtk_style_context_remove_provider_for_screen (GdkScreen        *screen,
  * @context: a #GtkStyleContext
  * @property: style property name
  * @state: state to retrieve the property value for
- * @value: (out) (transfer full):  return location for the style property value
+ * @value: (out):  return location for the style property value
  *
  * Gets a style property from @context for the given state.
  *
@@ -2363,7 +2363,7 @@ _gtk_style_context_peek_style_property (GtkStyleContext *context,
  * gtk_style_context_get_style_property:
  * @context: a #GtkStyleContext
  * @property_name: the name of the widget style property
- * @value: (out) (transfer full): Return location for the property value
+ * @value: Return location for the property value
  *
  * Gets the value for a widget style property.
  *
@@ -2614,7 +2614,7 @@ gtk_style_context_set_screen (GtkStyleContext *context,
  *
  * Returns the #GdkScreen to which @context is attached.
  *
- * Returns: a #GdkScreen.
+ * Returns: (transfer none): a #GdkScreen.
  **/
 GdkScreen *
 gtk_style_context_get_screen (GtkStyleContext *context)
@@ -3547,8 +3547,9 @@ gtk_style_context_get_margin (GtkStyleContext *context,
  * object is const and will remain valid until the
  * #GtkStyleContext::changed signal happens.
  *
- * Returns: the #PangoFontDescription for the given state. This
- *          object is owned by GTK+ and should not be freed.
+ * Returns: (transfer none): the #PangoFontDescription for the given
+ *          state.  This object is owned by GTK+ and should not be
+ *          freed.
  *
  * Since: 3.0
  **/
diff --git a/gtk/gtkstyleproperties.c b/gtk/gtkstyleproperties.c
index 0052257..9cb4d75 100644
--- a/gtk/gtkstyleproperties.c
+++ b/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
@@ -574,7 +574,7 @@ gtk_style_properties_map_color (GtkStyleProperties *props,
  * Returns the symbolic color that is mapped
  * to @name.
  *
- * Returns: The mapped color
+ * Returns: (transfer none): The mapped color
  *
  * Since: 3.0
  **/
@@ -915,7 +915,7 @@ _gtk_style_properties_peek_property (GtkStyleProperties *props,
  * @props: a #GtkStyleProperties
  * @property: style property name
  * @state: state to retrieve the property value for
- * @value: (out) (transfer full):  return location for the style property value.
+ * @value: (out): return location for the style property value.
  *
  * Gets a style property from @props for the given state. When done with @value,
  * g_value_unset() needs to be called to free any allocated memory.
diff --git a/gtk/gtkstyleprovider.c b/gtk/gtkstyleprovider.c
index 5cd63e4..d43808f 100644
--- a/gtk/gtkstyleprovider.c
+++ b/gtk/gtkstyleprovider.c
@@ -62,7 +62,8 @@ gtk_style_provider_iface_init (gpointer g_iface)
  * Returns the style settings affecting a widget defined by @path, or %NULL if
  * @provider doesn't contemplate styling @path.
  *
- * Returns: a #GtkStyleProperties containing the style settings affecting @path
+ * Returns: (transfer full): a #GtkStyleProperties containing the
+ * style settings affecting @path
  *
  * Since: 3.0
  **/
@@ -126,7 +127,7 @@ gtk_style_provider_get_style_property (GtkStyleProvider *provider,
  * Returns the #GtkIconFactory defined to be in use for @path, or %NULL if none
  * is defined.
  *
- * Returns: The icon factory to use for @path, or %NULL
+ * Returns: (transfer none): The icon factory to use for @path, or %NULL
  *
  * Since: 3.0
  **/
diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index e2e78e4..e216721 100644
--- a/gtk/gtkthemingengine.c
+++ b/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
@@ -392,9 +392,9 @@ gtk_theming_engine_register_property (const gchar            *name_space,
  * @engine: a #GtkThemingEngine
  * @property: the property name
  * @state: state to retrieve the value for
- * @value: (out) (transfer full): return location for the property value,
- *         you must free this memory using g_value_unset() once you are
- *         done with it.
+ * @value: (out): return location for the property value, you must
+ *         free this memory using g_value_unset() once you are done
+ *         with it.
  *
  * Gets a property value as retrieved from the style settings that apply
  * to the currently rendered element.
@@ -473,7 +473,7 @@ gtk_theming_engine_get (GtkThemingEngine *engine,
  * gtk_theming_engine_get_style_property:
  * @engine: a #GtkThemingEngine
  * @property_name: the name of the widget style property
- * @value: (out) (transfer full): Return location for the property value, free with
+ * @value: Return location for the property value, free with
  *         g_value_unset() after use.
  *
  * Gets the value for a widget style property.
@@ -881,8 +881,9 @@ gtk_theming_engine_get_margin (GtkThemingEngine *engine,
  *
  * Returns the font description for a given state.
  *
- * Returns: the #PangoFontDescription for the given state. This
- *          object is owned by GTK+ and should not be freed.
+ * Returns: (transfer none): the #PangoFontDescription for the given
+ *          state. This object is owned by GTK+ and should not be
+ *          freed.
  *
  * Since: 3.0
  **/
@@ -1029,7 +1030,7 @@ gtk_theming_engine_load (const gchar *name)
  *
  * Returns the #GdkScreen to which @engine currently rendering to.
  *
- * Returns: a #GdkScreen, or %NULL.
+ * Returns: (transfer none): a #GdkScreen, or %NULL.
  **/
 GdkScreen *
 gtk_theming_engine_get_screen (GtkThemingEngine *engine)
diff --git a/gtk/gtkwidgetpath.c b/gtk/gtkwidgetpath.c
index 6636abd..13d36eb 100644
--- a/gtk/gtkwidgetpath.c
+++ b/gtk/gtkwidgetpath.c
@@ -599,9 +599,9 @@ gtk_widget_path_iter_clear_classes (GtkWidgetPath *path,
  * Returns a list with all the class names defined for the widget
  * at position @pos in the hierarchy defined in @path.
  *
- * Returns: (transfer container) (type utf8): The list of classes,
- *          This is a list of strings, the #GSList contents are
- *          owned by GTK+, but you should use g_slist_free() to
+ * Returns: (transfer container) (element-type utf8): The list of
+ *          classes, This is a list of strings, the #GSList contents
+ *          are owned by GTK+, but you should use g_slist_free() to
  *          free the list itself.
  *
  * Since: 3.0
@@ -832,9 +832,9 @@ gtk_widget_path_iter_clear_regions (GtkWidgetPath *path,
  * Returns a list with all the region names defined for the widget
  * at position @pos in the hierarchy defined in @path.
  *
- * Returns: (transfer container) (type utf8): The list of regions,
- *          This is a list of strings, the #GSList contents are
- *          owned by GTK+, but you should use g_slist_free() to
+ * Returns: (transfer container) (element-type utf8): The list of
+ *          regions, This is a list of strings, the #GSList contents
+ *          are owned by GTK+, but you should use g_slist_free() to
  *          free the list itself.
  *
  * Since: 3.0
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]