[glib] Convert another table to a list
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib] Convert another table to a list
- Date: Sat, 8 Feb 2014 20:20:53 +0000 (UTC)
commit cd5cd874f0ae52d21accad24d27b0283352049a3
Author: Matthias Clasen <mclasen redhat com>
Date: Sat Feb 8 15:18:37 2014 -0500
Convert another table to a list
gio/gdbusutils.c | 103 ++++++++++--------------------------------------------
1 files changed, 19 insertions(+), 84 deletions(-)
---
diff --git a/gio/gdbusutils.c b/gio/gdbusutils.c
index 254ed04..4e17749 100644
--- a/gio/gdbusutils.c
+++ b/gio/gdbusutils.c
@@ -497,90 +497,25 @@ g_dbus_gvariant_to_gvalue (GVariant *value,
/**
* g_dbus_gvalue_to_gvariant:
- * @gvalue: A #GValue to convert to a #GVariant.
- * @type: A #GVariantType.
+ * @gvalue: A #GValue to convert to a #GVariant
+ * @type: A #GVariantType
*
- * Converts a #GValue to a #GVariant of the type indicated by the @type parameter.
+ * Converts a #GValue to a #GVariant of the type indicated by the @type
+ * parameter.
*
* The conversion is using the following rules:
- * <table frame='all'>
- * <title>#GValue / #GVariant conversion rules</title>
- * <tgroup cols='2' align='left' colsep='1' rowsep='1'>
- * <thead>
- * <row>
- * <entry>If the #GType for @gvalue is...</entry>
- * <entry>... then @type must be</entry>
- * </row>
- * </thead>
- * <tbody>
- * <row>
- * <entry>#G_TYPE_STRING</entry>
- * <entry>
- * ['s'][G-VARIANT-TYPE-STRING:CAPS],
- * ['o'][G-VARIANT-TYPE-OBJECT-PATH:CAPS],
- * ['g'][G-VARIANT-TYPE-SIGNATURE:CAPS] or
- * ['ay'][G-VARIANT-TYPE-BYTESTRING:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_STRV</entry>
- * <entry>
- * ['as'][G-VARIANT-TYPE-STRING-ARRAY:CAPS],
- * ['ao'][G-VARIANT-TYPE-OBJECT-PATH-ARRAY:CAPS] or
- * ['aay'][G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_BOOLEAN</entry>
- * <entry>
- * ['b'][G-VARIANT-TYPE-BOOLEAN:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_UCHAR</entry>
- * <entry>
- * ['y'][G-VARIANT-TYPE-BYTE:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_INT</entry>
- * <entry>
- * ['i'][G-VARIANT-TYPE-INT32:CAPS] or
- * ['n'][G-VARIANT-TYPE-INT16:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_UINT</entry>
- * <entry>
- * ['u'][G-VARIANT-TYPE-UINT32:CAPS] or
- * ['q'][G-VARIANT-TYPE-UINT16:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_INT64</entry>
- * <entry>
- * ['x'][G-VARIANT-TYPE-INT64:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_UINT64</entry>
- * <entry>
- * ['t'][G-VARIANT-TYPE-UINT64:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_DOUBLE</entry>
- * <entry>
- * ['d'][G-VARIANT-TYPE-DOUBLE:CAPS]
- * </entry>
- * </row>
- * <row>
- * <entry>#G_TYPE_VARIANT</entry>
- * <entry>Any #GVariantType</entry>
- * </row>
- * </tbody>
- * </tgroup>
- * </table>
+ *
+ * - #G_TYPE_STRING: 's', 'o', 'g' or 'ay'
+ * - #G_TYPE_STRV: 'as', 'ao' or 'aay'
+ * - #G_TYPE_BOOLEAN: 'b'
+ * - #G_TYPE_UCHAR: 'y'
+ * - #G_TYPE_INT: 'i', 'n'
+ * - #G_TYPE_UINT: 'u', 'q'
+ * - #G_TYPE_INT64 'x'
+ * - #G_TYPE_UINT64: 't'
+ * - #G_TYPE_DOUBLE: 'd'
+ * - #G_TYPE_VARIANT: Any #GVariantType
+ *
* This can fail if e.g. @gvalue is of type #G_TYPE_STRING and @type
* is ['i'][G-VARIANT-TYPE-INT32:CAPS]. It will also fail for any #GType
* (including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED derived-types) not
@@ -594,9 +529,9 @@ g_dbus_gvariant_to_gvalue (GVariant *value,
* See the g_dbus_gvariant_to_gvalue() function for how to convert a
* #GVariant to a #GValue.
*
- * Returns: A #GVariant (never floating) of #GVariantType
- * @type holding the data from @gvalue or %NULL in case of
- * failure. Free with g_variant_unref().
+ * Returns: A #GVariant (never floating) of #GVariantType @type holding
+ * the data from @gvalue or %NULL in case of failure. Free with
+ * g_variant_unref().
*
* Since: 2.30
*/
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]