diff options
author | Cosimo Cecchi <cosimoc@gnome.org> | 2013-04-24 11:58:47 -0400 |
---|---|---|
committer | Cosimo Cecchi <cosimoc@gnome.org> | 2013-04-24 11:58:47 -0400 |
commit | 03dd6cf1b55fbef243e90ee3253dacecae06cf61 (patch) | |
tree | 99c20869960eb5bef36cd51de5b0ee511cbd3ef3 /gio/gicon.c | |
parent | 755f4f0bf66ea6b9e735bf685a5ae2a2c404d6d2 (diff) |
docs: fix docs for g_icon_[de]serialize()
Diffstat (limited to 'gio/gicon.c')
-rw-r--r-- | gio/gicon.c | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/gio/gicon.c b/gio/gicon.c index bc3f2a515..be5e5b77b 100644 --- a/gio/gicon.c +++ b/gio/gicon.c @@ -553,6 +553,16 @@ g_icon_deserialize_emblemed (GVariant *value) return icon; } +/** + * g_icon_deserialize: + * @value: a #GVariant created with g_icon_serialize() + * + * Deserializes a #GIcon previously serialized using g_icon_serialize(). + * + * Returns: (transfer full): a #GIcon, or %NULL when deserialization fails. + * + * Since: 2.38 + */ GIcon * g_icon_deserialize (GVariant *value) { @@ -630,6 +640,20 @@ g_icon_deserialize (GVariant *value) return icon; } +/** + * g_icon_serialize: + * @icon: a #GIcon + * + * Serializes a #GIcon into a #GVariant. An equivalent #GIcon can be retrieved + * back by calling g_icon_deserialize() on the returned value. + * As serialization will avoid using raw icon data when possible, it only + * 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. + * + * Returns: (transfer full): a #GVariant, or %NULL when serialization fails. + * + * Since: 2.38 + */ GVariant * g_icon_serialize (GIcon *icon) { |