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

glib2 3.2.1-x64-mingw32 → 3.2.2-x64-mingw32

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>