Add GI annotations to GIcon and related classes and interfaces

This commit is contained in:
Pavel Holejsovsky 2010-12-27 16:08:46 +01:00
parent 7a1fbcd959
commit 5a8d012d29
5 changed files with 15 additions and 13 deletions

View File

@ -220,8 +220,8 @@ g_emblem_new_with_origin (GIcon *icon,
*
* Gives back the icon from @emblem.
*
* Returns: (transfer full): a #GIcon. The returned object belongs to the emblem
* and should not be modified or freed.
* Returns: (transfer none): a #GIcon. The returned object belongs to
* the emblem and should not be modified or freed.
*
* Since: 2.18
*/
@ -240,7 +240,7 @@ g_emblem_get_icon (GEmblem *emblem)
*
* Gets the origin of the emblem.
*
* Returns: the origin of the emblem
* Returns: (transfer none): the origin of the emblem
*
* Since: 2.18
*/

View File

@ -201,8 +201,8 @@ g_emblemed_icon_get_icon (GEmblemedIcon *emblemed)
*
* Gets the list of emblems for the @icon.
*
* Returns: (element-type utf8) (transfer none): a #GList of #GEmblem <!-- -->s that
* is owned by @emblemed
* Returns: (element-type Gio.Emblem) (transfer none): a #GList of
* #GEmblem <!-- -->s that is owned by @emblemed
*
* Since: 2.18
**/

View File

@ -397,8 +397,8 @@ ensure_builtin_icon_types (void)
* implementations you need to ensure that each #GType is registered
* with the type system prior to calling g_icon_new_for_string().
*
* Returns: An object implementing the #GIcon interface or %NULL if
* @error is set.
* Returns: (transfer full): An object implementing the #GIcon
* interface or %NULL if @error is set.
*
* Since: 2.20
**/

View File

@ -62,8 +62,9 @@ g_loadable_icon_default_init (GLoadableIconIface *iface)
* g_loadable_icon_load:
* @icon: a #GLoadableIcon.
* @size: an integer.
* @type: a location to store the type of the loaded icon, %NULL to ignore.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @type: (out) (allow-none): a location to store the type of the
* loaded icon, %NULL to ignore.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @error: a #GError location to store the error occuring, or %NULL to
* ignore.
*
@ -92,9 +93,10 @@ g_loadable_icon_load (GLoadableIcon *icon,
* g_loadable_icon_load_async:
* @icon: a #GLoadableIcon.
* @size: an integer.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the request is satisfied
* @user_data: the data to pass to callback function
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): a #GAsyncReadyCallback to call when the
* request is satisfied
* @user_data: (closure): the data to pass to callback function
*
* Loads an icon asynchronously. To finish this function, see
* g_loadable_icon_load_finish(). For the synchronous, blocking

View File

@ -275,7 +275,7 @@ g_themed_icon_new (const char *iconname)
/**
* g_themed_icon_new_from_names:
* @iconnames: an array of strings containing icon names.
* @iconnames: (array length=len): an array of strings containing icon names.
* @len: the length of the @iconnames array, or -1 if @iconnames is
* %NULL-terminated
*