RubyGems - glib2 - Versions diffs - 0.90.4-x86-mingw32 → 0.90.5-x86-mingw32 - Mend

glib2 0.90.4-x86-mingw32 → 0.90.5-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 (567) hide show

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

@@ -8,7 +8,7 @@
 <link rel="up" href="index.html" title="GLib Reference Manual">
 <link rel="prev" href="index.html" title="GLib Reference Manual">
 <link rel="next" href="glib-building.html" title="Compiling the GLib package">
-<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,7 +19,7 @@
 <th width="100%" align="center">GLib Reference Manual</th>
 <td><a accesskey="n" href="glib-building.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="GLib Overview">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
 <a name="glib"></a>GLib Overview</h2></div></div></div>
 <div class="toc"><dl>
@@ -75,6 +75,6 @@ synchronize their operation.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.14</div>
+          Generated by GTK-Doc V1.15.1</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="tools.html" title="GLib Tools">
 <link rel="prev" href="gtester.html" title="gtester">
 <link rel="next" href="api-index-full.html" title="Index">
-<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,7 +19,7 @@
 <th width="100%" align="center">GLib Reference Manual</th>
 <td><a accesskey="n" href="api-index-full.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="refentry" title="gtester-report">
+<div class="refentry">
 <a name="gtester-report"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -28,17 +28,17 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <h2>Synopsis</h2>
 <div class="cmdsynopsis"><p><code class="command">gtester-report</code>  [option...] [gtester-log]</p></div>
 </div>
-<div class="refsect1" title="Description">
-<a name="id532712"></a><h2>Description</h2>
+<div class="refsect1">
+<a name="id546133"></a><h2>Description</h2>
 <p><span class="command"><strong>gtester-report</strong></span> is a script which converts
 the XML output generated by gtester into HTML.
 </p>
-<div class="refsect2" title="Options">
-<a name="id549732"></a><h3>Options</h3>
+<div class="refsect2">
+<a name="id562114"></a><h3>Options</h3>
 <div class="variablelist"><table border="0">
 <col align="left" valign="top">
 <tbody>
@@ -58,15 +58,15 @@ print version information and exit
 </table></div>
 </div>
 </div>
-<div class="refsect1" title="See also">
-<a name="id779505"></a><h2>See also</h2>
+<div class="refsect1">
+<a name="id700082"></a><h2>See also</h2>
 <p>
-<span class="command"><strong>gtester</strong></span>(1)
+<span class="citerefentry"><span class="refentrytitle">gtester</span>(1)</span>
 </p>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.14</div>
+          Generated by GTK-Doc V1.15.1</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="tools.html" title="GLib Tools">
 <link rel="prev" href="glib-gettextize.html" title="glib-gettextize">
 <link rel="next" href="gtester-report.html" title="gtester-report">
-<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,7 +19,7 @@
 <th width="100%" align="center">GLib Reference Manual</th>
 <td><a accesskey="n" href="gtester-report.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="refentry" title="gtester">
+<div class="refentry">
 <a name="gtester"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -28,12 +28,12 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <h2>Synopsis</h2>
 <div class="cmdsynopsis"><p><code class="command">gtester</code>  [option...] [testprogram]</p></div>
 </div>
-<div class="refsect1" title="Description">
-<a name="id750575"></a><h2>Description</h2>
+<div class="refsect1">
+<a name="id537872"></a><h2>Description</h2>
 <p><span class="command"><strong>gtester</strong></span> is a utility to run unit tests that have
 been written using the GLib test framework.
 </p>
@@ -42,8 +42,8 @@ When called with the <code class="option">-o</code> option, <span class="command
 writes an XML report of the test results, which can be converted
 into HTML using the <span class="command"><strong>gtester-report</strong></span> utility.
 </p>
-<div class="refsect2" title="Options">
-<a name="id516903"></a><h3>Options</h3>
+<div class="refsect2">
+<a name="id551936"></a><h3>Options</h3>
 <div class="variablelist"><table border="0">
 <col align="left" valign="top">
 <tbody>
@@ -117,15 +117,15 @@ report success per testcase
 </table></div>
 </div>
 </div>
-<div class="refsect1" title="See also">
-<a name="id524859"></a><h2>See also</h2>
+<div class="refsect1">
+<a name="id555189"></a><h2>See also</h2>
 <p>
-<span class="command"><strong>gtester-report</strong></span>(1)
+<span class="citerefentry"><span class="refentrytitle">gtester-report</span>(1)</span>
 </p>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.14</div>
+          Generated by GTK-Doc V1.15.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-GVariant.html" title="GVariant">
 <link rel="next" href="tools.html" title="GLib Tools">
-<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,10 +19,10 @@
 <th width="100%" align="center">GLib Reference Manual</th>
 <td><a accesskey="n" href="tools.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="refentry" title="GVariant Format Strings">
+<div class="refentry">
 <a name="gvariant-format-strings"></a><div class="titlepage"></div>
-<div class="refsect1" title="Variable Argument Conversions">
-<a name="id526523"></a><h2>Variable Argument Conversions</h2>
+<div class="refsect1">
+<a name="id552741"></a><h2>Variable Argument Conversions</h2>
 <p>
    This page attempts to document how to perform variable argument conversions with GVariant.
   </p>
@@ -37,8 +37,8 @@
    <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> function.
   </p>
 </div>
-<div class="refsect1" title="Syntax">
-<a name="id580250"></a><h2>Syntax</h2>
+<div class="refsect1">
+<a name="id854768"></a><h2>Syntax</h2>
 <p>
    This section exhaustively describes all possibilities for GVariant format strings.  There are no valid forms of
    format strings other than those described here.  Please note that the format string syntax is likely to expand in the
@@ -54,8 +54,8 @@
     </p></li>
 <li class="listitem"><p>
      '<code class="literal">&amp;s</code>' '<code class="literal">&amp;o</code>', '<code class="literal">&amp;g</code>', '<code class="literal">^as</code>',
-     '<code class="literal">^ao</code>', '<code class="literal">^ag</code>', '<code class="literal">^a&amp;s</code>', '<code class="literal">^a&amp;o</code>' or
-     '<code class="literal">^a&amp;g</code>'
+     '<code class="literal">^a&amp;s</code>', '<code class="literal">^ay</code>', '<code class="literal">^&amp;ay</code>', '<code class="literal">^aay</code>'
+     or '<code class="literal">^a&amp;ay</code>'.
     </p></li>
 <li class="listitem"><p>
      any format string, prefixed with an '<code class="literal">m</code>'
@@ -69,8 +69,8 @@
     </p></li>
 </ul></div>
 </div>
-<div class="refsect1" title="Symbols">
-<a name="id576500"></a><h2>Symbols</h2>
+<div class="refsect1">
+<a name="id558277"></a><h2>Symbols</h2>
 <p>
     The following table describes the rough meaning of symbols that may appear inside a GVariant format string.  Each
     symbol is described in detail in its own section, including usage examples.
@@ -211,7 +211,9 @@
         <a class="link" href="glib-GVariant.html#GVariant" title="GVariant">GVariant</a> should be used in place of the normal C type or types.  For
         <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> this means that you must pass a
         non-<code class="literal">NULL</code> <code class="code">(<a class="link" href="glib-GVariant.html#GVariant" title="GVariant">GVariant</a>
-        *)</code>.  For <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> this means that you
+        *)</code>; if it is a floating reference, ownership will be taken, as
+        if by using <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a>.
+        For <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> this means that you
         must pass a pointer to a <code class="code">(<a class="link" href="glib-GVariant.html#GVariant" title="GVariant">GVariant</a> *)</code> for the value to be returned
         by reference or <code class="literal">NULL</code> to ignore the value.  See
         <a href="gvariant-format-strings.html#gvariant-format-strings-gvariant"><code class="code">GVariant *</code></a> below.
@@ -262,7 +264,7 @@
 </tr>
 </tbody>
 </table></div>
-<div class="refsect2" title="Numeric Types">
+<div class="refsect2">
 <a name="gvariant-format-strings-numeric-types"></a><h3>Numeric Types</h3>
 <p>
     <span class="strong"><strong>
@@ -459,8 +461,8 @@
     No type promotion occurs when using <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> since
     it operates with pointers.  The pointers must always point to a memory region of exactly the correct size.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id749793"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id649957"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -509,7 +511,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Strings">
+<div class="refsect2">
 <a name="gvariant-format-strings-strings"></a><h3>Strings</h3>
 <p>
     <span class="strong"><strong>
@@ -533,8 +535,8 @@
     <code class="literal">NULL</code> may also be passed to indicate that the value of the
     string should be ignored (in which case no copy is made).
    </p>
-<div class="refsect3" title="Examples">
-<a name="id508424"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id558163"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -581,7 +583,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Variants">
+<div class="refsect2">
 <a name="gvariant-format-strings-variants"></a><h3>Variants</h3>
 <p>
     <span class="strong"><strong>
@@ -602,8 +604,8 @@
     <code class="literal">NULL</code> may also be passed to indicate that the value should be
     ignored (in which case no new reference is created).
    </p>
-<div class="refsect3" title="Examples">
-<a name="id546664"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id676125"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -634,7 +636,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Arrays">
+<div class="refsect2">
 <a name="gvariant-format-strings-arrays"></a><h3>Arrays</h3>
 <p>
     <span class="strong"><strong>
@@ -657,12 +659,12 @@
     <code class="code">(<a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter">GVariantIter</a> **)</code>).
     A new heap-allocated iterator is created and returned, initialised for iterating over the elements of the array.
     This iterator should be freed when you are done with it, using
-    <code class="function">g_variant_iter_unref()</code>.
+    <a class="link" href="glib-GVariant.html#g-variant-iter-free" title="g_variant_iter_free ()"><code class="function">g_variant_iter_free()</code></a>.
     <code class="literal">NULL</code> may also be given to indicate that the value of the array
     should be ignored.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id506366"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id868364"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -685,16 +687,20 @@
 16
 17
 18
-19</pre></td>
+19
+20
+21
+22</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="usertype">GVariantBuilder</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">builder</span><span class="symbol">;</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">builder </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-new">g_variant_builder_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">G_VARIANT_TYPE_CLASS_ARRAY</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="normal">builder </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-new">g_variant_builder_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariantType.html#G-VARIANT-TYPE:CAPS">G_VARIANT_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"as"</span><span class="symbol">));</span>
 <span class="function"><a href="glib-GVariant.html#g-variant-builder-add">g_variant_builder_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"s"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"when"</span><span class="symbol">);</span>
 <span class="function"><a href="glib-GVariant.html#g-variant-builder-add">g_variant_builder_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"s"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"in"</span><span class="symbol">);</span>
 <span class="function"><a href="glib-GVariant.html#g-variant-builder-add">g_variant_builder_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"s"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"the"</span><span class="symbol">);</span>
 <span class="function"><a href="glib-GVariant.html#g-variant-builder-add">g_variant_builder_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"s"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"course"</span><span class="symbol">);</span>
 <span class="normal">value </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-new">g_variant_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"as"</span><span class="symbol">,</span><span class="normal"> builder</span><span class="symbol">);</span>
+<span class="function"><a href="glib-GVariant.html#g-variant-builder-unref">g_variant_builder_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">);</span>
 <span class="cbracket">{</span>
 <span class="normal">  </span><span class="usertype">GVariantIter</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">iter</span><span class="symbol">;</span>
@@ -702,9 +708,11 @@
 <span class="normal">  </span><span class="function"><a href="glib-GVariant.html#g-variant-get">g_variant_get</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="string">"as"</span><span class="symbol">,</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="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">(</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"s"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">str</span><span class="symbol">))</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">"%s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function">g_variant_iter_unref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">iter</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+<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">"%s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> str</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-free">g_variant_iter_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">iter</span><span class="symbol">);</span>
+<span class="cbracket">}</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></pre></td>
       </tr>
     </tbody>
   </table>
@@ -713,7 +721,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Maybe Types">
+<div class="refsect2">
 <a name="gvariant-format-strings-maybe-types"></a><h3>Maybe Types</h3>
 <p>
     <span class="strong"><strong>
@@ -761,8 +769,8 @@
     <code class="literal">FALSE</code> and the arguments will be collected in the normal way
     but have their values set to binary zero.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id539803"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id542746"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -885,7 +893,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Tuples">
+<div class="refsect2">
 <a name="gvariant-format-strings-tuples"></a><h3>Tuples</h3>
 <p>
     <span class="strong"><strong>
@@ -895,8 +903,8 @@
 <p>
     Tuples are handled by handling each item in the tuple, in sequence.  Each item is handled in the usual way.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id696306"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id538563"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -939,7 +947,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Dictionaries">
+<div class="refsect2">
 <a name="gvariant-format-strings-dictionaries"></a><h3>Dictionaries</h3>
 <p>
     <span class="strong"><strong>
@@ -949,8 +957,8 @@
 <p>
     Dictionary entries are handled by handling first the key, then the value.  Each is handled in the usual way.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id503994"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id646526"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -965,7 +973,7 @@
         <td class="listing_code"><pre class="programlisting"><span class="usertype">GVariantBuilder</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
 <span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dict</span><span class="symbol">;</span>
-<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-new">g_variant_builder_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">G_VARIANT_TYPE_CLASS_ARRAY</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-GVariantType.html#G-VARIANT-TYPE:CAPS">G_VARIANT_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"a{sv}"</span><span class="symbol">));</span>
+<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-new">g_variant_builder_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariantType.html#G-VARIANT-TYPE:CAPS">G_VARIANT_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"a{sv}"</span><span class="symbol">));</span>
 <span class="function"><a href="glib-GVariant.html#g-variant-builder-add">g_variant_builder_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">b</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"{sv}"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"name"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-new-string">g_variant_new_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo"</span><span class="symbol">));</span>
 <span class="function"><a href="glib-GVariant.html#g-variant-builder-add">g_variant_builder_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">b</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"{sv}"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"timeout"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-new-int32">g_variant_new_int32</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">10</span><span class="symbol">));</span>
 <span class="normal">dict </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-end">g_variant_builder_end</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">b</span><span class="symbol">);</span></pre></td>
@@ -977,7 +985,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="GVariant *">
+<div class="refsect2">
 <a name="gvariant-format-strings-gvariant"></a><h3>GVariant *</h3>
 <p>
     <span class="strong"><strong>
@@ -1012,8 +1020,8 @@
     use of '<code class="literal">@</code>'.  Using the other characters where possible is recommended, however, due to the
     improvements in type safety and code self-documentation.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id584926"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id553651"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -1072,7 +1080,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Pointers">
+<div class="refsect2">
 <a name="gvariant-format-strings-pointers"></a><h3>Pointers</h3>
 <p>
     <span class="strong"><strong>
@@ -1092,8 +1100,8 @@
     returned.  This pointer should not be freed.  Validity checks are performed to ensure that the string data will
     always be properly nul-terminated.
    </p>
-<div class="refsect3" title="Examples">
-<a name="id539396"></a><h4>Examples</h4>
+<div class="refsect3">
+<a name="id638703"></a><h4>Examples</h4>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -1124,7 +1132,7 @@
 </div>
 </div>
 <hr>
-<div class="refsect2" title="Convenience Conversions">
+<div class="refsect2">
 <a name="gvariant-format-strings-convenience"></a><h3>Convenience Conversions</h3>
 <p>
     <span class="strong"><strong>
@@ -1132,40 +1140,149 @@
     </strong></span>
    </p>
 <p>
-    The '<code class="literal">^</code>' character currently only has one purpose: to convert to and from
-    <code class="literal">G_TYPE_STRV</code> type arrays of strings.  It is always used with
-    arrays of strings (or other string types).  It has two forms.
-   </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-      '<code class="literal">^as</code>' (or <code class="literal">o</code> or <code class="literal">g</code>)
-     </p></li>
-<li class="listitem"><p>
-      '<code class="literal">^a&amp;s</code>' (or <code class="literal">o</code> or <code class="literal">g</code>)
-     </p></li>
-</ul></div>
-<p>
-    When used with <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> both forms are equivalent.
-    A <code class="code">(const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * const *)</code> is collected.  This must be a pointer to the
-    array of <code class="literal">NULL</code>-terminated pointers to strings.  This array is
-    converted to a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.  Copies are made, so the original
-    array may be freed immediately.
+    The '<code class="literal">^</code>' character currently supports conversion to and from bytestrings or to and from arrays
+    of strings or bytestrings.  It has a number of forms.
    </p>
 <p>
-    When used with <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> the two forms have
-    different meaning.  Both return a freshly allocated
-    <code class="literal">NULL</code>-terminated array of pointers to strings.  In the case of
-    '<code class="literal">^as</code>', the strings are owned by the caller -- it is appropriate to free the array with
-    <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>.  In the case of '<code class="literal">^a&amp;s</code>',
-    a shallow copy is made; the strings themselves are embedded in the serialised data and owned by the original
-    <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance -- it is only appropriate to free the outer array
-    with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.
+    In all forms, when used with <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> one
+    pointer value is collected from the variable arguments and passed to a function (as given in the table below).
+    The result of that function is used as the value for this position.  When used with
+    <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> one pointer value is produced by using
+    the function (given in the table) and returned by reference.
    </p>
+<div class="informaltable"><table border="1">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>Conversion</strong></span>
+        </p>
+       </td>
+<td>
+        <p>
+          <span class="strong"><strong>
+            Used with <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a>
+          </strong></span>
+        </p>
+       </td>
+<td>
+        <p>
+          <span class="strong"><strong>
+            Used with <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a>
+          </strong></span>
+        </p>
+       </td>
+</tr>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>
+          <code class="literal">^as</code>
+         </strong></span>
+        </p>
+       </td>
+<td rowspan="2">
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-new-strv" title="g_variant_new_strv ()"><code class="function">g_variant_new_strv()</code></a>
+        </p>
+       </td>
+<td>
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-dup-strv" title="g_variant_dup_strv ()"><code class="function">g_variant_dup_strv()</code></a>
+        </p>
+       </td>
+</tr>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>
+          <code class="literal">^a&amp;s</code>
+         </strong></span>
+        </p>
+       </td>
+<td>
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-get-strv" title="g_variant_get_strv ()"><code class="function">g_variant_get_strv()</code></a>
+        </p>
+       </td>
+</tr>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>
+          <code class="literal">^ay</code>
+         </strong></span>
+        </p>
+       </td>
+<td rowspan="2">
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-new-bytestring" title="g_variant_new_bytestring ()"><code class="function">g_variant_new_bytestring()</code></a>
+        </p>
+       </td>
+<td>
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-dup-bytestring" title="g_variant_dup_bytestring ()"><code class="function">g_variant_dup_bytestring()</code></a>
+        </p>
+       </td>
+</tr>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>
+          <code class="literal">^&amp;ay</code>
+         </strong></span>
+        </p>
+       </td>
+<td>
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-get-bytestring" title="g_variant_get_bytestring ()"><code class="function">g_variant_get_bytestring()</code></a>
+        </p>
+       </td>
+</tr>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>
+          <code class="literal">^aay</code>
+         </strong></span>
+        </p>
+       </td>
+<td rowspan="2">
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-new-bytestring-array" title="g_variant_new_bytestring_array ()"><code class="function">g_variant_new_bytestring_array()</code></a>
+        </p>
+       </td>
+<td>
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-dup-bytestring-array" title="g_variant_dup_bytestring_array ()"><code class="function">g_variant_dup_bytestring_array()</code></a>
+        </p>
+       </td>
+</tr>
+<tr>
+<td>
+        <p>
+         <span class="strong"><strong>
+          <code class="literal">^a&amp;ay</code>
+         </strong></span>
+        </p>
+       </td>
+<td>
+        <p>
+         equivalent to <a class="link" href="glib-GVariant.html#g-variant-get-bytestring-array" title="g_variant_get_bytestring_array ()"><code class="function">g_variant_get_bytestring_array()</code></a>
+        </p>
+       </td>
+</tr>
+</tbody>
+</table></div>
 </div>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.14</div>
+          Generated by GTK-Doc V1.15.1</div>
 </body>
 </html>