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

glib2 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

Files changed (1058) hide show

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Signals: GObject 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="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
 <link rel="prev" href="gobject-Varargs-Value-Collection.html" title="Varargs Value Collection">
 <link rel="next" href="gobject-Closures.html" title="Closures">
-<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">
@@ -34,7 +34,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="gobject-Signals.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">
@@ -418,7 +418,7 @@
 </div>
 <div class="refsect1">
 <a name="gobject-Signals.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">
@@ -516,6 +516,29 @@ argument of the signal handler currently subject to invocation.
 Specification of no detail argument for signal handlers (omission of the
 detail part of the signal specification upon connection) serves as a
 wildcard and matches any detail argument passed in to emission.</p>
+<div class="refsect3">
+<a name="signal-memory-management"></a><h4>Memory management of signal handlers</h4>
+<p>If you are connecting handlers to signals and using a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance as
+your signal handler user data, you should remember to pair calls to
+<a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()"><code class="function">g_signal_connect()</code></a> with calls to <a class="link" href="gobject-Signals.html#g-signal-handler-disconnect" title="g_signal_handler_disconnect ()"><code class="function">g_signal_handler_disconnect()</code></a> or
+<a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-by-func" title="g_signal_handlers_disconnect_by_func()"><code class="function">g_signal_handlers_disconnect_by_func()</code></a>. While signal handlers are
+automatically disconnected when the object emitting the signal is finalised,
+they are not automatically disconnected when the signal handler user data is
+destroyed. If this user data is a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance, using it from a
+signal handler after it has been finalised is an error.</p>
+<p>There are two strategies for managing such user data. The first is to
+disconnect the signal handler (using <a class="link" href="gobject-Signals.html#g-signal-handler-disconnect" title="g_signal_handler_disconnect ()"><code class="function">g_signal_handler_disconnect()</code></a> or
+<a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-by-func" title="g_signal_handlers_disconnect_by_func()"><code class="function">g_signal_handlers_disconnect_by_func()</code></a>) when the user data (object) is
+finalised; this has to be implemented manually. For non-threaded programs,
+<a class="link" href="gobject-Signals.html#g-signal-connect-object" title="g_signal_connect_object ()"><code class="function">g_signal_connect_object()</code></a> can be used to implement this automatically.
+Currently, however, it is unsafe to use in threaded programs.</p>
+<p>The second is to hold a strong reference on the user data until after the
+signal is disconnected for other reasons. This can be implemented
+automatically using <a class="link" href="gobject-Signals.html#g-signal-connect-data" title="g_signal_connect_data ()"><code class="function">g_signal_connect_data()</code></a>.</p>
+<p>The first approach is recommended, as the second approach can result in
+effective memory leaks of the user data if the signal handler is never
+disconnected for some reason.</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="gobject-Signals.functions_details"></a><h2>Functions</h2>
@@ -534,7 +557,7 @@ values is performed. The return value of signal emissions is then the
 value returned by the last callback.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.2.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">
@@ -570,7 +593,6 @@ is the return value of the current signal emission.</p></td>
 <p> The accumulator function returns whether the signal emission
 should be aborted. Returning <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> means to abort the
 current emission and <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned for continuation.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -587,7 +609,7 @@ emissions of that signal, from any object.</p>
 <p>You may not attach these to signals created with the <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS"><span class="type">G_SIGNAL_NO_HOOKS</span></a> flag.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.3.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">
@@ -623,7 +645,6 @@ the signal was emitted, followed by the parameters of the emission. </p></td>
 <a name="id-1.4.12.7.3.7"></a><h4>Returns</h4>
 <p> whether it wants to stay connected. If it returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, the signal
 hook is disconnected (and destroyed).</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -648,14 +669,14 @@ to the corresponding argument of <a class="link" href="gobject-Signals.html#g-si
 6
 7
 8</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-new">g_signal_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"size_request"</span><span class="symbol">,</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-FROM-CLASS:CAPS">G_TYPE_FROM_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gobject_class</span><span class="symbol">),</span>
-<span class="normal">     <a href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">G_SIGNAL_RUN_FIRST</a></span><span class="symbol">,</span>
-<span class="normal">     </span><span class="function"><a href="../glib/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://developer.gnome.org/gtk2/GtkWidget.html#GtkWidgetClass">GtkWidgetClass</a></span><span class="symbol">,</span><span class="normal"> size_request</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">     _gtk_marshal_VOID__BOXED</span><span class="symbol">,</span>
-<span class="normal">     <a href="gobject-Type-Information.html#G-TYPE-NONE:CAPS">G_TYPE_NONE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span>
-<span class="normal">     GTK_TYPE_REQUISITION </span><span class="symbol">|</span><span class="normal"> <a href="gobject-Signals.html#G-SIGNAL-TYPE-STATIC-SCOPE:CAPS">G_SIGNAL_TYPE_STATIC_SCOPE</a></span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-new">g_signal_new</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;size_request&quot;</span><span class="gtkdoc opt">,</span>
+  <span class="function"><a href="gobject-Type-Information.html#G-TYPE-FROM-CLASS:CAPS">G_TYPE_FROM_CLASS</a></span> <span class="gtkdoc opt">(</span>gobject_class<span class="gtkdoc opt">),</span>
+	 G_SIGNAL_RUN_FIRST<span class="gtkdoc opt">,</span>
+	 <span class="function"><a href="../glib/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="gtkdoc opt">(</span>GtkWidgetClass<span class="gtkdoc opt">,</span> size_request<span class="gtkdoc opt">),</span>
+	 NULL<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span>
+	 _gtk_marshal_VOID__BOXED<span class="gtkdoc opt">,</span>
+	 G_TYPE_NONE<span class="gtkdoc opt">,</span> <span class="number">1</span><span class="gtkdoc opt">,</span>
+	 GTK_TYPE_REQUISITION <span class="gtkdoc opt">|</span> G_SIGNAL_TYPE_STATIC_SCOPE<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -692,7 +713,7 @@ Instead they will have to use <a class="link" href="gobject-Signals.html#g-signa
 the marshaller for this signal.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.5.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">
@@ -763,7 +784,6 @@ without a return value.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.5.10"></a><h4>Returns</h4>
 <p> the signal id</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -786,7 +806,7 @@ g_signal_newv (<em class="parameter"><code>const <a href="../glib/glib-Basic-Typ
 the marshaller for this signal.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.6.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">
@@ -859,7 +879,6 @@ each parameter. </p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.6.8"></a><h4>Returns</h4>
 <p> the signal id</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -882,7 +901,7 @@ g_signal_new_valist (<em class="parameter"><code>const <a href="../glib/glib-Bas
 the marshaller for this signal.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.7.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">
@@ -952,7 +971,6 @@ without a return value.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.7.8"></a><h4>Returns</h4>
 <p> the signal id</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -968,7 +986,7 @@ common case of a single connected signal handler and avoids the
 overhead of <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>.  Its use is optional.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.8.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">
@@ -993,7 +1011,7 @@ overhead of <a class="link" href="gobject-Generic-values.html#GValue" title="GVa
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1010,7 +1028,7 @@ is 0. All members filled into the <a class="link" href="gobject-Signals.html#GSi
 be considered constant and have to be left untouched.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.9.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">
@@ -1045,7 +1063,7 @@ somewhat faster than using the name each time.</p>
 <p>See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for details on allowed signal names.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.10.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">
@@ -1068,7 +1086,6 @@ somewhat faster than using the name each time.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.10.8"></a><h4>Returns</h4>
 <p> the signal's identifying number, or 0 if no signal was found.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1080,7 +1097,7 @@ g_signal_name (<em class="parameter"><code><a href="../glib/glib-Basic-Types.htm
 <p>Two different signals may have the same name, if they have differing types.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.11.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">
@@ -1096,7 +1113,6 @@ g_signal_name (<em class="parameter"><code><a href="../glib/glib-Basic-Types.htm
 <div class="refsect3">
 <a name="id-1.4.12.7.11.7"></a><h4>Returns</h4>
 <p> the signal name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the signal number was invalid.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1110,7 +1126,7 @@ created. Further information about the signals can be acquired through
 <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()"><code class="function">g_signal_query()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.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">
@@ -1134,7 +1150,7 @@ created. Further information about the signals can be acquired through
 <div class="refsect3">
 <a name="id-1.4.12.7.12.6"></a><h4>Returns</h4>
 <p> Newly allocated array of signal IDs. </p>
-<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_ids]</span></p>
+<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_ids][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -1150,7 +1166,7 @@ g_signal_emit (<em class="parameter"><code><a href="../glib/glib-Basic-Types.htm
 if no handlers are connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.13.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">
@@ -1195,7 +1211,7 @@ g_signal_emit_by_name (<em class="parameter"><code><a href="../glib/glib-Basic-T
 if no handlers are connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.14.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">
@@ -1237,7 +1253,7 @@ g_signal_emitv (<em class="parameter"><code>const <a class="link" href="gobject-
 connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit()</code></a> and <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()"><code class="function">g_signal_emit_valist()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.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">
@@ -1263,8 +1279,10 @@ is being emitted on. The rest are any arguments to be passed to the signal. </p>
 </tr>
 <tr>
 <td class="parameter_name"><p>return_value</p></td>
-<td class="parameter_description"><p>Location to store the return value of the signal emission.</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> Location to
+store the return value of the signal emission. This must be provided if the
+specified signal returns a value, but may be ignored otherwise. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -1281,9 +1299,10 @@ g_signal_emit_valist (<em class="parameter"><code><a href="../glib/glib-Basic-Ty
 <p>Emits a signal.</p>
 <p>Note that <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()"><code class="function">g_signal_emit_valist()</code></a> resets the return value to the default
 if no handlers are connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a>.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
-<a name="id-1.4.12.7.16.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.12.7.16.7"></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">
@@ -1292,8 +1311,9 @@ if no handlers are connected, in contrast to <a class="link" href="gobject-Signa
 <tbody>
 <tr>
 <td class="parameter_name"><p>instance</p></td>
-<td class="parameter_description"><p>the instance the signal is being emitted on.</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the instance the signal is being
+emitted on. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.TypeInstance]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>signal_id</p></td>
@@ -1322,9 +1342,12 @@ is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="
 <pre class="programlisting">#define             g_signal_connect(instance, detailed_signal, c_handler, data)</pre>
 <p>Connects a <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> function to a signal for a particular object.</p>
 <p>The handler will be called before the default handler of the signal.</p>
+<p>See <a class="link" href="gobject-Signals.html#signal-memory-management" title="Memory management of signal handlers">memory management of signal handlers</a> for
+details on how to handle the return value and memory management of <em class="parameter"><code>data</code></em>
+.</p>
 <div class="refsect3">
-<a name="id-1.4.12.7.17.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.12.7.17.7"></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">
@@ -1356,9 +1379,8 @@ calls.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.12.7.17.7"></a><h4>Returns</h4>
+<a name="id-1.4.12.7.17.8"></a><h4>Returns</h4>
 <p> the handler id (always greater than 0 for successful connections)</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1369,7 +1391,7 @@ calls.</p></td>
 <p>The handler will be called after the default handler of the signal.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.18.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">
@@ -1403,7 +1425,6 @@ calls.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.18.7"></a><h4>Returns</h4>
 <p> the handler id (always greater than 0 for successful connections)</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1425,8 +1446,8 @@ parameters avoids the need to write a wrapper function.</p>
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"clicked"</span><span class="symbol">,</span>
-<span class="normal">                          </span><span class="symbol">(</span><span class="normal"><a href="gobject-Closures.html#GCallback">GCallback</a></span><span class="symbol">)</span><span class="normal"> <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-hide">gtk_widget_hide</a></span><span class="symbol">,</span><span class="normal"> other_widget</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span> <span class="gtkdoc opt">(</span>button<span class="gtkdoc opt">,</span> <span class="string">&quot;clicked&quot;</span><span class="gtkdoc opt">,</span>
+                          <span class="gtkdoc opt">(</span>GCallback<span class="gtkdoc opt">)</span> gtk_widget_hide<span class="gtkdoc opt">,</span> other_widget<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1448,16 +1469,16 @@ parameters avoids the need to write a wrapper function.</p>
 8
 9
 10</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">button_clicked_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">other_widget</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">    </span><span class="function"><a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-hide">gtk_widget_hide</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">other_widget</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
+<span class="function">button_clicked_cb</span> <span class="gtkdoc opt">(</span>GtkButton <span class="gtkdoc opt">*</span>button<span class="gtkdoc opt">,</span> GtkWidget <span class="gtkdoc opt">*</span>other_widget<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+    <span class="function"><a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-hide">gtk_widget_hide</a></span> <span class="gtkdoc opt">(</span>other_widget<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">…</span>
+…
-<span class="function"><a href="gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"clicked"</span><span class="symbol">,</span>
-<span class="normal">                  </span><span class="symbol">(</span><span class="normal"><a href="gobject-Closures.html#GCallback">GCallback</a></span><span class="symbol">)</span><span class="normal"> button_clicked_cb</span><span class="symbol">,</span><span class="normal"> other_widget</span><span class="symbol">);</span></pre></td>
+<span class="function"><a href="gobject-Signals.html#g-signal-connect">g_signal_connect</a></span> <span class="gtkdoc opt">(</span>button<span class="gtkdoc opt">,</span> <span class="string">&quot;clicked&quot;</span><span class="gtkdoc opt">,</span>
+                  <span class="gtkdoc opt">(</span>GCallback<span class="gtkdoc opt">)</span> button_clicked_cb<span class="gtkdoc opt">,</span> other_widget<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1466,7 +1487,7 @@ parameters avoids the need to write a wrapper function.</p>
 <p></p>
 <div class="refsect3">
 <a name="id-1.4.12.7.19.12"></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">
@@ -1500,7 +1521,6 @@ calls.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.19.13"></a><h4>Returns</h4>
 <p> the handler ID (always greater than 0 for successful connections)</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1524,9 +1544,10 @@ disconnected.  Note that this is not currently threadsafe (ie:
 emitting a signal while <em class="parameter"><code>gobject</code></em>
  is being destroyed in another thread
 is not safe).</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
-<a name="id-1.4.12.7.20.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.12.7.20.7"></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">
@@ -1535,8 +1556,8 @@ is not safe).</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>instance</p></td>
-<td class="parameter_description"><p>the instance to connect to.</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the instance to connect to. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.TypeInstance]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>detailed_signal</p></td>
@@ -1550,9 +1571,10 @@ is not safe).</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>gobject</p></td>
-<td class="parameter_description"><p>the object to pass as data to <em class="parameter"><code>c_handler</code></em>
-.</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the object to pass as data
+to <em class="parameter"><code>c_handler</code></em>
+. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>connect_flags</p></td>
@@ -1563,9 +1585,8 @@ is not safe).</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.12.7.20.7"></a><h4>Returns</h4>
+<a name="id-1.4.12.7.20.8"></a><h4>Returns</h4>
 <p> the handler id.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1586,7 +1607,7 @@ used. Specify <em class="parameter"><code>connect_flags</code></em>
 <code class="literal">..._swapped()</code> variants of this function.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.21.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">
@@ -1631,7 +1652,6 @@ calls.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.21.6"></a><h4>Returns</h4>
 <p> the handler id (always greater than 0 for successful connections)</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1645,7 +1665,7 @@ g_signal_connect_closure (<em class="parameter"><code><a href="../glib/glib-Basi
 <p>Connects a closure to a signal for a particular object.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.22.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">
@@ -1679,7 +1699,6 @@ default handler of the signal.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.22.6"></a><h4>Returns</h4>
 <p> the handler id (always greater than 0 for successful connections)</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1694,7 +1713,7 @@ g_signal_connect_closure_by_id (<em class="parameter"><code><a href="../glib/gli
 <p>Connects a closure to a signal for a particular object.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.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">
@@ -1733,7 +1752,6 @@ default handler of the signal.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.23.6"></a><h4>Returns</h4>
 <p> the handler id (always greater than 0 for successful connections)</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1753,7 +1771,7 @@ signal of <em class="parameter"><code>instance</code></em>
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.24.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">
@@ -1796,7 +1814,7 @@ connected to a signal of <em class="parameter"><code>instance</code></em>
  and is currently blocked.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.25.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">
@@ -1833,7 +1851,7 @@ signal of <em class="parameter"><code>instance</code></em>
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.26.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">
@@ -1873,7 +1891,7 @@ The match <em class="parameter"><code>mask</code></em>
 If no handler was found, 0 is returned.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.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">
@@ -1926,7 +1944,6 @@ the handler has to match.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.27.6"></a><h4>Returns</h4>
 <p> A valid non-0 signal handler id for a successful match.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1949,7 +1966,7 @@ If no handlers were found, 0 is returned, the number of blocked handlers
 otherwise.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.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">
@@ -2002,7 +2019,6 @@ the handlers have to match.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.28.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2026,7 +2042,7 @@ otherwise. The match criteria should not apply to any handlers that are
 not currently blocked.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.29.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">
@@ -2079,7 +2095,6 @@ the handlers have to match.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.29.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2103,7 +2118,7 @@ matches.  If no handlers were found, 0 is returned, the number of
 disconnected handlers otherwise.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.30.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">
@@ -2156,7 +2171,6 @@ the handlers have to match.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.30.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2170,7 +2184,7 @@ g_signal_handler_is_connected (<em class="parameter"><code><a href="../glib/glib
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.31.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">
@@ -2195,7 +2209,6 @@ g_signal_handler_is_connected (<em class="parameter"><code><a href="../glib/glib
 <p> whether <em class="parameter"><code>handler_id</code></em>
 identifies a handler connected to <em class="parameter"><code>instance</code></em>
 .</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2207,7 +2220,7 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.32.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">
@@ -2235,7 +2248,6 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 <div class="refsect3">
 <a name="id-1.4.12.7.32.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2247,7 +2259,7 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.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">
@@ -2275,7 +2287,6 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 <div class="refsect3">
 <a name="id-1.4.12.7.33.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2287,7 +2298,7 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.34.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">
@@ -2315,7 +2326,6 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 <div class="refsect3">
 <a name="id-1.4.12.7.34.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2326,7 +2336,7 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.35.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">
@@ -2349,9 +2359,8 @@ identifies a handler connected to <em class="parameter"><code>instance</code></e
 <div class="refsect3">
 <a name="id-1.4.12.7.35.6"></a><h4>Returns</h4>
 <p> The number of handlers that matched.</p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2372,13 +2381,15 @@ connected both without detail and with the given detail.  This is
 consistent with how a signal emitted with <em class="parameter"><code>detail</code></em>
  would be delivered
 to those handlers.</p>
+<p>Since 2.46 this also checks for a non-default class closure being
+installed, as this is basically always what you want.</p>
 <p>One example of when you might use this is when the arguments to the
 signal are difficult to compute. A class implementor may opt to not
 emit the signal if no one is attached anyway, thus saving the cost
 of building the arguments.</p>
 <div class="refsect3">
-<a name="id-1.4.12.7.36.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.12.7.36.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">
@@ -2409,10 +2420,9 @@ of building the arguments.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.12.7.36.8"></a><h4>Returns</h4>
+<a name="id-1.4.12.7.36.9"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a handler is connected to the signal, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
 otherwise.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2429,7 +2439,7 @@ flag).</p>
 <p>Prints a warning if used on a signal which isn't being emitted.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.37.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">
@@ -2466,7 +2476,7 @@ g_signal_stop_emission_by_name (<em class="parameter"><code><a href="../glib/gli
 signal id for you.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.38.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">
@@ -2504,7 +2514,7 @@ from the type to which the signal belongs.</p>
 parent class closure from inside the overridden one.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.39.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">
@@ -2543,7 +2553,7 @@ be called from an overridden class closure; see
 <a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()"><code class="function">g_signal_override_class_handler()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.40.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">
@@ -2595,7 +2605,7 @@ directly and can be overriden by derived classes with
 the marshaller for this signal.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.41.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">
@@ -2666,9 +2676,8 @@ without a return value.</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.41.9"></a><h4>Returns</h4>
 <p> the signal id</p>
-<p></p>
 </div>
-<p class="since">Since 2.18</p>
+<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2689,7 +2698,7 @@ type to which the signal belongs.</p>
 parent class closure from inside the overridden one.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.42.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">
@@ -2715,7 +2724,7 @@ for the signal.</p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.18</p>
+<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2728,9 +2737,10 @@ g_signal_chain_from_overridden_handler
 only be called from an overridden class closure; see
 <a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()"><code class="function">g_signal_override_class_closure()</code></a> and
 <a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()"><code class="function">g_signal_override_class_handler()</code></a>.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
-<a name="id-1.4.12.7.43.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.12.7.43.6"></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">
@@ -2739,8 +2749,9 @@ only be called from an overridden class closure; see
 <tbody>
 <tr>
 <td class="parameter_name"><p>instance</p></td>
-<td class="parameter_description"><p>the instance the signal is being emitted on.</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the instance the signal is being
+emitted on. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.TypeInstance]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>...</p></td>
@@ -2752,7 +2763,7 @@ is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.18</p>
+<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2768,7 +2779,7 @@ of that signal, independent of the instance. This is possible only
 for signals which don't have <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS"><span class="type">G_SIGNAL_NO_HOOKS</span></a> flag set.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.44.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">
@@ -2808,7 +2819,6 @@ for signals which don't have <a class="link" href="gobject-Signals.html#G-SIGNAL
 <div class="refsect3">
 <a name="id-1.4.12.7.44.6"></a><h4>Returns</h4>
 <p> the hook id, for later use with <a class="link" href="gobject-Signals.html#g-signal-remove-emission-hook" title="g_signal_remove_emission_hook ()"><code class="function">g_signal_remove_emission_hook()</code></a>.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2820,7 +2830,7 @@ g_signal_remove_emission_hook (<em class="parameter"><code><a href="../glib/glib
 <p>Deletes an emission hook.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.45.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">
@@ -2857,7 +2867,7 @@ and <em class="parameter"><code>detail</code></em>
  quark.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.46.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">
@@ -2897,7 +2907,6 @@ and <em class="parameter"><code>detail</code></em>
 <p> Whether the signal name could successfully be parsed and <em class="parameter"><code>signal_id_p</code></em>
 and <em class="parameter"><code>detail_p</code></em>
 contain valid return values.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2908,7 +2917,7 @@ g_signal_get_invocation_hint (<em class="parameter"><code><a href="../glib/glib-
 <p>Returns the invocation hint of the innermost signal emission of instance.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.47.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">
@@ -2940,7 +2949,7 @@ identified by <em class="parameter"><code>itype</code></em>
 .</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.48.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">
@@ -2965,7 +2974,6 @@ structure which is to be invoked by the new closure</p></td>
 <div class="refsect3">
 <a name="id-1.4.12.7.48.6"></a><h4>Returns</h4>
 <p> a new <a class="link" href="gobject-Closures.html#GCClosure" title="struct GCClosure"><span class="type">GCClosure</span></a></p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2987,7 +2995,7 @@ handler that is run as the return value for the signal and not run
 any further handlers (ie: the first handler "wins").</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.49.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">
@@ -3020,9 +3028,8 @@ any further handlers (ie: the first handler "wins").</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.49.7"></a><h4>Returns</h4>
 <p> standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> result</p>
-<p></p>
 </div>
-<p class="since">Since 2.28</p>
+<p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3041,7 +3048,7 @@ indicates that the callback handled the signal, and no further
 handling is needed.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.50.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">
@@ -3074,9 +3081,8 @@ handling is needed.</p>
 <div class="refsect3">
 <a name="id-1.4.12.7.50.6"></a><h4>Returns</h4>
 <p> standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> result</p>
-<p></p>
 </div>
-<p class="since">Since 2.4</p>
+<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -3093,7 +3099,7 @@ handling is needed.</p>
 to callbacks during a signal emission.</p>
 <div class="refsect3">
 <a name="id-1.4.12.8.2.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -3149,7 +3155,7 @@ signal description outlines how especially the RUN flags control the
 stages of a signal emission.</p>
 <div class="refsect3">
 <a name="id-1.4.12.8.5.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -3242,7 +3248,7 @@ stages of a signal emission.</p>
 match signals by.</p>
 <div class="refsect3">
 <a name="id-1.4.12.8.6.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -3312,7 +3318,7 @@ match signals by.</p>
 filled in by the <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()"><code class="function">g_signal_query()</code></a> function.</p>
 <div class="refsect3">
 <a name="id-1.4.12.8.7.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -3362,15 +3368,15 @@ user callbacks, note that the effective callback signature is:</p>
         <td class="listing_lines" align="right"><pre>1
 2
 3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">@</span><span class="usertype">return_type</span><span class="normal"> </span><span class="function">callback</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">#</span><span class="usertype">gpointer</span><span class="normal">     data1</span><span class="symbol">,</span>
-<span class="symbol">[</span><span class="usertype">param_types</span><span class="normal"> param_names</span><span class="symbol">,]</span>
-<span class="usertype">gpointer</span><span class="normal">     data2</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">&#64;return_type <span class="function">callback</span> <span class="gtkdoc opt">(</span><span class="gtkdoc ppc">#gpointer     data1,</span>
+<span class="gtkdoc opt">[</span>param_types param_names<span class="gtkdoc opt">,]</span>
+gpointer     data2<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
-<p></p>
+<p>. </p>
 </td>
 <td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_params]</span></td>
 </tr>
@@ -3399,7 +3405,7 @@ user callbacks, note that the effective callback signature is:</p>
 connection.</p>
 <div class="refsect3">
 <a name="id-1.4.12.8.10.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -3429,7 +3435,6 @@ connection.</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>