GVariant format string docs: fix maybe types
authorRyan Lortie <desrt@desrt.ca>
Fri, 21 Oct 2011 19:00:24 +0000 (15:00 -0400)
committerRyan Lortie <desrt@desrt.ca>
Fri, 21 Oct 2011 19:04:37 +0000 (15:04 -0400)
The documentation for maybe types failed to mention 'a' as one of the
types that was handled with a single pointer for which NULL means
"nothing".  Correct that omission.

Problem caught by Shaun McCance.

docs/reference/glib/gvariant-varargs.xml

index 1b15156..9b95f87 100644 (file)
@@ -671,11 +671,12 @@ g_variant_unref (value);]]></programlisting></informalexample>
    </para>
 
    <para>
-    The first way is used with format strings starting with '<literal>s</literal>', '<literal>o</literal>',
-    '<literal>g</literal>', '<literal>v</literal>', '<literal>@</literal>', '<literal>*</literal>',
-    '<literal>?</literal>', '<literal>r</literal>', '<literal>&amp;</literal>', or '<literal>^</literal>'.  In all of
-    these cases, for non-maybe types, <link linkend='g-variant-new'><function>g_variant_new()</function></link> takes
-    a pointer to a non-<link linkend='NULL:CAPS'><literal>NULL</literal></link> value and
+    The first way is used with format strings starting with '<literal>a</literal>', '<literal>s</literal>',
+    '<literal>o</literal>', '<literal>g</literal>', '<literal>v</literal>', '<literal>@</literal>',
+    '<literal>*</literal>', '<literal>?</literal>', '<literal>r</literal>', '<literal>&amp;</literal>', or
+    '<literal>^</literal>'.  In all of these cases, for non-maybe types,
+    <link linkend='g-variant-new'><function>g_variant_new()</function></link> takes a pointer to a
+    non-<link linkend='NULL:CAPS'><literal>NULL</literal></link> value and
     <link linkend='g-variant-get'><function>g_variant_get()</function></link> returns (by reference) a
     non-<link linkend='NULL:CAPS'><literal>NULL</literal></link> pointer.  When any of these format strings are
     prefixed with an '<literal>m</literal>', the type of arguments that are collected does not change in any way, but