RubyGems - glib2 - Versions diffs - 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32 - Mend

glib2 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

Files changed (1058) hide show

data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Value arrays: GObject Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
 <link rel="prev" href="gobject-Closures.html" title="Closures">
 <link rel="next" href="GBinding.html" title="GBinding">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -34,7 +34,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="gobject-Value-arrays.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
@@ -125,7 +125,7 @@
 </div>
 <div class="refsect1">
 <a name="gobject-Value-arrays.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
@@ -157,7 +157,7 @@ for instance, the following code:</p>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GValueArray</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">array </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Value-arrays.html#g-value-array-new">g_value_array_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">10</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">GValueArray <span class="gtkdoc opt">*</span>array <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Value-arrays.html#g-value-array-new">g_value_array_new</a></span> <span class="gtkdoc opt">(</span><span class="number">10</span><span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -171,8 +171,8 @@ for instance, the following code:</p>
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GArray</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">array </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Arrays.html#g-array-sized-new">g_array_sized_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gobject-Generic-values.html#GValue">GValue</a></span><span class="symbol">),</span><span class="normal"> </span><span class="number">10</span><span class="symbol">);</span>
-<span class="function"><a href="../glib/glib-Arrays.html#g-array-set-clear-func">g_array_set_clear_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> <a href="gobject-Generic-values.html#g-value-unset">g_value_unset</a></span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">GArray <span class="gtkdoc opt">*</span>array <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Arrays.html#g-array-sized-new">g_array_sized_new</a></span> <span class="gtkdoc opt">(</span>FALSE<span class="gtkdoc opt">,</span> TRUE<span class="gtkdoc opt">,</span> <span class="keyword">sizeof</span> <span class="gtkdoc opt">(</span>GValue<span class="gtkdoc opt">),</span> <span class="number">10</span><span class="gtkdoc opt">);</span>
+<span class="function"><a href="../glib/glib-Arrays.html#g-array-set-clear-func">g_array_set_clear_func</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> g_value_unset<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -196,7 +196,7 @@ g_value_array_get_nth (<em class="parameter"><code><a class="link" href="gobject
 .</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.2.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -240,7 +240,7 @@ regardless of the value of <em class="parameter"><code>n_prealloced</code></em>
 .</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.3.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -256,7 +256,6 @@ regardless of the value of <em class="parameter"><code>n_prealloced</code></em>
 <div class="refsect3">
 <a name="id-1.4.14.7.3.7"></a><h4>Returns</h4>
 <p> a newly allocated <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> with 0 values</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -272,7 +271,7 @@ g_value_array_copy (<em class="parameter"><code>const <a class="link" href="gobj
 contents.</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.4.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -303,7 +302,7 @@ g_value_array_free (<em class="parameter"><code><a class="link" href="gobject-Va
 <p>Free a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> including its contents.</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.5.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -334,7 +333,7 @@ g_value_array_append (<em class="parameter"><code><a class="link" href="gobject-
 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is appended.</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.6.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -378,7 +377,7 @@ g_value_array_prepend (<em class="parameter"><code><a class="link" href="gobject
 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is prepended.</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.7.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -423,7 +422,7 @@ g_value_array_insert (<em class="parameter"><code><a class="link" href="gobject-
 is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is inserted.</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.8.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -470,7 +469,7 @@ g_value_array_remove (<em class="parameter"><code><a class="link" href="gobject-
 .</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.9.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -517,7 +516,7 @@ the semantics of <a href="../glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><s
 C <code class="function">qsort()</code> function.</p>
 <div class="refsect3">
 <a name="id-1.4.14.7.10.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -561,9 +560,10 @@ g_value_array_sort_with_data (<em class="parameter"><code><a class="link" href="
 to the semantics of <a href="../glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a>.</p>
 <p>The current implementation uses the same sorting algorithm as standard
 C <code class="function">qsort()</code> function.</p>
+<p><span class="annotation">[<acronym title="Rename the original symbol's name to SYMBOL."><span class="acronym">rename-to</span></acronym> g_value_array_sort]</span></p>
 <div class="refsect3">
-<a name="id-1.4.14.7.11.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.14.7.11.8"></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">
@@ -590,7 +590,7 @@ C <code class="function">qsort()</code> function.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.14.7.11.8"></a><h4>Returns</h4>
+<a name="id-1.4.14.7.11.9"></a><h4>Returns</h4>
 <p> the <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> passed in as <em class="parameter"><code>value_array</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>
@@ -609,7 +609,7 @@ C <code class="function">qsort()</code> function.</p>
 <p>A <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> contains an array of <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> elements.</p>
 <div class="refsect3">
 <a name="id-1.4.14.8.2.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -637,7 +637,6 @@ C <code class="function">qsort()</code> function.</p>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Varargs Value Collection: GObject Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
 <link rel="prev" href="gobject-GParamSpec.html" title="GParamSpec">
 <link rel="next" href="gobject-Signals.html" title="Signals">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -33,7 +33,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="gobject-Varargs-Value-Collection.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
@@ -68,7 +68,7 @@
 </div>
 <div class="refsect1">
 <a name="gobject-Varargs-Value-Collection.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
@@ -108,7 +108,7 @@ implement the varargs collection as a macro, because on some systems
 va_list variables cannot be passed by reference.</p>
 <div class="refsect3">
 <a name="id-1.4.11.7.2.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -148,7 +148,7 @@ allocated error messages if something fails</p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -163,7 +163,7 @@ you should use the <a class="link" href="gobject-Varargs-Value-Collection.html#G
 <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>. That variant is faster than <a class="link" href="gobject-Varargs-Value-Collection.html#G-VALUE-COLLECT:CAPS" title="G_VALUE_COLLECT()"><span class="type">G_VALUE_COLLECT</span></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.11.7.3.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -208,7 +208,7 @@ allocated error messages if something fails</p></td>
 .</p>
 <div class="refsect3">
 <a name="id-1.4.11.7.4.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -237,7 +237,7 @@ allocated error messages if something fails</p></td>
 analogous to <a class="link" href="gobject-Varargs-Value-Collection.html#G-VALUE-COLLECT:CAPS" title="G_VALUE_COLLECT()"><code class="function">G_VALUE_COLLECT()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.11.7.5.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -281,7 +281,7 @@ allocated error messages if something fails</p></td>
 <p>A union holding one collected value.</p>
 <div class="refsect3">
 <a name="id-1.4.11.8.2.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="union_members_name">
 <col class="union_members_description">
@@ -328,7 +328,6 @@ single <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Object memory management: GObject Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="chapter-gobject.html" title="The GObject base class">
 <link rel="prev" href="chapter-gobject.html" title="The GObject base class">
 <link rel="next" href="gobject-properties.html" title="Object properties">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -28,77 +28,20 @@
       which can be integrated in applications which use or require different memory management
       models (such as garbage collection). The methods which are used to
       manipulate this reference count are described below.
-</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
-23
-24
-25
-26</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span>
-<span class="comment">  Refcounting</span>
-<span class="comment">*/</span>
-<span class="usertype">gpointer</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="usertype">gpointer</span><span class="normal">        object</span><span class="symbol">);</span>
-<span class="type">void</span><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="usertype">gpointer</span><span class="normal">        object</span><span class="symbol">);</span>
-<span class="comment">/*</span>
-<span class="comment"> * Weak References</span>
-<span class="comment"> */</span>
-<span class="keyword">typedef</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal"><a href="gobject-The-Base-Object-Type.html#GWeakNotify">GWeakNotify</a></span><span class="symbol">)</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="normal">                             </span><span class="usertype">GObject</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">where_the_object_was</span><span class="symbol">);</span>
-<span class="type">void</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-weak-ref">g_object_weak_ref</a></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="usertype">GWeakNotify</span><span class="normal">  notify</span><span class="symbol">,</span>
-<span class="normal">                                   </span><span class="usertype">gpointer</span><span class="normal">     data</span><span class="symbol">);</span>
-<span class="type">void</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-weak-unref">g_object_weak_unref</a></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="usertype">GWeakNotify</span><span class="normal">  notify</span><span class="symbol">,</span>
-<span class="normal">                                   </span><span class="usertype">gpointer</span><span class="normal">     data</span><span class="symbol">);</span>
-<span class="type">void</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-add-weak-pointer">g_object_add_weak_pointer</a></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="normal">                                   </span><span class="usertype">gpointer</span><span class="normal">    </span><span class="symbol">*</span><span class="normal">weak_pointer_location</span><span class="symbol">);</span>
-<span class="type">void</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-remove-weak-pointer">g_object_remove_weak_pointer</a></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="normal">                                   </span><span class="usertype">gpointer</span><span class="normal">    </span><span class="symbol">*</span><span class="normal">weak_pointer_location</span><span class="symbol">);</span>
-<span class="comment">/*</span>
-<span class="comment"> * Cycle handling</span>
-<span class="comment"> */</span>
-<span class="type">void</span><span class="normal"> </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-run-dispose">g_object_run_dispose</a></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></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
     </p>
 <div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="gobject-memory-refcount"></a>Reference count</h3></div></div></div>
 <p>
         The functions <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-ref" title="g_object_ref ()">g_object_ref</a></code>/<code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()">g_object_unref</a></code> respectively
-        increase and decrease the reference count.These functions are thread-safe as of GLib 2.8.
-        The reference count is, unsurprisingly, initialized to one by
+        increase and decrease the reference count. These functions are
+        thread-safe.
+        <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-clear-object" title="g_clear_object ()">g_clear_object</a></code>
+        is a convenience wrapper around <code class="function">g_object_unref</code>
+        which also clears the pointer passed to it.
+      </p>
+<p>
+        The reference count is initialized to one by
         <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-new" title="g_object_new ()">g_object_new</a></code> which means that the caller
         is currently the sole owner of the newly-created reference.
         When the reference count reaches zero, that is,
@@ -121,7 +64,7 @@
         </p>
 <div class="table">
 <a name="gobject-destruction-table"></a><p class="title"><b>Table 5. <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()">g_object_unref</a></code></b></p>
-<div class="table-contents"><table summary="g_object_unref" border="1">
+<div class="table-contents"><table class="table" summary="g_object_unref" border="1">
 <colgroup>
 <col align="left">
 <col align="left">
@@ -129,7 +72,7 @@
 </colgroup>
 <thead><tr>
 <th align="left">Invocation time</th>
-<th align="left">Function Invoked</th>
+<th align="left">Function invoked</th>
 <th align="left">Function's parameters</th>
 <th>Remark</th>
 </tr></thead>
@@ -166,24 +109,24 @@
 <td rowspan="4" align="left">Last call to <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-unref" title="g_object_unref ()">g_object_unref</a></code> for the last
                   instance of target type
                  </td>
-<td align="left">interface' interface_finalize function</td>
-<td align="left">On interface' vtable</td>
+<td align="left">interface's <code class="function">interface_finalize</code> function</td>
+<td align="left">On interface's vtable</td>
 <td>Never used in practice. Unlikely you will need it.</td>
 </tr>
 <tr>
-<td align="left">interface' base_finalize function</td>
-<td align="left">On interface' vtable</td>
+<td align="left">interface's <code class="function">base_finalize</code> function</td>
+<td align="left">On interface's vtable</td>
 <td>Never used in practice. Unlikely you will need it.</td>
 </tr>
 <tr>
-<td align="left">target type's class_finalize function</td>
+<td align="left">target type's <code class="function">class_finalize</code> function</td>
 <td align="left">On target type's class structure</td>
 <td>Never used in practice. Unlikely you will need it.</td>
 </tr>
 <tr>
-<td align="left">type's base_finalize function</td>
+<td align="left">type's <code class="function">base_finalize</code> function</td>
 <td align="left">On the inheritance tree of classes from fundamental type to target type.
-                  base_init is invoked once for each class structure.</td>
+                  <code class="function">base_init</code> is invoked once for each class structure.</td>
 <td>Never used in practice. Unlikely you will need it.</td>
 </tr>
 </tbody>
@@ -196,7 +139,7 @@
 <div class="titlepage"><div><div><h3 class="title">
 <a name="gobject-memory-weakref"></a>Weak References</h3></div></div></div>
 <p>
-      Weak References are used to monitor object finalization:
+      Weak references are used to monitor object finalization:
       <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-weak-ref" title="g_object_weak_ref ()">g_object_weak_ref</a></code> adds a monitoring callback which does
       not hold a reference to the object but which is invoked when the object runs
       its dispose method. As such, each weak ref can be invoked more than once upon
@@ -208,26 +151,26 @@
         callback from the object.
       </p>
 <p>
-        Weak References are also used to implement <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-weak-pointer" title="g_object_add_weak_pointer ()">g_object_add_weak_pointer</a></code>
+        Weak references are also used to implement <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-add-weak-pointer" title="g_object_add_weak_pointer ()">g_object_add_weak_pointer</a></code>
         and <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-remove-weak-pointer" title="g_object_remove_weak_pointer ()">g_object_remove_weak_pointer</a></code>. These functions add a weak reference
         to the object they are applied to which makes sure to nullify the pointer given by the user
         when object is finalized.
       </p>
+<p>
+        Similarly, <a class="link" href="gobject-The-Base-Object-Type.html#GWeakRef" title="GWeakRef"><span class="type">GWeakRef</span></a> can be
+        used to implement weak references if thread safety is required.
+      </p>
 </div>
 <div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="gobject-memory-cycles"></a>Reference counts and cycles</h3></div></div></div>
-<p>
-        Note: the following section was inspired by James Henstridge. I guess this means that
-        all praise and all curses will be directly forwarded to him.
-      </p>
 <p>
         GObject's memory management model was designed to be easily integrated in existing code
         using garbage collection. This is why the destruction process is split in two phases:
         the first phase, executed in the dispose handler is supposed to release all references
         to other member objects. The second phase, executed by the finalize handler is supposed
         to complete the object's destruction process. Object methods should be able to run
-        without program error (that is, without segfault :) in-between the two phases.
+        without program error in-between the two phases.
       </p>
 <p>
         This two-step destruction process is very useful to break reference counting cycles.
@@ -237,8 +180,8 @@
         to the object and thus release all references to other objects.
       </p>
 <p>
-        Attentive readers might now have understood one of the rules about the dispose handler
-        we stated a bit sooner: the dispose handler can be invoked multiple times. Let's say we
+        This explains one of the rules about the dispose handler stated earlier:
+        the dispose handler can be invoked multiple times. Let's say we
         have a reference count cycle: object A references B which itself references object A.
         Let's say we have detected the cycle and we want to destroy the two objects. One way to
         do this would be to invoke <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-run-dispose" title="g_object_run_dispose ()">g_object_run_dispose</a></code> on one of the
@@ -253,15 +196,13 @@
         A's finalize handler is invoked !
       </p>
 <p>
-        The above example, which might seem a bit contrived can really happen if your
-        GObject's are being handled by language bindings. I would thus suggest the rules stated above
-        for object destruction are closely followed. Otherwise, <span class="emphasis"><em>Bad Bad Things</em></span>
-        will happen.
+        The above example, which might seem a bit contrived, can really happen if
+        GObjects are being handled by language bindings — hence the rules for
+        object destruction should be closely followed.
       </p>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>