RubyGems - glib2 - Versions diffs - 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32 - Mend

glib2 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32

Files changed (1062) hide show

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>GSubprocess Launcher: GIO Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="subprocesses.html" title="Subprocesses">
 <link rel="prev" href="GSubprocess.html" title="GSubprocess">
 <link rel="next" href="networking.html" title="Low-level network support">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -35,7 +35,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="GSubprocessLauncher.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
@@ -181,7 +181,7 @@
 </div>
 <div class="refsect1">
 <a name="GSubprocessLauncher.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
 <colgroup>
 <col width="150px" class="properties_type">
 <col width="300px" class="properties_name">
@@ -196,7 +196,7 @@
 </div>
 <div class="refsect1">
 <a name="GSubprocessLauncher.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
@@ -240,7 +240,7 @@ environment of the calling process is made at the time of this call
 and will be used as the environment that the process is launched in.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.2.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -253,7 +253,7 @@ and will be used as the environment that the process is launched in.</p>
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -266,7 +266,7 @@ g_subprocess_launcher_spawn (<em class="parameter"><code><a class="link" href="G
 <p>Creates a <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a> given a provided varargs list of arguments.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.3.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -302,7 +302,7 @@ g_subprocess_launcher_spawn (<em class="parameter"><code><a class="link" href="G
 will be set). </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -314,7 +314,7 @@ g_subprocess_launcher_spawnv (<em class="parameter"><code><a class="link" href="
 <p>Creates a <a class="link" href="GSubprocess.html" title="GSubprocess"><span class="type">GSubprocess</span></a> given a provided array of arguments.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.4.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -345,7 +345,7 @@ g_subprocess_launcher_spawnv (<em class="parameter"><code><a class="link" href="
 will be set). </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -360,12 +360,11 @@ the process 'environ' and using the functions <a href="../glib/glib-Miscellaneou
 <a href="../glib/glib-Miscellaneous-Utility-Functions.html#g-environ-unsetenv"><code class="function">g_environ_unsetenv()</code></a>, etc.</p>
 <p>As an alternative, you can use <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-setenv" title="g_subprocess_launcher_setenv ()"><code class="function">g_subprocess_launcher_setenv()</code></a>,
 <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-unsetenv" title="g_subprocess_launcher_unsetenv ()"><code class="function">g_subprocess_launcher_unsetenv()</code></a>, etc.</p>
-<p>All strings in this array are expected to be in the GLib file name
-encoding.  On UNIX, this means that they can be arbitrary byte
-strings.  On Windows, they should be in UTF-8.</p>
+<p>On UNIX, all strings in this array can be arbitrary byte strings.
+On Windows, they should be in UTF-8.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.5.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -385,7 +384,7 @@ strings.  On Windows, they should be in UTF-8.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -398,12 +397,12 @@ g_subprocess_launcher_setenv (<em class="parameter"><code><a class="link" href="
 <p>Sets the environment variable <em class="parameter"><code>variable</code></em>
  in the environment of
 processes launched from this launcher.</p>
-<p>Both the variable's name and value should be in the GLib file name
-encoding. On UNIX, this means that they can be arbitrary byte
-strings. On Windows, they should be in UTF-8.</p>
+<p>On UNIX, both the variable's name and value can be arbitrary byte
+strings, except that the variable's name cannot contain '='.
+On Windows, they should be in UTF-8.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.6.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -433,7 +432,7 @@ strings. On Windows, they should be in UTF-8.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -444,12 +443,11 @@ g_subprocess_launcher_unsetenv (<em class="parameter"><code><a class="link" href
 <p>Removes the environment variable <em class="parameter"><code>variable</code></em>
  from the environment of
 processes launched from this launcher.</p>
-<p>The variable name should be in the GLib file name encoding.  On UNIX,
-this means that they can be arbitrary byte strings.  On Windows, they
-should be in UTF-8.</p>
+<p>On UNIX, the variable's name can be an arbitrary byte string not
+containing '='. On Windows, it should be in UTF-8.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.7.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -469,7 +467,7 @@ should be in UTF-8.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -480,12 +478,11 @@ g_subprocess_launcher_getenv (<em class="parameter"><code><a class="link" href="
 <p>Returns the value of the environment variable <em class="parameter"><code>variable</code></em>
  in the
 environment of processes launched from this launcher.</p>
-<p>The returned string is in the GLib file name encoding.  On UNIX, this
-means that it can be an arbitrary byte string.  On Windows, it will
-be UTF-8.</p>
+<p>On UNIX, the returned string can be an arbitrary byte string.
+On Windows, it will be UTF-8.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.8.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -508,9 +505,8 @@ be UTF-8.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.8.7"></a><h4>Returns</h4>
 <p> the value of the environment variable, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unset</p>
-<p></p>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -524,7 +520,7 @@ with.</p>
 of the launching process at the time of launch.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.9.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -544,7 +540,7 @@ of the launching process at the time of launch.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -563,7 +559,7 @@ function like <a class="link" href="GSubprocessLauncher.html#g-subprocess-launch
 <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-take-stdout-fd" title="g_subprocess_launcher_take_stdout_fd ()"><code class="function">g_subprocess_launcher_take_stdout_fd()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.10.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -583,7 +579,7 @@ function like <a class="link" href="GSubprocessLauncher.html#g-subprocess-launch
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -601,7 +597,7 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
 <p>This feature is only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.11.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -621,7 +617,7 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -646,7 +642,7 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
 <p>This feature is only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.12.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -666,7 +662,7 @@ the launcher flags contain any flags directing stdin elsewhere.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -685,7 +681,7 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
 <p>This feature is only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.13.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -705,7 +701,7 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -729,7 +725,7 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
 <p>This feature is only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.14.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -749,7 +745,7 @@ if the launcher flags contain any flags directing stdout elsewhere.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -770,7 +766,7 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
 <p>This feature is only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.15.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -790,7 +786,7 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -813,7 +809,7 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
 <p>This feature is only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.16.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -833,7 +829,7 @@ if the launcher flags contain any flags directing stderr elsewhere.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -855,7 +851,7 @@ descriptor in the child.</p>
 the passphrase to be written.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.17.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -902,7 +898,7 @@ given.</p>
 <p>Child setup functions are only available on UNIX.</p>
 <div class="refsect3">
 <a name="id-1.4.12.3.9.18.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -934,7 +930,7 @@ given.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -943,7 +939,7 @@ given.</p>
 <a name="GSubprocessLauncher-struct"></a><h3>GSubprocessLauncher</h3>
 <pre class="programlisting">typedef struct _GSubprocessLauncher GSubprocessLauncher;</pre>
 <p>Options for launching a child process.</p>
-<p class="since">Since 2.40</p>
+<p class="since">Since: <a class="link" href="api-index-2-40.html#api-index-2.40">2.40</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -957,7 +953,6 @@ given.</p>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>GTask: GIO Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="async.html" title="Asynchronous I/O">
 <link rel="prev" href="GAsyncResult.html" title="GAsyncResult">
 <link rel="next" href="gio-GIOScheduler.html" title="GIOScheduler">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -37,7 +37,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="GTask.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
@@ -304,7 +304,7 @@
 </div>
 <div class="refsect1">
 <a name="GTask.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
 <colgroup>
 <col width="150px" class="properties_type">
 <col width="300px" class="properties_name">
@@ -319,7 +319,7 @@
 </div>
 <div class="refsect1">
 <a name="GTask.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
@@ -462,97 +462,97 @@ the return value.</p>
 89
 90
 91</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">CakeFrostingType</span><span class="normal"> frosting</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">;</span>
-<span class="cbracket">}</span><span class="normal"> DecorationData</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">struct</span> <span class="gtkdoc opt">{</span>
+  CakeFrostingType frosting<span class="gtkdoc opt">;</span>
+  <span class="gtkdoc kwb">char</span> <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span> DecorationData<span class="gtkdoc opt">;</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">decoration_data_free</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">DecorationData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">decoration</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">decoration</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">DecorationData</span><span class="symbol">,</span><span class="normal"> decoration</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">decoration_data_free</span> <span class="gtkdoc opt">(</span>DecorationData <span class="gtkdoc opt">*</span>decoration<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>decoration<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span> <span class="gtkdoc opt">(</span>DecorationData<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">baked_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Cake</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">,</span>
-<span class="normal">          </span><span class="usertype">gpointer</span><span class="normal">  user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task </span><span class="symbol">=</span><span class="normal"> user_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">DecorationData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">decoration </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-get-task-data">g_task_get_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">baked_cb</span> <span class="gtkdoc opt">(</span>Cake     <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">,</span>
+          gpointer  user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GTask <span class="gtkdoc opt">*</span>task <span class="gtkdoc opt">=</span> user_data<span class="gtkdoc opt">;</span>
+  DecorationData <span class="gtkdoc opt">*</span>decoration <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-get-task-data">g_task_get_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+  GError <span class="gtkdoc opt">*</span>error <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake </span><span class="symbol">==</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> BAKER_ERROR</span><span class="symbol">,</span><span class="normal"> BAKER_ERROR_NO_FLOUR</span><span class="symbol">,</span>
-<span class="normal">                               </span><span class="string">"Go to the supermarket"</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>cake <span class="gtkdoc opt">==</span> NULL<span class="gtkdoc opt">)</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> BAKER_ERROR<span class="gtkdoc opt">,</span> BAKER_ERROR_NO_FLOUR<span class="gtkdoc opt">,</span>
+                               <span class="string">&quot;Go to the supermarket&quot;</span><span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function">cake_decorate</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">,</span><span class="normal"> decoration</span><span class="symbol">-&gt;</span><span class="normal">frosting</span><span class="symbol">,</span><span class="normal"> decoration</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="comment">// g_task_return_error() takes ownership of error</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(!</span><span class="function">cake_decorate</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">-&gt;</span>frosting<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">, &amp;</span>error<span class="gtkdoc opt">))</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">);</span>
+      <span class="gtkdoc slc">// g_task_return_error() takes ownership of error</span>
+      <span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake</span><span class="symbol">,</span><span class="normal"> <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  <span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="type">void</span>
-<span class="function">baker_bake_cake_async</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">               </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">guint</span><span class="normal">                radius</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFlavor</span><span class="normal">           flavor</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFrostingType</span><span class="normal">     frosting</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal">          </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GCancellable</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GAsyncReadyCallback</span><span class="normal">  callback</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">gpointer</span><span class="normal">             user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">DecorationData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">decoration</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">Cake</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">;</span>
+<span class="gtkdoc kwb">void</span>
+<span class="function">baker_bake_cake_async</span> <span class="gtkdoc opt">(</span>Baker               <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                       guint                radius<span class="gtkdoc opt">,</span>
+                       CakeFlavor           flavor<span class="gtkdoc opt">,</span>
+                       CakeFrostingType     frosting<span class="gtkdoc opt">,</span>
+                       <span class="gtkdoc kwb">const char</span>          <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">,</span>
+                       GCancellable        <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">,</span>
+                       GAsyncReadyCallback  callback<span class="gtkdoc opt">,</span>
+                       gpointer             user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
+  DecorationData <span class="gtkdoc opt">*</span>decoration<span class="gtkdoc opt">;</span>
+  Cake  <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">;</span>
-<span class="normal">  task </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> callback</span><span class="symbol">,</span><span class="normal"> user_data</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">radius </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">3</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> BAKER_ERROR</span><span class="symbol">,</span><span class="normal"> BAKER_ERROR_TOO_SMALL</span><span class="symbol">,</span>
-<span class="normal">                               </span><span class="string">"%ucm radius cakes are silly"</span><span class="symbol">,</span>
-<span class="normal">                               radius</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> callback<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>radius <span class="gtkdoc opt">&lt;</span> <span class="number">3</span><span class="gtkdoc opt">)</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> BAKER_ERROR<span class="gtkdoc opt">,</span> BAKER_ERROR_TOO_SMALL<span class="gtkdoc opt">,</span>
+                               <span class="string">&quot;%ucm radius cakes are silly&quot;</span><span class="gtkdoc opt">,</span>
+                               radius<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  cake </span><span class="symbol">=</span><span class="normal"> </span><span class="function">_baker_get_cached_cake</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> radius</span><span class="symbol">,</span><span class="normal"> flavor</span><span class="symbol">,</span><span class="normal"> frosting</span><span class="symbol">,</span><span class="normal"> message</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake </span><span class="symbol">!=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="comment">// _baker_get_cached_cake() returns a reffed cake</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake</span><span class="symbol">,</span><span class="normal"> <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  cake <span class="gtkdoc opt">=</span> <span class="function">_baker_get_cached_cake</span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> radius<span class="gtkdoc opt">,</span> flavor<span class="gtkdoc opt">,</span> frosting<span class="gtkdoc opt">,</span> message<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>cake <span class="gtkdoc opt">!=</span> NULL<span class="gtkdoc opt">)</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="gtkdoc slc">// _baker_get_cached_cake() returns a reffed cake</span>
+      <span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  decoration </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">DecorationData</span><span class="symbol">);</span>
-<span class="normal">  decoration</span><span class="symbol">-&gt;</span><span class="normal">frosting </span><span class="symbol">=</span><span class="normal"> frosting</span><span class="symbol">;</span>
-<span class="normal">  decoration</span><span class="symbol">-&gt;</span><span class="normal">message </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> decoration</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> decoration_data_free</span><span class="symbol">);</span>
+  decoration <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>DecorationData<span class="gtkdoc opt">);</span>
+  decoration<span class="gtkdoc opt">-&gt;</span>frosting <span class="gtkdoc opt">=</span> frosting<span class="gtkdoc opt">;</span>
+  decoration<span class="gtkdoc opt">-&gt;</span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>message<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> decoration<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> decoration_data_free<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function">_baker_begin_cake</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> radius</span><span class="symbol">,</span><span class="normal"> flavor</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> baked_cb</span><span class="symbol">,</span><span class="normal"> task</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  <span class="function">_baker_begin_cake</span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> radius<span class="gtkdoc opt">,</span> flavor<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> baked_cb<span class="gtkdoc opt">,</span> task<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">Cake </span><span class="symbol">*</span>
-<span class="function">baker_bake_cake_finish</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                        </span><span class="usertype">GAsyncResult</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">result</span><span class="symbol">,</span>
-<span class="normal">                        </span><span class="usertype">GError</span><span class="normal">       </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">,</span><span class="normal"> self</span><span class="symbol">),</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+Cake <span class="gtkdoc opt">*</span>
+<span class="function">baker_bake_cake_finish</span> <span class="gtkdoc opt">(</span>Baker         <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                        GAsyncResult  <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
+                        GError       <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">,</span> self<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_TASK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">),</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">return</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span><span class="function">G_TASK</span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">),</span> error<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -697,129 +697,131 @@ of waiting for a source to fire (automatically using the correct
 119
 120
 121
-122</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">Cake</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">CakeFrostingType</span><span class="normal"> frosting</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">;</span>
-<span class="cbracket">}</span><span class="normal"> BakingData</span><span class="symbol">;</span>
+122
+123</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">struct</span> <span class="gtkdoc opt">{</span>
+  Cake <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">;</span>
+  CakeFrostingType frosting<span class="gtkdoc opt">;</span>
+  <span class="gtkdoc kwb">char</span> <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span> BakingData<span class="gtkdoc opt">;</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">decoration_data_free</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">BakingData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bd</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bd</span><span class="symbol">-&gt;</span><span class="normal">cake</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bd</span><span class="symbol">-&gt;</span><span class="normal">cake</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bd</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">BakingData</span><span class="symbol">,</span><span class="normal"> bd</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">decoration_data_free</span> <span class="gtkdoc opt">(</span>BakingData <span class="gtkdoc opt">*</span>bd<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-&gt;</span>cake<span class="gtkdoc opt">)</span>
+    <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-&gt;</span>cake<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span> <span class="gtkdoc opt">(</span>BakingData<span class="gtkdoc opt">,</span> bd<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">decorated_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Cake</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">,</span>
-<span class="normal">              </span><span class="usertype">GAsyncResult</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">result</span><span class="symbol">,</span>
-<span class="normal">              </span><span class="usertype">gpointer</span><span class="normal">      user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task </span><span class="symbol">=</span><span class="normal"> user_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">decorated_cb</span> <span class="gtkdoc opt">(</span>Cake         <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">,</span>
+              GAsyncResult <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
+              gpointer      user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GTask <span class="gtkdoc opt">*</span>task <span class="gtkdoc opt">=</span> user_data<span class="gtkdoc opt">;</span>
+  GError <span class="gtkdoc opt">*</span>error <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function">cake_decorate_finish</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">,</span><span class="normal"> result</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(!</span><span class="function">cake_decorate_finish</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">,</span> result<span class="gtkdoc opt">, &amp;</span>error<span class="gtkdoc opt">))</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="comment">// baking_data_free() will drop its ref on the cake, so we have to</span>
-<span class="normal">  </span><span class="comment">// take another here to give to the caller.</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">),</span><span class="normal"> <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  <span class="gtkdoc slc">// baking_data_free() will drop its ref on the cake, so we have to</span>
+  <span class="gtkdoc slc">// take another here to give to the caller.</span>
+  <span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">),</span> g_object_unref<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">decorator_ready</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task </span><span class="symbol">=</span><span class="normal"> user_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">BakingData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bd </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-get-task-data">g_task_get_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
+<span class="gtkdoc kwb">static</span> gboolean
+<span class="function">decorator_ready</span> <span class="gtkdoc opt">(</span>gpointer user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GTask <span class="gtkdoc opt">*</span>task <span class="gtkdoc opt">=</span> user_data<span class="gtkdoc opt">;</span>
+  BakingData <span class="gtkdoc opt">*</span>bd <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-get-task-data">g_task_get_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function">cake_decorate_async</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bd</span><span class="symbol">-&gt;</span><span class="normal">cake</span><span class="symbol">,</span><span class="normal"> bd</span><span class="symbol">-&gt;</span><span class="normal">frosting</span><span class="symbol">,</span><span class="normal"> bd</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="function"><a href="GTask.html#g-task-get-cancellable">g_task_get_cancellable</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">),</span>
-<span class="normal">                       decorated_cb</span><span class="symbol">,</span><span class="normal"> task</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  <span class="function">cake_decorate_async</span> <span class="gtkdoc opt">(</span>bd<span class="gtkdoc opt">-&gt;</span>cake<span class="gtkdoc opt">,</span> bd<span class="gtkdoc opt">-&gt;</span>frosting<span class="gtkdoc opt">,</span> bd<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">,</span>
+                       <span class="function"><a href="GTask.html#g-task-get-cancellable">g_task_get_cancellable</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">),</span>
+                       decorated_cb<span class="gtkdoc opt">,</span> task<span class="gtkdoc opt">);</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">baked_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Cake</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">,</span>
-<span class="normal">          </span><span class="usertype">gpointer</span><span class="normal">  user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task </span><span class="symbol">=</span><span class="normal"> user_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">BakingData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bd </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-get-task-data">g_task_get_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+  <span class="keyword">return</span> G_SOURCE_REMOVE<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake </span><span class="symbol">==</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> BAKER_ERROR</span><span class="symbol">,</span><span class="normal"> BAKER_ERROR_NO_FLOUR</span><span class="symbol">,</span>
-<span class="normal">                               </span><span class="string">"Go to the supermarket"</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">baked_cb</span> <span class="gtkdoc opt">(</span>Cake     <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">,</span>
+          gpointer  user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GTask <span class="gtkdoc opt">*</span>task <span class="gtkdoc opt">=</span> user_data<span class="gtkdoc opt">;</span>
+  BakingData <span class="gtkdoc opt">*</span>bd <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-get-task-data">g_task_get_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+  GError <span class="gtkdoc opt">*</span>error <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  bd</span><span class="symbol">-&gt;</span><span class="normal">cake </span><span class="symbol">=</span><span class="normal"> cake</span><span class="symbol">;</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>cake <span class="gtkdoc opt">==</span> NULL<span class="gtkdoc opt">)</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="GTask.html#g-task-return-new-error">g_task_return_new_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> BAKER_ERROR<span class="gtkdoc opt">,</span> BAKER_ERROR_NO_FLOUR<span class="gtkdoc opt">,</span>
+                               <span class="string">&quot;Go to the supermarket&quot;</span><span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="comment">// Bail out now if the user has already cancelled</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GTask.html#g-task-return-error-if-cancelled">g_task_return_error_if_cancelled</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  bd<span class="gtkdoc opt">-&gt;</span>cake <span class="gtkdoc opt">=</span> cake<span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">cake_decorator_available</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="function">decorator_ready</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">else</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="usertype">GSource</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">source</span><span class="symbol">;</span>
+  <span class="gtkdoc slc">// Bail out now if the user has already cancelled</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-return-error-if-cancelled">g_task_return_error_if_cancelled</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">))</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">      source </span><span class="symbol">=</span><span class="normal"> </span><span class="function">cake_decorator_wait_source_new</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="comment">// Attach @source to @task's GMainContext and have it call</span>
-<span class="normal">      </span><span class="comment">// decorator_ready() when it is ready.</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-attach-source">g_task_attach_source</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> source</span><span class="symbol">,</span>
-<span class="normal">                            </span><span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">decorator_ready</span><span class="symbol">));</span>
-<span class="normal">      </span><span class="function"><a href="../glib/glib-The-Main-Event-Loop.html#g-source-unref">g_source_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">source</span><span class="symbol">);</span>
-<span class="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function">cake_decorator_available</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">))</span>
+    <span class="function">decorator_ready</span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+  <span class="keyword">else</span>
+    <span class="gtkdoc opt">{</span>
+      GSource <span class="gtkdoc opt">*</span>source<span class="gtkdoc opt">;</span>
-<span class="type">void</span>
-<span class="function">baker_bake_cake_async</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">               </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">guint</span><span class="normal">                radius</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFlavor</span><span class="normal">           flavor</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFrostingType</span><span class="normal">     frosting</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal">          </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">gint</span><span class="normal">                 priority</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GCancellable</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GAsyncReadyCallback</span><span class="normal">  callback</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">gpointer</span><span class="normal">             user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">BakingData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bd</span><span class="symbol">;</span>
+      source <span class="gtkdoc opt">=</span> <span class="function">cake_decorator_wait_source_new</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">);</span>
+      <span class="gtkdoc slc">// Attach &#64;source to &#64;task's GMainContext and have it call</span>
+      <span class="gtkdoc slc">// decorator_ready() when it is ready.</span>
+      <span class="function"><a href="GTask.html#g-task-attach-source">g_task_attach_source</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> source<span class="gtkdoc opt">,</span> decorator_ready<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="../glib/glib-The-Main-Event-Loop.html#g-source-unref">g_source_unref</a></span> <span class="gtkdoc opt">(</span>source<span class="gtkdoc opt">);</span>
+    <span class="gtkdoc opt">}</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">  task </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> callback</span><span class="symbol">,</span><span class="normal"> user_data</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-priority">g_task_set_priority</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> priority</span><span class="symbol">);</span>
+<span class="gtkdoc kwb">void</span>
+<span class="function">baker_bake_cake_async</span> <span class="gtkdoc opt">(</span>Baker               <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                       guint                radius<span class="gtkdoc opt">,</span>
+                       CakeFlavor           flavor<span class="gtkdoc opt">,</span>
+                       CakeFrostingType     frosting<span class="gtkdoc opt">,</span>
+                       <span class="gtkdoc kwb">const char</span>          <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">,</span>
+                       gint                 priority<span class="gtkdoc opt">,</span>
+                       GCancellable        <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">,</span>
+                       GAsyncReadyCallback  callback<span class="gtkdoc opt">,</span>
+                       gpointer             user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
+  BakingData <span class="gtkdoc opt">*</span>bd<span class="gtkdoc opt">;</span>
-<span class="normal">  bd </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new0">g_slice_new0</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">BakingData</span><span class="symbol">);</span>
-<span class="normal">  bd</span><span class="symbol">-&gt;</span><span class="normal">frosting </span><span class="symbol">=</span><span class="normal"> frosting</span><span class="symbol">;</span>
-<span class="normal">  bd</span><span class="symbol">-&gt;</span><span class="normal">message </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> bd</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> baking_data_free</span><span class="symbol">);</span>
+  task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> callback<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-priority">g_task_set_priority</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> priority<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function">_baker_begin_cake</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> radius</span><span class="symbol">,</span><span class="normal"> flavor</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> baked_cb</span><span class="symbol">,</span><span class="normal"> task</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  bd <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new0">g_slice_new0</a></span> <span class="gtkdoc opt">(</span>BakingData<span class="gtkdoc opt">);</span>
+  bd<span class="gtkdoc opt">-&gt;</span>frosting <span class="gtkdoc opt">=</span> frosting<span class="gtkdoc opt">;</span>
+  bd<span class="gtkdoc opt">-&gt;</span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>message<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bd<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> baking_data_free<span class="gtkdoc opt">);</span>
-<span class="normal">Cake </span><span class="symbol">*</span>
-<span class="function">baker_bake_cake_finish</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                        </span><span class="usertype">GAsyncResult</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">result</span><span class="symbol">,</span>
-<span class="normal">                        </span><span class="usertype">GError</span><span class="normal">       </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">,</span><span class="normal"> self</span><span class="symbol">),</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+  <span class="function">_baker_begin_cake</span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> radius<span class="gtkdoc opt">,</span> flavor<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> baked_cb<span class="gtkdoc opt">,</span> task<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_TASK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">),</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+Cake <span class="gtkdoc opt">*</span>
+<span class="function">baker_bake_cake_finish</span> <span class="gtkdoc opt">(</span>Baker         <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                        GAsyncResult  <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
+                        GError       <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">,</span> self<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
+  <span class="keyword">return</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span><span class="function">G_TASK</span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">),</span> error<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -905,73 +907,73 @@ which will then dispatch the result back to the caller's
 65
 66
 67</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">guint</span><span class="normal"> radius</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">CakeFlavor</span><span class="normal"> flavor</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">CakeFrostingType</span><span class="normal"> frosting</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">;</span>
-<span class="cbracket">}</span><span class="normal"> CakeData</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">struct</span> <span class="gtkdoc opt">{</span>
+  guint radius<span class="gtkdoc opt">;</span>
+  CakeFlavor flavor<span class="gtkdoc opt">;</span>
+  CakeFrostingType frosting<span class="gtkdoc opt">;</span>
+  <span class="gtkdoc kwb">char</span> <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span> CakeData<span class="gtkdoc opt">;</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">cake_data_free</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">CakeData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake_data</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">CakeData</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">cake_data_free</span> <span class="gtkdoc opt">(</span>CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>cake_data<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">bake_cake_thread</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GTask</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="usertype">gpointer</span><span class="normal">       source_object</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="usertype">gpointer</span><span class="normal">       task_data</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="usertype">GCancellable</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">Baker</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self </span><span class="symbol">=</span><span class="normal"> source_object</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">CakeData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake_data </span><span class="symbol">=</span><span class="normal"> task_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">Cake</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">bake_cake_thread</span> <span class="gtkdoc opt">(</span>GTask         <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">,</span>
+                  gpointer       source_object<span class="gtkdoc opt">,</span>
+                  gpointer       task_data<span class="gtkdoc opt">,</span>
+                  GCancellable  <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  Baker <span class="gtkdoc opt">*</span>self <span class="gtkdoc opt">=</span> source_object<span class="gtkdoc opt">;</span>
+  CakeData <span class="gtkdoc opt">*</span>cake_data <span class="gtkdoc opt">=</span> task_data<span class="gtkdoc opt">;</span>
+  Cake <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">;</span>
+  GError <span class="gtkdoc opt">*</span>error <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  cake </span><span class="symbol">=</span><span class="normal"> </span><span class="function">bake_cake</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">baker</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">-&gt;</span><span class="normal">radius</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">-&gt;</span><span class="normal">flavor</span><span class="symbol">,</span>
-<span class="normal">                    cake_data</span><span class="symbol">-&gt;</span><span class="normal">frosting</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                    cancellable</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cake</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake</span><span class="symbol">,</span><span class="normal"> <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">else</span>
-<span class="normal">    </span><span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  cake <span class="gtkdoc opt">=</span> <span class="function">bake_cake</span> <span class="gtkdoc opt">(</span>baker<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">-&gt;</span>radius<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">-&gt;</span>flavor<span class="gtkdoc opt">,</span>
+                    cake_data<span class="gtkdoc opt">-&gt;</span>frosting<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">,</span>
+                    cancellable<span class="gtkdoc opt">, &amp;</span>error<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>cake<span class="gtkdoc opt">)</span>
+    <span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">);</span>
+  <span class="keyword">else</span>
+    <span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="type">void</span>
-<span class="function">baker_bake_cake_async</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">               </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">guint</span><span class="normal">                radius</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFlavor</span><span class="normal">           flavor</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFrostingType</span><span class="normal">     frosting</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal">          </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GCancellable</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GAsyncReadyCallback</span><span class="normal">  callback</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">gpointer</span><span class="normal">             user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">CakeData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">;</span>
+<span class="gtkdoc kwb">void</span>
+<span class="function">baker_bake_cake_async</span> <span class="gtkdoc opt">(</span>Baker               <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                       guint                radius<span class="gtkdoc opt">,</span>
+                       CakeFlavor           flavor<span class="gtkdoc opt">,</span>
+                       CakeFrostingType     frosting<span class="gtkdoc opt">,</span>
+                       <span class="gtkdoc kwb">const char</span>          <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">,</span>
+                       GCancellable        <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">,</span>
+                       GAsyncReadyCallback  callback<span class="gtkdoc opt">,</span>
+                       gpointer             user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">;</span>
+  GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
-<span class="normal">  cake_data </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">CakeData</span><span class="symbol">);</span>
-<span class="normal">  cake_data</span><span class="symbol">-&gt;</span><span class="normal">radius </span><span class="symbol">=</span><span class="normal"> radius</span><span class="symbol">;</span>
-<span class="normal">  cake_data</span><span class="symbol">-&gt;</span><span class="normal">flavor </span><span class="symbol">=</span><span class="normal"> flavor</span><span class="symbol">;</span>
-<span class="normal">  cake_data</span><span class="symbol">-&gt;</span><span class="normal">frosting </span><span class="symbol">=</span><span class="normal"> frosting</span><span class="symbol">;</span>
-<span class="normal">  cake_data</span><span class="symbol">-&gt;</span><span class="normal">message </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">  task </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> callback</span><span class="symbol">,</span><span class="normal"> user_data</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> cake_data_free</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-run-in-thread">g_task_run_in_thread</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> bake_cake_thread</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">);</span>
+  cake_data<span class="gtkdoc opt">-&gt;</span>radius <span class="gtkdoc opt">=</span> radius<span class="gtkdoc opt">;</span>
+  cake_data<span class="gtkdoc opt">-&gt;</span>flavor <span class="gtkdoc opt">=</span> flavor<span class="gtkdoc opt">;</span>
+  cake_data<span class="gtkdoc opt">-&gt;</span>frosting <span class="gtkdoc opt">=</span> frosting<span class="gtkdoc opt">;</span>
+  cake_data<span class="gtkdoc opt">-&gt;</span>message <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>message<span class="gtkdoc opt">);</span>
+  task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> callback<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> cake_data_free<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-run-in-thread">g_task_run_in_thread</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bake_cake_thread<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">Cake </span><span class="symbol">*</span>
-<span class="function">baker_bake_cake_finish</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                        </span><span class="usertype">GAsyncResult</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">result</span><span class="symbol">,</span>
-<span class="normal">                        </span><span class="usertype">GError</span><span class="normal">       </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">,</span><span class="normal"> self</span><span class="symbol">),</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+Cake <span class="gtkdoc opt">*</span>
+<span class="function">baker_bake_cake_finish</span> <span class="gtkdoc opt">(</span>Baker         <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                        GAsyncResult  <span class="gtkdoc opt">*</span>result<span class="gtkdoc opt">,</span>
+                        GError       <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-is-valid">g_task_is_valid</a></span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">,</span> self<span class="gtkdoc opt">),</span> NULL<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_TASK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">result</span><span class="symbol">),</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">return</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span><span class="function">G_TASK</span> <span class="gtkdoc opt">(</span>result<span class="gtkdoc opt">),</span> error<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1085,94 +1087,94 @@ synchronous variants of blocking APIs.</p>
 86
 87
 88</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">bake_cake_thread</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GTask</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="usertype">gpointer</span><span class="normal">       source_object</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="usertype">gpointer</span><span class="normal">       task_data</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="usertype">GCancellable</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">Baker</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self </span><span class="symbol">=</span><span class="normal"> source_object</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">CakeData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake_data </span><span class="symbol">=</span><span class="normal"> task_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">Cake</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
+<span class="function">bake_cake_thread</span> <span class="gtkdoc opt">(</span>GTask         <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">,</span>
+                  gpointer       source_object<span class="gtkdoc opt">,</span>
+                  gpointer       task_data<span class="gtkdoc opt">,</span>
+                  GCancellable  <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  Baker <span class="gtkdoc opt">*</span>self <span class="gtkdoc opt">=</span> source_object<span class="gtkdoc opt">;</span>
+  CakeData <span class="gtkdoc opt">*</span>cake_data <span class="gtkdoc opt">=</span> task_data<span class="gtkdoc opt">;</span>
+  Cake <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">;</span>
+  GError <span class="gtkdoc opt">*</span>error <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  cake </span><span class="symbol">=</span><span class="normal"> </span><span class="function">bake_cake</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">baker</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">-&gt;</span><span class="normal">radius</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">-&gt;</span><span class="normal">flavor</span><span class="symbol">,</span>
-<span class="normal">                    cake_data</span><span class="symbol">-&gt;</span><span class="normal">frosting</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                    </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  cake <span class="gtkdoc opt">=</span> <span class="function">bake_cake</span> <span class="gtkdoc opt">(</span>baker<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">-&gt;</span>radius<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">-&gt;</span>flavor<span class="gtkdoc opt">,</span>
+                    cake_data<span class="gtkdoc opt">-&gt;</span>frosting<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">,</span>
+                    <span class="gtkdoc opt">&amp;</span>error<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>error<span class="gtkdoc opt">)</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="function"><a href="GTask.html#g-task-return-error">g_task_return_error</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
+      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+    <span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="comment">// If the task has already been cancelled, then we don't want to add</span>
-<span class="normal">  </span><span class="comment">// the cake to the cake cache. Likewise, we don't  want to have the</span>
-<span class="normal">  </span><span class="comment">// task get cancelled in the middle of updating the cache.</span>
-<span class="normal">  </span><span class="comment">// g_task_set_return_on_cancel() will return %TRUE here if it managed</span>
-<span class="normal">  </span><span class="comment">// to disable return-on-cancel, or %FALSE if the task was cancelled</span>
-<span class="normal">  </span><span class="comment">// before it could.</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GTask.html#g-task-set-return-on-cancel">g_task_set_return_on_cancel</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="comment">// If the caller cancels at this point, their</span>
-<span class="normal">      </span><span class="comment">// GAsyncReadyCallback won't be invoked until we return,</span>
-<span class="normal">      </span><span class="comment">// so we don't have to worry that this code will run at</span>
-<span class="normal">      </span><span class="comment">// the same time as that code does. But if there were</span>
-<span class="normal">      </span><span class="comment">// other functions that might look at the cake cache,</span>
-<span class="normal">      </span><span class="comment">// then we'd probably need a GMutex here as well.</span>
-<span class="normal">      </span><span class="function">baker_add_cake_to_cache</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">baker</span><span class="symbol">,</span><span class="normal"> cake</span><span class="symbol">);</span>
-<span class="normal">      </span><span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake</span><span class="symbol">,</span><span class="normal"> <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">);</span>
-<span class="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span>
+  <span class="gtkdoc slc">// If the task has already been cancelled, then we don't want to add</span>
+  <span class="gtkdoc slc">// the cake to the cake cache. Likewise, we don't  want to have the</span>
+  <span class="gtkdoc slc">// task get cancelled in the middle of updating the cache.</span>
+  <span class="gtkdoc slc">// g_task_set_return_on_cancel() will return %TRUE here if it managed</span>
+  <span class="gtkdoc slc">// to disable return-on-cancel, or %FALSE if the task was cancelled</span>
+  <span class="gtkdoc slc">// before it could.</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="GTask.html#g-task-set-return-on-cancel">g_task_set_return_on_cancel</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> FALSE<span class="gtkdoc opt">))</span>
+    <span class="gtkdoc opt">{</span>
+      <span class="gtkdoc slc">// If the caller cancels at this point, their</span>
+      <span class="gtkdoc slc">// GAsyncReadyCallback won't be invoked until we return,</span>
+      <span class="gtkdoc slc">// so we don't have to worry that this code will run at</span>
+      <span class="gtkdoc slc">// the same time as that code does. But if there were</span>
+      <span class="gtkdoc slc">// other functions that might look at the cake cache,</span>
+      <span class="gtkdoc slc">// then we'd probably need a GMutex here as well.</span>
+      <span class="function">baker_add_cake_to_cache</span> <span class="gtkdoc opt">(</span>baker<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">);</span>
+      <span class="function"><a href="GTask.html#g-task-return-pointer">g_task_return_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">);</span>
+    <span class="gtkdoc opt">}</span>
+<span class="gtkdoc opt">}</span>
-<span class="type">void</span>
-<span class="function">baker_bake_cake_async</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">               </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">guint</span><span class="normal">                radius</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFlavor</span><span class="normal">           flavor</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">CakeFrostingType</span><span class="normal">     frosting</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal">          </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GCancellable</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">GAsyncReadyCallback</span><span class="normal">  callback</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">gpointer</span><span class="normal">             user_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">CakeData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">;</span>
+<span class="gtkdoc kwb">void</span>
+<span class="function">baker_bake_cake_async</span> <span class="gtkdoc opt">(</span>Baker               <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                       guint                radius<span class="gtkdoc opt">,</span>
+                       CakeFlavor           flavor<span class="gtkdoc opt">,</span>
+                       CakeFrostingType     frosting<span class="gtkdoc opt">,</span>
+                       <span class="gtkdoc kwb">const char</span>          <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">,</span>
+                       GCancellable        <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">,</span>
+                       GAsyncReadyCallback  callback<span class="gtkdoc opt">,</span>
+                       gpointer             user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">;</span>
+  GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
-<span class="normal">  cake_data </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">CakeData</span><span class="symbol">);</span>
+  cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="symbol">...</span>
+  <span class="gtkdoc opt">...</span>
-<span class="normal">  task </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> callback</span><span class="symbol">,</span><span class="normal"> user_data</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> cake_data_free</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-return-on-cancel">g_task_set_return_on_cancel</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-run-in-thread">g_task_run_in_thread</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> bake_cake_thread</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+  task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> callback<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> cake_data_free<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-return-on-cancel">g_task_set_return_on_cancel</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> TRUE<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-run-in-thread">g_task_run_in_thread</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bake_cake_thread<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">Cake </span><span class="symbol">*</span>
-<span class="function">baker_bake_cake_sync</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Baker</span><span class="normal">               </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span>
-<span class="normal">                      </span><span class="usertype">guint</span><span class="normal">                radius</span><span class="symbol">,</span>
-<span class="normal">                      </span><span class="usertype">CakeFlavor</span><span class="normal">           flavor</span><span class="symbol">,</span>
-<span class="normal">                      </span><span class="usertype">CakeFrostingType</span><span class="normal">     frosting</span><span class="symbol">,</span>
-<span class="normal">                      </span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal">          </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                      </span><span class="usertype">GCancellable</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">cancellable</span><span class="symbol">,</span>
-<span class="normal">                      </span><span class="usertype">GError</span><span class="normal">             </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">CakeData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake_data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GTask</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">task</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">Cake</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cake</span><span class="symbol">;</span>
+Cake <span class="gtkdoc opt">*</span>
+<span class="function">baker_bake_cake_sync</span> <span class="gtkdoc opt">(</span>Baker               <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span>
+                      guint                radius<span class="gtkdoc opt">,</span>
+                      CakeFlavor           flavor<span class="gtkdoc opt">,</span>
+                      CakeFrostingType     frosting<span class="gtkdoc opt">,</span>
+                      <span class="gtkdoc kwb">const char</span>          <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">,</span>
+                      GCancellable        <span class="gtkdoc opt">*</span>cancellable<span class="gtkdoc opt">,</span>
+                      GError             <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  CakeData <span class="gtkdoc opt">*</span>cake_data<span class="gtkdoc opt">;</span>
+  GTask <span class="gtkdoc opt">*</span>task<span class="gtkdoc opt">;</span>
+  Cake <span class="gtkdoc opt">*</span>cake<span class="gtkdoc opt">;</span>
-<span class="normal">  cake_data </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">CakeData</span><span class="symbol">);</span>
+  cake_data <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span> <span class="gtkdoc opt">(</span>CakeData<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="symbol">...</span>
+  <span class="gtkdoc opt">...</span>
-<span class="normal">  task </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> cancellable</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> cake_data</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> cake_data_free</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-set-return-on-cancel">g_task_set_return_on_cancel</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="GTask.html#g-task-run-in-thread-sync">g_task_run_in_thread_sync</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> bake_cake_thread</span><span class="symbol">);</span>
+  task <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-new">g_task_new</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> cancellable<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-task-data">g_task_set_task_data</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> cake_data<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> cake_data_free<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-set-return-on-cancel">g_task_set_return_on_cancel</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> TRUE<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="GTask.html#g-task-run-in-thread-sync">g_task_run_in_thread_sync</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> bake_cake_thread<span class="gtkdoc opt">);</span>
-<span class="normal">  cake </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">task</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> cake</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+  cake <span class="gtkdoc opt">=</span> <span class="function"><a href="GTask.html#g-task-propagate-pointer">g_task_propagate_pointer</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>task<span class="gtkdoc opt">);</span>
+  <span class="keyword">return</span> cake<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1267,7 +1269,7 @@ do not want this behavior, you can use
 <a class="link" href="GTask.html#g-task-set-check-cancellable" title="g_task_set_check_cancellable ()"><code class="function">g_task_set_check_cancellable()</code></a> to change it.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.2.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1302,9 +1304,8 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
 <div class="refsect3">
 <a name="id-1.4.5.4.10.2.8"></a><h4>Returns</h4>
 <p> a <a class="link" href="GTask.html" title="GTask"><span class="type">GTask</span></a>.</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1317,7 +1318,7 @@ g_task_set_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
 's task data (freeing the existing task data, if any).</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.3.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1343,7 +1344,7 @@ g_task_set_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1360,7 +1361,7 @@ and can also be explicitly retrieved later via
 <a class="link" href="GTask.html#g-task-get-priority" title="g_task_get_priority ()"><code class="function">g_task_get_priority()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.4.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1380,7 +1381,7 @@ and can also be explicitly retrieved later via
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1405,7 +1406,7 @@ via <a class="link" href="GTask.html#g-task-return-error-if-cancelled" title="g_
 you must leave check-cancellable set <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.5.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1426,7 +1427,7 @@ its <a class="link" href="GCancellable.html" title="GCancellable"><span class="t
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1463,7 +1464,7 @@ again will cause the task to be cancelled at that point.</p>
 will also be completed right away.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.6.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1492,9 +1493,8 @@ match <em class="parameter"><code>return_on_cancel</code></em>
 . <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>task</code></em>
 has already been
 cancelled.</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1511,7 +1511,7 @@ task's "finish" function, to figure out if the response came from a
 particular place.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.7.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1531,7 +1531,7 @@ particular place.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1551,7 +1551,7 @@ wrapper method, and deal with it appropriately if so.</p>
 <p>See also <a class="link" href="GTask.html#g-task-report-new-error" title="g_task_report_new_error ()"><code class="function">g_task_report_new_error()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.8.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1588,7 +1588,7 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1612,7 +1612,7 @@ appropriately if so.</p>
 <p>See also <a class="link" href="GTask.html#g-task-report-error" title="g_task_report_error ()"><code class="function">g_task_report_error()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.9.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1665,7 +1665,7 @@ this task, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1676,7 +1676,7 @@ g_task_get_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
 's <code class="literal">task_data</code>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.10.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1695,7 +1695,7 @@ g_task_get_task_data (<em class="parameter"><code><a class="link" href="GTask.ht
 's <code class="literal">task_data</code>. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1706,7 +1706,7 @@ g_task_get_priority (<em class="parameter"><code><a class="link" href="GTask.htm
 's priority</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.11.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1723,9 +1723,8 @@ g_task_get_priority (<em class="parameter"><code><a class="link" href="GTask.htm
 <a name="id-1.4.5.4.10.11.6"></a><h4>Returns</h4>
 <p> <em class="parameter"><code>task</code></em>
 's priority</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1736,7 +1735,7 @@ g_task_get_cancellable (<em class="parameter"><code><a class="link" href="GTask.
 's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a></p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.12.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1755,7 +1754,7 @@ g_task_get_cancellable (<em class="parameter"><code><a class="link" href="GTask.
 's <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1767,7 +1766,7 @@ g_task_get_check_cancellable (<em class="parameter"><code><a class="link" href="
 <a class="link" href="GTask.html#g-task-set-check-cancellable" title="g_task_set_check_cancellable ()"><code class="function">g_task_set_check_cancellable()</code></a> for more details.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.13.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1780,7 +1779,7 @@ g_task_get_check_cancellable (<em class="parameter"><code><a class="link" href="
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1792,7 +1791,7 @@ g_task_get_return_on_cancel (<em class="parameter"><code><a class="link" href="G
 <a class="link" href="GTask.html#g-task-set-return-on-cancel" title="g_task_set_return_on_cancel ()"><code class="function">g_task_set_return_on_cancel()</code></a> for more details.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.14.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1805,7 +1804,7 @@ g_task_get_return_on_cancel (<em class="parameter"><code><a class="link" href="G
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1822,7 +1821,7 @@ at the point when <em class="parameter"><code>task</code></em>
 context is the default <a href="../glib/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.15.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1841,7 +1840,7 @@ context is the default <a href="../glib/glib-The-Main-Event-Loop.html#GMainConte
 's <a href="../glib/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a>. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1853,7 +1852,7 @@ g_task_get_source_object (<em class="parameter"><code><a class="link" href="GTas
 <a class="link" href="GAsyncResult.html#g-async-result-get-source-object" title="g_async_result_get_source_object ()"><code class="function">g_async_result_get_source_object()</code></a>, but does not ref the object.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.16.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1872,7 +1871,7 @@ g_task_get_source_object (<em class="parameter"><code><a class="link" href="GTas
 's source object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject]</span></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1883,7 +1882,7 @@ g_task_get_source_tag (<em class="parameter"><code><a class="link" href="GTask.h
 's source tag. See <a class="link" href="GTask.html#g-task-set-source-tag" title="g_task_set_source_tag ()"><code class="function">g_task_set_source_tag()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.17.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1902,7 +1901,7 @@ g_task_get_source_tag (<em class="parameter"><code><a class="link" href="GTask.h
 's source tag. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1917,7 +1916,7 @@ g_task_return_boolean (<em class="parameter"><code><a class="link" href="GTask.h
 means).</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.18.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1937,7 +1936,7 @@ means).</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1952,7 +1951,7 @@ g_task_return_int (<em class="parameter"><code><a class="link" href="GTask.html"
 means).</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.19.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1972,7 +1971,7 @@ means).</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2006,7 +2005,7 @@ valid after calling this, unless you are still holding another
 reference on it.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.20.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2032,7 +2031,7 @@ function. </p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2056,7 +2055,7 @@ as well.</p>
 <p>See also <a class="link" href="GTask.html#g-task-return-new-error" title="g_task_return_new_error ()"><code class="function">g_task_return_new_error()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.21.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2076,7 +2075,7 @@ as well.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2098,7 +2097,7 @@ means).</p>
 <p>See also <a class="link" href="GTask.html#g-task-return-error" title="g_task_return_error ()"><code class="function">g_task_return_error()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.22.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2134,7 +2133,7 @@ means).</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2149,7 +2148,7 @@ g_task_return_error_if_cancelled (<em class="parameter"><code><a class="link" hr
 means).</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.23.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2166,9 +2165,8 @@ means).</p>
 <a name="id-1.4.5.4.10.23.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>task</code></em>
 has been cancelled, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2185,7 +2183,7 @@ instead return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code clas
 error) to the caller, you may only call it once.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.24.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2208,9 +2206,8 @@ error) to the caller, you may only call it once.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.24.8"></a><h4>Returns</h4>
 <p> the task result, or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2227,7 +2224,7 @@ instead return -1 and set <em class="parameter"><code>error</code></em>
 error) to the caller, you may only call it once.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.25.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2250,9 +2247,8 @@ error) to the caller, you may only call it once.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.25.8"></a><h4>Returns</h4>
 <p> the task result, or -1 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2270,7 +2266,7 @@ instead return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class
 error) to the caller, you may only call it once.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.26.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2295,7 +2291,7 @@ error) to the caller, you may only call it once.</p>
 <p> the task result, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2306,7 +2302,7 @@ g_task_had_error (<em class="parameter"><code><a class="link" href="GTask.html"
  resulted in an error.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.27.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2322,9 +2318,8 @@ g_task_had_error (<em class="parameter"><code><a class="link" href="GTask.html"
 <div class="refsect3">
 <a name="id-1.4.5.4.10.27.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the task resulted in an error, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2336,7 +2331,7 @@ the task’s callback is invoked, and will return <a href="../glib/glib-Standard
 the callback.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.28.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2352,9 +2347,8 @@ the callback.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.28.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the task has completed, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
-<p></p>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2372,9 +2366,14 @@ g_task_run_in_thread (<em class="parameter"><code><a class="link" href="GTask.ht
  until the task completes.</p>
 <p>See <a class="link" href="GTask.html#GTaskThreadFunc" title="GTaskThreadFunc ()"><span class="type">GTaskThreadFunc</span></a> for more details about how <em class="parameter"><code>task_func</code></em>
  is handled.</p>
+<p>Although GLib currently rate-limits the tasks queued via
+<a class="link" href="GTask.html#g-task-run-in-thread" title="g_task_run_in_thread ()"><code class="function">g_task_run_in_thread()</code></a>, you should not assume that it will always
+do this. If you have a very large number of tasks to run, but don't
+want them to all run at once, you should only queue a limited
+number of them at a time.</p>
 <div class="refsect3">
-<a name="id-1.4.5.4.10.29.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.5.4.10.29.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2394,7 +2393,7 @@ g_task_run_in_thread (<em class="parameter"><code><a class="link" href="GTask.ht
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2414,9 +2413,14 @@ to get the result of <em class="parameter"><code>task_func</code></em>
 have a callback, it will not be invoked when <em class="parameter"><code>task_func</code></em>
  returns.
 <a class="link" href="GTask.html#GTask--completed" title="The “completed” property"><span class="type">“completed”</span></a> will be set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> just before this function returns.</p>
+<p>Although GLib currently rate-limits the tasks queued via
+<a class="link" href="GTask.html#g-task-run-in-thread-sync" title="g_task_run_in_thread_sync ()"><code class="function">g_task_run_in_thread_sync()</code></a>, you should not assume that it will
+always do this. If you have a very large number of tasks to run,
+but don't want them to all run at once, you should only queue a
+limited number of them at a time.</p>
 <div class="refsect3">
-<a name="id-1.4.5.4.10.30.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.5.4.10.30.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2436,7 +2440,7 @@ have a callback, it will not be invoked when <em class="parameter"><code>task_fu
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2464,7 +2468,7 @@ externally-visible state in this case. See
 <code class="literal">g_task_return_</code> function.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.31.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2497,7 +2501,7 @@ externally-visible state in this case. See
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2521,7 +2525,7 @@ callback to <em class="parameter"><code>callback</code></em>
  is destroyed.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.32.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2547,7 +2551,7 @@ triggers</p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2564,7 +2568,7 @@ source object (or that <em class="parameter"><code>source_object</code></em>
 source object). This can be used in <a href="../glib/glib-Warnings-and-Assertions.html#g-return-if-fail"><code class="function">g_return_if_fail()</code></a> checks.</p>
 <div class="refsect3">
 <a name="id-1.4.5.4.10.33.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2591,9 +2595,8 @@ expected to be associated with the task. </p></td>
 and <em class="parameter"><code>source_object</code></em>
 are valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
 if not</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -2619,7 +2622,7 @@ on the task.</p>
 context as the task’s callback, immediately after that callback is invoked.</p>
 <p>Flags: Read</p>
 <p>Default value: FALSE</p>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -2628,7 +2631,6 @@ context as the task’s callback, immediately after that callback is invoked.</p
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>