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/ch01s02.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Exporting a C API: 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-intro.html" title="Background">
 <link rel="prev" href="chapter-intro.html" title="Background">
 <link rel="next" href="chapter-gtype.html" title="The GLib Dynamic Type System">
-<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">
@@ -38,7 +38,7 @@
     </p>
 <p>
       For the sake of discussion, here is a sample C function and the associated 32 bit x86
-      assembly code generated by GCC on my Linux box:
+      assembly code generated by GCC on a Linux computer:
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -56,20 +56,26 @@
 10
 11
 12
-13</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span><span class="function">function_foo</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> foo</span><span class="symbol">)</span>
-<span class="cbracket">{}</span>
+13
+14
+15
+16</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
+<span class="function">function_foo</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">int</span> foo<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+<span class="gtkdoc opt">}</span>
-<span class="type">int</span><span class="normal"> </span><span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">argv</span><span class="symbol">[])</span>
-<span class="cbracket">{</span>
+<span class="gtkdoc kwb">int</span>
+<span class="function">main</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">int</span>   argc<span class="gtkdoc opt">,</span>
+      <span class="gtkdoc kwb">char</span> <span class="gtkdoc opt">*</span>argv<span class="gtkdoc opt">[])</span>
+<span class="gtkdoc opt">{</span>
+	<span class="function">function_foo</span> <span class="gtkdoc opt">(</span><span class="number">10</span><span class="gtkdoc opt">);</span>
-<span class="normal">        </span><span class="function">function_foo</span><span class="normal"> </span><span class="symbol">(</span><span class="number">10</span><span class="symbol">);</span>
+	<span class="keyword">return</span> <span class="number">0</span><span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">        </span><span class="keyword">return</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-<span class="cbracket">}</span>
-<span class="normal">push   $</span><span class="number">0xa</span>
-<span class="normal">call   </span><span class="number">0x80482f4</span><span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">function_foo</span><span class="symbol">&gt;</span></pre></td>
+push   $<span class="number">0xa</span>
+call   <span class="number">0x80482f4</span> <span class="gtkdoc opt">&lt;</span>function_foo<span class="gtkdoc opt">&gt;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -79,7 +85,7 @@
       The assembly code shown above is pretty straightforward: the first instruction pushes
       the hexadecimal value 0xa (decimal value 10) as a 32-bit integer on the stack and calls
       <code class="function">function_foo</code>. As you can see, C function calls are implemented by
-      gcc by native function calls (this is probably the fastest implementation possible).
+      GCC as native function calls (this is probably the fastest implementation possible).
     </p>
 <p>
       Now, let's say we want to call the C function <code class="function">function_foo</code> from
@@ -150,7 +156,6 @@
 </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/chapter-gobject.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>The GObject base class: 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="pt01.html" title="Part I. Concepts">
 <link rel="prev" href="gtype-non-instantiable-classed.html" title="Non-instantiable classed types: interfaces">
 <link rel="next" href="gobject-memory.html" title="Object memory management">
-<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">
@@ -77,29 +77,13 @@
      to explicitly set them.
     </p>
 <p>
-      Objects which inherit from GObject are allowed to override this
-      constructor class method: they should however chain to their parent
-      constructor method before doing so:
-</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</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="gobject-The-Base-Object-Type.html#GObject">GObject</a> </span><span class="symbol">*(*</span><span class="normal"> constructor</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GType</span><span class="normal">                  gtype</span><span class="symbol">,</span>
-<span class="normal">                          </span><span class="usertype">guint</span><span class="normal">                  n_properties</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">properties</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
+      Once all construction operations have been completed and constructor
+      properties set, the constructed class method is called.
     </p>
 <p>
-      The example below shows how <span class="type">MamanBar</span> overrides the parent's constructor:
+      Objects which inherit from GObject are allowed to override this
+      constructed class method.
+      The example below shows how <span class="type">ViewerFile</span> overrides the parent's construction process:
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -140,99 +124,57 @@
 33
 34
 35
-36
-37
-38
-39
-40
-41
-42
-43
-44
-45
-46
-47
-48
-49
-50
-51
-52
-53
-54
-55
-56
-57</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="function">MAMAN_TYPE_BAR</span><span class="normal">                  </span><span class="symbol">(</span><span class="function">maman_bar_get_type</span><span class="normal"> </span><span class="symbol">())</span>
-<span class="preproc">#define</span><span class="normal"> </span><span class="function">MAMAN_BAR</span><span class="symbol">(</span><span class="normal">obj</span><span class="symbol">)</span><span class="normal">                  </span><span class="symbol">(</span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-CHECK-INSTANCE-CAST:CAPS">G_TYPE_CHECK_INSTANCE_CAST</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">obj</span><span class="symbol">),</span><span class="normal"> MAMAN_TYPE_BAR</span><span class="symbol">,</span><span class="normal"> MamanBar</span><span class="symbol">))</span>
-<span class="preproc">#define</span><span class="normal"> </span><span class="function">MAMAN_IS_BAR</span><span class="symbol">(</span><span class="normal">obj</span><span class="symbol">)</span><span class="normal">               </span><span class="symbol">(</span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-CHECK-INSTANCE-TYPE:CAPS">G_TYPE_CHECK_INSTANCE_TYPE</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">obj</span><span class="symbol">),</span><span class="normal"> MAMAN_TYPE_BAR</span><span class="symbol">))</span>
-<span class="preproc">#define</span><span class="normal"> </span><span class="function">MAMAN_BAR_CLASS</span><span class="symbol">(</span><span class="normal">klass</span><span class="symbol">)</span><span class="normal">          </span><span class="symbol">(</span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-CHECK-CLASS-CAST:CAPS">G_TYPE_CHECK_CLASS_CAST</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">klass</span><span class="symbol">),</span><span class="normal"> MAMAN_TYPE_BAR</span><span class="symbol">,</span><span class="normal"> MamanBarClass</span><span class="symbol">))</span>
-<span class="preproc">#define</span><span class="normal"> </span><span class="function">MAMAN_IS_BAR_CLASS</span><span class="symbol">(</span><span class="normal">klass</span><span class="symbol">)</span><span class="normal">       </span><span class="symbol">(</span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-CHECK-CLASS-TYPE:CAPS">G_TYPE_CHECK_CLASS_TYPE</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">klass</span><span class="symbol">),</span><span class="normal"> MAMAN_TYPE_BAR</span><span class="symbol">))</span>
-<span class="preproc">#define</span><span class="normal"> </span><span class="function">MAMAN_BAR_GET_CLASS</span><span class="symbol">(</span><span class="normal">obj</span><span class="symbol">)</span><span class="normal">        </span><span class="symbol">(</span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-INSTANCE-GET-CLASS:CAPS">G_TYPE_INSTANCE_GET_CLASS</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">obj</span><span class="symbol">),</span><span class="normal"> MAMAN_TYPE_BAR</span><span class="symbol">,</span><span class="normal"> MamanBarClass</span><span class="symbol">))</span>
-<span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="classname">_MamanBar</span><span class="normal">        MamanBar</span><span class="symbol">;</span>
-<span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="classname">_MamanBarClass</span><span class="normal">   MamanBarClass</span><span class="symbol">;</span>
-<span class="keyword">struct</span><span class="normal"> </span><span class="classname">_MamanBar</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GObject</span><span class="normal"> parent_instance</span><span class="symbol">;</span>
+36</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#define VIEWER_TYPE_FILE viewer_file_get_type ()</span>
+<span class="function"><a href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS">G_DECLARE_FINAL_TYPE</a></span> <span class="gtkdoc opt">(</span>ViewerFile<span class="gtkdoc opt">,</span> viewer_file<span class="gtkdoc opt">,</span> VIEWER<span class="gtkdoc opt">,</span> <span class="gtkdoc kwb">FILE</span><span class="gtkdoc opt">,</span> GObject<span class="gtkdoc opt">)</span>
-<span class="normal">  </span><span class="comment">/* instance members */</span>
-<span class="cbracket">}</span><span class="symbol">;</span>
+<span class="gtkdoc kwb">struct</span> _ViewerFile
+<span class="gtkdoc opt">{</span>
+  GObject parent_instance<span class="gtkdoc opt">;</span>
-<span class="keyword">struct</span><span class="normal"> </span><span class="classname">_MamanBarClass</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GObjectClass</span><span class="normal"> parent_class</span><span class="symbol">;</span>
+  <span class="comment">/* instance members */</span>
+<span class="gtkdoc opt">};</span>
-<span class="normal">  </span><span class="comment">/* class members */</span>
-<span class="cbracket">}</span><span class="symbol">;</span>
+<span class="comment">/* will create viewer_file_get_type and set viewer_file_parent_class */</span>
+<span class="function"><a href="gobject-Type-Information.html#G-DEFINE-TYPE:CAPS">G_DEFINE_TYPE</a></span> <span class="gtkdoc opt">(</span>ViewerFile<span class="gtkdoc opt">,</span> viewer_file<span class="gtkdoc opt">,</span> G_TYPE_OBJECT<span class="gtkdoc opt">)</span>
-<span class="comment">/* will create maman_bar_get_type and set maman_bar_parent_class */</span>
-<span class="function"><a href="gobject-Type-Information.html#G-DEFINE-TYPE:CAPS">G_DEFINE_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">MamanBar</span><span class="symbol">,</span><span class="normal"> maman_bar</span><span class="symbol">,</span><span class="normal"> <a href="gobject-Type-Information.html#G-TYPE-OBJECT:CAPS">G_TYPE_OBJECT</a></span><span class="symbol">);</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">viewer_file_constructed</span> <span class="gtkdoc opt">(</span>GObject <span class="gtkdoc opt">*</span>obj<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="comment">/* update the object state depending on constructor properties */</span>
-<span class="keyword">static</span><span class="normal"> <a href="gobject-The-Base-Object-Type.html#GObject">GObject</a> </span><span class="symbol">*</span>
-<span class="function">maman_bar_constructor</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GType</span><span class="normal">                  gtype</span><span class="symbol">,</span>
-<span class="normal">                       </span><span class="usertype">guint</span><span class="normal">                  n_properties</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">properties</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">obj</span><span class="symbol">;</span>
+  <span class="comment">/* Always chain up to the parent constructed function to complete object</span>
+<span class="comment">   * initialisation. */</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>viewer_file_parent_class<span class="gtkdoc opt">)-&gt;</span><span class="function">constructed</span> <span class="gtkdoc opt">(</span>obj<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span>
-<span class="normal">  </span><span class="cbracket">{</span>
-<span class="normal">    </span><span class="comment">/* Always chain up to the parent constructor */</span>
-<span class="normal">    obj </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">maman_bar_parent_class</span><span class="symbol">)-&gt;</span><span class="function">constructor</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gtype</span><span class="symbol">,</span><span class="normal"> n_properties</span><span class="symbol">,</span><span class="normal"> properties</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="cbracket">}</span>
-<span class="normal">  </span>
-<span class="normal">  </span><span class="comment">/* update the object state depending on constructor properties */</span>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">viewer_file_class_init</span> <span class="gtkdoc opt">(</span>ViewerFileClass <span class="gtkdoc opt">*</span>klass<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GObjectClass <span class="gtkdoc opt">*</span>object_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="normal">  </span><span class="keyword">return</span><span class="normal"> obj</span><span class="symbol">;</span>
-<span class="cbracket">}</span>
+  object_class<span class="gtkdoc opt">-&gt;</span>constructed <span class="gtkdoc opt">=</span> viewer_file_constructed<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span>
-<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
-<span class="function">maman_bar_class_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MamanBarClass</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>
-<span class="normal">  gobject_class</span><span class="symbol">-&gt;</span><span class="normal">constructor </span><span class="symbol">=</span><span class="normal"> maman_bar_constructor</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">maman_bar_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MamanBar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="comment">/* initialize the object */</span>
-<span class="cbracket">}</span></pre></td>
+<span class="gtkdoc kwb">static void</span>
+<span class="function">viewer_file_init</span> <span class="gtkdoc opt">(</span>ViewerFile <span class="gtkdoc opt">*</span>self<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="comment">/* initialize the object */</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
 <p>
-      If the user instantiates an object <span class="type">MamanBar</span> with:
+      If the user instantiates an object <span class="type">ViewerFile</span> with:
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">MamanBar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bar </span><span class="symbol">=</span><span class="normal"> </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">MAMAN_TYPE_BAR</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">ViewerFile <span class="gtkdoc opt">*</span>file <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>VIEWER_TYPE_FILE<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -240,36 +182,37 @@
 <p>
       If this is the first instantiation of such an object, the
-      <code class="function">maman_bar_class_init</code> function will be invoked
-      after any <code class="function">maman_bar_base_class_init</code> function.
+      <code class="function">viewer_file_class_init</code> function will be invoked
+      after any <code class="function">viewer_file_base_class_init</code> function.
       This will make sure the class structure of this new object is
-      correctly initialized. Here, <code class="function">maman_bar_class_init</code>
+      correctly initialized. Here, <code class="function">viewer_file_class_init</code>
       is expected to override the object's class methods and setup the
       class' own methods. In the example above, the constructor method is
       the only overridden method: it is set to
-      <code class="function">maman_bar_constructor</code>.
+      <code class="function">viewer_file_constructor</code>.
     </p>
 <p>
       Once <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> has obtained a reference to an initialized
       class structure, it invokes its constructor method to create an instance of the new
-      object. Since it has just been overridden by <code class="function">maman_bar_class_init</code>
-      to <code class="function">maman_bar_constructor</code>, the latter is called and, because it
-      was implemented correctly, it chains up to its parent's constructor. In
+      object, if the constructor has been overridden in <code class="function">viewer_file_class_init</code>.
+      Overridden constructors must chain up to their parent’s constructor. In
       order to find the parent class and chain up to the parent class
-      constructor, we can use the <code class="literal">maman_bar_parent_class</code>
+      constructor, we can use the <code class="literal">viewer_file_parent_class</code>
       pointer that has been set up for us by the
-      <code class="literal">G_DEFINE_TYPE</code> macro.
+      <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE:CAPS" title="G_DEFINE_TYPE()"><code class="literal">G_DEFINE_TYPE</code></a>
+      macro.
     </p>
 <p>
       Finally, at one point or another, <code class="function">g_object_constructor</code> is invoked
-      by the last constructor in the chain. This function allocates the object's instance' buffer
+      by the last constructor in the chain. This function allocates the object's instance buffer
       through <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-create-instance" title="g_type_create_instance ()">g_type_create_instance</a></code>
-      which means that the instance_init function is invoked at this point if one
-      was registered. After instance_init returns, the object is fully initialized and should be
-      ready to answer any user-request. When <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-create-instance" title="g_type_create_instance ()">g_type_create_instance</a></code>
+      which means that the <code class="function">instance_init</code> function is invoked at this point if one
+      was registered. After <code class="function">instance_init</code> returns, the object is fully initialized and should be
+      ready to have its methods called by the user. When
+      <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-create-instance" title="g_type_create_instance ()">g_type_create_instance</a></code>
       returns, <code class="function">g_object_constructor</code> sets the construction properties
       (i.e. the properties which were given to <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>) and returns
-      to the user's constructor which is then allowed to do useful instance initialization...
+      to the user's constructor.
     </p>
 <p>
       The process described above might seem a bit complicated, but it can be
@@ -281,7 +224,7 @@
       </p>
 <div class="table">
 <a name="gobject-construction-table"></a><p class="title"><b>Table 4. <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></b></p>
-<div class="table-contents"><table summary="g_object_new" border="1">
+<div class="table-contents"><table class="table" summary="g_object_new" border="1">
 <colgroup>
 <col align="left">
 <col align="left">
@@ -289,23 +232,20 @@
 </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>
 <tbody>
 <tr>
 <td rowspan="4" align="left">First call to <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> for target type</td>
-<td align="left">target type's base_init function</td>
+<td align="left">target type's <code class="function">base_init</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>
-<td>
-                I have no real idea on how this can be used. If you have a good real-life
-                example of how a class' base_init can be used, please, let me know.
-              </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>
 <tr>
-<td align="left">target type's class_init function</td>
+<td align="left">target type's <code class="function">class_init</code> function</td>
 <td align="left">On target type's class structure</td>
 <td>
                 Here, you should make sure to initialize or override class methods (that is,
@@ -314,37 +254,48 @@
               </td>
 </tr>
 <tr>
-<td align="left">interface' base_init function</td>
-<td align="left">On interface' vtable</td>
+<td align="left">interface's <code class="function">base_init</code> function</td>
+<td align="left">On interface's vtable</td>
 <td> </td>
 </tr>
 <tr>
-<td align="left">interface' interface_init function</td>
-<td align="left">On interface' vtable</td>
+<td align="left">interface's <code class="function">interface_init</code> function</td>
+<td align="left">On interface's vtable</td>
 <td> </td>
 </tr>
 <tr>
-<td rowspan="2" align="left">Each call to <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> for target type</td>
-<td align="left">target type's class constructor method: GObjectClass-&gt;constructor</td>
+<td rowspan="3" align="left">Each call to <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> for target type</td>
+<td align="left">target type's class <code class="function">constructor</code> method: <code class="function">GObjectClass-&gt;constructor</code>
+</td>
 <td align="left">On object's instance</td>
 <td>
-                If you need to complete the object initialization after all the construction properties
-                are set, override the constructor method and make sure to chain up to the object's
+                If you need to handle construct properties in a custom way, or implement a singleton class, override the constructor
+                method and make sure to chain up to the object's
                 parent class before doing your own initialization.
                 In doubt, do not override the constructor method.
               </td>
 </tr>
 <tr>
-<td align="left">type's instance_init function</td>
+<td align="left">type's <code class="function">instance_init</code> function</td>
 <td align="left">On the inheritance tree of classes from fundamental type to target type.
-              the instance_init provided for each type is invoked once for each instance
+              the <code class="function">instance_init</code> provided for each type is invoked once for each instance
               structure.</td>
 <td>
-                Provide an instance_init function to initialize your object before its construction
+                Provide an <code class="function">instance_init</code> function to initialize your object before its construction
                 properties are set. This is the preferred way to initialize a GObject instance.
                 This function is equivalent to C++ constructors.
               </td>
 </tr>
+<tr>
+<td align="left">target type's class <code class="function">constructed</code> method: <code class="function">GObjectClass-&gt;constructed</code>
+</td>
+<td align="left">On object's instance</td>
+<td>
+                If you need to perform object initialization steps after all construct properties have been set.
+                This is the final step in the object initialization process, and is only called if the <code class="function">constructor</code>
+                method returned a new object instance (rather than, for example, an existing singleton).
+              </td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -353,19 +304,18 @@
 <p>
       Readers should feel concerned about one little twist in the order in
       which functions are invoked: while, technically, the class' constructor
-      method is called <span class="emphasis"><em>before</em></span> the GType's instance_init
-      function (since <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-create-instance" title="g_type_create_instance ()">g_type_create_instance</a></code> which calls instance_init is called by
+      method is called <span class="emphasis"><em>before</em></span> the GType's <code class="function">instance_init</code>
+      function (since <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-create-instance" title="g_type_create_instance ()">g_type_create_instance</a></code> which calls <code class="function">instance_init</code> is called by
       <code class="function">g_object_constructor</code> which is the top-level class
       constructor method and to which users are expected to chain to), the
       user's code which runs in a user-provided constructor will always
-      run <span class="emphasis"><em>after</em></span> GType's instance_init function since the
+      run <span class="emphasis"><em>after</em></span> GType's <code class="function">instance_init</code> function since the
       user-provided constructor <span class="emphasis"><em>must</em></span> (you've been warned)
       chain up <span class="emphasis"><em>before</em></span> doing anything useful.
     </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>