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

glib2 2.2.5-x86-mingw32 → 3.0.0-x86-mingw32

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

Files changed (1979) hide show

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

@@ -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 Viewed

@@ -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 Viewed

@@ -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 Viewed

@@ -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 Viewed

@@ -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 Viewed

@@ -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">