summaryrefslogtreecommitdiff
path: root/gio/gdbusutils.c
diff options
context:
space:
mode:
authorPhilip Withnall <withnall@endlessm.com>2017-07-04 10:21:38 +0100
committerPhilip Withnall <withnall@endlessm.com>2017-07-04 10:45:50 +0100
commit5a8b02cae6a630a19cc0c164f5f8a93eddb240ab (patch)
tree6d40098f2c77f8218fc7d8a6045a92227ea2cfee /gio/gdbusutils.c
parent9bc3d025f97ad1db456604f42bd014b7a9ac4048 (diff)
downloadglib-5a8b02cae6a630a19cc0c164f5f8a93eddb240ab.tar.gz
gdbusutils: Add an example to g_dbus_gvariant_to_gvalue() docs
Clarify that GVariants of type v are not magically unboxed. Signed-off-by: Philip Withnall <withnall@endlessm.com> https://bugzilla.gnome.org/show_bug.cgi?id=784433
Diffstat (limited to 'gio/gdbusutils.c')
-rw-r--r--gio/gdbusutils.c6
1 files changed, 5 insertions, 1 deletions
diff --git a/gio/gdbusutils.c b/gio/gdbusutils.c
index df0b3f545..ff036c765 100644
--- a/gio/gdbusutils.c
+++ b/gio/gdbusutils.c
@@ -358,7 +358,11 @@ g_dbus_is_guid (const gchar *string)
* Converts a #GVariant to a #GValue. If @value is floating, it is consumed.
*
* The rules specified in the g_dbus_gvalue_to_gvariant() function are
- * used - this function is essentially its reverse form.
+ * used - this function is essentially its reverse form. So, a #GVariant
+ * containing any basic or string array type will be converted to a #GValue
+ * containing a basic value or string array. Any other #GVariant (handle,
+ * variant, tuple, dict entry) will be converted to a #GValue containing that
+ * #GVariant.
*
* The conversion never fails - a valid #GValue is always returned in
* @out_gvalue.