RubyGems - glib2 - Versions diffs - 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32 - Mend

glib2 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1752) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Spawning-Processes.html" title="Spawning Processes">
 <link rel="next" href="glib-URI-Functions.html" title="URI Functions">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -123,6 +123,8 @@ typedef             <a class="link" href="glib-File-Utilities.html#GStatBuf" tit
 <span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-chdir" title="g_chdir ()">g_chdir</a>                             (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *path</code></em>);
 <span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-utime" title="g_utime ()">g_utime</a>                             (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>,
                                                          <em class="parameter"><code><span class="type">struct utimbuf</span> *utb</code></em>);
+<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-File-Utilities.html#g-close" title="g_close ()">g_close</a>                             (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> fd</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 </pre>
 </div>
 <div class="refsect1">
@@ -506,7 +508,7 @@ codes are those in the <a class="link" href="glib-File-Utilities.html#GFileError
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
-<td>name of a file to read contents from, in the GLib file name encoding. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+<td>name of a file to read contents from, in the GLib file name encoding. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -586,7 +588,7 @@ to 7 characters to <em class="parameter"><code>filename</code></em>.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
 <td>name of a file to write <em class="parameter"><code>contents</code></em> to, in the GLib file name
-encoding. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+encoding. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -652,12 +654,12 @@ tricked into writing into a different location. It doesn't work!
 4
 5
 6</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* DON'T DO THIS */</span>
-<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-File-Utilities.html#g-file-test">g_file_test</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> <a href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK:CAPS">G_FILE_TEST_IS_SYMLINK</a></span><span class="symbol">))</span><span class="normal"> </span>
-<span class="normal">   </span><span class="cbracket">{</span>
-<span class="normal">     fd </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-File-Utilities.html#g-open">g_open</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> O_WRONLY</span><span class="symbol">);</span>
-<span class="normal">     </span><span class="comment">/* write to fd */</span>
-<span class="normal">   </span><span class="cbracket">}</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> DON'T DO THIS </span><span class="comment">*/</span>
+ <span class="keyword">if</span> (!<span class="function"><a href="glib-File-Utilities.html#g-file-test">g_file_test</a></span> (filename, <span class="number">G_FILE_TEST_IS_SYMLINK</span>))
+   {
+     fd = <span class="function"><a href="glib-File-Utilities.html#g-open">g_open</a></span> (filename, O_WRONLY);
+     <span class="comment">/*</span><span class="comment"> write to fd </span><span class="comment">*/</span>
+   }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -727,7 +729,7 @@ Most importantly, on Windows it should be in UTF-8.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
-<td>template filename. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+<td>template filename. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -769,7 +771,7 @@ on Windows it should be in UTF-8.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
-<td>template filename. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+<td>template filename. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -828,13 +830,13 @@ name encoding.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
 <td>Template for file name, as in
-<a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()"><code class="function">g_mkstemp()</code></a>, basename only, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for a default template. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+<a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()"><code class="function">g_mkstemp()</code></a>, basename only, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for a default template. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>name_used</code></em> :</span></p></td>
 <td>location to store actual name used,
-or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -944,7 +946,7 @@ on Windows it should be in UTF-8.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
-<td>template directory name. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+<td>template directory name. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -984,7 +986,7 @@ should be in UTF-8.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
-<td>template directory name. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+<td>template directory name. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 <tr>
@@ -1030,7 +1032,7 @@ modified, and might thus be a read-only literal string.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
 <td>Template for directory name,
-as in <a class="link" href="glib-File-Utilities.html#g-mkdtemp" title="g_mkdtemp ()"><code class="function">g_mkdtemp()</code></a>, basename only, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for a default template. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+as in <a class="link" href="glib-File-Utilities.html#g-mkdtemp" title="g_mkdtemp ()"><code class="function">g_mkdtemp()</code></a>, basename only, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for a default template. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -1043,7 +1045,7 @@ as in <a class="link" href="glib-File-Utilities.html#g-mkdtemp" title="g_mkdtemp
 <td>The actual name used. This string
 should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when not needed any longer and is
 is in the GLib file name encoding. In case of errors, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is
-returned and <em class="parameter"><code>error</code></em> will be set. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+returned and <em class="parameter"><code>error</code></em> will be set. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
 </td>
 </tr>
 </tbody>
@@ -2100,10 +2102,43 @@ occurred</td>
 </table></div>
 <p class="since">Since 2.18</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="g-close"></a><h3>g_close ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_close                             (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> fd</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<p>
+This wraps the <code class="function">close()</code> call; in case of error, <code class="literal">errno</code> will be
+preserved, but the error will also be stored as a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> in <em class="parameter"><code>error</code></em>.
+</p>
+<p>
+Besides using <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, there is another major reason to prefer this
+function over the call provided by the system; on Unix, it will
+attempt to correctly handle <code class="literal">EINTR</code>, which has platform-specific
+semantics.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>fd</code></em> :</span></p></td>
+<td>A file descriptor</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
+<td>a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-GTimeZone.html" title="GTimeZone">
 <link rel="next" href="glib-Random-Numbers.html" title="Random Numbers">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -2335,6 +2335,6 @@ should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" t
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Date-and-Time-Functions.html" title="Date and Time Functions">
 <link rel="next" href="glib-GDateTime.html" title="GDateTime">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -163,22 +163,55 @@ something that would pass as a valid value for the
 <code class="varname">TZ</code> environment variable (including <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>).
 </p>
 <p>
-Valid RFC3339 time offsets are <code class="literal">"Z"</code> (for UTC) or
-<code class="literal">"±hh:mm"</code>.  ISO 8601 additionally specifies
-<code class="literal">"±hhmm"</code> and <code class="literal">"±hh"</code>.
+In Windows, <em class="parameter"><code>identifier</code></em> can also be the unlocalized name of a time
+zone for standard time, for example "Pacific Standard Time".
 </p>
 <p>
-The <code class="varname">TZ</code> environment variable typically corresponds
-to the name of a file in the zoneinfo database, but there are many
-other possibilities.  Note that those other possibilities are not
-currently implemented, but are planned.
+Valid RFC3339 time offsets are <code class="literal">"Z"</code> (for UTC) or
+<code class="literal">"±hh:mm"</code>.  ISO 8601 additionally specifies
+<code class="literal">"±hhmm"</code> and <code class="literal">"±hh"</code>.  Offsets are
+time values to be added to Coordinated Universal Time (UTC) to get
+the local time.
+</p>
+<p>
+In Unix, the <code class="varname">TZ</code> environment variable typically
+corresponds to the name of a file in the zoneinfo database, or
+string in "std offset [dst [offset],start[/time],end[/time]]"
+(POSIX) format.  There  are  no spaces in the specification.  The
+name of standard and daylight savings time zone must be three or more
+alphabetic characters.  Offsets are time values to be added to local
+time to get Coordinated Universal Time (UTC) and should be
+<code class="literal">"[±]hh[[:]mm[:ss]]"</code>.  Dates are either
+<code class="literal">"Jn"</code> (Julian day with n between 1 and 365, leap
+years not counted), <code class="literal">"n"</code> (zero-based Julian day
+with n between 0 and 365) or <code class="literal">"Mm.w.d"</code> (day d
+(0 &lt;= d &lt;= 6) of week w (1 &lt;= w &lt;= 5) of month m (1 &lt;= m &lt;= 12), day
+0 is a Sunday).  Times are in local wall clock time, the default is
+02:00:00.
+</p>
+<p>
+In Windows, the "tzn[+|–]hh[:mm[:ss]][dzn]" format is used, but also
+accepts POSIX format.  The Windows format uses US rules for all time
+zones; daylight savings time is 60 minutes behind the standard time
+with date and time of change taken from Pacific Standard Time.
+Offsets are time values to be added to the local time to get
+Coordinated Universal Time (UTC).
 </p>
 <p>
 <a class="link" href="glib-GTimeZone.html#g-time-zone-new-local" title="g_time_zone_new_local ()"><code class="function">g_time_zone_new_local()</code></a> calls this function with the value of the
 <code class="varname">TZ</code> environment variable.  This function itself is
 independent of the value of <code class="varname">TZ</code>, but if <em class="parameter"><code>identifier</code></em>
 is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then <code class="filename">/etc/localtime</code> will be consulted
-to discover the correct timezone.
+to discover the correct time zone on Unix and the registry will be
+consulted or <code class="function">GetTimeZoneInformation()</code> will be used to get the local
+time zone on Windows.
+</p>
+<p>
+If intervals are not available, only time zone rules from
+<code class="varname">TZ</code> environment variable or other means, then they
+will be computed from year 1900 to 2037.  If the maximum year for the
+rules is available and it is greater than 2037, then it will followed
+instead.
 </p>
 <p>
 See <a class="ulink" href="http://tools.ietf.org/html/rfc3339#section-5.6" target="_top">RFC3339
@@ -186,7 +219,9 @@ See <a class="ulink" href="http://tools.ietf.org/html/rfc3339#section-5.6" targe
 (the <code class="varname">time-offset</code> expansion) and ISO 8601 for the
 full list of valid time offsets.  See <a class="ulink" href="http://www.gnu.org/s/libc/manual/html_node/TZ-Variable.html" target="_top">The
 GNU C Library manual</a> for an explanation of the possible
-values of the <code class="varname">TZ</code> environment variable.
+values of the <code class="varname">TZ</code> environment variable.  See <a class="ulink" href="http://msdn.microsoft.com/en-us/library/ms912391%28v=winembedded.11%29.aspx" target="_top">
+Microsoft Time Zone Index Values</a> for the list of time zones
+on Windows.
 </p>
 <p>
 You should release the return value by calling <a class="link" href="glib-GTimeZone.html#g-time-zone-unref" title="g_time_zone_unref ()"><code class="function">g_time_zone_unref()</code></a>
@@ -543,6 +578,6 @@ Determines if daylight savings time is in effect during a particular
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-GVariantType.html" title="GVariantType">
 <link rel="next" href="gvariant-format-strings.html" title="GVariant Format Strings">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -163,6 +163,7 @@ const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span cla
 <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a>               <a class="link" href="glib-GVariant.html#g-variant-get-size" title="g_variant_get_size ()">g_variant_get_size</a>                  (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
 <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a>       <a class="link" href="glib-GVariant.html#g-variant-get-data" title="g_variant_get_data ()">g_variant_get_data</a>                  (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
+<a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="returnvalue">GBytes</span></a> *            <a class="link" href="glib-GVariant.html#g-variant-get-data-as-bytes" title="g_variant_get_data_as_bytes ()">g_variant_get_data_as_bytes</a>         (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="glib-GVariant.html#g-variant-store" title="g_variant_store ()">g_variant_store</a>                     (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);
 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="glib-GVariant.html#g-variant-new-from-data" title="g_variant_new_from_data ()">g_variant_new_from_data</a>             (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
@@ -171,6 +172,9 @@ const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span cla
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> trusted</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> notify</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
+<a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="glib-GVariant.html#g-variant-new-from-bytes" title="g_variant_new_from_bytes ()">g_variant_new_from_bytes</a>            (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="type">GBytes</span></a> *bytes</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> trusted</code></em>);
 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="glib-GVariant.html#g-variant-byteswap" title="g_variant_byteswap ()">g_variant_byteswap</a>                  (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="glib-GVariant.html#g-variant-get-normal-form" title="g_variant_get_normal_form ()">g_variant_get_normal_form</a>           (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-GVariant.html#g-variant-is-normal-form" title="g_variant_is_normal_form ()">g_variant_is_normal_form</a>            (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
@@ -268,7 +272,7 @@ Serialised <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><
 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is largely compatible with D-Bus.  Almost all types of
 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instances can be sent over D-Bus.  See <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> for
 exceptions.  (However, <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>'s serialisation format is not the same
-as the serialisation format of a D-Bus message body: use <a href="./../gio/gio/GDBusMessage.html"><span class="type">GDBusMessage</span></a>,
+as the serialisation format of a D-Bus message body: use <span class="type">GDBusMessage</span>,
 in the gio library, for those.)
 </p>
 <p>
@@ -299,7 +303,7 @@ with type inferencing.
 <p>
 </p>
 <div class="refsect2">
-<a name="idp61798528"></a><h3>Memory Use</h3>
+<a name="id-1.6.19.4.12.1"></a><h3>Memory Use</h3>
 <p>
   <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> tries to be quite efficient with respect to memory use.
   This section gives a rough idea of how much memory is used by the
@@ -381,7 +385,7 @@ with type inferencing.
   </p>
 </div>
 <div class="refsect3">
-<a name="idp61810480"></a><h4>Type Information Cache</h4>
+<a name="id-1.6.19.4.12.1.5"></a><h4>Type Information Cache</h4>
 <p>
    For each GVariant type that currently exists in the program a type
    information structure is kept in the type information cache.  The
@@ -436,7 +440,7 @@ with type inferencing.
   </p>
 </div>
 <div class="refsect3">
-<a name="idp61818864"></a><h4>Buffer Management Memory</h4>
+<a name="id-1.6.19.4.12.1.6"></a><h4>Buffer Management Memory</h4>
 <p>
    <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> uses an internal buffer management structure to deal
    with the various different possible sources of serialised data
@@ -452,7 +456,7 @@ with type inferencing.
   </p>
 </div>
 <div class="refsect3">
-<a name="idp61825360"></a><h4>GVariant structure</h4>
+<a name="id-1.6.19.4.12.1.7"></a><h4>GVariant structure</h4>
 <p>
    The size of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> structure is 6 * (void *).  On 32 bit
    systems, that's 24 bytes.
@@ -477,7 +481,7 @@ with type inferencing.
   </p>
 </div>
 <div class="refsect3">
-<a name="idp61832752"></a><h4>Summary</h4>
+<a name="id-1.6.19.4.12.1.8"></a><h4>Summary</h4>
 <p>
    To put the entire example together, for our dictionary mapping
    strings to variants (with two entries, as given above), we are
@@ -861,12 +865,12 @@ general.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>one</code></em> :</span></p></td>
-<td>a basic-typed <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GVariant]</span>
+<td>a basic-typed <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GVariant]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>two</code></em> :</span></p></td>
-<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance of the same type. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GVariant]</span>
+<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance of the same type. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GVariant]</span>
 </td>
 </tr>
 <tr>
@@ -1057,7 +1061,7 @@ check fails then a <a class="link" href="glib-Message-Logging.html#g-critical" t
 <p>
 This function is meant to be used by functions that wish to provide
 varargs accessors to <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> values of uncertain values (eg:
-<a class="link" href="glib-GVariant.html#g-variant-lookup" title="g_variant_lookup ()"><code class="function">g_variant_lookup()</code></a> or <a href="./../gio/gio/GMenuModel.html#g-menu-model-get-item-attribute"><code class="function">g_menu_model_get_item_attribute()</code></a>).
+<a class="link" href="glib-GVariant.html#g-variant-lookup" title="g_variant_lookup ()"><code class="function">g_variant_lookup()</code></a> or <code class="function">g_menu_model_get_item_attribute()</code>).
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
@@ -3392,6 +3396,36 @@ serialised data).
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-variant-get-data-as-bytes"></a><h3>g_variant_get_data_as_bytes ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="returnvalue">GBytes</span></a> *            g_variant_get_data_as_bytes         (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
+<p>
+Returns a pointer to the serialised form of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
+The semantics of this function are exactly the same as
+<a class="link" href="glib-GVariant.html#g-variant-get-data" title="g_variant_get_data ()"><code class="function">g_variant_get_data()</code></a>, except that the returned <a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="type">GBytes</span></a> holds
+a reference to the variant data.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
+<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A new <a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="type">GBytes</span></a> representing the variant data. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.36</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="g-variant-store"></a><h3>g_variant_store ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                g_variant_store                     (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
@@ -3517,6 +3551,48 @@ before this function returns.
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-variant-new-from-bytes"></a><h3>g_variant_new_from_bytes ()</h3>
+<pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> *          g_variant_new_from_bytes            (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="type">GBytes</span></a> *bytes</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> trusted</code></em>);</pre>
+<p>
+Constructs a new serialised-mode <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.  This is the
+inner interface for creation of new serialised values that gets
+called from various functions in gvariant.c.
+</p>
+<p>
+A reference is taken on <em class="parameter"><code>bytes</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
+<td>a <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>bytes</code></em> :</span></p></td>
+<td>a <a class="link" href="glib-Byte-Arrays.html#GBytes" title="GBytes"><span class="type">GBytes</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>trusted</code></em> :</span></p></td>
+<td>if the contents of <em class="parameter"><code>bytes</code></em> are trusted</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> with a floating reference</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.36</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="g-variant-byteswap"></a><h3>g_variant_byteswap ()</h3>
 <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> *          g_variant_byteswap                  (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
 <p>
@@ -3662,7 +3738,7 @@ function with <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHa
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
-<td>a basic <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> value as a <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GVariant]</span>
+<td>a basic <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> value as a <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GVariant]</span>
 </td>
 </tr>
 <tr>
@@ -3694,12 +3770,12 @@ this function with <a class="link" href="glib-Hash-Tables.html#GHashTable" title
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>one</code></em> :</span></p></td>
-<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GVariant]</span>
+<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GVariant]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>two</code></em> :</span></p></td>
-<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GVariant]</span>
+<td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GVariant]</span>
 </td>
 </tr>
 <tr>
@@ -3987,7 +4063,7 @@ you no longer need it.
 <p>
 </p>
 <div class="example">
-<a name="idp63856992"></a><p class="title"><b>Example 18. Iterating with <a class="link" href="glib-GVariant.html#g-variant-iter-next-value" title="g_variant_iter_next_value ()"><code class="function">g_variant_iter_next_value()</code></a></b></p>
+<a name="id-1.6.19.5.92.6.1"></a><p class="title"><b>Example 17. Iterating with <a class="link" href="glib-GVariant.html#g-variant-iter-next-value" title="g_variant_iter_next_value ()"><code class="function">g_variant_iter_next_value()</code></a></b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -4010,24 +4086,24 @@ you no longer need it.
 16
 17
 18</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* recursively iterate a container */</span>
-<span class="type">void</span>
-<span class="function">iterate_container_recursive</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">container</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GVariantIter</span><span class="normal"> iter</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">child</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> recursively iterate a container </span><span class="comment">*/</span>
+  <span class="type">void</span>
+  iterate_container_recursive (<span class="type">GVariant</span> *container)
+  {
+    <span class="type">GVariantIter</span> iter;
+    <span class="type">GVariant</span> *child;
-<span class="normal">  </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> container</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">child </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-next-value">g_variant_iter_next_value</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">)))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"type '%s'</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">));</span>
+    <span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span> (&amp;iter, container);
+    <span class="keyword">while</span> ((child = <span class="function"><a href="glib-GVariant.html#g-variant-iter-next-value">g_variant_iter_next_value</a></span> (&amp;iter)))
+      {
+        <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> (<span class="number">&quot;type '</span><span class="symbol">%s</span><span class="number">'</span><span class="symbol">\n</span><span class="number">&quot;</span>, <span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span> (child));
-<span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-is-container">g_variant_is_container</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">))</span>
-<span class="normal">        </span><span class="function">iterate_container_recursive</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">);</span>
+        <span class="keyword">if</span> (<span class="function"><a href="glib-GVariant.html#g-variant-is-container">g_variant_is_container</a></span> (child))
+          iterate_container_recursive (child);
-<span class="normal">      </span><span class="function"><a href="glib-GVariant.html#g-variant-unref">g_variant_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">);</span>
-<span class="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span></pre></td>
+        <span class="function"><a href="glib-GVariant.html#g-variant-unref">g_variant_unref</a></span> (child);
+      }
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -4082,7 +4158,7 @@ Format Strings</GTKDOCLINK>.
 <p>
 </p>
 <div class="example">
-<a name="idp63885456"></a><p class="title"><b>Example 19. Memory management with <a class="link" href="glib-GVariant.html#g-variant-iter-next" title="g_variant_iter_next ()"><code class="function">g_variant_iter_next()</code></a></b></p>
+<a name="id-1.6.19.5.93.8.1"></a><p class="title"><b>Example 18. Memory management with <a class="link" href="glib-GVariant.html#g-variant-iter-next" title="g_variant_iter_next ()"><code class="function">g_variant_iter_next()</code></a></b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -4106,25 +4182,25 @@ Format Strings</GTKDOCLINK>.
 17
 18
 19</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Iterates a dictionary of type 'a{sv}' */</span>
-<span class="type">void</span>
-<span class="function">iterate_dictionary</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dictionary</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GVariantIter</span><span class="normal"> iter</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">key</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> Iterates a dictionary of type 'a{sv}' </span><span class="comment">*/</span>
+  <span class="type">void</span>
+  iterate_dictionary (<span class="type">GVariant</span> *dictionary)
+  {
+    <span class="type">GVariantIter</span> iter;
+    <span class="type">GVariant</span> *value;
+    <span class="type">gchar</span> *key;
-<span class="normal">  </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> dictionary</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-iter-next">g_variant_iter_next</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"{sv}"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">key</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">value</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Item '%s' has type '%s'</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> key</span><span class="symbol">,</span>
-<span class="normal">               </span><span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">));</span>
+    <span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span> (&amp;iter, dictionary);
+    <span class="keyword">while</span> (<span class="function"><a href="glib-GVariant.html#g-variant-iter-next">g_variant_iter_next</a></span> (&amp;iter, <span class="number">&quot;{sv}&quot;</span>, &amp;key, &amp;value))
+      {
+        <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> (<span class="number">&quot;Item '</span><span class="symbol">%s</span><span class="number">' has type '</span><span class="symbol">%s</span><span class="number">'</span><span class="symbol">\n</span><span class="number">&quot;</span>, key,
+                 <span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span> (value));
-<span class="normal">      </span><span class="comment">/* must free data for ourselves */</span>
-<span class="normal">      </span><span class="function"><a href="glib-GVariant.html#g-variant-unref">g_variant_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">key</span><span class="symbol">);</span>
-<span class="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span></pre></td>
+        <span class="comment">/*</span><span class="comment"> must free data for ourselves </span><span class="comment">*/</span>
+        <span class="function"><a href="glib-GVariant.html#g-variant-unref">g_variant_unref</a></span> (value);
+        <span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span> (key);
+      }
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -4213,7 +4289,7 @@ Format Strings</GTKDOCLINK>.
 <p>
 </p>
 <div class="example">
-<a name="idp63927664"></a><p class="title"><b>Example 20. Memory management with <a class="link" href="glib-GVariant.html#g-variant-iter-loop" title="g_variant_iter_loop ()"><code class="function">g_variant_iter_loop()</code></a></b></p>
+<a name="id-1.6.19.5.94.10.1"></a><p class="title"><b>Example 19. Memory management with <a class="link" href="glib-GVariant.html#g-variant-iter-loop" title="g_variant_iter_loop ()"><code class="function">g_variant_iter_loop()</code></a></b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -4236,24 +4312,24 @@ Format Strings</GTKDOCLINK>.
 16
 17
 18</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Iterates a dictionary of type 'a{sv}' */</span>
-<span class="type">void</span>
-<span class="function">iterate_dictionary</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dictionary</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GVariantIter</span><span class="normal"> iter</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">key</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> Iterates a dictionary of type 'a{sv}' </span><span class="comment">*/</span>
+  <span class="type">void</span>
+  iterate_dictionary (<span class="type">GVariant</span> *dictionary)
+  {
+    <span class="type">GVariantIter</span> iter;
+    <span class="type">GVariant</span> *value;
+    <span class="type">gchar</span> *key;
-<span class="normal">  </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> dictionary</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-iter-loop">g_variant_iter_loop</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"{sv}"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">key</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">value</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Item '%s' has type '%s'</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> key</span><span class="symbol">,</span>
-<span class="normal">               </span><span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">));</span>
+    <span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span> (&amp;iter, dictionary);
+    <span class="keyword">while</span> (<span class="function"><a href="glib-GVariant.html#g-variant-iter-loop">g_variant_iter_loop</a></span> (&amp;iter, <span class="number">&quot;{sv}&quot;</span>, &amp;key, &amp;value))
+      {
+        <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> (<span class="number">&quot;Item '</span><span class="symbol">%s</span><span class="number">' has type '</span><span class="symbol">%s</span><span class="number">'</span><span class="symbol">\n</span><span class="number">&quot;</span>, key,
+                 <span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span> (value));
-<span class="normal">      </span><span class="comment">/* no need to free 'key' and 'value' here */</span>
-<span class="normal">      </span><span class="comment">/* unless breaking out of this loop */</span>
-<span class="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span></pre></td>
+        <span class="comment">/*</span><span class="comment"> no need to free 'key' and 'value' here </span><span class="comment">*/</span>
+        <span class="comment">/*</span><span class="comment"> unless breaking out of this loop </span><span class="comment">*/</span>
+      }
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -5082,7 +5158,7 @@ Consider this simple example:
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-GVariant.html#g-variant-new-parsed">g_variant_new_parsed</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"[('one', 1), ('two', %i), (%s, 3)]"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"three"</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-GVariant.html#g-variant-new-parsed">g_variant_new_parsed</a></span> (<span class="number">&quot;[('one', 1), ('two', </span><span class="symbol">%i</span><span class="number">), (</span><span class="symbol">%s</span><span class="number">, 3)]&quot;</span>, <span class="number">2</span>, <span class="number">&quot;three&quot;</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -5137,6 +5213,6 @@ GVariantType
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>