luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 06:56:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

gicon: Clarify GVariant refcounting in docs

Browse Source 
Slightly unexpectedly, `g_icon_serialize()` doesn’t produce a floating
`GVariant`, it produces one with full ownership and returns that. That’s
not the convention for `GVariant` return values from functions which
build variants, but there’s nothing we can do to change this now as that
would be an API break.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall 2020-03-31 14:27:00 +01:00
parent eae7b0274c
commit f6ed9503d0
1 changed files with 2 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gio/gicon.c
View File

@ -558,7 +558,7 @@ g_icon_deserialize_emblemed (GVariant *value)
/** /**
* g_icon_deserialize: * g_icon_deserialize:
* @value: a #GVariant created with g_icon_serialize() * @value: (transfer none): a #GVariant created with g_icon_serialize()
* *
* Deserializes a #GIcon previously serialized using g_icon_serialize(). * Deserializes a #GIcon previously serialized using g_icon_serialize().
* *
@ -653,7 +653,7 @@ g_icon_deserialize (GVariant *value)
* makes sense to transfer the #GVariant between processes on the same machine, * makes sense to transfer the #GVariant between processes on the same machine,
* (as opposed to over the network), and within the same file system namespace. * (as opposed to over the network), and within the same file system namespace.
* *
* Returns: (transfer full): a #GVariant, or %NULL when serialization fails. * Returns: (transfer full): a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating.
* *
* Since: 2.38 * Since: 2.38
*/ */