[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]