RubyGems - glib2 - Versions diffs - 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32 - Mend

glib2 3.2.1-x86-mingw32 → 3.2.2-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 (927) hide show

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

@@ -8,7 +8,7 @@
 <link rel="up" href="rn01.html" title="API Reference">
 <link rel="prev" href="gobject-Generic-values.html" title="Generic values">
 <link rel="next" href="gobject-GParamSpec.html" title="GParamSpec">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -1431,7 +1431,7 @@ API.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-boolean.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -1628,7 +1628,7 @@ g_param_spec_char (<em class="parameter"><code>const <a href="../glib-Basic-Type
 </div>
 <div class="refsect3">
 <a name="g-param-spec-char.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -1895,7 +1895,7 @@ g_param_spec_uchar (<em class="parameter"><code>const <a href="../glib-Basic-Typ
 </div>
 <div class="refsect3">
 <a name="g-param-spec-uchar.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -2093,7 +2093,7 @@ g_param_spec_int (<em class="parameter"><code>const <a href="../glib-Basic-Types
 </div>
 <div class="refsect3">
 <a name="g-param-spec-int.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -2291,7 +2291,7 @@ g_param_spec_uint (<em class="parameter"><code>const <a href="../glib-Basic-Type
 </div>
 <div class="refsect3">
 <a name="g-param-spec-uint.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -2489,7 +2489,7 @@ g_param_spec_long (<em class="parameter"><code>const <a href="../glib-Basic-Type
 </div>
 <div class="refsect3">
 <a name="g-param-spec-long.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -2688,7 +2688,7 @@ property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-ulong.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -2886,7 +2886,7 @@ g_param_spec_int64 (<em class="parameter"><code>const <a href="../glib-Basic-Typ
 </div>
 <div class="refsect3">
 <a name="g-param-spec-int64.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -3085,7 +3085,7 @@ property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-uint64.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -3283,7 +3283,7 @@ g_param_spec_float (<em class="parameter"><code>const <a href="../glib-Basic-Typ
 </div>
 <div class="refsect3">
 <a name="g-param-spec-float.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -3482,7 +3482,7 @@ property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-double.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -3675,7 +3675,7 @@ property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-enum.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -3868,7 +3868,7 @@ property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-flags.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -4041,7 +4041,7 @@ g_param_spec_string (<em class="parameter"><code>const <a href="../glib-Basic-Ty
 </tr>
 <tr>
 <td class="parameter_name"><p>default_value</p></td>
-<td class="parameter_description"><p> default value for the property specified. </p></td>
+<td class="parameter_description"><p>default value for the property specified. </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>]</span></td>
 </tr>
 <tr>
@@ -4054,7 +4054,7 @@ g_param_spec_string (<em class="parameter"><code>const <a href="../glib-Basic-Ty
 </div>
 <div class="refsect3">
 <a name="g-param-spec-string.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -4082,7 +4082,7 @@ g_value_set_string (<em class="parameter"><code><a class="link" href="gobject-Ge
 </tr>
 <tr>
 <td class="parameter_name"><p>v_string</p></td>
-<td class="parameter_description"><p> caller-owned string to be duplicated for the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>. </p></td>
+<td class="parameter_description"><p>caller-owned string to be duplicated for the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>. </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>]</span></td>
 </tr>
 </tbody>
@@ -4115,7 +4115,7 @@ when setting the <a class="link" href="gobject-Generic-values.html#GValue" title
 </tr>
 <tr>
 <td class="parameter_name"><p>v_string</p></td>
-<td class="parameter_description"><p> static string to be set. </p></td>
+<td class="parameter_description"><p>static string to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4146,7 +4146,7 @@ g_value_take_string (<em class="parameter"><code><a class="link" href="gobject-G
 </tr>
 <tr>
 <td class="parameter_name"><p>v_string</p></td>
-<td class="parameter_description"><p> string to take ownership of. </p></td>
+<td class="parameter_description"><p>string to take ownership of. </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>]</span></td>
 </tr>
 </tbody>
@@ -4181,7 +4181,7 @@ g_value_set_string_take_ownership (<em class="parameter"><code><a class="link" h
 </tr>
 <tr>
 <td class="parameter_name"><p>v_string</p></td>
-<td class="parameter_description"><p> duplicated unowned string to be set. </p></td>
+<td class="parameter_description"><p>duplicated unowned string to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4367,7 +4367,7 @@ property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-param.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -4395,7 +4395,7 @@ g_value_set_param (<em class="parameter"><code><a class="link" href="gobject-Gen
 </tr>
 <tr>
 <td class="parameter_name"><p>param</p></td>
-<td class="parameter_description"><p> the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> to be set. </p></td>
+<td class="parameter_description"><p>the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4430,7 +4430,7 @@ doesn't have to unref it any more.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>param</p></td>
-<td class="parameter_description"><p> the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> to be set. </p></td>
+<td class="parameter_description"><p>the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4466,7 +4466,7 @@ g_value_set_param_take_ownership (<em class="parameter"><code><a class="link" hr
 </tr>
 <tr>
 <td class="parameter_name"><p>param</p></td>
-<td class="parameter_description"><p> the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> to be set. </p></td>
+<td class="parameter_description"><p>the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4496,7 +4496,7 @@ g_value_get_param (<em class="parameter"><code>const <a class="link" href="gobje
 </div>
 <div class="refsect3">
 <a name="g-value-get-param.returns"></a><h4>Returns</h4>
-<p> <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> content of <em class="parameter"><code>value</code></em>
+<p><a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> content of <em class="parameter"><code>value</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>
 </div>
@@ -4657,7 +4657,7 @@ derived property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-boxed.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -4685,7 +4685,7 @@ g_value_set_boxed (<em class="parameter"><code><a class="link" href="gobject-Gen
 </tr>
 <tr>
 <td class="parameter_name"><p>v_boxed</p></td>
-<td class="parameter_description"><p> boxed value to be set. </p></td>
+<td class="parameter_description"><p>boxed value to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4718,7 +4718,7 @@ when setting the <a class="link" href="gobject-Generic-values.html#GValue" title
 </tr>
 <tr>
 <td class="parameter_name"><p>v_boxed</p></td>
-<td class="parameter_description"><p> static boxed value to be set. </p></td>
+<td class="parameter_description"><p>static boxed value to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4752,7 +4752,7 @@ the caller doesn't have to unref it any more.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>v_boxed</p></td>
-<td class="parameter_description"><p> duplicated unowned boxed value to be set. </p></td>
+<td class="parameter_description"><p>duplicated unowned boxed value to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4787,7 +4787,7 @@ g_value_set_boxed_take_ownership (<em class="parameter"><code><a class="link" hr
 </tr>
 <tr>
 <td class="parameter_name"><p>v_boxed</p></td>
-<td class="parameter_description"><p> duplicated unowned boxed value to be set. </p></td>
+<td class="parameter_description"><p>duplicated unowned boxed value to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -4817,7 +4817,7 @@ g_value_get_boxed (<em class="parameter"><code>const <a class="link" href="gobje
 </div>
 <div class="refsect3">
 <a name="g-value-get-boxed.returns"></a><h4>Returns</h4>
-<p> boxed contents of <em class="parameter"><code>value</code></em>
+<p>boxed contents of <em class="parameter"><code>value</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>
 </div>
@@ -4974,7 +4974,7 @@ Where possible, it is better to use <a class="link" href="gobject-Standard-Param
 </div>
 <div class="refsect3">
 <a name="g-param-spec-pointer.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -5032,7 +5032,7 @@ g_value_get_pointer (<em class="parameter"><code>const <a class="link" href="gob
 </div>
 <div class="refsect3">
 <a name="g-value-get-pointer.returns"></a><h4>Returns</h4>
-<p> pointer contents of <em class="parameter"><code>value</code></em>
+<p>pointer contents of <em class="parameter"><code>value</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>
 </div>
@@ -5162,7 +5162,7 @@ derived property.</p>
 </div>
 <div class="refsect3">
 <a name="g-param-spec-object.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -5201,7 +5201,7 @@ the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><sp
 </tr>
 <tr>
 <td class="parameter_name"><p>v_object</p></td>
-<td class="parameter_description"><p> object value to be set. </p></td>
+<td class="parameter_description"><p>object value to be set. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -5240,7 +5240,7 @@ count of the object is not increased).</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>v_object</p></td>
-<td class="parameter_description"><p> object value to be set. </p></td>
+<td class="parameter_description"><p>object value to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -5276,7 +5276,7 @@ g_value_set_object_take_ownership (<em class="parameter"><code><a class="link" h
 </tr>
 <tr>
 <td class="parameter_name"><p>v_object</p></td>
-<td class="parameter_description"><p> object value to be set. </p></td>
+<td class="parameter_description"><p>object value to be set. </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>]</span></td>
 </tr>
 </tbody>
@@ -5306,7 +5306,7 @@ g_value_get_object (<em class="parameter"><code>const <a class="link" href="gobj
 </div>
 <div class="refsect3">
 <a name="g-value-get-object.returns"></a><h4>Returns</h4>
-<p> object contents of <em class="parameter"><code>value</code></em>
+<p>object contents of <em class="parameter"><code>value</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -5336,7 +5336,7 @@ its reference count. If the contents of the <a class="link" href="gobject-Generi
 </div>
 <div class="refsect3">
 <a name="g-value-dup-object.returns"></a><h4>Returns</h4>
-<p> object content of <em class="parameter"><code>value</code></em>
+<p>object content of <em class="parameter"><code>value</code></em>
 ,
 should be unreferenced when no longer needed. </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
@@ -5442,7 +5442,7 @@ property. <a class="link" href="gobject-Generic-values.html#GValue" title="GValu
 </div>
 <div class="refsect3">
 <a name="g-param-spec-unichar.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
@@ -5777,7 +5777,7 @@ of the property (use <a class="link" href="gobject-Type-Information.html#G-TYPE-
 </div>
 <div class="refsect3">
 <a name="g-param-spec-gtype.returns"></a><h4>Returns</h4>
-<p> a newly created parameter specification. </p>
+<p>a newly created parameter specification. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
@@ -5965,7 +5965,7 @@ property.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>default_value</p></td>
-<td class="parameter_description"><p> a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of type <em class="parameter"><code>type</code></em>
+<td class="parameter_description"><p>a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of type <em class="parameter"><code>type</code></em>
 to
 use as the default value, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
@@ -5980,7 +5980,7 @@ use as the default value, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><c
 </div>
 <div class="refsect3">
 <a name="g-param-spec-variant.returns"></a><h4>Returns</h4>
-<p> the newly created <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a>. </p>
+<p>the newly created <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></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>
 <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
@@ -6008,8 +6008,9 @@ g_value_get_variant (<em class="parameter"><code>const <a class="link" href="gob
 </div>
 <div class="refsect3">
 <a name="g-value-get-variant.returns"></a><h4>Returns</h4>
-<p> variant contents of <em class="parameter"><code>value</code></em>
-</p>
+<p>variant contents of <em class="parameter"><code>value</code></em>
+(may be <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>). </p>
+<p><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>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
@@ -6018,7 +6019,8 @@ g_value_get_variant (<em class="parameter"><code>const <a class="link" href="gob
 <a name="g-value-dup-variant"></a><h3>g_value_dup_variant ()</h3>
 <pre class="programlisting"><a href="../glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 g_value_dup_variant (<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>Get the contents of a variant <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>, increasing its refcount.</p>
+<p>Get the contents of a variant <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>, increasing its refcount. The returned
+<a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is never floating.</p>
 <div class="refsect3">
 <a name="g-value-dup-variant.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -6036,9 +6038,10 @@ g_value_dup_variant (<em class="parameter"><code>const <a class="link" href="gob
 </div>
 <div class="refsect3">
 <a name="g-value-dup-variant.returns"></a><h4>Returns</h4>
-<p> variant contents of <em class="parameter"><code>value</code></em>
-, should be unrefed using
-<a href="../glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when no longer needed</p>
+<p>variant contents of <em class="parameter"><code>value</code></em>
+(may be <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>);
+should be unreffed using <a href="../glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when no longer needed. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
@@ -6067,7 +6070,7 @@ If the variant is floating, it is consumed.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>variant</p></td>
-<td class="parameter_description"><p> a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_description"><p>a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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>]</span></td>
 </tr>
 </tbody>
@@ -6110,7 +6113,7 @@ a hard reference.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>variant</p></td>
-<td class="parameter_description"><p> a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_description"><p>a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -7091,6 +7094,6 @@ unless you are implementing a new base type similar to GObject.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="rn01.html" title="API Reference">
 <link rel="prev" href="GTypeModule.html" title="GTypeModule">
 <link rel="next" href="gobject-Enumeration-and-Flag-Types.html" title="Enumeration and Flag Types">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -308,6 +308,18 @@
 </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-weak-pointer" title="g_set_weak_pointer()">g_set_weak_pointer</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="gobject-The-Base-Object-Type.html#g-clear-weak-pointer" title="g_clear_weak_pointer()">g_clear_weak_pointer</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
 <td class="function_type">
 <span class="returnvalue">void</span>
 </td>
@@ -700,8 +712,8 @@ allows code to be written as:</p>
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting">container <span class="gtkdoc opt">=</span> <span class="function">create_container</span> <span class="gtkdoc opt">();</span>
-<span class="function">container_add_child</span> <span class="gtkdoc opt">(</span>container<span class="gtkdoc opt">,</span> <span class="function">create_child</span><span class="gtkdoc opt">());</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">container </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_container</span><span class="normal"> </span><span class="symbol">();</span>
+<span class="function">container_add_child</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">container</span><span class="symbol">,</span><span class="normal"> </span><span class="function">create_child</span><span class="symbol">());</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -722,11 +734,11 @@ written as:</p>
 3
 4
 5</pre></td>
-        <td class="listing_code"><pre class="programlisting">Child <span class="gtkdoc opt">*</span>child<span class="gtkdoc opt">;</span>
-container <span class="gtkdoc opt">=</span> <span class="function">create_container</span> <span class="gtkdoc opt">();</span>
-child <span class="gtkdoc opt">=</span> <span class="function">create_child</span> <span class="gtkdoc opt">();</span>
-<span class="function">container_add_child</span> <span class="gtkdoc opt">(</span>container<span class="gtkdoc opt">,</span> child<span class="gtkdoc opt">);</span>
-<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>child<span class="gtkdoc opt">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">Child</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">child</span><span class="symbol">;</span>
+<span class="normal">container </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_container</span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">child </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_child</span><span class="normal"> </span><span class="symbol">();</span>
+<span class="function">container_add_child</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">container</span><span class="symbol">,</span><span class="normal"> child</span><span class="symbol">);</span>
+<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -742,7 +754,7 @@ language bindings that provide automated reference and memory ownership
 maintenance (such as smart pointers or garbage collection) should not
 expose floating references in their API.</p>
 <p>Some object implementations may need to save an objects floating state
-across certain code portions (an example is <a href="../gtk4/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a>), to achieve this,
+across certain code portions (an example is <span class="type">GtkMenu</span>), to achieve this,
 the following sequence can be used:</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -760,18 +772,18 @@ the following sequence can be used:</p>
 10
 11
 12</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc slc">// save floating state</span>
-gboolean was_floating <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-is-floating">g_object_is_floating</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
-<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-ref-sink">g_object_ref_sink</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
-<span class="gtkdoc slc">// protected code portion</span>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">// save floating state</span>
+<span class="usertype">gboolean</span><span class="normal"> was_floating </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-is-floating">g_object_is_floating</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
+<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-ref-sink">g_object_ref_sink</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
+<span class="comment">// protected code portion</span>
-<span class="gtkdoc opt">...</span>
+<span class="symbol">...</span>
-<span class="gtkdoc slc">// restore floating state</span>
-<span class="keyword">if</span> <span class="gtkdoc opt">(</span>was_floating<span class="gtkdoc opt">)</span>
-  <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-force-floating">g_object_force_floating</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span>
+<span class="comment">// restore floating state</span>
+<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">was_floating</span><span class="symbol">)</span>
+<span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-force-floating">g_object_force_floating</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
 <span class="keyword">else</span>
-  <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">);</span> <span class="gtkdoc slc">// release previously acquired reference</span></pre></td>
+<span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span><span class="normal"> </span><span class="comment">// release previously acquired reference</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1242,34 +1254,34 @@ class initialization:</p>
 26
 27
 28</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">enum</span> <span class="gtkdoc opt">{</span>
-  PROP_0<span class="gtkdoc opt">,</span> PROP_FOO<span class="gtkdoc opt">,</span> PROP_BAR<span class="gtkdoc opt">,</span> N_PROPERTIES
-<span class="gtkdoc opt">};</span>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">enum</span><span class="normal"> </span><span class="cbracket">{</span>
+<span class="normal">  PROP_0</span><span class="symbol">,</span><span class="normal"> PROP_FOO</span><span class="symbol">,</span><span class="normal"> PROP_BAR</span><span class="symbol">,</span><span class="normal"> N_PROPERTIES</span>
+<span class="cbracket">}</span><span class="symbol">;</span>
-<span class="gtkdoc kwb">static</span> GParamSpec <span class="gtkdoc opt">*</span>obj_properties<span class="gtkdoc opt">[</span>N_PROPERTIES<span class="gtkdoc opt">] = {</span> NULL<span class="gtkdoc opt">, };</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="usertype">GParamSpec</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">obj_properties</span><span class="symbol">[</span><span class="normal">N_PROPERTIES</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">my_object_class_init</span> <span class="gtkdoc opt">(</span>MyObjectClass <span class="gtkdoc opt">*</span>klass<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  GObjectClass <span class="gtkdoc opt">*</span>gobject_class <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span> <span class="gtkdoc opt">(</span>klass<span class="gtkdoc opt">);</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">my_object_class_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObjectClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">klass</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GObjectClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">gobject_class </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">klass</span><span class="symbol">);</span>
-  obj_properties<span class="gtkdoc opt">[</span>PROP_FOO<span class="gtkdoc opt">] =</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="gtkdoc opt">(</span><span class="string">&quot;foo&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;Foo&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;Foo&quot;</span><span class="gtkdoc opt">,</span>
-                      <span class="gtkdoc opt">-</span><span class="number">1</span><span class="gtkdoc opt">,</span> G_MAXINT<span class="gtkdoc opt">,</span>
-                      <span class="number">0</span><span class="gtkdoc opt">,</span>
-                      G_PARAM_READWRITE<span class="gtkdoc opt">);</span>
+<span class="normal">  obj_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">"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-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">                      <a href="gobject-GParamSpec.html#G-PARAM-READWRITE:CAPS">G_PARAM_READWRITE</a></span><span class="symbol">);</span>
-  obj_properties<span class="gtkdoc opt">[</span>PROP_BAR<span class="gtkdoc opt">] =</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="gtkdoc opt">(</span><span class="string">&quot;bar&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;Bar&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;Bar&quot;</span><span class="gtkdoc opt">,</span>
-                         NULL<span class="gtkdoc opt">,</span>
-                         G_PARAM_READWRITE<span class="gtkdoc opt">);</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-Standard-Macros.html#NULL:CAPS">NULL</a></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>
-  gobject_class<span class="gtkdoc opt">-&gt;</span>set_property <span class="gtkdoc opt">=</span> my_object_set_property<span class="gtkdoc opt">;</span>
-  gobject_class<span class="gtkdoc opt">-&gt;</span>get_property <span class="gtkdoc opt">=</span> my_object_get_property<span class="gtkdoc opt">;</span>
-  <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-class-install-properties">g_object_class_install_properties</a></span> <span class="gtkdoc opt">(</span>gobject_class<span class="gtkdoc opt">,</span>
-                                     N_PROPERTIES<span class="gtkdoc opt">,</span>
-                                     obj_properties<span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<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>
+<span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-class-install-properties">g_object_class_install_properties</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gobject_class</span><span class="symbol">,</span>
+<span class="normal">                                     N_PROPERTIES</span><span class="symbol">,</span>
+<span class="normal">                                     obj_properties</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1290,15 +1302,15 @@ class initialization:</p>
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>
-<span class="function">my_object_set_foo</span> <span class="gtkdoc opt">(</span>MyObject <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">,</span> gint foo<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">-&gt;</span>foo <span class="gtkdoc opt">!=</span> foo<span class="gtkdoc opt">)</span>
-    <span class="gtkdoc opt">{</span>
-      self<span class="gtkdoc opt">-&gt;</span>foo <span class="gtkdoc opt">=</span> foo<span class="gtkdoc opt">;</span>
-      <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec">g_object_notify_by_pspec</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">),</span> obj_properties<span class="gtkdoc opt">[</span>PROP_FOO<span class="gtkdoc opt">]);</span>
-    <span class="gtkdoc opt">}</span>
- <span class="gtkdoc opt">}</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">void</span>
+<span class="function">my_object_set_foo</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gint</span><span class="normal"> foo</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">-&gt;</span><span class="normal">foo </span><span class="symbol">!=</span><span class="normal"> foo</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      self</span><span class="symbol">-&gt;</span><span class="normal">foo </span><span class="symbol">=</span><span class="normal"> foo</span><span class="symbol">;</span>
+<span class="normal">      </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec">g_object_notify_by_pspec</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">),</span><span class="normal"> obj_properties</span><span class="symbol">[</span><span class="normal">PROP_FOO</span><span class="symbol">]);</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal"> </span><span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1326,7 +1338,7 @@ class initialization:</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>pspecs</p></td>
-<td class="parameter_description"><p> the <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpecs</span></a> array
+<td class="parameter_description"><p>the <a href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpecs</span></a> array
 defining the new properties. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_pspecs]</span></td>
 </tr>
@@ -1366,7 +1378,7 @@ g_object_class_find_property (<em class="parameter"><code><a class="link" href="
 </div>
 <div class="refsect3">
 <a name="g-object-class-find-property.returns"></a><h4>Returns</h4>
-<p> the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> for the property, or
+<p>the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> for the property, or
 <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the class doesn't have a property of that name. </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>
@@ -1394,7 +1406,7 @@ g_object_class_list_properties (<em class="parameter"><code><a class="link" href
 </tr>
 <tr>
 <td class="parameter_name"><p>n_properties</p></td>
-<td class="parameter_description"><p> return location for the length of the returned array. </p></td>
+<td class="parameter_description"><p>return location for the length of the returned array. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -1402,7 +1414,7 @@ g_object_class_list_properties (<em class="parameter"><code><a class="link" href
 </div>
 <div class="refsect3">
 <a name="g-object-class-list-properties.returns"></a><h4>Returns</h4>
-<p> an array of
+<p>an array of
 <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a>* which should be freed after use. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
 </div>
@@ -1486,6 +1498,8 @@ vtable initialization function (the <em class="parameter"><code>class_init</code
 <a class="link" href="gobject-Type-Information.html#GTypeInfo" title="struct GTypeInfo"><span class="type">GTypeInfo</span></a>.) It must not be called after after <em class="parameter"><code>class_init</code></em>
  has
 been called for any object types implementing this interface.</p>
+<p>If <em class="parameter"><code>pspec</code></em>
+ is a floating reference, it will be consumed.</p>
 <div class="refsect3">
 <a name="g-object-interface-install-property.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1497,7 +1511,7 @@ been called for any object types implementing this interface.</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>g_iface</p></td>
-<td class="parameter_description"><p> any interface vtable for the
+<td class="parameter_description"><p>any interface vtable for the
 interface, or the default
 vtable for the interface. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.TypeInterface]</span></td>
@@ -1535,7 +1549,7 @@ if you know the interface has already been loaded,
 <tbody>
 <tr>
 <td class="parameter_name"><p>g_iface</p></td>
-<td class="parameter_description"><p> any interface vtable for the
+<td class="parameter_description"><p>any interface vtable for the
 interface, or the default vtable for the interface. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.TypeInterface]</span></td>
 </tr>
@@ -1549,7 +1563,7 @@ interface, or the default vtable for the interface. </p></td>
 </div>
 <div class="refsect3">
 <a name="g-object-interface-find-property.returns"></a><h4>Returns</h4>
-<p> the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> for the property of the
+<p>the <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a> for the property of the
 interface with the name <em class="parameter"><code>property_name</code></em>
 , or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no
 such property exists. </p>
@@ -1579,13 +1593,13 @@ already been loaded, <a class="link" href="gobject-Type-Information.html#g-type-
 <tbody>
 <tr>
 <td class="parameter_name"><p>g_iface</p></td>
-<td class="parameter_description"><p> any interface vtable for the
+<td class="parameter_description"><p>any interface vtable for the
 interface, or the default vtable for the interface. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.TypeInterface]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>n_properties_p</p></td>
-<td class="parameter_description"><p> location to store number of properties returned. </p></td>
+<td class="parameter_description"><p>location to store number of properties returned. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -1593,7 +1607,7 @@ interface, or the default vtable for the interface. </p></td>
 </div>
 <div class="refsect3">
 <a name="g-object-interface-list-properties.returns"></a><h4>Returns</h4>
-<p> a
+<p>a
 pointer to an array of pointers to <a class="link" href="gobject-GParamSpec.html#GParamSpec" title="struct GParamSpec"><span class="type">GParamSpec</span></a>
 structures. The paramspecs are owned by GLib, but the
 array should be freed with <a href="../glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when you are done with
@@ -1643,7 +1657,7 @@ name/value pairs, followed by <a href="../glib-Standard-Macros.html#NULL:CAPS"><
 </div>
 <div class="refsect3">
 <a name="g-object-new.returns"></a><h4>Returns</h4>
-<p> a new instance of
+<p>a new instance of
 <em class="parameter"><code>object_type</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></p>
@@ -1685,12 +1699,12 @@ which are not explicitly specified are set to their default values.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>names</p></td>
-<td class="parameter_description"><p> the names of each property to be set. </p></td>
+<td class="parameter_description"><p>the names of each property to be set. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>values</p></td>
-<td class="parameter_description"><p> the values of each property to be set. </p></td>
+<td class="parameter_description"><p>the values of each property to be set. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
 </tr>
 </tbody>
@@ -1698,7 +1712,7 @@ which are not explicitly specified are set to their default values.</p>
 </div>
 <div class="refsect3">
 <a name="g-object-new-with-properties.returns"></a><h4>Returns</h4>
-<p> a new instance of
+<p>a new instance of
 <em class="parameter"><code>object_type</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
@@ -1742,7 +1756,7 @@ array</p></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>parameters</p></td>
-<td class="parameter_description"><p> an array of <a class="link" href="gobject-The-Base-Object-Type.html#GParameter" title="struct GParameter"><span class="type">GParameter</span></a>. </p></td>
+<td class="parameter_description"><p>an array of <a class="link" href="gobject-The-Base-Object-Type.html#GParameter" title="struct GParameter"><span class="type">GParameter</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_parameters]</span></td>
 </tr>
 </tbody>
@@ -1750,7 +1764,7 @@ array</p></td>
 </div>
 <div class="refsect3">
 <a name="g-object-newv.returns"></a><h4>Returns</h4>
-<p> a new instance of
+<p>a new instance of
 <em class="parameter"><code>object_type</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
@@ -1763,6 +1777,11 @@ array</p></td>
 g_object_ref (<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>);</pre>
 <p>Increases the reference count of <em class="parameter"><code>object</code></em>
 .</p>
+<p>Since GLib 2.56, if <code class="literal">GLIB_VERSION_MAX_ALLOWED</code> is 2.56 or greater, the type
+of <em class="parameter"><code>object</code></em>
+ will be propagated to the return type (using the GCC <code class="function">typeof()</code>
+extension), so any casting the caller needs to do on the return type must be
+explicit.</p>
 <div class="refsect3">
 <a name="g-object-ref.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1773,14 +1792,14 @@ g_object_ref (<em class="parameter"><code><a href="../glib-Basic-Types.html#gpoi
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr></tbody>
 </table></div>
 </div>
 <div class="refsect3">
 <a name="g-object-ref.returns"></a><h4>Returns</h4>
-<p> the same <em class="parameter"><code>object</code></em>
+<p>the same <em class="parameter"><code>object</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -1807,7 +1826,7 @@ invalid <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span c
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr></tbody>
 </table></div>
@@ -1827,6 +1846,9 @@ ownership" of the floating reference, converting it to a normal
 reference by clearing the floating flag while leaving the reference
 count unchanged.  If the object is not floating, then this call
 adds a new normal reference increasing the reference count by one.</p>
+<p>Since GLib 2.56, the type of <em class="parameter"><code>object</code></em>
+ will be propagated to the return type
+under the same conditions as for <a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref" title="g_object_ref ()"><code class="function">g_object_ref()</code></a>.</p>
 <div class="refsect3">
 <a name="g-object-ref-sink.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1837,14 +1859,14 @@ adds a new normal reference increasing the reference count by one.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr></tbody>
 </table></div>
 </div>
 <div class="refsect3">
 <a name="g-object-ref-sink.returns"></a><h4>Returns</h4>
-<p> <em class="parameter"><code>object</code></em>
+<p><em class="parameter"><code>object</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -1883,16 +1905,16 @@ between compilation units.</p>
 8
 9
 10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>
-<span class="function">foo_set_bar</span> <span class="gtkdoc opt">(</span>Foo <span class="gtkdoc opt">*</span>foo<span class="gtkdoc opt">,</span>
-             Bar <span class="gtkdoc opt">*</span>new_bar<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span> <span class="gtkdoc opt">(</span><span class="function">IS_FOO</span> <span class="gtkdoc opt">(</span>foo<span class="gtkdoc opt">));</span>
-  <span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span> <span class="gtkdoc opt">(</span>new_bar <span class="gtkdoc opt">==</span> NULL <span class="gtkdoc opt">||</span> <span class="function">IS_BAR</span> <span class="gtkdoc opt">(</span>new_bar<span class="gtkdoc opt">));</span>
+        <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-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-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-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="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-set-object">g_set_object</a></span> <span class="gtkdoc opt">(&amp;</span>foo<span class="gtkdoc opt">-&gt;</span>bar<span class="gtkdoc opt">,</span> new_bar<span class="gtkdoc opt">))</span>
-    <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-notify">g_object_notify</a></span> <span class="gtkdoc opt">(</span>foo<span class="gtkdoc opt">,</span> <span class="string">&quot;bar&quot;</span><span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<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>
@@ -1915,7 +1937,7 @@ between compilation units.</p>
 </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
+<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-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>
@@ -1977,7 +1999,7 @@ g_object_is_floating (<em class="parameter"><code><a href="../glib-Basic-Types.h
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr></tbody>
 </table></div>
@@ -2166,9 +2188,9 @@ thread. Use <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" ti
 </tr>
 <tr>
 <td class="parameter_name"><p>weak_pointer_location</p></td>
-<td class="parameter_description"><p> The memory address
+<td class="parameter_description"><p>The memory address
 of a pointer. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][not optional]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL must not be passed as the pointer to a location."><span class="acronym">not optional</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -2202,13 +2224,123 @@ to match the one used with <a class="link" href="gobject-The-Base-Object-Type.ht
 </tr>
 <tr>
 <td class="parameter_name"><p>weak_pointer_location</p></td>
-<td class="parameter_description"><p> The memory address
+<td class="parameter_description"><p>The memory address
 of a pointer. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][not optional]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL must not be passed as the pointer to a location."><span class="acronym">not optional</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-set-weak-pointer"></a><h3>g_set_weak_pointer()</h3>
+<pre class="programlisting">#define             g_set_weak_pointer(weak_pointer_location, new_object)</pre>
+<p>Updates a pointer to weakly refer to <em class="parameter"><code>new_object</code></em>
+. It assigns <em class="parameter"><code>new_object</code></em>
+to <em class="parameter"><code>weak_pointer_location</code></em>
+ and ensures that <em class="parameter"><code>weak_pointer_location</code></em>
+ will
+automaticaly be set to <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>new_object</code></em>
+ gets destroyed. The assignment
+is not atomic. The weak reference is not thread-safe, see
+<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> for details.</p>
+<p><em class="parameter"><code>weak_pointer_location</code></em>
+ must not be <a href="../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-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-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-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-weak-pointer">g_set_weak_pointer</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="g-set-weak-pointer.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>weak_pointer_location</p></td>
+<td class="parameter_description"><p>the memory address of a pointer</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-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="g-set-weak-pointer.returns"></a><h4>Returns</h4>
+<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the value of <em class="parameter"><code>weak_pointer_location</code></em>
+changed, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
+</div>
+<p class="since">Since: 2.56</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-clear-weak-pointer"></a><h3>g_clear_weak_pointer()</h3>
+<pre class="programlisting">#define             g_clear_weak_pointer(weak_pointer_location)</pre>
+<p>Clears a weak reference to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.</p>
+<p><em class="parameter"><code>weak_pointer_location</code></em>
+ must not be <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
+<p>If the weak reference is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then this function does nothing.
+Otherwise, the weak reference to the object is removed for that location
+and the pointer is set to <a href="../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>
+<div class="refsect3">
+<a name="g-clear-weak-pointer.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>weak_pointer_location</p></td>
+<td class="parameter_description"><p>The memory address of a pointer</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<p class="since">Since: 2.56</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2396,14 +2528,14 @@ g_object_connect (<em class="parameter"><code><a href="../glib-Basic-Types.html#
 6
 7
 8</pre></td>
-        <td class="listing_code"><pre class="programlisting">menu<span class="gtkdoc opt">-&gt;</span>toplevel <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-connect">g_object_connect</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span> <span class="gtkdoc opt">(</span>GTK_TYPE_WINDOW<span class="gtkdoc opt">,</span>
-						   <span class="string">&quot;type&quot;</span><span class="gtkdoc opt">,</span> GTK_WINDOW_POPUP<span class="gtkdoc opt">,</span>
-						   <span class="string">&quot;child&quot;</span><span class="gtkdoc opt">,</span> menu<span class="gtkdoc opt">,</span>
-						   NULL<span class="gtkdoc opt">),</span>
-				     <span class="string">&quot;signal::event&quot;</span><span class="gtkdoc opt">,</span> gtk_menu_window_event<span class="gtkdoc opt">,</span> menu<span class="gtkdoc opt">,</span>
-				     <span class="string">&quot;signal::size_request&quot;</span><span class="gtkdoc opt">,</span> gtk_menu_window_size_request<span class="gtkdoc opt">,</span> menu<span class="gtkdoc opt">,</span>
-				     <span class="string">&quot;signal::destroy&quot;</span><span class="gtkdoc opt">,</span> gtk_widget_destroyed<span class="gtkdoc opt">, &amp;</span>menu<span class="gtkdoc opt">-&gt;</span>toplevel<span class="gtkdoc opt">,</span>
-				     NULL<span class="gtkdoc opt">);</span></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">"child"</span><span class="symbol">,</span><span class="normal"> menu</span><span class="symbol">,</span>
+<span class="normal">                           <a href="../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>
+<span class="normal">                     </span><span class="string">"signal::size_request"</span><span class="symbol">,</span><span class="normal"> gtk_menu_window_size_request</span><span class="symbol">,</span><span class="normal"> menu</span><span class="symbol">,</span>
+<span class="normal">                     </span><span class="string">"signal::destroy"</span><span class="symbol">,</span><span class="normal"> gtk_widget_destroyed</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">menu</span><span class="symbol">-&gt;</span><span class="normal">toplevel</span><span class="symbol">,</span>
+<span class="normal">                     <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2422,7 +2554,7 @@ g_object_connect (<em class="parameter"><code><a href="../glib-Basic-Types.html#
 <tbody>
 <tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr>
 <tr>
@@ -2442,7 +2574,7 @@ spec/callback/data triples, followed by <a href="../glib-Standard-Macros.html#NU
 </div>
 <div class="refsect3">
 <a name="g-object-connect.returns"></a><h4>Returns</h4>
-<p> <em class="parameter"><code>object</code></em>
+<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>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></p>
 </div>
@@ -2471,7 +2603,7 @@ disconnects the signal named "signal_name".</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr>
 <tr>
@@ -2513,7 +2645,7 @@ reverse order) after all properties have been set. See
 <tbody>
 <tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr>
 <tr>
@@ -2568,12 +2700,12 @@ properties are passed in.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>names</p></td>
-<td class="parameter_description"><p> the names of each property to be set. </p></td>
+<td class="parameter_description"><p>the names of each property to be set. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>values</p></td>
-<td class="parameter_description"><p> the values of each property to be set. </p></td>
+<td class="parameter_description"><p>the values of each property to be set. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
 </tr>
 </tbody>
@@ -2612,20 +2744,20 @@ of three properties: an integer, a string and an object:</p>
 12
 13
 14</pre></td>
-        <td class="listing_code"><pre class="programlisting">gint intval<span class="gtkdoc opt">;</span>
-gchar <span class="gtkdoc opt">*</span>strval<span class="gtkdoc opt">;</span>
-GObject <span class="gtkdoc opt">*</span>objval<span class="gtkdoc opt">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">gint</span><span class="normal"> intval</span><span class="symbol">;</span>
+<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">strval</span><span class="symbol">;</span>
+<span class="usertype">GObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">objval</span><span class="symbol">;</span>
-<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-get">g_object_get</a></span> <span class="gtkdoc opt">(</span>my_object<span class="gtkdoc opt">,</span>
-              <span class="string">&quot;int-property&quot;</span><span class="gtkdoc opt">, &amp;</span>intval<span class="gtkdoc opt">,</span>
-              <span class="string">&quot;str-property&quot;</span><span class="gtkdoc opt">, &amp;</span>strval<span class="gtkdoc opt">,</span>
-              <span class="string">&quot;obj-property&quot;</span><span class="gtkdoc opt">, &amp;</span>objval<span class="gtkdoc opt">,</span>
-              NULL<span class="gtkdoc opt">);</span>
+<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-get">g_object_get</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_object</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="string">"int-property"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">intval</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="string">"str-property"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">strval</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="string">"obj-property"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">objval</span><span class="symbol">,</span>
+<span class="normal">              <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-<span class="gtkdoc slc">// Do something with intval, strval, objval</span>
+<span class="comment">// Do something with intval, strval, objval</span>
-<span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>strval<span class="gtkdoc opt">);</span>
-<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span>objval<span class="gtkdoc opt">);</span></pre></td>
+<span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">strval</span><span class="symbol">);</span>
+<span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">objval</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2644,7 +2776,7 @@ GObject <span class="gtkdoc opt">*</span>objval<span class="gtkdoc opt">;</span>
 <tbody>
 <tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
 </tr>
 <tr>
@@ -2698,12 +2830,12 @@ properties are passed in.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>names</p></td>
-<td class="parameter_description"><p> the names of each property to get. </p></td>
+<td class="parameter_description"><p>the names of each property to get. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>values</p></td>
-<td class="parameter_description"><p> the values of each property to get. </p></td>
+<td class="parameter_description"><p>the values of each property to get. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
 </tr>
 </tbody>
@@ -2790,26 +2922,26 @@ instead, is to store the GParamSpec used with
 18
 19
 20</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">enum</span>
-<span class="gtkdoc opt">{</span>
-  PROP_0<span class="gtkdoc opt">,</span>
-  PROP_FOO<span class="gtkdoc opt">,</span>
-  PROP_LAST
-<span class="gtkdoc opt">};</span>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">enum</span>
+<span class="cbracket">{</span>
+<span class="normal">  PROP_0</span><span class="symbol">,</span>
+<span class="normal">  PROP_FOO</span><span class="symbol">,</span>
+<span class="normal">  PROP_LAST</span>
+<span class="cbracket">}</span><span class="symbol">;</span>
-<span class="gtkdoc kwb">static</span> GParamSpec <span class="gtkdoc opt">*</span>properties<span class="gtkdoc opt">[</span>PROP_LAST<span class="gtkdoc opt">];</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="usertype">GParamSpec</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">properties</span><span class="symbol">[</span><span class="normal">PROP_LAST</span><span class="symbol">];</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">my_object_class_init</span> <span class="gtkdoc opt">(</span>MyObjectClass <span class="gtkdoc opt">*</span>klass<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  properties<span class="gtkdoc opt">[</span>PROP_FOO<span class="gtkdoc opt">] =</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="gtkdoc opt">(</span><span class="string">&quot;foo&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;Foo&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;The foo&quot;</span><span class="gtkdoc opt">,</span>
-                                           <span class="number">0</span><span class="gtkdoc opt">,</span> <span class="number">100</span><span class="gtkdoc opt">,</span>
-                                           <span class="number">50</span><span class="gtkdoc opt">,</span>
-                                           G_PARAM_READWRITE<span class="gtkdoc opt">);</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="gtkdoc opt">(</span>gobject_class<span class="gtkdoc opt">,</span>
-                                   PROP_FOO<span class="gtkdoc opt">,</span>
-                                   properties<span class="gtkdoc opt">[</span>PROP_FOO<span class="gtkdoc opt">]);</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">my_object_class_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObjectClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">klass</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<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">                                           <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>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2822,7 +2954,7 @@ instead, is to store the GParamSpec used with
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec">g_object_notify_by_pspec</a></span> <span class="gtkdoc opt">(</span>self<span class="gtkdoc opt">,</span> properties<span class="gtkdoc opt">[</span>PROP_FOO<span class="gtkdoc opt">]);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-notify-by-pspec">g_object_notify_by_pspec</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">,</span><span class="normal"> properties</span><span class="symbol">[</span><span class="normal">PROP_FOO</span><span class="symbol">]);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2945,8 +3077,9 @@ g_object_get_data (<em class="parameter"><code><a class="link" href="gobject-The
 </div>
 <div class="refsect3">
 <a name="g-object-get-data.returns"></a><h4>Returns</h4>
-<p> the data if found, or <a href="../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>
+<p>the data if found,
+or <a href="../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>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2981,8 +3114,8 @@ the old association will be destroyed.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>data</p></td>
-<td class="parameter_description"><p>data to associate with that key</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p>data to associate with that key. </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>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -3024,13 +3157,13 @@ to a different value or when the object is destroyed.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>data</p></td>
-<td class="parameter_description"><p>data to associate with that key</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p>data to associate with that key. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>destroy</p></td>
-<td class="parameter_description"><p>function to call when the association is destroyed</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p>function to call when the association is destroyed. </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>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -3068,8 +3201,9 @@ without invoking the association's destroy handler.</p>
 </div>
 <div class="refsect3">
 <a name="g-object-steal-data.returns"></a><h4>Returns</h4>
-<p> the data if found, or <a href="../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>
+<p>the data if found, or <a href="../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>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -3096,6 +3230,7 @@ is locked.</p>
 <p>This function can be useful to avoid races when multiple
 threads are using object data on the same key on the same
 object.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
 <a name="g-object-dup-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -3117,12 +3252,12 @@ object.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>dup_func</p></td>
-<td class="parameter_description"><p> function to dup the value. </p></td>
+<td class="parameter_description"><p>function to dup the value. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
-<td class="parameter_description"><p> passed as user_data to <em class="parameter"><code>dup_func</code></em>
+<td class="parameter_description"><p>passed as user_data to <em class="parameter"><code>dup_func</code></em>
 . </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>]</span></td>
 </tr>
@@ -3167,10 +3302,11 @@ old value (<em class="parameter"><code>oldval</code></em>
 ) is passed to the caller, including
 the registered destroy notify for it (passed out in <em class="parameter"><code>old_destroy</code></em>
 ).
-Its up to the caller to free this as he wishes, which may
+It’s up to the caller to free this as needed, which may
 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>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
 <a name="g-object-replace-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -3192,23 +3328,23 @@ should not destroy the object in the normal way.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>oldval</p></td>
-<td class="parameter_description"><p> the old value to compare against. </p></td>
+<td class="parameter_description"><p>the old value to compare against. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>newval</p></td>
-<td class="parameter_description"><p> the new value. </p></td>
+<td class="parameter_description"><p>the new value. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>destroy</p></td>
-<td class="parameter_description"><p> a destroy notify for the new value. </p></td>
+<td class="parameter_description"><p>a destroy notify for the new value. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>old_destroy</p></td>
-<td class="parameter_description"><p> destroy notify for the existing value. </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>]</span></td>
+<td class="parameter_description"><p>destroy notify for the existing value. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -3254,8 +3390,8 @@ g_object_get_qdata (<em class="parameter"><code><a class="link" href="gobject-Th
 </div>
 <div class="refsect3">
 <a name="g-object-get-qdata.returns"></a><h4>Returns</h4>
-<p> The user data pointer set, or <a href="../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>
+<p>The user data pointer set, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -3297,8 +3433,8 @@ removes the data stored.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>data</p></td>
-<td class="parameter_description"><p>An opaque user data pointer</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p>An opaque user data 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>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -3342,15 +3478,15 @@ with the same <em class="parameter"><code>quark</code></em>
 </tr>
 <tr>
 <td class="parameter_name"><p>data</p></td>
-<td class="parameter_description"><p>An opaque user data pointer</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p>An opaque user data 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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>destroy</p></td>
 <td class="parameter_description"><p>Function to invoke with <em class="parameter"><code>data</code></em>
 as argument, when <em class="parameter"><code>data</code></em>
-needs to be freed</p></td>
-<td class="parameter_annotations"> </td>
+needs to be freed. </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>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -3396,29 +3532,29 @@ user data pointers with a destroy notifier, for example:</p>
 21
 22
 23</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>
-<span class="function">object_add_to_user_list</span> <span class="gtkdoc opt">(</span>GObject     <span class="gtkdoc opt">*</span>object<span class="gtkdoc opt">,</span>
-                         <span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>new_string<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="gtkdoc slc">// the quark, naming the object data</span>
-  GQuark quark_string_list <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;my-string-list&quot;</span><span class="gtkdoc opt">);</span>
-  <span class="gtkdoc slc">// retrive the old string list</span>
-  GList <span class="gtkdoc opt">*</span>list <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-steal-qdata">g_object_steal_qdata</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">,</span> quark_string_list<span class="gtkdoc opt">);</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">void</span>
+<span class="function">object_add_to_user_list</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GObject</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">object</span><span class="symbol">,</span>
+<span class="normal">                         </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">new_string</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="comment">// the quark, naming the object data</span>
+<span class="normal">  </span><span class="usertype">GQuark</span><span class="normal"> quark_string_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"my-string-list"</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="comment">// retrive the old string list</span>
+<span class="normal">  </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-steal-qdata">g_object_steal_qdata</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">,</span><span class="normal"> quark_string_list</span><span class="symbol">);</span>
-  <span class="gtkdoc slc">// prepend new string</span>
-  list <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">,</span> <span class="function"><a href="../glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> <span class="gtkdoc opt">(</span>new_string<span class="gtkdoc opt">));</span>
-  <span class="gtkdoc slc">// this changed &apos;list&apos;, so we need to set it again</span>
-  <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-set-qdata-full">g_object_set_qdata_full</a></span> <span class="gtkdoc opt">(</span>object<span class="gtkdoc opt">,</span> quark_string_list<span class="gtkdoc opt">,</span> list<span class="gtkdoc opt">,</span> free_string_list<span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">free_string_list</span> <span class="gtkdoc opt">(</span>gpointer data<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  GList <span class="gtkdoc opt">*</span>node<span class="gtkdoc opt">, *</span>list <span class="gtkdoc opt">=</span> data<span class="gtkdoc opt">;</span>
+<span class="normal">  </span><span class="comment">// prepend new string</span>
+<span class="normal">  list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="../glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">new_string</span><span class="symbol">));</span>
+<span class="normal">  </span><span class="comment">// this changed 'list', so we need to set it again</span>
+<span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-set-qdata-full">g_object_set_qdata_full</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">,</span><span class="normal"> quark_string_list</span><span class="symbol">,</span><span class="normal"> list</span><span class="symbol">,</span><span class="normal"> free_string_list</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">free_string_list</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">node</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">list </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
-  <span class="keyword">for</span> <span class="gtkdoc opt">(</span>node <span class="gtkdoc opt">=</span> list<span class="gtkdoc opt">;</span> node<span class="gtkdoc opt">;</span> node <span class="gtkdoc opt">=</span> node<span class="gtkdoc opt">-&gt;</span>next<span class="gtkdoc opt">)</span>
-    <span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>node<span class="gtkdoc opt">-&gt;</span>data<span class="gtkdoc opt">);</span>
-  <span class="function"><a href="../glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<span class="normal">  </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">node </span><span class="symbol">=</span><span class="normal"> list</span><span class="symbol">;</span><span class="normal"> node</span><span class="symbol">;</span><span class="normal"> node </span><span class="symbol">=</span><span class="normal"> node</span><span class="symbol">-&gt;</span><span class="normal">next</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="function"><a href="../glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">node</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="../glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -3453,8 +3589,8 @@ and thus the partial string list would have been freed upon
 </div>
 <div class="refsect3">
 <a name="g-object-steal-qdata.returns"></a><h4>Returns</h4>
-<p> The user data pointer set, or <a href="../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>
+<p>The user data pointer set, or <a href="../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>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -3481,6 +3617,7 @@ is locked.</p>
 <p>This function can be useful to avoid races when multiple
 threads are using object data on the same key on the same
 object.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
 <a name="g-object-dup-qdata.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -3502,12 +3639,12 @@ object.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>dup_func</p></td>
-<td class="parameter_description"><p> function to dup the value. </p></td>
+<td class="parameter_description"><p>function to dup the value. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
-<td class="parameter_description"><p> passed as user_data to <em class="parameter"><code>dup_func</code></em>
+<td class="parameter_description"><p>passed as user_data to <em class="parameter"><code>dup_func</code></em>
 . </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>]</span></td>
 </tr>
@@ -3552,10 +3689,11 @@ old value (<em class="parameter"><code>oldval</code></em>
 ) is passed to the caller, including
 the registered destroy notify for it (passed out in <em class="parameter"><code>old_destroy</code></em>
 ).
-Its up to the caller to free this as he wishes, which may
+It’s up to the caller to free this as needed, which may
 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>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
 <a name="g-object-replace-qdata.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -3577,23 +3715,23 @@ should not destroy the object in the normal way.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>oldval</p></td>
-<td class="parameter_description"><p> the old value to compare against. </p></td>
+<td class="parameter_description"><p>the old value to compare against. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>newval</p></td>
-<td class="parameter_description"><p> the new value. </p></td>
+<td class="parameter_description"><p>the new value. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>destroy</p></td>
-<td class="parameter_description"><p> a destroy notify for the new value. </p></td>
+<td class="parameter_description"><p>a destroy notify for the new value. </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>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>old_destroy</p></td>
-<td class="parameter_description"><p> destroy notify for the existing value. </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>]</span></td>
+<td class="parameter_description"><p>destroy notify for the existing value. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -3940,13 +4078,13 @@ properly initialised.  Just use <a class="link" href="gobject-The-Base-Object-Ty
 <tbody>
 <tr>
 <td class="parameter_name"><p>weak_ref</p></td>
-<td class="parameter_description"><p> uninitialized or empty location for a weak
+<td class="parameter_description"><p>uninitialized or empty location for a weak
 reference. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -3974,7 +4112,7 @@ After this call, the <a class="link" href="gobject-The-Base-Object-Type.html#GWe
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>weak_ref</p></td>
-<td class="parameter_description"><p> location of a weak reference, which
+<td class="parameter_description"><p>location of a weak reference, which
 may be empty. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
 </tr></tbody>
@@ -4006,14 +4144,14 @@ by using <a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref"
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>weak_ref</p></td>
-<td class="parameter_description"><p> location of a weak reference to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
+<td class="parameter_description"><p>location of a weak reference to a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
 </div>
 <div class="refsect3">
 <a name="g-weak-ref-get.returns"></a><h4>Returns</h4>
-<p> the object pointed to
+<p>the object pointed to
 by <em class="parameter"><code>weak_ref</code></em>
 , or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it was empty. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></p>
@@ -4049,7 +4187,7 @@ function.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>object</p></td>
-<td class="parameter_description"><p> a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -4100,28 +4238,60 @@ to the <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span cl
 };
 </pre>
 <p>The class structure for the GObject type.</p>
-<p>&lt;example&gt;
-&lt;title&gt;Implementing singletons using a constructor&lt;/title&gt;
-&lt;programlisting&gt;
-static MySingleton *the_singleton = NULL;</p>
-<p>static GObject*
-my_singleton_constructor (GType                  type,
-                          guint                  n_construct_params,
-                          GObjectConstructParam *construct_params)
-{
-  GObject *object;</p>
-<p>  if (!the_singleton)
-    {
-      object = G_OBJECT_CLASS (parent_class)-&gt;constructor (type,
-                                                           n_construct_params,
-                                                           construct_params);
-      the_singleton = MY_SINGLETON (object);
-    }
-  else
-    object = g_object_ref (G_OBJECT (the_singleton));</p>
-<p>  return object;
-}
-&lt;/programlisting&gt;&lt;/example&gt;</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">// Example of implementing a singleton using a constructor.</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="usertype">MySingleton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">the_singleton </span><span class="symbol">=</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="keyword">static</span><span class="normal"> <a href="gobject-The-Base-Object-Type.html#GObject-struct">GObject</a></span><span class="symbol">*</span>
+<span class="function">my_singleton_constructor</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GType</span><span class="normal">                  type</span><span class="symbol">,</span>
+<span class="normal">                          </span><span class="usertype">guint</span><span class="normal">                  n_construct_params</span><span class="symbol">,</span>
+<span class="normal">                          </span><span class="usertype">GObjectConstructParam</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">construct_params</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">object</span><span class="symbol">;</span>
+<span class="normal">  </span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">the_singleton</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      object </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">parent_class</span><span class="symbol">)-&gt;</span><span class="function">constructor</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">type</span><span class="symbol">,</span>
+<span class="normal">                                                           n_construct_params</span><span class="symbol">,</span>
+<span class="normal">                                                           construct_params</span><span class="symbol">);</span>
+<span class="normal">      the_singleton </span><span class="symbol">=</span><span class="normal"> </span><span class="function">MY_SINGLETON</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="keyword">else</span>
+<span class="normal">    object </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">the_singleton</span><span class="symbol">));</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> object</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
 <div class="refsect3">
 <a name="GObjectClass.members"></a><h4>Members</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -4360,9 +4530,9 @@ single property, by specifying the property name as a detail in the
         <td class="listing_lines" align="right"><pre>1
 2
 3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-connect">g_signal_connect</a></span> <span class="gtkdoc opt">(</span>text_view<span class="gtkdoc opt">-&gt;</span>buffer<span class="gtkdoc opt">,</span> <span class="string">&quot;notify::paste-target-list&quot;</span><span class="gtkdoc opt">,</span>
-                  <span class="function"><a href="gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span> <span class="gtkdoc opt">(</span>gtk_text_view_target_list_notify<span class="gtkdoc opt">),</span>
-                  text_view<span class="gtkdoc opt">)</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text_view</span><span class="symbol">-&gt;</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"notify::paste-target-list"</span><span class="symbol">,</span>
+<span class="normal">                  </span><span class="function"><a href="gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gtk_text_view_target_list_notify</span><span class="symbol">),</span>
+<span class="normal">                  text_view</span><span class="symbol">)</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -4408,6 +4578,6 @@ detail strings for the notify signal.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>