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/signal.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="chapter-signal.html" title="The GObject messaging system">
 <link rel="prev" href="chapter-signal.html" title="The GObject messaging system">
 <link rel="next" href="rn01.html" title="API Reference">
-<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">
@@ -26,8 +26,8 @@
       GObject's signals have nothing to do with standard UNIX signals: they connect
       arbitrary application-specific events with any number of listeners.
       For example, in GTK+, every user event (keystroke or mouse move) is received
-      from the X server and generates a GTK+ event under the form of a signal emission
-      on a given object instance.
+      from the windowing system and generates a GTK+ event in the form of a signal emission
+      on the widget object instance.
     </p>
 <p>
       Each signal is registered in the type system together with the type on which
@@ -47,7 +47,7 @@
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">return_type</span><span class="normal"> </span><span class="function">function_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> instance</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">...</span><span class="normal"> </span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">return_type <span class="function">function_callback</span> <span class="gtkdoc opt">(</span>gpointer instance<span class="gtkdoc opt">,</span> …<span class="gtkdoc opt">,</span> gpointer user_data<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -76,16 +76,16 @@
 8
 9
 10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">guint</span><span class="normal"> </span><span class="function"><a href="gobject-Signals.html#g-signal-newv">g_signal_newv</a></span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">signal_name</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GType</span><span class="normal">               itype</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GSignalFlags</span><span class="normal">        signal_flags</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GClosure</span><span class="normal">           </span><span class="symbol">*</span><span class="normal">class_closure</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GSignalAccumulator</span><span class="normal">  accumulator</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">gpointer</span><span class="normal">            accu_data</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GSignalCMarshaller</span><span class="normal">  c_marshaller</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GType</span><span class="normal">               return_type</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">guint</span><span class="normal">               n_params</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GType</span><span class="normal">              </span><span class="symbol">*</span><span class="normal">param_types</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">guint <span class="function"><a href="gobject-Signals.html#g-signal-newv">g_signal_newv</a></span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">const</span> gchar        <span class="gtkdoc opt">*</span>signal_name<span class="gtkdoc opt">,</span>
+                     GType               itype<span class="gtkdoc opt">,</span>
+                     GSignalFlags        signal_flags<span class="gtkdoc opt">,</span>
+                     GClosure           <span class="gtkdoc opt">*</span>class_closure<span class="gtkdoc opt">,</span>
+                     GSignalAccumulator  accumulator<span class="gtkdoc opt">,</span>
+                     gpointer            accu_data<span class="gtkdoc opt">,</span>
+                     GSignalCMarshaller  c_marshaller<span class="gtkdoc opt">,</span>
+                     GType               return_type<span class="gtkdoc opt">,</span>
+                     guint               n_params<span class="gtkdoc opt">,</span>
+                     GType              <span class="gtkdoc opt">*</span>param_types<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -97,43 +97,47 @@
 		</p>
 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>
-			  signal_name: is a string which can be used to uniquely identify a given signal.
+			  <em class="parameter"><code>signal_name</code></em>: is a string which can be used to uniquely identify a given signal.
 			</p></li>
 <li class="listitem"><p>
-			  itype: is the instance type on which this signal can be emitted.
+			  <em class="parameter"><code>itype</code></em>: is the instance type on which this signal can be emitted.
 			</p></li>
 <li class="listitem"><p>
-			  signal_flags: partly defines the order in which closures which were connected to the
+			  <em class="parameter"><code>signal_flags</code></em>: partly defines the order in which closures which were connected to the
 			  signal are invoked.
 			</p></li>
 <li class="listitem"><p>
-			  class_closure: this is the default closure for the signal: if it is not NULL upon
+			  <em class="parameter"><code>class_closure</code></em>: this is the default closure for the signal: if it is not NULL upon
 			  the signal emission, it will be invoked upon this emission of the signal. The
 			  moment where this closure is invoked compared to other closures connected to that
 			  signal depends partly on the signal_flags.
 			</p></li>
 <li class="listitem"><p>
-			  accumulator: this is a function pointer which is invoked after each closure
+			  <em class="parameter"><code>accumulator</code></em>: this is a function pointer which is invoked after each closure
 			  has been invoked. If it returns FALSE, signal emission is stopped. If it returns
 			  TRUE, signal emission proceeds normally. It is also used to compute the return
 			  value of the signal based on the return value of all the invoked closures.
+			  For example, an accumulator could ignore
+			  <code class="literal">NULL</code> returns from closures; or it
+			  could build a list of the values returned by the
+			  closures.
 			</p></li>
 <li class="listitem"><p>
-			  accumulator_data: this pointer will be passed down to each invocation of the
+			  <em class="parameter"><code>accumulator_data</code></em>: this pointer will be passed down to each invocation of the
 			  accumulator during emission.
 			</p></li>
 <li class="listitem"><p>
-			  c_marshaller: this is the default C marshaller for any closure which is connected to
+			  <em class="parameter"><code>c_marshaller</code></em>: this is the default C marshaller for any closure which is connected to
 			this signal.
 			</p></li>
 <li class="listitem"><p>
-			  return_type: this is the type of the return value of the signal.
+			  <em class="parameter"><code>return_type</code></em>: this is the type of the return value of the signal.
 			</p></li>
 <li class="listitem"><p>
-			  n_params: this is the number of parameters this signal takes.
+			  <em class="parameter"><code>n_params</code></em>: this is the number of parameters this signal takes.
 			</p></li>
 <li class="listitem"><p>
-			  param_types: this is an array of GTypes which indicate the type of each parameter
+			  <em class="parameter"><code>param_types</code></em>: this is an array of GTypes which indicate the type of each parameter
 			  of the signal. The length of this array is indicated by n_params.
 			</p></li>
 </ul></div>
@@ -154,12 +158,12 @@
 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>
 		  You can register a class closure at signal registration: this is a
-		  system-wide operation. i.e.: the class_closure will be invoked during each emission
-		  of a given signal on all the instances of the type which supports that signal.
+		  system-wide operation. i.e.: the class closure will be invoked during each emission
+		  of a given signal on <span class="emphasis"><em>any</em></span> of the instances of the type which supports that signal.
 			</p></li>
 <li class="listitem"><p>
 		  You can use <code class="function"><a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()">g_signal_override_class_closure</a></code> which
-		  overrides the class_closure of a given type. It is possible to call this function
+		  overrides the class closure of a given type. It is possible to call this function
 		  only on a derived type of the type on which the signal was registered.
 		  This function is of use only to language bindings.
 			</p></li>
@@ -193,10 +197,10 @@
 2
 3
 4</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal"> </span><span class="function"><a href="gobject-Signals.html#g-signal-emitv">g_signal_emitv</a></span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">instance_and_params</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">guint</span><span class="normal">         signal_id</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GQuark</span><span class="normal">        detail</span><span class="symbol">,</span>
-<span class="normal">                     </span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">return_value</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span> <span class="function"><a href="gobject-Signals.html#g-signal-emitv">g_signal_emitv</a></span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">const</span> GValue <span class="gtkdoc opt">*</span>instance_and_params<span class="gtkdoc opt">,</span>
+                     guint         signal_id<span class="gtkdoc opt">,</span>
+                     GQuark        detail<span class="gtkdoc opt">,</span>
+                     GValue       <span class="gtkdoc opt">*</span>return_value<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -206,93 +210,89 @@
 		</p>
 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>
-			The instance_and_params array of GValues contains the list of input
+			The <em class="parameter"><code>instance_and_params</code></em> array of GValues contains the list of input
 			parameters to the signal. The first element of the array is the
 			instance pointer on which to invoke the signal. The following elements of
 			the array contain the list of parameters to the signal.
 			</p></li>
 <li class="listitem"><p>
-			signal_id identifies the signal to invoke.
+			<em class="parameter"><code>signal_id</code></em> identifies the signal to invoke.
 			</p></li>
 <li class="listitem"><p>
-			detail identifies the specific detail of the signal to invoke. A detail is a kind of
+			<em class="parameter"><code>detail</code></em> identifies the specific detail of the signal to invoke. A detail is a kind of
 			magic token/argument which is passed around during signal emission and which is used
 			by closures connected to the signal to filter out unwanted signal emissions. In most
 			cases, you can safely set this value to zero. See <a class="xref" href="signal.html#signal-detail" title="The detail argument">the section called “The <span class="emphasis"><em>detail</em></span> argument”</a> for
 			more details about this parameter.
 			</p></li>
 <li class="listitem"><p>
-			return_value holds the return value of the last closure invoked during emission if
+			<em class="parameter"><code>return_value</code></em> holds the return value of the last closure invoked during emission if
 			no accumulator was specified. If an accumulator was specified during signal creation,
-			this accumulator is used to calculate the return_value as a function of the return
+			this accumulator is used to calculate the return value as a function of the return
 			values of all the closures invoked during emission.
-			<a href="#ftn.id-1.3.5.3.7.2.3.4.1.1" class="footnote" name="id-1.3.5.3.7.2.3.4.1.1"><sup class="footnote">[8]</sup></a>
 			If no closure is invoked during
-			emission, the return_value is nonetheless initialized to zero/null.
+			emission, the <em class="parameter"><code>return_value</code></em> is nonetheless initialized to zero/null.
 			</p></li>
 </ul></div>
 <p>
 		</p>
 <p>
-		Internally, the GValue array is passed to the emission function proper,
-		<code class="function">signal_emit_unlocked_R</code> (implemented in <code class="filename">gsignal.c</code>).
 		Signal emission can be decomposed in 5 steps:
 		</p>
-<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<div class="orderedlist"><ol class="orderedlist" type="1">
 <li class="listitem"><p>
-			<span class="emphasis"><em>RUN_FIRST</em></span>: if the G_SIGNAL_RUN_FIRST flag was used
-			during signal registration and if there exist a class_closure for this signal,
-			the class_closure is invoked. Jump to <span class="emphasis"><em>EMISSION_HOOK</em></span> state.
+			<code class="literal">RUN_FIRST</code>: if the
+			<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> flag was used
+			during signal registration and if there exists a class closure for this signal,
+			the class closure is invoked.
 			</p></li>
 <li class="listitem"><p>
-			<span class="emphasis"><em>EMISSION_HOOK</em></span>: if any emission hook was added to
-			the signal, they are invoked from first to last added. Accumulate return values
-			and jump to <span class="emphasis"><em>HANDLER_RUN_FIRST</em></span> state.
+			<code class="literal">EMISSION_HOOK</code>: if any emission hook was added to
+			the signal, they are invoked from first to last added. Accumulate return values.
 			</p></li>
 <li class="listitem"><p>
-			<span class="emphasis"><em>HANDLER_RUN_FIRST</em></span>: if any closure were connected
+			<code class="literal">HANDLER_RUN_FIRST</code>: if any closure were connected
 			with the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a></code> family of
 			functions, and if they are not blocked (with the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-handler-block" title="g_signal_handler_block ()">g_signal_handler_block</a></code>
 			family of functions) they are run here, from first to last connected.
-			Jump to <span class="emphasis"><em>RUN_LAST</em></span> state.
 			</p></li>
 <li class="listitem"><p>
-			<span class="emphasis"><em>RUN_LAST</em></span>: if the G_SIGNAL_RUN_LAST
-			flag was set during registration and if a class_closure
-			was set, it is invoked here. Jump to
-			<span class="emphasis"><em>HANDLER_RUN_LAST</em></span> state.
+			<code class="literal">RUN_LAST</code>: if the <code class="literal">G_SIGNAL_RUN_LAST</code>
+			flag was set during registration and if a class closure
+			was set, it is invoked here.
 			</p></li>
 <li class="listitem"><p>
-			<span class="emphasis"><em>HANDLER_RUN_LAST</em></span>: if any closure were connected
+			<code class="literal">HANDLER_RUN_LAST</code>: if any closure were connected
 			with the <code class="function">g_signal_connect_after</code> family of
-			functions, if they were not invoked during HANDLER_RUN_FIRST and if they
+			functions, if they were not invoked during <code class="literal">HANDLER_RUN_FIRST</code> and if they
 			are not blocked, they are run here, from first to last connected.
-			Jump to  <span class="emphasis"><em>RUN_CLEANUP</em></span> state.
 			</p></li>
 <li class="listitem"><p>
-			<span class="emphasis"><em>RUN_CLEANUP</em></span>: if the G_SIGNAL_RUN_CLEANUP flag
-			was set during registration and if a class_closure was set,
+			<code class="literal">RUN_CLEANUP</code>: if the <code class="literal">G_SIGNAL_RUN_CLEANUP</code> flag
+			was set during registration and if a class closure was set,
 			it is invoked here. Signal emission is completed here.
 			</p></li>
-</ul></div>
-<p>
+</ol></div>
+<p>
 	  </p>
 <p>
-		If, at any point during emission (except in RUN_CLEANUP state), one of the
+		If, at any point during emission (except in <code class="literal">RUN_CLEANUP</code> state), one of the
 		closures or emission hook stops the signal emission with
 		<code class="function"><a class="link" href="gobject-Signals.html#g-signal-stop-emission" title="g_signal_stop_emission ()">g_signal_stop_emission</a></code>,
-		emission jumps to CLEANUP state.
+		emission jumps to <code class="literal">RUN_CLEANUP</code> state.
 	  </p>
 <p>
 		If, at any point during emission, one of the closures or emission hook
 		emits the same signal on the same instance, emission is restarted from
-		the RUN_FIRST state.
+		the <code class="literal">RUN_FIRST</code> state.
 	  </p>
 <p>
 		The accumulator function is invoked in all states, after invocation
-		of each closure (except in EMISSION_HOOK and CLEANUP). It accumulates
+		of each closure (except in <code class="literal">RUN_EMISSION_HOOK</code> and
+		<code class="literal">RUN_CLEANUP</code>). It accumulates
 		the closure return value into the signal return value and returns TRUE or
-		FALSE. If, at any point, it does not return TRUE, emission jumps to CLEANUP state.
+		FALSE. If, at any point, it does not return TRUE, emission jumps
+		to <code class="literal">RUN_CLEANUP</code> state.
 	  </p>
 <p>
 		If no accumulator function was provided, the value returned by the last handler
@@ -304,169 +304,69 @@
 <a name="signal-detail"></a>The <span class="emphasis"><em>detail</em></span> argument</h3></div></div></div>
 <p>All the functions related to signal emission or signal connection have a parameter
 		named the <span class="emphasis"><em>detail</em></span>. Sometimes, this parameter is hidden by the API
-		but it is always there, under one form or another.
+		but it is always there, in one form or another.
 	  </p>
 <p>
 	    Of the three main connection functions,
-		only one has an explicit detail parameter as a <a href="../glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>
-		<a href="#ftn.id-1.3.5.3.8.3.2" class="footnote" name="id-1.3.5.3.8.3.2"><sup class="footnote">[9]</sup></a>:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gulong</span><span class="normal">     </span><span class="function"><a href="gobject-Signals.html#g-signal-connect-closure-by-id">g_signal_connect_closure_by_id</a></span><span class="normal">          </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">          instance</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">guint</span><span class="normal">          signal_id</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">GQuark</span><span class="normal">          detail</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">GClosure</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">closure</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">gboolean</span><span class="normal">          after</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-        The two other functions hide the detail parameter in the signal name identification:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6
-7
-8
-9
-10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gulong</span><span class="normal">     </span><span class="function"><a href="gobject-Signals.html#g-signal-connect-closure">g_signal_connect_closure</a></span><span class="normal">          </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">          instance</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">detailed_signal</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">GClosure</span><span class="normal">         </span><span class="symbol">*</span><span class="normal">closure</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">gboolean</span><span class="normal">          after</span><span class="symbol">);</span>
-<span class="usertype">gulong</span><span class="normal">     </span><span class="function"><a href="gobject-Signals.html#g-signal-connect-data">g_signal_connect_data</a></span><span class="normal">              </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">          instance</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">detailed_signal</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">GCallback</span><span class="normal">      c_handler</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">gpointer</span><span class="normal">          data</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">GClosureNotify</span><span class="normal">      destroy_data</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="usertype">GConnectFlags</span><span class="normal">      connect_flags</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
+		only one has an explicit detail parameter as a <a href="../glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>:
+		<a class="link" href="gobject-Signals.html#g-signal-connect-closure-by-id" title="g_signal_connect_closure_by_id ()"><code class="function">g_signal_connect_closure_by_id</code></a>.
+		<a href="#ftn.id-1.3.5.3.8.3.3" class="footnote" name="id-1.3.5.3.8.3.3"><sup class="footnote">[6]</sup></a>
+	  </p>
 <p>
-		Their detailed_signal parameter is a string which identifies the name of the signal
-		to connect to. However, the format of this string is structured to look like
-		<span class="emphasis"><em>signal_name::detail_name</em></span>. Connecting to the signal
-		named <span class="emphasis"><em>notify::cursor_position</em></span> will actually connect to the signal
-		named <span class="emphasis"><em>notify</em></span> with the <span class="emphasis"><em>cursor_position</em></span> name.
+	    The two other functions,
+	    <a class="link" href="gobject-Signals.html#g-signal-connect-closure" title="g_signal_connect_closure ()"><code class="function">g_signal_connect_closure</code></a> and
+	    <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>
+	    hide the detail parameter in the signal name identification.
+		Their <em class="parameter"><code>detailed_signal</code></em> parameter is a
+		string which identifies the name of the signal to connect to.
+		The format of this string should match
+		<span class="emphasis"><em>signal_name::detail_name</em></span>. For example,
+		connecting to the signal named
+		<span class="emphasis"><em>notify::cursor_position</em></span> will actually
+		connect to the signal named <span class="emphasis"><em>notify</em></span> with the
+		<span class="emphasis"><em>cursor_position</em></span> detail.
 		Internally, the detail string is transformed to a GQuark if it is present.
 	  </p>
 <p>
-		Of the four main signal emission functions, three have an explicit detail parameter as a
-		<a href="../glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> again:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal">                  </span><span class="function"><a href="gobject-Signals.html#g-signal-emitv">g_signal_emitv</a></span><span class="normal">        </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">instance_and_params</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">guint</span><span class="normal">               signal_id</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">GQuark</span><span class="normal">              detail</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">GValue</span><span class="normal">             </span><span class="symbol">*</span><span class="normal">return_value</span><span class="symbol">);</span>
-<span class="type">void</span><span class="normal">                  </span><span class="function"><a href="gobject-Signals.html#g-signal-emit-valist">g_signal_emit_valist</a></span><span class="normal">  </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">            instance</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">guint</span><span class="normal">               signal_id</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">GQuark</span><span class="normal">              detail</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">va_list</span><span class="normal">             var_args</span><span class="symbol">);</span>
-<span class="type">void</span><span class="normal">                  </span><span class="function"><a href="gobject-Signals.html#g-signal-emit">g_signal_emit</a></span><span class="normal">         </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">            instance</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">guint</span><span class="normal">               signal_id</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">GQuark</span><span class="normal">              detail</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="symbol">...);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-        The fourth function hides it in its signal name parameter:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal">                  </span><span class="function"><a href="gobject-Signals.html#g-signal-emit-by-name">g_signal_emit_by_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">            instance</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">detailed_signal</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="symbol">...);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-        The format of the detailed_signal parameter is exactly the same as the format used by
-        the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a></code> functions: <span class="emphasis"><em>signal_name::detail_name</em></span>.
+	    Of the four main signal emission functions, one hides it in its
+	    signal name parameter:
+	    <a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()"><code class="function">g_signal_connect</code></a>.
+	    The other three have an explicit detail parameter as a
+	    <a href="../glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> again:
+	    <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit</code></a>,
+	    <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv</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>
 <p>
         If a detail is provided by the user to the emission function, it is used during emission to match
         against the closures which also provide a detail.
-        If the closures' detail does not match the detail provided by the user, they will not be invoked
-        (even though they are connected to a signal which is being emitted).
+        If a closure's detail does not match the detail provided by the user, it
+        will not be invoked (even though it is connected to a signal which is
+        being emitted).
 	  </p>
 <p>
 		This completely optional filtering mechanism is mainly used as an optimization for signals
 		which are often emitted for many different reasons: the clients can filter out which events they are
 		interested in before the closure's marshalling code runs. For example, this is used extensively
-		by the <span class="emphasis"><em>notify</em></span> signal of GObject: whenever a property is modified on a GObject,
+		by the <a class="link" href="gobject-The-Base-Object-Type.html#GObject-notify" title="The “notify” signal"><em class="structfield"><code>notify</code></em></a> signal of GObject: whenever a property is modified on a GObject,
 		instead of just emitting the <span class="emphasis"><em>notify</em></span> signal, GObject associates as a detail to this
 		signal emission the name of the property modified. This allows clients who wish to be notified of changes
 		to only one property to filter most events before receiving them.
 	  </p>
 <p>
 		As a simple rule, users can and should set the detail parameter to zero: this will disable completely
-        this optional filtering.
+        this optional filtering for that signal.
 	  </p>
 </div>
 <div class="footnotes">
 <br><hr style="width:100; text-align:left;margin-left: 0">
-<div id="ftn.id-1.3.5.3.7.2.3.4.1.1" class="footnote"><p><a href="#id-1.3.5.3.7.2.3.4.1.1" class="para"><sup class="para">[8] </sup></a>
-			  James (again!!) gives a few non-trivial examples of accumulators:
-			  <span class="quote">“<span class="quote">
-				For instance, you may have an accumulator that ignores NULL returns from
-				closures, and only accumulates the non-NULL ones. Another accumulator may try
-				to return the list of values returned by the closures.
-			  </span>”</span>
-			</p></div>
-<div id="ftn.id-1.3.5.3.8.3.2" class="footnote"><p><a href="#id-1.3.5.3.8.3.2" class="para"><sup class="para">[9] </sup></a>A GQuark is an integer which uniquely represents a string. It is possible to transform
+<div id="ftn.id-1.3.5.3.8.3.3" class="footnote"><p><a href="#id-1.3.5.3.8.3.3" class="para"><sup class="para">[6] </sup></a>A GQuark is an integer which uniquely represents a string. It is possible to transform
 		   back and forth between the integer and string representations with the functions
 		   <code class="function"><a href="../glib/glib-Quarks.html#g-quark-from-string">g_quark_from_string</a></code> and <code class="function"><a href="../glib/glib-Quarks.html#g-quark-to-string">g_quark_to_string</a></code>.
 		  </p></div>
 </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/gobject/style.css CHANGED Viewed

@@ -60,7 +60,7 @@ a:hover
 div.informaltable table
 {
   border-collapse: separate;
-  border-spacing: 1em 0.5em;
+  border-spacing: 1em 0.3em;
   border: none;
 }
@@ -148,6 +148,8 @@ div.table table th
 h4
 {
   color: #555753;
+  margin-top: 1em;
+  margin-bottom: 1em;
 }
 hr
@@ -166,17 +168,16 @@ dl.toc dt
   padding-bottom: 0.25em;
 }
-dl.toc > dd > dl > dt
+dl.toc > dt
 {
   padding-top: 0.25em;
   padding-bottom: 0.25em;
+  font-weight: bold;
 }
-dl.toc > dt
+dl.toc > dl
 {
-  padding-top: 1em;
   padding-bottom: 0.5em;
-  font-weight: bold;
 }
 .parameter
@@ -346,7 +347,9 @@ acronym,abbr
 }
 @media screen {
-  sup a.footnote
+  /* these have a <sup> as a first child, but since there are no parent selectors
+   * we can't use that. */
+  a.footnote
   {
     position: relative;
     top: 0em ! important;

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Graphical inspection of GObjects: 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="pt03.html" title="Part V. Related Tools">
 <link rel="prev" href="tools-gob.html" title="GObject builder">
 <link rel="next" href="tools-refdb.html" title="Debugging reference count problems">
-<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">
@@ -29,7 +29,6 @@
       </p>
 </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/gobject/tools-gob.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>GObject builder: 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="pt03.html" title="Part V. Related Tools">
 <link rel="prev" href="tools-vala.html" title="Vala">
 <link rel="next" href="tools-ginspector.html" title="Graphical inspection of GObjects">
-<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,6 @@
     </p>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>