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

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

Files changed (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>