RubyGems - glib2 - Versions diffs - 2.2.5-x64-mingw32 → 3.0.0-x64-mingw32 - Mend

glib2 2.2.5-x64-mingw32 → 3.0.0-x64-mingw32

Files changed (1979) hide show

data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: Enumeration and Flag Types</title>
+<title>Enumeration and Flag Types: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
@@ -229,6 +229,35 @@ properties, using <a class="link" href="gobject-Standard-Parameter-and-Value-Typ
 <p>GObject ships with a utility called <a href="glib-mkenums.html">glib-mkenums</a>,
 that can construct suitable type registration functions from C enumeration
 definitions.</p>
+<p>Example of how to get a string representation of an enum value:</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</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">GEnumClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">enum_class</span><span class="symbol">;</span>
+<span class="usertype">GEnumValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">enum_value</span><span class="symbol">;</span>
+<span class="normal">enum_class </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Type-Information.html#g-type-class-ref">g_type_class_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">MAMAN_TYPE_MY_ENUM</span><span class="symbol">);</span>
+<span class="normal">enum_value </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Enumeration-and-Flag-Types.html#g-enum-get-value">g_enum_get_value</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">enum_class</span><span class="symbol">,</span><span class="normal"> MAMAN_MY_ENUM_FOO</span><span class="symbol">);</span>
+<span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Name: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> enum_value</span><span class="symbol">-&gt;</span><span class="normal">value_name</span><span class="symbol">);</span>
+<span class="function"><a href="gobject-Type-Information.html#g-type-class-unref">g_type_class_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">enum_class</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
 </div>
 <div class="refsect1">
 <a name="gobject-Enumeration-and-Flag-Types.functions_details"></a><h2>Functions</h2>

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

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: GParamSpec</title>
+<title>GParamSpec: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
@@ -689,6 +689,31 @@ g_param_spec_ref_sink (<em class="parameter"><code><a class="link" href="gobject
 <a name="g-param-spec-get-default-value"></a><h3>g_param_spec_get_default_value ()</h3>
 <pre class="programlisting">const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *
 g_param_spec_get_default_value (<em class="parameter"><code><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> *param</code></em>);</pre>
+<p>Gets the default value of <em class="parameter"><code>param</code></em>
+ as a pointer to a <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>.</p>
+<p>The <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> will remain value for the life of <em class="parameter"><code>param</code></em>
+.</p>
+<div class="refsect3">
+<a name="id-1.4.10.7.16.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>param</p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.10.7.16.7"></a><h4>Returns</h4>
+<p> a pointer to a <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> which must not be modified</p>
+<p></p>
+</div>
+<p class="since">Since 2.38</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1693,7 +1718,7 @@ according to this type
 <div class="refsect2">
 <a name="GParamFlags"></a><h3>enum GParamFlags</h3>
 <p>Through the <a class="link" href="gobject-GParamSpec.html#GParamFlags" title="enum GParamFlags"><span class="type">GParamFlags</span></a> flag values, certain aspects of parameters
-can be configured. See also <a class="link" href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS"><span class="type">G_PARAM_READWRITE</span></a> and <a class="link" href="gobject-GParamSpec.html#G-PARAM-STATIC-STRINGS:CAPS" title="G_PARAM_STATIC_STRINGS"><span class="type">G_PARAM_STATIC_STRINGS</span></a>.</p>
+can be configured. See also <a class="link" href="gobject-GParamSpec.html#G-PARAM-STATIC-STRINGS:CAPS" title="G_PARAM_STATIC_STRINGS"><span class="type">G_PARAM_STATIC_STRINGS</span></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.10.8.4.4"></a><h4>Members</h4>
 <div class="informaltable"><table width="100%" border="0">
@@ -1734,7 +1759,7 @@ can be configured. See also <a class="link" href="gobject-GParamSpec.html#G-PARA
 <tr>
 <td class="enum_member_name"><p><a name="G-PARAM-CONSTRUCT-ONLY:CAPS"></a>G_PARAM_CONSTRUCT_ONLY</p></td>
 <td class="enum_member_description">
-<p>the parameter will only be set upon object construction</p>
+<p>the parameter can only be set upon object construction</p>
 </td>
 <td class="enum_member_annotations"> </td>
 </tr>

data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: Generic values</title>
+<title>Generic values: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">

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

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: Signals</title>
+<title>Signals: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
@@ -650,7 +650,7 @@ to the corresponding argument of <a class="link" href="gobject-Signals.html#g-si
 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">     G_SIGNAL_RUN_FIRST</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>
@@ -962,6 +962,38 @@ without a return value.</p></td>
 g_signal_set_va_marshaller (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
                             <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> instance_type</code></em>,
                             <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCVaMarshaller" title="GSignalCVaMarshaller"><span class="type">GSignalCVaMarshaller</span></a> va_marshaller</code></em>);</pre>
+<p>Change the <a class="link" href="gobject-Signals.html#GSignalCVaMarshaller" title="GSignalCVaMarshaller"><span class="type">GSignalCVaMarshaller</span></a> used for a given signal.  This is a
+specialised form of the marshaller that can often be used for the
+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">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>signal_id</p></td>
+<td class="parameter_description"><p>the signal id</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>instance_type</p></td>
+<td class="parameter_description"><p>the instance type on which to set the marshaller.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>va_marshaller</p></td>
+<td class="parameter_description"><p>the marshaller to set.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.32</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2332,12 +2364,20 @@ g_signal_has_handler_pending (<em class="parameter"><code><a href="../glib/glib-
 <p>Returns whether there are any handlers connected to <em class="parameter"><code>instance</code></em>
  for the
 given signal id and detail.</p>
+<p>If <em class="parameter"><code>detail</code></em>
+ is 0 then it will only match handlers that were connected
+without detail.  If <em class="parameter"><code>detail</code></em>
+ is non-zero then it will match handlers
+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>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.6"></a><h4>Parameters</h4>
+<a name="id-1.4.12.7.36.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2369,7 +2409,7 @@ of building the arguments.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.12.7.36.7"></a><h4>Returns</h4>
+<a name="id-1.4.12.7.36.8"></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>

data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: Parameters and Values</title>
+<title>Parameters and Values: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
@@ -1389,7 +1389,10 @@ g_param_spec_boolean (<em class="parameter"><code>const <a href="../glib/glib-Ba
                       <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> default_value</code></em>,
                       <em class="parameter"><code><a class="link" href="gobject-GParamSpec.html#GParamFlags" title="enum GParamFlags"><span class="type">GParamFlags</span></a> flags</code></em>);</pre>
 <p>Creates a new <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecBoolean" title="struct GParamSpecBoolean"><span class="type">GParamSpecBoolean</span></a> instance specifying a <a class="link" href="gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS" title="G_TYPE_BOOLEAN"><code class="literal">G_TYPE_BOOLEAN</code></a>
-property.</p>
+property. In many cases, it may be more appropriate to use an enum with
+<a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-enum" title="g_param_spec_enum ()"><code class="function">g_param_spec_enum()</code></a>, both to improve code clarity by using explicitly named
+values, and to allow for more values to be added in future without breaking
+API.</p>
 <p>See <a class="link" href="gobject-GParamSpec.html#g-param-spec-internal" title="g_param_spec_internal ()"><code class="function">g_param_spec_internal()</code></a> for details on property names.</p>
 <div class="refsect3">
 <a name="id-1.4.9.7.5.6"></a><h4>Parameters</h4>
@@ -4981,7 +4984,9 @@ g_param_spec_pointer (<em class="parameter"><code>const <a href="../glib/glib-Ba
                       <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nick</code></em>,
                       <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *blurb</code></em>,
                       <em class="parameter"><code><a class="link" href="gobject-GParamSpec.html#GParamFlags" title="enum GParamFlags"><span class="type">GParamFlags</span></a> flags</code></em>);</pre>
-<p>Creates a new <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecPointer" title="struct GParamSpecPointer"><span class="type">GParamSpecPointer</span></a> instance specifying a pointer property.</p>
+<p>Creates a new <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecPointer" title="struct GParamSpecPointer"><span class="type">GParamSpecPointer</span></a> instance specifying a pointer property.
+Where possible, it is better to use <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-object" title="g_param_spec_object ()"><code class="function">g_param_spec_object()</code></a> or
+<a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-boxed" title="g_param_spec_boxed ()"><code class="function">g_param_spec_boxed()</code></a> to expose memory management information.</p>
 <p>See <a class="link" href="gobject-GParamSpec.html#g-param-spec-internal" title="g_param_spec_internal ()"><code class="function">g_param_spec_internal()</code></a> for details on property names.</p>
 <div class="refsect3">
 <a name="id-1.4.9.7.114.6"></a><h4>Parameters</h4>

data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: GObject</title>
+<title>GObject: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
@@ -230,6 +230,12 @@
 </td>
 </tr>
 <tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="gobject-The-Base-Object-Type.html#g-set-object" title="g_set_object()">g_set_object</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
 <td class="function_type">
 <span class="returnvalue">void</span>
 </td>
@@ -1228,12 +1234,12 @@ class initialization:</p>
 <span class="normal">    </span><span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-int">g_param_spec_int</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Foo"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Foo"</span><span class="symbol">,</span>
 <span class="normal">                      </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS">G_MAXINT</a></span><span class="symbol">,</span>
 <span class="normal">                      </span><span class="number">0</span><span class="symbol">,</span>
-<span class="normal">                      G_PARAM_READWRITE</span><span class="symbol">);</span>
+<span class="normal">                      <a href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS">G_PARAM_READWRITE</a></span><span class="symbol">);</span>
 <span class="normal">  obj_properties</span><span class="symbol">[</span><span class="normal">PROP_BAR</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span>
 <span class="normal">    </span><span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-string">g_param_spec_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"bar"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Bar"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Bar"</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">                         G_PARAM_READWRITE</span><span class="symbol">);</span>
+<span class="normal">                         <a href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS">G_PARAM_READWRITE</a></span><span class="symbol">);</span>
 <span class="normal">  gobject_class</span><span class="symbol">-&gt;</span><span class="normal">set_property </span><span class="symbol">=</span><span class="normal"> my_object_set_property</span><span class="symbol">;</span>
 <span class="normal">  gobject_class</span><span class="symbol">-&gt;</span><span class="normal">get_property </span><span class="symbol">=</span><span class="normal"> my_object_get_property</span><span class="symbol">;</span>
@@ -1627,9 +1633,8 @@ g_object_newv (<em class="parameter"><code><a class="link" href="gobject-Type-In
 <p>Creates a new instance of a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> subtype and sets its properties.</p>
 <p>Construction parameters (see <a class="link" href="gobject-GParamSpec.html#G-PARAM-CONSTRUCT:CAPS"><span class="type">G_PARAM_CONSTRUCT</span></a>, <a class="link" href="gobject-GParamSpec.html#G-PARAM-CONSTRUCT-ONLY:CAPS"><span class="type">G_PARAM_CONSTRUCT_ONLY</span></a>)
 which are not explicitly specified are set to their default values.</p>
-<p>Rename to: g_object_new</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.24.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.24.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1657,7 +1662,7 @@ array</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.24.8"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.24.7"></a><h4>Returns</h4>
 <p> a new instance of
 <em class="parameter"><code>object_type</code></em>
 . </p>
@@ -1701,8 +1706,12 @@ g_object_unref (<em class="parameter"><code><a href="../glib/glib-Basic-Types.ht
 <p>Decreases the reference count of <em class="parameter"><code>object</code></em>
 . When its reference count
 drops to 0, the object is finalized (i.e. its memory is freed).</p>
+<p>If the pointer to the <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> may be reused in future (for example, if it is
+an instance variable of another object), it is recommended to clear the
+pointer to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> rather than retain a dangling pointer to a potentially
+invalid <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance. Use <a class="link" href="gobject-The-Base-Object-Type.html#g-clear-object" title="g_clear_object ()"><code class="function">g_clear_object()</code></a> for this.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.26.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.26.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1756,6 +1765,86 @@ adds a new normal reference increasing the reference count by one.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-set-object"></a><h3>g_set_object()</h3>
+<pre class="programlisting">#define             g_set_object(object_ptr, new_object)</pre>
+<p>Updates a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> pointer to refer to <em class="parameter"><code>new_object</code></em>
+. It increments the
+reference count of <em class="parameter"><code>new_object</code></em>
+ (if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), decrements the reference
+count of the current value of <em class="parameter"><code>object_ptr</code></em>
+ (if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), and assigns
+<em class="parameter"><code>new_object</code></em>
+ to <em class="parameter"><code>object_ptr</code></em>
+. The assignment is not atomic.</p>
+<p><em class="parameter"><code>object_ptr</code></em>
+ must not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
+<p>A macro is also included that allows this function to be used without
+pointer casts. The function itself is static inline, so its address may vary
+between compilation units.</p>
+<p>One convenient usage of this function is in implementing property setters:</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="type">void</span>
+<span class="function">foo_set_bar</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">Foo</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">foo</span><span class="symbol">,</span>
+<span class="normal">             </span><span class="usertype">Bar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">new_bar</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">IS_FOO</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">));</span>
+<span class="normal">  </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">new_bar </span><span class="symbol">==</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">||</span><span class="normal"> </span><span class="function">IS_BAR</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">new_bar</span><span class="symbol">));</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-set-object">g_set_object</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">foo</span><span class="symbol">-&gt;</span><span class="normal">bar</span><span class="symbol">,</span><span class="normal"> new_bar</span><span class="symbol">))</span>
+<span class="normal">    </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-notify">g_object_notify</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"bar"</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<div class="refsect3">
+<a name="id-1.4.5.10.28.10"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>object_ptr</p></td>
+<td class="parameter_description"><p>a pointer to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> reference</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>new_object</p></td>
+<td class="parameter_description"><p> a pointer to the new <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> to
+assign to it, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to clear the pointer. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.5.10.28.11"></a><h4>Returns</h4>
+<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the value of <em class="parameter"><code>object_ptr</code></em>
+changed, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
+<p></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="g-clear-object"></a><h3>g_clear_object ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 g_clear_object (<em class="parameter"><code>volatile <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> **object_ptr</code></em>);</pre>
@@ -1768,7 +1857,7 @@ pointer is set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code cl
 <p>A macro is also included that allows this function to be used without
 pointer casts.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.28.8"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.29.8"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1792,7 +1881,7 @@ g_object_is_floating (<em class="parameter"><code><a href="../glib/glib-Basic-Ty
 <p>Checks whether <em class="parameter"><code>object</code></em>
  has a <a class="link" href="gobject-The-Base-Object-Type.html#floating-ref" title="Floating references">floating</a> reference.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.29.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.30.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1807,7 +1896,7 @@ g_object_is_floating (<em class="parameter"><code><a href="../glib/glib-Basic-Ty
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.29.6"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.30.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em>
 has a floating reference</p>
 <p></p>
@@ -1824,7 +1913,7 @@ a <a class="link" href="gobject-The-Base-Object-Type.html#floating-ref" title="F
 required: all <a href="gobject-The-Base-Object-Type.html#GInitiallyUnowned"><span class="type">GInitiallyUnowneds</span></a> are created with a floating reference
 which usually just needs to be sunken by calling <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref-sink" title="g_object_ref_sink ()"><code class="function">g_object_ref_sink()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.30.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.31.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1851,7 +1940,7 @@ triggered when the object is finalized. Since the object is already being
 finalized when the <a class="link" href="gobject-The-Base-Object-Type.html#GWeakNotify" title="GWeakNotify ()"><span class="type">GWeakNotify</span></a> is called, there's not much you could do
 with the object, apart from e.g. using its address as hash-index or the like.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.31.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.32.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1890,7 +1979,7 @@ thread-safe: they cannot safely be used in one thread if the
 object's last <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a> might happen in another thread.
 Use <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef"><span class="type">GWeakRef</span></a> if thread-safety is required.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.32.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.33.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1926,7 +2015,7 @@ g_object_weak_unref (<em class="parameter"><code><a class="link" href="gobject-T
                      <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 <p>Removes a weak reference callback to an object.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.33.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.34.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1973,7 +2062,7 @@ this method are not thread-safe: they cannot safely be used in one
 thread if the object's last <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a> might happen in another
 thread. Use <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef"><span class="type">GWeakRef</span></a> if thread-safety is required.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.34.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.35.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2007,7 +2096,7 @@ using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-weak-
  has
 to match the one used with <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-weak-pointer" title="g_object_add_weak_pointer ()"><code class="function">g_object_add_weak_pointer()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.35.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.36.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2039,7 +2128,7 @@ to match the one used with <a class="link" href="gobject-The-Base-Object-Type.ht
 <p>A callback function used for notification when the state
 of a toggle reference changes. See <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-toggle-ref" title="g_object_add_toggle_ref ()"><code class="function">g_object_add_toggle_ref()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.36.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.37.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2109,7 +2198,7 @@ of them will ever be notified until all but one are removed.  For
 this reason, you should only ever use a toggle reference if there
 is important state in the proxy object.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.37.9"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.38.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2150,7 +2239,7 @@ g_object_remove_toggle_ref (<em class="parameter"><code><a class="link" href="go
 <p>Removes a reference added with <a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-toggle-ref" title="g_object_add_toggle_ref ()"><code class="function">g_object_add_toggle_ref()</code></a>. The
 reference count of the object is decreased by one.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.38.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.39.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2214,7 +2303,7 @@ g_object_connect (<em class="parameter"><code><a href="../glib/glib-Basic-Types.
 7
 8</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="normal">menu</span><span class="symbol">-&gt;</span><span class="normal">toplevel </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-connect">g_object_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GTK_TYPE_WINDOW</span><span class="symbol">,</span>
-<span class="normal">                           </span><span class="string">"type"</span><span class="symbol">,</span><span class="normal"> GTK_WINDOW_POPUP</span><span class="symbol">,</span>
+<span class="normal">                           </span><span class="string">"type"</span><span class="symbol">,</span><span class="normal"> <a href="http://developer.gnome.org/gtk2/GtkWindow.html#GTK-WINDOW-POPUP:CAPS">GTK_WINDOW_POPUP</a></span><span class="symbol">,</span>
 <span class="normal">                           </span><span class="string">"child"</span><span class="symbol">,</span><span class="normal"> menu</span><span class="symbol">,</span>
 <span class="normal">                           <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">),</span>
 <span class="normal">                     </span><span class="string">"signal::event"</span><span class="symbol">,</span><span class="normal"> gtk_menu_window_event</span><span class="symbol">,</span><span class="normal"> menu</span><span class="symbol">,</span>
@@ -2228,7 +2317,7 @@ g_object_connect (<em class="parameter"><code><a href="../glib/glib-Basic-Types.
 <p></p>
 <div class="refsect3">
-<a name="id-1.4.5.10.39.9"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.40.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2257,7 +2346,7 @@ spec/callback/data triples, followed by <a href="../glib/glib-Standard-Macros.ht
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.39.10"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.40.10"></a><h4>Returns</h4>
 <p> <em class="parameter"><code>object</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@@ -2276,7 +2365,7 @@ g_object_disconnect (<em class="parameter"><code><a href="../glib/glib-Basic-Typ
 callback and data, or "any_signal::signal_name", which only
 disconnects the signal named "signal_name".</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.40.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.41.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2317,7 +2406,7 @@ g_object_set (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html
 reverse order) after all properties have been set. See
 <a class="link" href="gobject-The-Base-Object-Type.html#g-object-freeze-notify" title="g_object_freeze_notify ()"><code class="function">g_object_freeze_notify()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.41.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.42.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2397,7 +2486,7 @@ of three properties: an integer, a string and an object:</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.4.5.10.42.9"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.43.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2442,7 +2531,7 @@ instead.</p>
 and will be emitted (in reverse order) when <a class="link" href="gobject-The-Base-Object-Type.html#g-object-thaw-notify" title="g_object_thaw_notify ()"><code class="function">g_object_thaw_notify()</code></a> is
 called.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.43.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.44.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2519,7 +2608,7 @@ instead, is to store the GParamSpec used with
 <span class="normal">  properties</span><span class="symbol">[</span><span class="normal">PROP_FOO</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-int">g_param_spec_int</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Foo"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"The foo"</span><span class="symbol">,</span>
 <span class="normal">                                           </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100</span><span class="symbol">,</span>
 <span class="normal">                                           </span><span class="number">50</span><span class="symbol">,</span>
-<span class="normal">                                           G_PARAM_READWRITE</span><span class="symbol">);</span>
+<span class="normal">                                           <a href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS">G_PARAM_READWRITE</a></span><span class="symbol">);</span>
 <span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-class-install-property">g_object_class_install_property</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gobject_class</span><span class="symbol">,</span>
 <span class="normal">                                   PROP_FOO</span><span class="symbol">,</span>
 <span class="normal">                                   properties</span><span class="symbol">[</span><span class="normal">PROP_FOO</span><span class="symbol">]);</span>
@@ -2544,7 +2633,7 @@ instead, is to store the GParamSpec used with
 <p></p>
 <div class="refsect3">
-<a name="id-1.4.5.10.44.12"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.45.12"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2584,7 +2673,7 @@ object is frozen.</p>
 <p>This is necessary for accessors that modify multiple properties to prevent
 premature notification while the object is still being modified.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.45.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.46.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2613,7 +2702,7 @@ and when it reaches zero, queued "notify" signals are emitted.</p>
 in which they have been queued.</p>
 <p>It is an error to call this function when the freeze count is zero.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.46.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.47.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2636,7 +2725,7 @@ g_object_get_data (<em class="parameter"><code><a class="link" href="gobject-The
                    <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
 <p>Gets a named field from the objects table of associations (see <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-data" title="g_object_set_data ()"><code class="function">g_object_set_data()</code></a>).</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.47.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.48.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2658,7 +2747,7 @@ g_object_get_data (<em class="parameter"><code><a class="link" href="gobject-The
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.47.6"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.48.6"></a><h4>Returns</h4>
 <p> the data if found, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -2675,7 +2764,7 @@ strings to pointers.  This function lets you set an association.</p>
 <p>If the object already had an association with that name,
 the old association will be destroyed.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.48.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.49.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2717,7 +2806,7 @@ to a different value or when the object is destroyed.</p>
  callback is not called if <em class="parameter"><code>data</code></em>
  is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.49.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.50.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2758,7 +2847,7 @@ g_object_steal_data (<em class="parameter"><code><a class="link" href="gobject-T
 <p>Remove a specified datum from the object's data associations,
 without invoking the association's destroy handler.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.50.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.51.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2780,7 +2869,7 @@ without invoking the association's destroy handler.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.50.6"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.51.6"></a><h4>Returns</h4>
 <p> the data if found, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such data exists. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
@@ -2810,7 +2899,7 @@ is locked.</p>
 threads are using object data on the same key on the same
 object.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.51.8"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.52.8"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2843,7 +2932,7 @@ object.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.51.9"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.52.9"></a><h4>Returns</h4>
 <p> the result of calling <em class="parameter"><code>dup_func</code></em>
 on the value
 associated with <em class="parameter"><code>key</code></em>
@@ -2886,7 +2975,7 @@ or may not include using <em class="parameter"><code>old_destroy</code></em>
  as sometimes replacement
 should not destroy the object in the normal way.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.52.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.53.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2928,7 +3017,7 @@ should not destroy the object in the normal way.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.52.8"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.53.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the existing value for <em class="parameter"><code>key</code></em>
 was replaced
 by <em class="parameter"><code>newval</code></em>
@@ -2946,7 +3035,7 @@ g_object_get_qdata (<em class="parameter"><code><a class="link" href="gobject-Th
 <p>This function gets back user data pointers stored via
 <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-qdata" title="g_object_set_qdata ()"><code class="function">g_object_set_qdata()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.53.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.54.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2968,7 +3057,7 @@ g_object_get_qdata (<em class="parameter"><code><a class="link" href="gobject-Th
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.53.6"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.54.6"></a><h4>Returns</h4>
 <p> The user data pointer set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -2991,7 +3080,7 @@ Setting a previously set user data pointer, overrides (frees)
 the old pointer set, using <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> as pointer essentially
 removes the data stored.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.54.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.55.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3035,7 +3124,7 @@ the data is being overwritten by a call to <a class="link" href="gobject-The-Bas
 with the same <em class="parameter"><code>quark</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.55.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.56.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3143,7 +3232,7 @@ Using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-qdata
 and thus the partial string list would have been freed upon
 <a class="link" href="gobject-The-Base-Object-Type.html#g-object-set-qdata-full" title="g_object_set_qdata_full ()"><code class="function">g_object_set_qdata_full()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.56.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.57.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3165,7 +3254,7 @@ and thus the partial string list would have been freed upon
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.56.8"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.57.8"></a><h4>Returns</h4>
 <p> The user data pointer set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
@@ -3195,7 +3284,7 @@ is locked.</p>
 threads are using object data on the same key on the same
 object.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.57.8"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.58.8"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3228,7 +3317,7 @@ object.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.57.9"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.58.9"></a><h4>Returns</h4>
 <p> the result of calling <em class="parameter"><code>dup_func</code></em>
 on the value
 associated with <em class="parameter"><code>quark</code></em>
@@ -3271,7 +3360,7 @@ or may not include using <em class="parameter"><code>old_destroy</code></em>
  as sometimes replacement
 should not destroy the object in the normal way.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.58.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.59.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3313,7 +3402,7 @@ should not destroy the object in the normal way.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.58.8"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.59.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the existing value for <em class="parameter"><code>quark</code></em>
 was replaced
 by <em class="parameter"><code>newval</code></em>
@@ -3331,7 +3420,7 @@ g_object_set_property (<em class="parameter"><code><a class="link" href="gobject
                        <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 <p>Sets a property on an object.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.59.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.60.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3374,7 +3463,7 @@ responsible for freeing the memory by calling <a class="link" href="gobject-Gene
 <p>Note that <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get-property" title="g_object_get_property ()"><code class="function">g_object_get_property()</code></a> is really intended for language
 bindings, <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get" title="g_object_get ()"><code class="function">g_object_get()</code></a> is much more convenient for C programming.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.60.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.61.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3412,7 +3501,7 @@ g_object_new_valist (<em class="parameter"><code><a class="link" href="gobject-T
 <p>Construction parameters (see <a class="link" href="gobject-GParamSpec.html#G-PARAM-CONSTRUCT:CAPS"><span class="type">G_PARAM_CONSTRUCT</span></a>, <a class="link" href="gobject-GParamSpec.html#G-PARAM-CONSTRUCT-ONLY:CAPS"><span class="type">G_PARAM_CONSTRUCT_ONLY</span></a>)
 which are not explicitly specified are set to their default values.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.61.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.62.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3440,7 +3529,7 @@ name/value pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CA
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.61.7"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.62.7"></a><h4>Returns</h4>
 <p> a new instance of <em class="parameter"><code>object_type</code></em>
 </p>
 <p></p>
@@ -3455,7 +3544,7 @@ g_object_set_valist (<em class="parameter"><code><a class="link" href="gobject-T
                      <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
 <p>Sets properties on an object.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.62.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.63.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3496,7 +3585,7 @@ is responsible for freeing the memory in the appropriate manner for
 the type, for instance by calling <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> or <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a>.</p>
 <p>See <a class="link" href="gobject-The-Base-Object-Type.html#g-object-get" title="g_object_get ()"><code class="function">g_object_get()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.63.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.64.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3546,7 +3635,7 @@ reference count is held on <em class="parameter"><code>object</code></em>
 use this <em class="parameter"><code>object</code></em>
  as closure data.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.64.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.65.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3576,9 +3665,9 @@ use this <em class="parameter"><code>object</code></em>
 g_object_run_dispose (<em class="parameter"><code><a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>);</pre>
 <p>Releases all references to other objects. This can be used to break
 reference cycles.</p>
-<p>This functions should only be called from object system implementations.</p>
+<p>This function should only be called from object system implementations.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.65.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.66.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3600,7 +3689,7 @@ reference cycles.</p>
 <p>This macro should be used to emit a standard warning about unexpected
 properties in <code class="function">set_property()</code> and <code class="function">get_property()</code> implementations.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.66.5"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.67.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3642,7 +3731,7 @@ freshly-initialised weak reference.</p>
 <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef"><span class="type">GWeakRef</span></a> in static storage because it will already be
 properly initialised.  Just use <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-set" title="g_weak_ref_set ()"><code class="function">g_weak_ref_set()</code></a> directly.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.67.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.68.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3676,7 +3765,7 @@ After this call, the <a class="link" href="gobject-The-Base-Object-Type.html#GWe
 <p>You should only call this on a <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef"><span class="type">GWeakRef</span></a> that previously had
 <a class="link" href="gobject-The-Base-Object-Type.html#g-weak-ref-init" title="g_weak_ref_init ()"><code class="function">g_weak_ref_init()</code></a> called on it.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.68.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.69.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3707,7 +3796,7 @@ its last reference at the same time in a different thread.</p>
 <p>The caller should release the resulting reference in the usual way,
 by using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()"><code class="function">g_object_unref()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.69.7"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.70.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -3722,7 +3811,7 @@ by using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref"
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.5.10.69.8"></a><h4>Returns</h4>
+<a name="id-1.4.5.10.70.8"></a><h4>Returns</h4>
 <p> the object pointed to
 by <em class="parameter"><code>weak_ref</code></em>
 , or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it was empty. </p>
@@ -3743,7 +3832,7 @@ g_weak_ref_set (<em class="parameter"><code><a class="link" href="gobject-The-Ba
  while calling this
 function.</p>
 <div class="refsect3">
-<a name="id-1.4.5.10.70.6"></a><h4>Parameters</h4>
+<a name="id-1.4.5.10.71.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">