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

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

Files changed (1979) hide show

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

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GObject Reference Manual: Type Information</title>
+<title>Type Information: GObject Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GObject Reference Manual">
 <link rel="up" href="rn01.html" title="API Reference">
@@ -658,6 +658,32 @@
 </td>
 </tr>
 <tr>
+<td class="function_type">
+<span class="returnvalue">int</span>
+</td>
+<td class="function_name">
+<a class="link" href="gobject-Type-Information.html#g-type-get-instance-count" title="g_type_get_instance_count ()">g_type_get_instance_count</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS" title="G_DECLARE_FINAL_TYPE()">G_DECLARE_FINAL_TYPE</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS" title="G_DECLARE_DERIVABLE_TYPE()">G_DECLARE_DERIVABLE_TYPE</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="gobject-Type-Information.html#G-DECLARE-INTERFACE:CAPS" title="G_DECLARE_INTERFACE()">G_DECLARE_INTERFACE</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
 <td class="define_keyword">#define</td>
 <td class="function_name">
 <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE:CAPS" title="G_DEFINE_TYPE()">G_DEFINE_TYPE</a><span class="c_punctuation">()</span>
@@ -4174,6 +4200,382 @@ time by comparing the current serial with the one at the type lookup.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-type-get-instance-count"></a><h3>g_type_get_instance_count ()</h3>
+<pre class="programlisting"><span class="returnvalue">int</span>
+g_type_get_instance_count (<em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> type</code></em>);</pre>
+<p>Returns the number of instances allocated of the particular type;
+this is only available if GLib is built with debugging support and
+the instance_count debug flag is set (by setting the GOBJECT_DEBUG
+variable to include instance-count).</p>
+<div class="refsect3">
+<a name="id-1.4.2.7.86.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>type</p></td>
+<td class="parameter_description"><p>a <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.2.7.86.6"></a><h4>Returns</h4>
+<p> the number of instances allocated of the given type;
+if instance counts are not available, returns 0.</p>
+<p></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-DECLARE-FINAL-TYPE:CAPS"></a><h3>G_DECLARE_FINAL_TYPE()</h3>
+<pre class="programlisting">#define             G_DECLARE_FINAL_TYPE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, ParentName)</pre>
+<p>A convenience macro for emitting the usual declarations in the header file for a type which is not (at the
+present time) intended to be subclassed.</p>
+<p>You might use it in a header as follows:</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</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#ifndef</span><span class="normal"> _myapp_window_h_</span>
+<span class="preproc">#define</span><span class="normal"> _myapp_window_h_</span>
+<span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gtk/gtk.h&gt;</span>
+<span class="preproc">#define</span><span class="normal"> </span><span class="usertype">MY_APP_TYPE_WINDOW</span><span class="normal"> </span><span class="function">my_app_window_get_type</span><span class="normal"> </span><span class="symbol">()</span>
+<span class="function"><a href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS">G_DECLARE_FINAL_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">MyAppWindow</span><span class="symbol">,</span><span class="normal"> my_app_window</span><span class="symbol">,</span><span class="normal"> MY_APP</span><span class="symbol">,</span><span class="normal"> WINDOW</span><span class="symbol">,</span><span class="normal"> <a href="http://developer.gnome.org/gtk2/GtkWindow.html">GtkWindow</a></span><span class="symbol">)</span>
+<span class="normal">MyAppWindow </span><span class="symbol">*</span><span class="normal">    </span><span class="function">my_app_window_new</span><span class="normal">    </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">);</span>
+<span class="symbol">...</span>
+<span class="preproc">#endif</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p>This results in the following things happening:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>the usual <code class="function">my_app_window_get_type()</code> function is declared with a return type of <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a></p></li>
+<li class="listitem"><p>the MyAppWindow types is defined as a typedef of struct _MyAppWindow.  The struct itself is not
+defined and should be defined from the .c file before <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE:CAPS" title="G_DEFINE_TYPE()"><code class="function">G_DEFINE_TYPE()</code></a> is used.</p></li>
+<li class="listitem"><p>the <code class="function">MY_APP_WINDOW()</code> cast is emitted as static inline function along with the <code class="function">MY_APP_IS_WINDOW()</code> type
+checking function</p></li>
+<li class="listitem"><p>the MyAppWindowClass type is defined as a struct containing GtkWindowClass.  This is done for the
+convenience of the person defining the type and should not be considered to be part of the ABI.  In
+particular, without a firm declaration of the instance structure, it is not possible to subclass the type
+and therefore the fact that the size of the class structure is exposed is not a concern and it can be
+freely changed at any point in the future.</p></li>
+<li class="listitem"><p>g_autoptr() support being added for your type, based on the type of your parent class</p></li>
+</ul></div>
+<p>You can only use this function if your parent type also supports <a href="../glib/glib-Miscellaneous-Macros.html#g-autoptr"><code class="function">g_autoptr()</code></a>.</p>
+<p>Because the type macro (MY_APP_TYPE_WINDOW in the above example) is not a callable, you must continue to
+manually define this as a macro for yourself.</p>
+<p>The declaration of the <code class="function">_get_type()</code> function is the first thing emitted by the macro.  This allows this macro
+to be used in the usual way with export control and API versioning macros.</p>
+<p>If you want to declare your own class structure, use <a class="link" href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS" title="G_DECLARE_DERIVABLE_TYPE()"><code class="function">G_DECLARE_DERIVABLE_TYPE()</code></a>.</p>
+<p>If you are writing a library, it is important to note that it is possible to convert a type from using
+<a class="link" href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS" title="G_DECLARE_FINAL_TYPE()"><code class="function">G_DECLARE_FINAL_TYPE()</code></a> to <a class="link" href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS" title="G_DECLARE_DERIVABLE_TYPE()"><code class="function">G_DECLARE_DERIVABLE_TYPE()</code></a> without breaking API or ABI.  As a precaution, you
+should therefore use <a class="link" href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS" title="G_DECLARE_FINAL_TYPE()"><code class="function">G_DECLARE_FINAL_TYPE()</code></a> until you are sure that it makes sense for your class to be
+subclassed.  Once a class structure has been exposed it is not possible to change its size or remove or
+reorder items without breaking the API and/or ABI.</p>
+<div class="refsect3">
+<a name="id-1.4.2.7.87.15"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>ModuleObjName</p></td>
+<td class="parameter_description"><p>The name of the new type, in camel case (like GtkWidget)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>module_obj_name</p></td>
+<td class="parameter_description"><p>The name of the new type in lowercase, with words
+separated by '_' (like 'gtk_widget')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>MODULE</p></td>
+<td class="parameter_description"><p>The name of the module, in all caps (like 'GTK')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>OBJ_NAME</p></td>
+<td class="parameter_description"><p>The bare name of the type, in all caps (like 'WIDGET')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>ParentName</p></td>
+<td class="parameter_description"><p>the name of the parent type, in camel case (like GtkWidget)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-DECLARE-DERIVABLE-TYPE:CAPS"></a><h3>G_DECLARE_DERIVABLE_TYPE()</h3>
+<pre class="programlisting">#define             G_DECLARE_DERIVABLE_TYPE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, ParentName)</pre>
+<p>A convenience macro for emitting the usual declarations in the header file for a type which will is intended
+to be subclassed.</p>
+<p>You might use it in a header as follows:</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="preproc">#ifndef</span><span class="normal"> _gtk_frobber_h_</span>
+<span class="preproc">#define</span><span class="normal"> _gtk_frobber_h_</span>
+<span class="preproc">#define</span><span class="normal"> </span><span class="usertype">GTK_TYPE_FROBBER</span><span class="normal"> </span><span class="function">gtk_frobber_get_type</span><span class="normal"> </span><span class="symbol">()</span>
+<span class="normal">GDK_AVAILABLE_IN_3_12</span>
+<span class="function"><a href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS">G_DECLARE_DERIVABLE_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GtkFrobber</span><span class="symbol">,</span><span class="normal"> gtk_frobber</span><span class="symbol">,</span><span class="normal"> GTK</span><span class="symbol">,</span><span class="normal"> FROBBER</span><span class="symbol">,</span><span class="normal"> <a href="http://developer.gnome.org/gtk2/GtkWidget.html">GtkWidget</a></span><span class="symbol">)</span>
+<span class="keyword">struct</span><span class="normal"> </span><span class="classname">_GtkFrobberClass</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GtkWidgetClass</span><span class="normal"> parent_class</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="type">void</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal"> handle_frob</span><span class="symbol">)</span><span class="normal">  </span><span class="symbol">(</span><span class="usertype">GtkFrobber</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">frobber</span><span class="symbol">,</span>
+<span class="normal">                         </span><span class="usertype">guint</span><span class="normal">       n_frobs</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="usertype">gpointer</span><span class="normal"> padding</span><span class="symbol">[</span><span class="number">12</span><span class="symbol">];</span>
+<span class="cbracket">}</span><span class="symbol">;</span>
+<span class="normal"><a href="http://developer.gnome.org/gtk2/GtkWidget.html">GtkWidget</a> </span><span class="symbol">*</span><span class="normal">    </span><span class="function">gtk_frobber_new</span><span class="normal">   </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">);</span>
+<span class="symbol">...</span>
+<span class="preproc">#endif</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p>This results in the following things happening:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>the usual <code class="function">gtk_frobber_get_type()</code> function is declared with a return type of <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a></p></li>
+<li class="listitem"><p>the GtkFrobber struct is created with GtkWidget as the first and only item.  You are expected to use
+a private structure from your .c file to store your instance variables.</p></li>
+<li class="listitem"><p>the GtkFrobberClass type is defined as a typedef to struct _GtkFrobberClass, which is left undefined.
+You should do this from the header file directly after you use the macro.</p></li>
+<li class="listitem"><p>the <code class="function">GTK_FROBBER()</code> and <code class="function">GTK_FROBBER_CLASS()</code> casts are emitted as static inline functions along with
+the <code class="function">GTK_IS_FROBBER()</code> and <code class="function">GTK_IS_FROBBER_CLASS()</code> type checking functions and <code class="function">GTK_FROBBER_GET_CLASS()</code>
+function.</p></li>
+<li class="listitem"><p>g_autoptr() support being added for your type, based on the type of your parent class</p></li>
+</ul></div>
+<p>You can only use this function if your parent type also supports <a href="../glib/glib-Miscellaneous-Macros.html#g-autoptr"><code class="function">g_autoptr()</code></a>.</p>
+<p>Because the type macro (GTK_TYPE_FROBBER in the above example) is not a callable, you must continue to
+manually define this as a macro for yourself.</p>
+<p>The declaration of the <code class="function">_get_type()</code> function is the first thing emitted by the macro.  This allows this macro
+to be used in the usual way with export control and API versioning macros.</p>
+<p>If you are writing a library, it is important to note that it is possible to convert a type from using
+<a class="link" href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS" title="G_DECLARE_FINAL_TYPE()"><code class="function">G_DECLARE_FINAL_TYPE()</code></a> to <a class="link" href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS" title="G_DECLARE_DERIVABLE_TYPE()"><code class="function">G_DECLARE_DERIVABLE_TYPE()</code></a> without breaking API or ABI.  As a precaution, you
+should therefore use <a class="link" href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS" title="G_DECLARE_FINAL_TYPE()"><code class="function">G_DECLARE_FINAL_TYPE()</code></a> until you are sure that it makes sense for your class to be
+subclassed.  Once a class structure has been exposed it is not possible to change its size or remove or
+reorder items without breaking the API and/or ABI.  If you want to declare your own class structure, use
+<a class="link" href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS" title="G_DECLARE_DERIVABLE_TYPE()"><code class="function">G_DECLARE_DERIVABLE_TYPE()</code></a>.  If you want to declare a class without exposing the class or instance
+structures, use <a class="link" href="gobject-Type-Information.html#G-DECLARE-FINAL-TYPE:CAPS" title="G_DECLARE_FINAL_TYPE()"><code class="function">G_DECLARE_FINAL_TYPE()</code></a>.</p>
+<p>If you must use <a class="link" href="gobject-Type-Information.html#G-DECLARE-DERIVABLE-TYPE:CAPS" title="G_DECLARE_DERIVABLE_TYPE()"><code class="function">G_DECLARE_DERIVABLE_TYPE()</code></a> you should be sure to include some padding at the bottom of your
+class structure to leave space for the addition of future virtual functions.</p>
+<div class="refsect3">
+<a name="id-1.4.2.7.88.15"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>ModuleObjName</p></td>
+<td class="parameter_description"><p>The name of the new type, in camel case (like GtkWidget)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>module_obj_name</p></td>
+<td class="parameter_description"><p>The name of the new type in lowercase, with words
+separated by '_' (like 'gtk_widget')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>MODULE</p></td>
+<td class="parameter_description"><p>The name of the module, in all caps (like 'GTK')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>OBJ_NAME</p></td>
+<td class="parameter_description"><p>The bare name of the type, in all caps (like 'WIDGET')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>ParentName</p></td>
+<td class="parameter_description"><p>the name of the parent type, in camel case (like GtkWidget)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-DECLARE-INTERFACE:CAPS"></a><h3>G_DECLARE_INTERFACE()</h3>
+<pre class="programlisting">#define             G_DECLARE_INTERFACE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, PrerequisiteName)</pre>
+<p>A convenience macro for emitting the usual declarations in the header file for a GInterface type.</p>
+<p>You might use it in a header as follows:</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</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#ifndef</span><span class="normal"> _my_model_h_</span>
+<span class="preproc">#define</span><span class="normal"> _my_model_h_</span>
+<span class="preproc">#define</span><span class="normal"> </span><span class="usertype">MY_TYPE_MODEL</span><span class="normal"> </span><span class="function">my_model_get_type</span><span class="normal"> </span><span class="symbol">()</span>
+<span class="normal">GDK_AVAILABLE_IN_3_12</span>
+<span class="function"><a href="gobject-Type-Information.html#G-DECLARE-INTERFACE:CAPS">G_DECLARE_INTERFACE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">MyModel</span><span class="symbol">,</span><span class="normal"> my_model</span><span class="symbol">,</span><span class="normal"> MY</span><span class="symbol">,</span><span class="normal"> MODEL</span><span class="symbol">,</span><span class="normal"> <a href="gobject-The-Base-Object-Type.html#GObject">GObject</a></span><span class="symbol">)</span>
+<span class="keyword">struct</span><span class="normal"> </span><span class="classname">_MyModelInterface</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GTypeInterface</span><span class="normal"> g_iface</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a></span><span class="normal"> </span><span class="symbol">(*</span><span class="normal"> get_item</span><span class="symbol">)</span><span class="normal">  </span><span class="symbol">(</span><span class="usertype">MyModel</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">model</span><span class="symbol">);</span>
+<span class="cbracket">}</span><span class="symbol">;</span>
+<span class="usertype">gpointer</span><span class="normal"> </span><span class="function">my_model_get_item</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyModel</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">model</span><span class="symbol">);</span>
+<span class="symbol">...</span>
+<span class="preproc">#endif</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p>This results in the following things happening:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>the usual <code class="function">my_model_get_type()</code> function is declared with a return type of <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a></p></li>
+<li class="listitem"><p>the MyModelInterface type is defined as a typedef to struct _MyModelInterface,
+which is left undefined. You should do this from the header file directly after
+you use the macro.</p></li>
+<li class="listitem"><p>the <code class="function">MY_MODEL()</code> cast is emitted as static inline functions along with
+the <code class="function">MY_IS_MODEL()</code> type checking function and <code class="function">MY_MODEL_GET_IFACE()</code> function.</p></li>
+<li class="listitem"><p>g_autoptr() support being added for your type, based on your prerequisite type.</p></li>
+</ul></div>
+<p>You can only use this function if your prerequisite type also supports <a href="../glib/glib-Miscellaneous-Macros.html#g-autoptr"><code class="function">g_autoptr()</code></a>.</p>
+<p>Because the type macro (MY_TYPE_MODEL in the above example) is not a callable, you must continue to
+manually define this as a macro for yourself.</p>
+<p>The declaration of the <code class="function">_get_type()</code> function is the first thing emitted by the macro.  This allows this macro
+to be used in the usual way with export control and API versioning macros.</p>
+<div class="refsect3">
+<a name="id-1.4.2.7.89.13"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>ModuleObjName</p></td>
+<td class="parameter_description"><p>The name of the new type, in camel case (like GtkWidget)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>module_obj_name</p></td>
+<td class="parameter_description"><p>The name of the new type in lowercase, with words
+separated by '_' (like 'gtk_widget')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>MODULE</p></td>
+<td class="parameter_description"><p>The name of the module, in all caps (like 'GTK')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>OBJ_NAME</p></td>
+<td class="parameter_description"><p>The bare name of the type, in all caps (like 'WIDGET')</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>PrerequisiteName</p></td>
+<td class="parameter_description"><p>the name of the prerequisite type, in camel case (like GtkWidget)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="G-DEFINE-TYPE:CAPS"></a><h3>G_DEFINE_TYPE()</h3>
 <pre class="programlisting">#define G_DEFINE_TYPE(TN, t_n, T_P)			    G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, 0, {})
 </pre>
@@ -4183,7 +4585,7 @@ for information about these) and a static variable named <code class="literal">t
 pointing to the parent class. Furthermore, it defines  a *_get_type() function.
 See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:CAPS" title="G_DEFINE_TYPE_EXTENDED()"><code class="function">G_DEFINE_TYPE_EXTENDED()</code></a> for an example.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.86.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.90.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4227,7 +4629,7 @@ for an example.</p>
 name of the form <em class="parameter"><code>TN</code></em>
  Private.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.87.6"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.91.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4266,7 +4668,7 @@ Similar to <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE:CAP
 *_get_type() function, e.g. interface implementations via <a class="link" href="gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS" title="G_IMPLEMENT_INTERFACE()"><code class="function">G_IMPLEMENT_INTERFACE()</code></a>.
 See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:CAPS" title="G_DEFINE_TYPE_EXTENDED()"><code class="function">G_DEFINE_TYPE_EXTENDED()</code></a> for an example.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.88.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.92.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4308,7 +4710,7 @@ See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:C
 Similar to <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE:CAPS" title="G_DEFINE_TYPE()"><code class="function">G_DEFINE_TYPE()</code></a>, but defines an abstract type.
 See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:CAPS" title="G_DEFINE_TYPE_EXTENDED()"><code class="function">G_DEFINE_TYPE_EXTENDED()</code></a> for an example.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.89.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.93.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4345,7 +4747,7 @@ separated by '_'.</p></td>
 <p>Similar to <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-WITH-PRIVATE:CAPS" title="G_DEFINE_TYPE_WITH_PRIVATE()"><code class="function">G_DEFINE_TYPE_WITH_PRIVATE()</code></a>, but defines an abstract type.
 See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:CAPS" title="G_DEFINE_TYPE_EXTENDED()"><code class="function">G_DEFINE_TYPE_EXTENDED()</code></a> for an example.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.90.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.94.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4385,7 +4787,7 @@ allows you to insert custom code into the *_get_type() function, e.g.
 interface implementations  via <a class="link" href="gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS" title="G_IMPLEMENT_INTERFACE()"><code class="function">G_IMPLEMENT_INTERFACE()</code></a>.
 See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:CAPS" title="G_DEFINE_TYPE_EXTENDED()"><code class="function">G_DEFINE_TYPE_EXTENDED()</code></a> for an example.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.91.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.95.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4513,7 +4915,7 @@ macros, since it depends on variable names from those macros.</p>
 <p>Also note that private structs added with these macros must have a struct
 name of the form <code class="literal">TypeNamePrivate</code>.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.92.14"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.96.14"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4541,7 +4943,7 @@ structure for <em class="parameter"><code>TypeName</code></em>
 and <a class="link" href="gobject-Type-Information.html#G-ADD-PRIVATE:CAPS" title="G_ADD_PRIVATE()"><code class="function">G_ADD_PRIVATE()</code></a> macros, since it depends on variable names from
 those macros.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.93.6"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.97.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4577,7 +4979,7 @@ structure for <em class="parameter"><code>TypeName</code></em>
 and <a class="link" href="gobject-Type-Information.html#G-ADD-PRIVATE:CAPS" title="G_ADD_PRIVATE()"><code class="function">G_ADD_PRIVATE()</code></a> macros, since it depends on variable names from
 those macros.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.94.6"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.98.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4624,7 +5026,7 @@ structure for <em class="parameter"><code>TypeName</code></em>
 and <a class="link" href="gobject-Type-Information.html#G-ADD-PRIVATE:CAPS" title="G_ADD_PRIVATE()"><code class="function">G_ADD_PRIVATE()</code></a> macros, since it depends on variable names from
 those macros.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.95.6"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.99.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4665,7 +5067,7 @@ function.</p>
 name <code class="literal">t_n ## _default_init</code>, and the interface structure to have the
 name <code class="literal">TN ## Interface</code>.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.96.6"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.100.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4706,7 +5108,7 @@ via <a class="link" href="gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CA
 <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:CAPS" title="G_DEFINE_TYPE_EXTENDED()"><code class="function">G_DEFINE_TYPE_EXTENDED()</code></a> for a similar example using
 <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-WITH-CODE:CAPS" title="G_DEFINE_TYPE_WITH_CODE()"><code class="function">G_DEFINE_TYPE_WITH_CODE()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.97.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.101.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4750,7 +5152,7 @@ See <a class="link" href="gobject-Type-Information.html#G-DEFINE-TYPE-EXTENDED:C
 <p>Note that this macro can only be used together with the G_DEFINE_TYPE_*
 macros, since it depends on variable names from those macros.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.98.6"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.102.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4883,7 +5285,7 @@ The only pieces which have to be manually provided are the definitions of
 the instance and class structure and the definitions of the instance and
 class init functions.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.99.9"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.103.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4930,7 +5332,7 @@ separated by '_'.</p></td>
 <p>A convenience macro for boxed type implementations, which defines a
 <code class="function">type_name_get_type()</code> function registering the boxed type.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.100.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.104.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -4974,7 +5376,7 @@ Similar to <a class="link" href="gobject-Type-Information.html#G-DEFINE-BOXED-TY
 <code class="function">type_name_get_type()</code> function, e.g. to register value transformations with
 <a class="link" href="gobject-Generic-values.html#g-value-register-transform-func" title="g_value_register_transform_func ()"><code class="function">g_value_register_transform_func()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.101.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.105.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -5021,7 +5423,7 @@ separated by '_'</p></td>
 <p>A convenience macro for pointer type implementations, which defines a
 <code class="function">type_name_get_type()</code> function registering the pointer type.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.102.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.106.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -5054,7 +5456,7 @@ separated by '_'</p></td>
 Similar to <a class="link" href="gobject-Type-Information.html#G-DEFINE-POINTER-TYPE:CAPS" title="G_DEFINE_POINTER_TYPE()"><code class="function">G_DEFINE_POINTER_TYPE()</code></a>, but allows to insert
 custom code into the <code class="function">type_name_get_type()</code> function.</p>
 <div class="refsect3">
-<a name="id-1.4.2.7.103.5"></a><h4>Parameters</h4>
+<a name="id-1.4.2.7.107.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -5320,46 +5722,172 @@ used specifically for managing interface types.</p>
 				  guint		collect_flags);
 };
 </pre>
-<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
-<p>'i' - Integers. passed as collect_values[].v_int.</p>
-<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; ">
-<li class="listitem"><p>'l' - Longs. passed as collect_values[].v_long.</p></li>
-<li class="listitem"><p>'d' - Doubles. passed as collect_values[].v_double.</p></li>
-<li class="listitem"><p>'p' - Pointers. passed as collect_values[].v_pointer.</p></li>
-</ul></div>
-<p>It should be noted that for variable argument list construction,
-ANSI C promotes every type smaller than an integer to an int, and
-floats to doubles. So for collection of short int or char, 'i'
-needs to be used, and for collection of floats 'd'.
-<em class="parameter"><code>collect_value</code></em>
-: The <code class="function">collect_value()</code> function is responsible for converting the
-values collected from a variable argument list into contents
-suitable for storage in a GValue. This function should setup
-<em class="parameter"><code>value</code></em>
- similar to <code class="function">value_init()</code>; e.g. for a string value that
-does not allow <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointers, it needs to either spew an error,
-or do an implicit conversion by storing an empty string.
-The <em class="parameter"><code>value</code></em>
- passed in to this function has a zero-filled data
-array, so just like for <code class="function">value_init()</code> it is guaranteed to not
-contain any old contents that might need freeing.
+<p>The <a class="link" href="gobject-Type-Information.html#GTypeValueTable" title="struct GTypeValueTable"><span class="type">GTypeValueTable</span></a> provides the functions required by the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>
+implementation, to serve as a container for values of a type.</p>
+<div class="refsect3">
+<a name="id-1.4.2.8.10.5"></a><h4>Members</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="300px" class="struct_members_name">
+<col class="struct_members_description">
+<col width="200px" class="struct_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-init"></a>value_init</code></em> ()</p></td>
+<td class="struct_member_description">
+<p>Default initialize <em class="parameter"><code>values</code></em>
+contents by poking values
+directly into the value-&gt;data array. The data array of
+the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> passed into this function was zero-filled
+with <code class="literal"><code class="function">memset()</code></code>, so no care has to be taken to free any
+old contents. E.g. for the implementation of a string
+value that may never be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the implementation might
+look like:</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="normal">value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">""</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+</td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-free"></a>value_free</code></em> ()</p></td>
+<td class="struct_member_description">
+<p>Free any old contents that might be left in the
+data array of the passed in <em class="parameter"><code>value</code></em>
+. No resources may
+remain allocated through the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> contents after
+this function returns. E.g. for our above string type:</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="comment">// only free strings without a specific flag for static storage</span>
+<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!(</span><span class="normal">value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">v_uint </span><span class="symbol">&amp;</span><span class="normal"> G_VALUE_NOCOPY_CONTENTS</span><span class="symbol">))</span>
+<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+</td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-copy"></a>value_copy</code></em> ()</p></td>
+<td class="struct_member_description">
+<p><em class="parameter"><code>dest_value</code></em>
+is a <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> with zero-filled data section
+and <em class="parameter"><code>src_value</code></em>
+is a properly setup <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> of same or
+derived type.
+The purpose of this function is to copy the contents of
+<em class="parameter"><code>src_value</code></em>
+into <em class="parameter"><code>dest_value</code></em>
+in a way, that even after
+<em class="parameter"><code>src_value</code></em>
+has been freed, the contents of <em class="parameter"><code>dest_value</code></em>
+remain valid. String type example:</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="normal">dest_value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">src_value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+</td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-peek-pointer"></a>value_peek_pointer</code></em> ()</p></td>
+<td class="struct_member_description">
+<p>If the value contents fit into a pointer, such as objects
+or strings, return this pointer, so the caller can peek at
+the current contents. To extend on our above string example:</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="keyword">return</span><span class="normal"> value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer</span><span class="symbol">;</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+</td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GTypeValueTable.collect-format"></a>collect_format</code></em>;</p></td>
+<td class="struct_member_description">
+<p>A string format describing how to collect the contents of
+this value bit-by-bit. Each character in the format represents
+an argument to be collected, and the characters themselves indicate
+the type of the argument. Currently supported arguments are:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>'i' - Integers. passed as collect_values[].v_int.</p></li>
+<li class="listitem"><p>'l' - Longs. passed as collect_values[].v_long.</p></li>
+<li class="listitem"><p>'d' - Doubles. passed as collect_values[].v_double.</p></li>
+<li class="listitem"><p>'p' - Pointers. passed as collect_values[].v_pointer.
+It should be noted that for variable argument list construction,
+ANSI C promotes every type smaller than an integer to an int, and
+floats to doubles. So for collection of short int or char, 'i'
+needs to be used, and for collection of floats 'd'.</p></li>
+</ul></div>
+</td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.collect-value"></a>collect_value</code></em> ()</p></td>
+<td class="struct_member_description">
+<p>The <code class="function">collect_value()</code> function is responsible for converting the
+values collected from a variable argument list into contents
+suitable for storage in a GValue. This function should setup
+<em class="parameter"><code>value</code></em>
+similar to <code class="function">value_init()</code>; e.g. for a string value that
+does not allow <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointers, it needs to either spew an error,
+or do an implicit conversion by storing an empty string.
+The <em class="parameter"><code>value</code></em>
+passed in to this function has a zero-filled data
+array, so just like for <code class="function">value_init()</code> it is guaranteed to not
+contain any old contents that might need freeing.
 <em class="parameter"><code>n_collect_values</code></em>
- is exactly the string length of <em class="parameter"><code>collect_format</code></em>
+is exactly the string length of <em class="parameter"><code>collect_format</code></em>
 ,
 and <em class="parameter"><code>collect_values</code></em>
- is an array of unions <a class="link" href="gobject-Varargs-Value-Collection.html#GTypeCValue" title="union GTypeCValue"><span class="type">GTypeCValue</span></a> with
+is an array of unions <a class="link" href="gobject-Varargs-Value-Collection.html#GTypeCValue" title="GTypeCValue"><span class="type">GTypeCValue</span></a> with
 length <em class="parameter"><code>n_collect_values</code></em>
 , containing the collected values
 according to <em class="parameter"><code>collect_format</code></em>
 .
 <em class="parameter"><code>collect_flags</code></em>
- is an argument provided as a hint by the caller.
+is an argument provided as a hint by the caller.
 It may contain the flag <code class="literal">G_VALUE_NOCOPY_CONTENTS</code> indicating,
 that the collected value contents may be considered "static"
 for the duration of the <em class="parameter"><code>value</code></em>
- lifetime.
+lifetime.
 Thus an extra copy of the contents stored in <em class="parameter"><code>collect_values</code></em>
- is
+is
 not required for assignment to <em class="parameter"><code>value</code></em>
 .
 For our above string example, we continue with:</p>
@@ -5443,35 +5971,41 @@ an error condition occurred, <code class="function">collect_value()</code> may s
 error by returning a newly allocated non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> string, giving
 a suitable description of the error condition.
 The calling code makes no assumptions about the <em class="parameter"><code>value</code></em>
 contents being valid upon error returns, <em class="parameter"><code>value</code></em>
 is simply thrown away without further freeing. As such, it is
 a good idea to not allocate <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> contents, prior to returning
 an error, however, <code class="function">collect_values()</code> is not obliged to return
 a correctly setup <em class="parameter"><code>value</code></em>
- for error returns, simply because
+for error returns, simply because
 any non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> return is considered a fatal condition so further
-program behaviour is undefined.
-<em class="parameter"><code>lcopy_format</code></em>
-: Format description of the arguments to collect for <em class="parameter"><code>lcopy_value</code></em>
+program behaviour is undefined.</p>
+</td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GTypeValueTable.lcopy-format"></a>lcopy_format</code></em>;</p></td>
+<td class="struct_member_description"><p>Format description of the arguments to collect for <em class="parameter"><code>lcopy_value</code></em>
 ,
 analogous to <em class="parameter"><code>collect_format</code></em>
 . Usually, <em class="parameter"><code>lcopy_format</code></em>
- string consists
-only of 'p's to provide <code class="function">lcopy_value()</code> with pointers to storage locations.
-<em class="parameter"><code>lcopy_value</code></em>
-: This function is responsible for storing the <em class="parameter"><code>value</code></em>
- contents into
+string consists
+only of 'p's to provide <code class="function">lcopy_value()</code> with pointers to storage locations.</p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.lcopy-value"></a>lcopy_value</code></em> ()</p></td>
+<td class="struct_member_description">
+<p>This function is responsible for storing the <em class="parameter"><code>value</code></em>
+contents into
 arguments passed through a variable argument list which got
 collected into <em class="parameter"><code>collect_values</code></em>
- according to <em class="parameter"><code>lcopy_format</code></em>
+according to <em class="parameter"><code>lcopy_format</code></em>
 .
 <em class="parameter"><code>n_collect_values</code></em>
- equals the string length of <em class="parameter"><code>lcopy_format</code></em>
+equals the string length of <em class="parameter"><code>lcopy_format</code></em>
 ,
 and <em class="parameter"><code>collect_flags</code></em>
- may contain <code class="literal">G_VALUE_NOCOPY_CONTENTS</code>.
+may contain <code class="literal">G_VALUE_NOCOPY_CONTENTS</code>.
 In contrast to <code class="function">collect_value()</code>, <code class="function">lcopy_value()</code> is obliged to
 always properly support <code class="literal">G_VALUE_NOCOPY_CONTENTS</code>.
 Similar to <code class="function">collect_value()</code> the function may prematurely abort
@@ -5532,146 +6066,10 @@ reference-counted types:</p>
   </table>
 </div>
-<p></p>
-</li></ul></div>
-<p>The <a class="link" href="gobject-Type-Information.html#GTypeValueTable" title="struct GTypeValueTable"><span class="type">GTypeValueTable</span></a> provides the functions required by the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>
-implementation, to serve as a container for values of a type.</p>
-<div class="refsect3">
-<a name="id-1.4.2.8.10.6"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
-<colgroup>
-<col width="300px" class="struct_members_name">
-<col class="struct_members_description">
-<col width="200px" class="struct_members_annotations">
-</colgroup>
-<tbody>
-<tr>
-<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-init"></a>value_init</code></em> ()</p></td>
-<td class="struct_member_description">
-<p>Default initialize <em class="parameter"><code>values</code></em>
-contents by poking values
-directly into the value-&gt;data array. The data array of
-the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> passed into this function was zero-filled
-with <code class="literal"><code class="function">memset()</code></code>, so no care has to be taken to free any
-old contents. E.g. for the implementation of a string
-value that may never be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the implementation might
-look like:</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="normal">value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">""</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
 <p></p>
 </td>
 <td class="struct_member_annotations"> </td>
 </tr>
-<tr>
-<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-free"></a>value_free</code></em> ()</p></td>
-<td class="struct_member_description">
-<p>Free any old contents that might be left in the
-data array of the passed in <em class="parameter"><code>value</code></em>
-. No resources may
-remain allocated through the <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> contents after
-this function returns. E.g. for our above string type:</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="comment">// only free strings without a specific flag for static storage</span>
-<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!(</span><span class="normal">value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">v_uint </span><span class="symbol">&amp;</span><span class="normal"> G_VALUE_NOCOPY_CONTENTS</span><span class="symbol">))</span>
-<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p></p>
-</td>
-<td class="struct_member_annotations"> </td>
-</tr>
-<tr>
-<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-copy"></a>value_copy</code></em> ()</p></td>
-<td class="struct_member_description">
-<p><em class="parameter"><code>dest_value</code></em>
-is a <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> with zero-filled data section
-and <em class="parameter"><code>src_value</code></em>
-is a properly setup <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> of same or
-derived type.
-The purpose of this function is to copy the contents of
-<em class="parameter"><code>src_value</code></em>
-into <em class="parameter"><code>dest_value</code></em>
-in a way, that even after
-<em class="parameter"><code>src_value</code></em>
-has been freed, the contents of <em class="parameter"><code>dest_value</code></em>
-remain valid. String type example:</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="normal">dest_value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">src_value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p></p>
-</td>
-<td class="struct_member_annotations"> </td>
-</tr>
-<tr>
-<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.value-peek-pointer"></a>value_peek_pointer</code></em> ()</p></td>
-<td class="struct_member_description">
-<p>If the value contents fit into a pointer, such as objects
-or strings, return this pointer, so the caller can peek at
-the current contents. To extend on our above string example:</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="keyword">return</span><span class="normal"> value</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">].</span><span class="normal">v_pointer</span><span class="symbol">;</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p></p>
-</td>
-<td class="struct_member_annotations"> </td>
-</tr>
-<tr>
-<td class="struct_member_name"><p>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GTypeValueTable.collect-format"></a>collect_format</code></em>;</p></td>
-<td class="struct_member_description"><p>A string format describing how to collect the contents of
-this value bit-by-bit. Each character in the format represents
-an argument to be collected, and the characters themselves indicate
-the type of the argument. Currently supported arguments are:</p></td>
-<td class="struct_member_annotations"> </td>
-</tr>
-<tr>
-<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.collect-value"></a>collect_value</code></em> ()</p></td>
-<td> </td>
-<td> </td>
-</tr>
-<tr>
-<td class="struct_member_name"><p>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GTypeValueTable.lcopy-format"></a>lcopy_format</code></em>;</p></td>
-<td> </td>
-<td> </td>
-</tr>
-<tr>
-<td class="struct_member_name"><p><em class="structfield"><code><a name="GTypeValueTable.lcopy-value"></a>lcopy_value</code></em> ()</p></td>
-<td> </td>
-<td> </td>
-</tr>
 </tbody>
 </table></div>
 </div>
@@ -5725,6 +6123,13 @@ environment variable.</p>
 <td class="enum_member_annotations"> </td>
 </tr>
 <tr>
+<td class="enum_member_name"><p><a name="G-TYPE-DEBUG-INSTANCE-COUNT:CAPS"></a>G_TYPE_DEBUG_INSTANCE_COUNT</p></td>
+<td class="enum_member_description">
+<p>Keep a count of instances of each type</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
 <td class="enum_member_name"><p><a name="G-TYPE-DEBUG-MASK:CAPS"></a>G_TYPE_DEBUG_MASK</p></td>
 <td class="enum_member_description">
 <p>Mask covering all debug flags</p>