* padding bytes. That makes a total of 6 + 2 + 3 = 11 bytes.
*
* We now require extra padding between the two items in the array.
- * After the 14 bytes of the first item, that's 2 bytes required. We
- * now require 2 framing offsets for an extra two bytes. 14 + 2 + 11
- * + 2 = 29 bytes to encode the entire two-item dictionary.
+ * After the 14 bytes of the first item, that's 2 bytes required.
+ * We now require 2 framing offsets for an extra two
+ * bytes. 14 + 2 + 11 + 2 = 29 bytes to encode the entire two-item
+ * dictionary.
*
* ## Type Information Cache
*
* If you only require an equality comparison, g_variant_equal() is more
* general.
*
- * Returns: negative value if a < b;
+ * Returns: negative value if a < b;
* zero if a = b;
- * positive value if a > b.
+ * positive value if a > b.
*
* Since: 2.26
**/
*
* Here is an example for iterating with g_variant_iter_next_value():
* |[<!-- language="C" -->
- * /* recursively iterate a container */
+ * // recursively iterate a container
* void
* iterate_container_recursive (GVariant *container)
* {
/* GVariantDict {{{1 */
/**
- * GVariantDict: (skip)
+ * GVariantDict:
*
* #GVariantDict is a mutable interface to #GVariant dictionaries.
*
*
* ## Using a stack-allocated GVariantDict
*
- * |[
+ * |[<!-- language="C" -->
* GVariant *
* add_to_count (GVariant *orig,
* GError **error)
* GVariantDict dict;
* guint32 count;
*
- * g_variant_dict_init (&dict, orig);
- * if (!g_variant_dict_lookup (&dict, "count", "u", &count))
+ * g_variant_dict_init (&dict, orig);
+ * if (!g_variant_dict_lookup (&dict, "count", "u", &count))
* {
* g_set_error (...);
- * g_variant_dict_clear (&dict);
+ * g_variant_dict_clear (&dict);
* return NULL;
* }
*
- * g_variant_dict_insert (&dict, "count", "u", count + 1);
+ * g_variant_dict_insert (&dict, "count", "u", count + 1);
*
- * return g_variant_dict_end (&dict);
+ * return g_variant_dict_end (&dict);
* }
* ]|
*
* ## Using heap-allocated GVariantDict
*
- * |[
+ * |[<!-- language="C" -->
* GVariant *
* add_to_count (GVariant *orig,
* GError **error)
*
* dict = g_variant_dict_new (orig);
*
- * if (g_variant_dict_lookup (dict, "count", "u", &count))
+ * if (g_variant_dict_lookup (dict, "count", "u", &count))
* {
* g_variant_dict_insert (dict, "count", "u", count + 1);
* result = g_variant_dict_end (dict);
* specified in @format_string. This can be achieved by casting them. See
* the [GVariant varargs documentation][gvariant-varargs].
*
- * <programlisting>
+ * |[<!-- language="C" -->
* MyFlags some_flags = FLAG_ONE | FLAG_TWO;
* const gchar *some_strings[] = { "a", "b", "c", NULL };
* GVariant *new_variant;
* /<!-- -->* This cast is required. *<!-- -->/
* (guint64) some_flags,
* some_strings);
- * </programlisting>
+ * ]|
*
* Returns: a new floating #GVariant instance
*
*
* Here is an example for memory management with g_variant_iter_next():
* |[<!-- language="C" -->
- * /* Iterates a dictionary of type 'a{sv}' */
+ * // Iterates a dictionary of type 'a{sv}'
* void
* iterate_dictionary (GVariant *dictionary)
* {
* g_print ("Item '%s' has type '%s'\n", key,
* g_variant_get_type_string (value));
*
- * /* must free data for ourselves */
+ * // must free data for ourselves
* g_variant_unref (value);
* g_free (key);
* }
*
* Here is an example for memory management with g_variant_iter_loop():
* |[<!-- language="C" -->
- * /* Iterates a dictionary of type 'a{sv}' */
+ * // Iterates a dictionary of type 'a{sv}'
* void
* iterate_dictionary (GVariant *dictionary)
* {
* g_print ("Item '%s' has type '%s'\n", key,
* g_variant_get_type_string (value));
*
- * /* no need to free 'key' and 'value' here
- * * unless breaking out of this loop
- * */
+ * // no need to free 'key' and 'value' here
+ * // unless breaking out of this loop
* }
* }
* ]|