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

glib2 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32

Files changed (1062) hide show

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>The GLib Dynamic Type System: 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="ch01s02.html" title="Exporting a C API">
 <link rel="next" href="gtype-conventions.html" title="Conventions">
-<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">
@@ -74,37 +74,37 @@
 29
 30
 31</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="classname">_GTypeInfo</span><span class="normal">               <a href="gobject-Type-Information.html#GTypeInfo">GTypeInfo</a></span><span class="symbol">;</span>
-<span class="keyword">struct</span><span class="normal"> </span><span class="classname">_GTypeInfo</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="comment">/* interface types, classed types, instantiated types */</span>
-<span class="normal">  </span><span class="usertype">guint16</span><span class="normal">                class_size</span><span class="symbol">;</span>
-<span class="normal">  </span>
-<span class="normal">  </span><span class="usertype">GBaseInitFunc</span><span class="normal">          base_init</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GBaseFinalizeFunc</span><span class="normal">      base_finalize</span><span class="symbol">;</span>
-<span class="normal">  </span>
-<span class="normal">  </span><span class="comment">/* classed types, instantiated types */</span>
-<span class="normal">  </span><span class="usertype">GClassInitFunc</span><span class="normal">         class_init</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GClassFinalizeFunc</span><span class="normal">     class_finalize</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">gconstpointer</span><span class="normal">          class_data</span><span class="symbol">;</span>
-<span class="normal">  </span>
-<span class="normal">  </span><span class="comment">/* instantiated types */</span>
-<span class="normal">  </span><span class="usertype">guint16</span><span class="normal">                instance_size</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">guint16</span><span class="normal">                n_preallocs</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GInstanceInitFunc</span><span class="normal">      instance_init</span><span class="symbol">;</span>
-<span class="normal">  </span>
-<span class="normal">  </span><span class="comment">/* value handling */</span>
-<span class="normal">  </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GTypeValueTable</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value_table</span><span class="symbol">;</span>
-<span class="cbracket">}</span><span class="symbol">;</span>
-<span class="usertype">GType</span><span class="normal"> </span><span class="function"><a href="gobject-Type-Information.html#g-type-register-static">g_type_register_static</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GType</span><span class="normal">             parent_type</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">type_name</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GTypeInfo</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">info</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">GTypeFlags</span><span class="normal">        flags</span><span class="symbol">);</span>
-<span class="usertype">GType</span><span class="normal"> </span><span class="function"><a href="gobject-Type-Information.html#g-type-register-fundamental">g_type_register_fundamental</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GType</span><span class="normal">                       type_id</span><span class="symbol">,</span>
-<span class="normal">                                   </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">                </span><span class="symbol">*</span><span class="normal">type_name</span><span class="symbol">,</span>
-<span class="normal">                                   </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GTypeInfo</span><span class="normal">            </span><span class="symbol">*</span><span class="normal">info</span><span class="symbol">,</span>
-<span class="normal">                                   </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GTypeFundamentalInfo</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">finfo</span><span class="symbol">,</span>
-<span class="normal">                                   </span><span class="usertype">GTypeFlags</span><span class="normal">                  flags</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">struct</span> _GTypeInfo               GTypeInfo<span class="gtkdoc opt">;</span>
+<span class="gtkdoc kwb">struct</span> _GTypeInfo
+<span class="gtkdoc opt">{</span>
+  <span class="comment">/* interface types, classed types, instantiated types */</span>
+  guint16                class_size<span class="gtkdoc opt">;</span>
+  GBaseInitFunc          base_init<span class="gtkdoc opt">;</span>
+  GBaseFinalizeFunc      base_finalize<span class="gtkdoc opt">;</span>
+  <span class="comment">/* classed types, instantiated types */</span>
+  GClassInitFunc         class_init<span class="gtkdoc opt">;</span>
+  GClassFinalizeFunc     class_finalize<span class="gtkdoc opt">;</span>
+  gconstpointer          class_data<span class="gtkdoc opt">;</span>
+  <span class="comment">/* instantiated types */</span>
+  guint16                instance_size<span class="gtkdoc opt">;</span>
+  guint16                n_preallocs<span class="gtkdoc opt">;</span>
+  GInstanceInitFunc      instance_init<span class="gtkdoc opt">;</span>
+  <span class="comment">/* value handling */</span>
+  <span class="gtkdoc kwb">const</span> GTypeValueTable <span class="gtkdoc opt">*</span>value_table<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">};</span>
+GType <span class="function"><a href="gobject-Type-Information.html#g-type-register-static">g_type_register_static</a></span> <span class="gtkdoc opt">(</span>GType             parent_type<span class="gtkdoc opt">,</span>
+                              <span class="gtkdoc kwb">const</span> gchar      <span class="gtkdoc opt">*</span>type_name<span class="gtkdoc opt">,</span>
+                              <span class="gtkdoc kwb">const</span> GTypeInfo  <span class="gtkdoc opt">*</span>info<span class="gtkdoc opt">,</span>
+                              GTypeFlags        flags<span class="gtkdoc opt">);</span>
+GType <span class="function"><a href="gobject-Type-Information.html#g-type-register-fundamental">g_type_register_fundamental</a></span> <span class="gtkdoc opt">(</span>GType                       type_id<span class="gtkdoc opt">,</span>
+                                   <span class="gtkdoc kwb">const</span> gchar                <span class="gtkdoc opt">*</span>type_name<span class="gtkdoc opt">,</span>
+                                   <span class="gtkdoc kwb">const</span> GTypeInfo            <span class="gtkdoc opt">*</span>info<span class="gtkdoc opt">,</span>
+                                   <span class="gtkdoc kwb">const</span> GTypeFundamentalInfo <span class="gtkdoc opt">*</span>finfo<span class="gtkdoc opt">,</span>
+                                   GTypeFlags                  flags<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -113,16 +113,16 @@
 <p>
       </p>
 <p>
-        <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-static" title="g_type_register_static ()">g_type_register_static</a></code> and
+        <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-static" title="g_type_register_static ()">g_type_register_static</a></code>,
+        <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-dynamic" title="g_type_register_dynamic ()">g_type_register_dynamic</a></code> and
         <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-fundamental" title="g_type_register_fundamental ()">g_type_register_fundamental</a></code>
         are the C functions, defined in
         <code class="filename">gtype.h</code> and implemented in <code class="filename">gtype.c</code>
         which you should use to register a new <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> in the program's type system.
         It is not likely you will ever need to use
-        <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-fundamental" title="g_type_register_fundamental ()">g_type_register_fundamental</a></code> (you have to be Tim Janik
-        to do that) but in case you want to, the last chapter explains how to create
+        <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-fundamental" title="g_type_register_fundamental ()">g_type_register_fundamental</a></code>
+        but in case you want to, the last chapter explains how to create
         new fundamental types.
-        <a href="#ftn.id-1.3.3.3.7" class="footnote" name="id-1.3.3.3.7"><sup class="footnote">[2]</sup></a>
       </p>
 <p>
         Fundamental types are top-level types which do not derive from any other type
@@ -140,8 +140,8 @@
             class size: the class_size field in <a class="link" href="gobject-Type-Information.html#GTypeInfo" title="struct GTypeInfo"><span class="type">GTypeInfo</span></a>.
           </p></li>
 <li class="listitem"><p>
-            class initialization functions (C++ constructor): the base_init and
-            class_init fields in <a class="link" href="gobject-Type-Information.html#GTypeInfo" title="struct GTypeInfo"><span class="type">GTypeInfo</span></a>.
+            class initialization functions (C++ constructor): the <code class="function">base_init</code> and
+            <code class="function">class_init</code> fields in <a class="link" href="gobject-Type-Information.html#GTypeInfo" title="struct GTypeInfo"><span class="type">GTypeInfo</span></a>.
           </p></li>
 <li class="listitem"><p>
             class destruction functions (C++ destructor): the base_finalize and
@@ -189,8 +189,7 @@
         </p>
 <p>
           The following code shows how you can copy around a 64 bit integer, as well as a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
-          instance pointer (sample code for this is located in the source tarball for this document in
-          <code class="filename">sample/gtype/test.c</code>):
+          instance pointer:
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -241,51 +240,51 @@
 43
 44
 45</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">test_int</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GValue</span><span class="normal"> a_value </span><span class="symbol">=</span><span class="normal"> <a href="gobject-Generic-values.html#G-VALUE-INIT:CAPS">G_VALUE_INIT</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GValue</span><span class="normal"> b_value </span><span class="symbol">=</span><span class="normal"> <a href="gobject-Generic-values.html#G-VALUE-INIT:CAPS">G_VALUE_INIT</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">guint64</span><span class="normal"> a</span><span class="symbol">,</span><span class="normal"> b</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span> <span class="function">test_int</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GValue a_value <span class="gtkdoc opt">=</span> G_VALUE_INIT<span class="gtkdoc opt">;</span>
+  GValue b_value <span class="gtkdoc opt">=</span> G_VALUE_INIT<span class="gtkdoc opt">;</span>
+  guint64 a<span class="gtkdoc opt">,</span> b<span class="gtkdoc opt">;</span>
-<span class="normal">  a </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0xdeadbeaf</span><span class="symbol">;</span>
+  a <span class="gtkdoc opt">=</span> <span class="number">0xdeadbeef</span><span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">a_value</span><span class="symbol">,</span><span class="normal"> <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS">G_TYPE_UINT64</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-uint64">g_value_set_uint64</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">a_value</span><span class="symbol">,</span><span class="normal"> a</span><span class="symbol">);</span>
+  <span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span> <span class="gtkdoc opt">(&amp;</span>a_value<span class="gtkdoc opt">,</span> G_TYPE_UINT64<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-uint64">g_value_set_uint64</a></span> <span class="gtkdoc opt">(&amp;</span>a_value<span class="gtkdoc opt">,</span> a<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b_value</span><span class="symbol">,</span><span class="normal"> <a href="gobject-Type-Information.html#G-TYPE-UINT64:CAPS">G_TYPE_UINT64</a></span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Generic-values.html#g-value-copy">g_value_copy</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">a_value</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">b_value</span><span class="symbol">);</span>
+  <span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span> <span class="gtkdoc opt">(&amp;</span>b_value<span class="gtkdoc opt">,</span> G_TYPE_UINT64<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="gobject-Generic-values.html#g-value-copy">g_value_copy</a></span> <span class="gtkdoc opt">(&amp;</span>a_value<span class="gtkdoc opt">, &amp;</span>b_value<span class="gtkdoc opt">);</span>
-<span class="normal">  b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-uint64">g_value_get_uint64</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b_value</span><span class="symbol">);</span>
+  b <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-get-uint64">g_value_get_uint64</a></span> <span class="gtkdoc opt">(&amp;</span>b_value<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">a </span><span class="symbol">==</span><span class="normal"> b</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">    </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Yay !! 10 lines of code to copy around a uint64.</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="cbracket">}</span><span class="normal"> </span><span class="keyword">else</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">    </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Are you sure this is not a Z80 ?</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="cbracket">}</span>
-<span class="cbracket">}</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>a <span class="gtkdoc opt">==</span> b<span class="gtkdoc opt">) {</span>
+    <span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;Yay !! 10 lines of code to copy around a uint64.</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">);</span>
+  <span class="gtkdoc opt">}</span> <span class="keyword">else</span> <span class="gtkdoc opt">{</span>
+    <span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;Are you sure this is not a Z80 ?</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">);</span>
+  <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="normal"> </span><span class="function">test_object</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</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="normal">  </span><span class="usertype">GValue</span><span class="normal"> obj_vala </span><span class="symbol">=</span><span class="normal"> <a href="gobject-Generic-values.html#G-VALUE-INIT:CAPS">G_VALUE_INIT</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GValue</span><span class="normal"> obj_valb </span><span class="symbol">=</span><span class="normal"> <a href="gobject-Generic-values.html#G-VALUE-INIT:CAPS">G_VALUE_INIT</a></span><span class="symbol">;</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-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>
+<span class="gtkdoc kwb">static void</span> <span class="function">test_object</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  GObject <span class="gtkdoc opt">*</span>obj<span class="gtkdoc opt">;</span>
+  GValue obj_vala <span class="gtkdoc opt">=</span> G_VALUE_INIT<span class="gtkdoc opt">;</span>
+  GValue obj_valb <span class="gtkdoc opt">=</span> G_VALUE_INIT<span class="gtkdoc opt">;</span>
+  obj <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>
-<span class="normal">  </span><span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">obj_vala</span><span class="symbol">,</span><span class="normal"> MAMAN_TYPE_BAR</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-object">g_value_set_object</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">obj_vala</span><span class="symbol">,</span><span class="normal"> obj</span><span class="symbol">);</span>
+  <span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span> <span class="gtkdoc opt">(&amp;</span>obj_vala<span class="gtkdoc opt">,</span> VIEWER_TYPE_FILE<span class="gtkdoc opt">);</span>
+  <span class="function"><a href="gobject-Standard-Parameter-and-Value-Types.html#g-value-set-object">g_value_set_object</a></span> <span class="gtkdoc opt">(&amp;</span>obj_vala<span class="gtkdoc opt">,</span> obj<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">obj_valb</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="function"><a href="gobject-Generic-values.html#g-value-init">g_value_init</a></span> <span class="gtkdoc opt">(&amp;</span>obj_valb<span class="gtkdoc opt">,</span> G_TYPE_OBJECT<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="comment">/* g_value_copy's semantics for G_TYPE_OBJECT types is to copy the reference.</span>
-<span class="comment">     This function thus calls g_object_ref.</span>
-<span class="comment">     It is interesting to note that the assignment works here because</span>
-<span class="comment">     MAMAN_TYPE_BAR is a G_TYPE_OBJECT.</span>
+  <span class="comment">/* g_value_copy's semantics for G_TYPE_OBJECT types is to copy the reference.</span>
+<span class="comment">   * This function thus calls g_object_ref.</span>
+<span class="comment">   * It is interesting to note that the assignment works here because</span>
+<span class="comment">   * VIEWER_TYPE_FILE is a G_TYPE_OBJECT.</span>
 <span class="comment">   */</span>
-<span class="normal">  </span><span class="function"><a href="gobject-Generic-values.html#g-value-copy">g_value_copy</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">obj_vala</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">obj_valb</span><span class="symbol">);</span>
+  <span class="function"><a href="gobject-Generic-values.html#g-value-copy">g_value_copy</a></span> <span class="gtkdoc opt">(&amp;</span>obj_vala<span class="gtkdoc opt">, &amp;</span>obj_valb<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">obj</span><span class="symbol">));</span>
-<span class="normal">  </span><span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">obj</span><span class="symbol">));</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span> <span class="gtkdoc opt">(</span>obj<span class="gtkdoc opt">));</span>
+  <span class="function"><a href="gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span> <span class="gtkdoc opt">(</span>obj<span class="gtkdoc opt">));</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -299,82 +298,19 @@
           the reference count of the instance and copy the reference to the new GValue.
         </p>
 <p>
-          The value_table used to specify these assignment functions is defined in
-          <code class="filename">gtype.h</code> and is thoroughly described in the
-          API documentation provided with GObject (for once ;-) which is why we will
-          not detail its exact semantics.
-          </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</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="classname">_GTypeValueTable</span><span class="normal">         <a href="gobject-Type-Information.html#GTypeValueTable">GTypeValueTable</a></span><span class="symbol">;</span>
-<span class="keyword">struct</span><span class="normal"> </span><span class="classname">_GTypeValueTable</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="type">void</span><span class="normal">     </span><span class="symbol">(*</span><span class="normal">value_init</span><span class="symbol">)</span><span class="normal">         </span><span class="symbol">(</span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">value</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">value_free</span><span class="symbol">)</span><span class="normal">         </span><span class="symbol">(</span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">value</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">value_copy</span><span class="symbol">)</span><span class="normal">         </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">src_value</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">dest_value</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="comment">/* varargs functionality (optional) */</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">value_peek_pointer</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="usertype">gchar</span><span class="normal">            </span><span class="symbol">*</span><span class="normal">collect_format</span><span class="symbol">;</span>
-<span class="normal">  <a href="../glib/glib-Basic-Types.html#gchar">gchar</a></span><span class="symbol">*</span><span class="normal">   </span><span class="symbol">(*</span><span class="normal">collect_value</span><span class="symbol">)</span><span class="normal">      </span><span class="symbol">(</span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">guint</span><span class="normal">         n_collect_values</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">GTypeCValue</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">collect_values</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">guint</span><span class="normal">                collect_flags</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="usertype">gchar</span><span class="normal">            </span><span class="symbol">*</span><span class="normal">lcopy_format</span><span class="symbol">;</span>
-<span class="normal">  <a href="../glib/glib-Basic-Types.html#gchar">gchar</a></span><span class="symbol">*</span><span class="normal">   </span><span class="symbol">(*</span><span class="normal">lcopy_value</span><span class="symbol">)</span><span class="normal">        </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">guint</span><span class="normal">         n_collect_values</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">GTypeCValue</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">collect_values</span><span class="symbol">,</span>
-<span class="normal">                                  </span><span class="usertype">guint</span><span class="normal">                collect_flags</span><span class="symbol">);</span>
-<span class="cbracket">}</span><span class="symbol">;</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
+          The value table used to specify these assignment functions is
+          documented in
+          <a class="link" href="gobject-Type-Information.html#GTypeValueTable" title="struct GTypeValueTable"><span class="type">GTypeValueTable</span></a>.
+        </p>
 <p>
           Interestingly, it is also very unlikely
           you will ever need to specify a value_table during type registration
           because these value_tables are inherited from the parent types for
-          non-fundamental types which means that unless you want to write a
-          fundamental type (not a great idea!), you will not need to provide
-          a new value_table since you will inherit the value_table structure
-          from your parent type.
+          non-fundamental types.
         </p>
 </div>
-<div class="footnotes">
-<br><hr style="width:100; text-align:left;margin-left: 0">
-<div id="ftn.id-1.3.3.3.7" class="footnote"><p><a href="#id-1.3.3.3.7" class="para"><sup class="para">[2] </sup></a>
-            Please note that there exists another registration function: the
-            <code class="function"><a class="link" href="gobject-Type-Information.html#g-type-register-dynamic" title="g_type_register_dynamic ()">g_type_register_dynamic</a></code>. We will not discuss this
-            function here since its use is very similar to the <code class="function">_static</code>
-            version.
-          </p></div>
-</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-intro.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Background: 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="pt01.html" title="Part I. Concepts">
 <link rel="next" href="ch01s02.html" title="Exporting a C API">
-<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">
@@ -54,7 +54,7 @@
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="id-1.3.2.5"></a>Data types and programming</h2></div></div></div>
 <p>
-      One could say (I have seen such definitions used in some textbooks on programming language theory)
+      One could say
       that a programming language is merely a way to create data types and manipulate them. Most languages
       provide a number of language-native types and a few primitives to create more complex types based
       on these primitive types.
@@ -63,7 +63,7 @@
       In C, the language provides types such as <span class="emphasis"><em>char</em></span>, <span class="emphasis"><em>long</em></span>,
       <span class="emphasis"><em>pointer</em></span>. During compilation of C code, the compiler maps these
       language types to the compiler's target architecture machine types. If you are using a C interpreter
-      (I have never seen one myself but it is possible :), the interpreter (the program which interprets
+      (assuming one exists), the interpreter (the program which interprets
       the source code and executes it) maps the language types to the machine types of the target machine at
       runtime, during the program execution (or just before execution if it uses a Just In Time compiler engine).
     </p>
@@ -81,8 +81,8 @@
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">my $tmp </span><span class="symbol">=</span><span class="normal"> </span><span class="number">10</span><span class="symbol">;</span>
-<span class="normal">print </span><span class="string">"this is an integer converted to a string:"</span><span class="normal"> </span><span class="symbol">.</span><span class="normal"> $tmp </span><span class="symbol">.</span><span class="normal"> </span><span class="string">"</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">my $tmp <span class="gtkdoc opt">=</span> <span class="number">10</span><span class="gtkdoc opt">;</span>
+print <span class="string">&quot;this is an integer converted to a string:&quot;</span> <span class="gtkdoc opt">.</span> $tmp <span class="gtkdoc opt">.</span> <span class="string">&quot;</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -95,7 +95,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-signal.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>The GObject messaging system: 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="gobject-properties.html" title="Object properties">
 <link rel="next" href="signal.html" title="Signals">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -54,7 +54,7 @@
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">return_type</span><span class="normal"> </span><span class="function">function_callback</span><span class="normal"> </span><span class="symbol">(...</span><span class="normal"> </span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">return_type <span class="function">function_callback</span> <span class="gtkdoc opt">(</span>… <span class="gtkdoc opt">,</span> gpointer user_data<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -64,7 +64,7 @@
         </p>
 </li>
 <li class="listitem"><p>
-           the user_data pointer which is passed to the callback upon invocation of the closure
+           the <em class="parameter"><code>user_data</code></em> pointer which is passed to the callback upon invocation of the closure
           </p></li>
 <li class="listitem"><p>
            a function pointer which represents the destructor of the closure: whenever the
@@ -76,9 +76,9 @@
     </p>
 <p>
       The <a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure"><span class="type">GClosure</span></a> structure represents the common functionality of all
-      closure implementations: there exists a different Closure implementation for
+      closure implementations: there exists a different closure implementation for
       each separate runtime which wants to use the GObject type system.
-      <a href="#ftn.id-1.3.5.2.3.2" class="footnote" name="id-1.3.5.2.3.2"><sup class="footnote">[6]</sup></a>
+      <a href="#ftn.id-1.3.5.2.3.2" class="footnote" name="id-1.3.5.2.3.2"><sup class="footnote">[4]</sup></a>
       The GObject library provides a simple <a class="link" href="gobject-Closures.html#GCClosure" title="struct GCClosure"><span class="type">GCClosure</span></a> type which
       is a specific implementation of closures to be used with C/C++ callbacks.
     </p>
@@ -101,7 +101,7 @@
           events (<code class="function"><a class="link" href="gobject-Closures.html#g-closure-remove-finalize-notifier" title="g_closure_remove_finalize_notifier ()">g_closure_remove_finalize_notifier</a></code> and
           <code class="function"><a class="link" href="gobject-Closures.html#g-closure-remove-invalidate-notifier" title="g_closure_remove_invalidate_notifier ()">g_closure_remove_invalidate_notifier</a></code>) but not for the invocation
           process.
-          <a href="#ftn.id-1.3.5.2.4.2.2.1.6" class="footnote" name="id-1.3.5.2.4.2.2.1.6"><sup class="footnote">[7]</sup></a></p></li>
+          <a href="#ftn.id-1.3.5.2.4.2.2.1.6" class="footnote" name="id-1.3.5.2.4.2.2.1.6"><sup class="footnote">[5]</sup></a></p></li>
 </ul></div>
 <p>
     </p>
@@ -112,47 +112,25 @@
         If you are using C or C++
         to connect a callback to a given event, you will either use simple <a class="link" href="gobject-Closures.html#GCClosure" title="struct GCClosure"><span class="type">GCClosure</span></a>s
         which have a pretty minimal API or the even simpler <code class="function"><a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a></code>
-        functions (which will be presented a bit later :).
-</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</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span><span class="normal">             </span><span class="symbol">(</span><span class="usertype">GCallback</span><span class="normal">      callback_func</span><span class="symbol">,</span>
-<span class="normal">                                      </span><span class="usertype">gpointer</span><span class="normal">       user_data</span><span class="symbol">,</span>
-<span class="normal">                                      </span><span class="usertype">GClosureNotify</span><span class="normal"> destroy_data</span><span class="symbol">);</span>
-<span class="usertype">GClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="function"><a href="gobject-Closures.html#g-cclosure-new-swap">g_cclosure_new_swap</a></span><span class="normal">        </span><span class="symbol">(</span><span class="usertype">GCallback</span><span class="normal">      callback_func</span><span class="symbol">,</span>
-<span class="normal">                                      </span><span class="usertype">gpointer</span><span class="normal">       user_data</span><span class="symbol">,</span>
-<span class="normal">                                      </span><span class="usertype">GClosureNotify</span><span class="normal"> destroy_data</span><span class="symbol">);</span>
-<span class="usertype">GClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="function"><a href="gobject-Signals.html#g-signal-type-cclosure-new">g_signal_type_cclosure_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GType</span><span class="normal">          itype</span><span class="symbol">,</span>
-<span class="normal">                                      </span><span class="usertype">guint</span><span class="normal">          struct_offset</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
+        functions (which will be presented a bit later).
       </p>
 <p>
         <code class="function"><a class="link" href="gobject-Closures.html#g-cclosure-new" title="g_cclosure_new ()">g_cclosure_new</a></code> will create a new closure which can invoke the
-        user-provided callback_func with the user-provided user_data as last parameter. When the closure
-        is finalized (second stage of the destruction process), it will invoke the destroy_data function
-        if the user has supplied one.
+        user-provided callback_func with the user-provided
+        <em class="parameter"><code>user_data</code></em> as its last parameter. When the closure
+        is finalized (second stage of the destruction process), it will invoke
+        the <em class="parameter"><code>destroy_data</code></em> function if the user has
+        supplied one.
       </p>
 <p>
         <code class="function"><a class="link" href="gobject-Closures.html#g-cclosure-new-swap" title="g_cclosure_new_swap ()">g_cclosure_new_swap</a></code> will create a new closure which can invoke the
-        user-provided callback_func with the user-provided user_data as first parameter (instead of being the
+        user-provided <em class="parameter"><code>callback_func</code></em> with the
+        user-provided <em class="parameter"><code>user_data</code></em> as its first parameter
+        (instead of being the
         last parameter as with <code class="function"><a class="link" href="gobject-Closures.html#g-cclosure-new" title="g_cclosure_new ()">g_cclosure_new</a></code>). When the closure
-        is finalized (second stage of the destruction process), it will invoke the destroy_data
-        function if the user has supplied one.
+        is finalized (second stage of the destruction process), it will invoke
+        the <em class="parameter"><code>destroy_data</code></em> function if the user has
+        supplied one.
       </p>
 </div>
 <div class="sect2">
@@ -171,8 +149,17 @@
         function, transform it into a GValue and return this GValue to the marshaller caller.
       </p>
 <p>
-        The following code implements a simple marshaller in C for a C function which takes an
-        integer as first parameter and returns void.
+        A generic C closure marshaller is available as
+        <a class="link" href="gobject-Closures.html#g-cclosure-marshal-generic" title="g_cclosure_marshal_generic ()"><code class="function">g_cclosure_marshal_generic</code></a>
+        which implements marshalling for all function types using libffi. Custom
+        marshallers for different types are not needed apart from performance
+        critical code where the libffi-based marshaller may be too slow.
+      </p>
+<p>
+        An example of a custom marshaller is given below, illustrating how
+        <span class="type">GValue</span>s can be converted to a C function call. The
+        marshaller is for a C function which takes an integer as its first
+        parameter and returns void.
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -203,31 +190,31 @@
 23
 24
 25</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Closures.html#g-cclosure-marshal-VOID--INT">g_cclosure_marshal_VOID__INT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GClosure</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">closure</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">return_value</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">guint</span><span class="normal">         n_param_values</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">param_values</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">gpointer</span><span class="normal">      invocation_hint</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">gpointer</span><span class="normal">      marshal_data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">typedef</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal">GMarshalFunc_VOID__INT</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">     data1</span><span class="symbol">,</span>
-<span class="normal">                                          </span><span class="usertype">gint</span><span class="normal">         arg_1</span><span class="symbol">,</span>
-<span class="normal">                                          </span><span class="usertype">gpointer</span><span class="normal">     data2</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">register</span><span class="normal"> </span><span class="usertype">GMarshalFunc_VOID__INT</span><span class="normal"> callback</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="keyword">register</span><span class="normal"> </span><span class="usertype">GCClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cc </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gobject-Closures.html#GCClosure">GCClosure</a></span><span class="symbol">*)</span><span class="normal"> closure</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="keyword">register</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data1</span><span class="symbol">,</span><span class="normal"> data2</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Closures.html#g-cclosure-marshal-VOID--INT">g_cclosure_marshal_VOID__INT</a></span> <span class="gtkdoc opt">(</span>GClosure     <span class="gtkdoc opt">*</span>closure<span class="gtkdoc opt">,</span>
+                              GValue       <span class="gtkdoc opt">*</span>return_value<span class="gtkdoc opt">,</span>
+                              guint         n_param_values<span class="gtkdoc opt">,</span>
+                              <span class="gtkdoc kwb">const</span> GValue <span class="gtkdoc opt">*</span>param_values<span class="gtkdoc opt">,</span>
+                              gpointer      invocation_hint<span class="gtkdoc opt">,</span>
+                              gpointer      marshal_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">void</span> <span class="gtkdoc opt">(*</span>GMarshalFunc_VOID__INT<span class="gtkdoc opt">) (</span>gpointer     data1<span class="gtkdoc opt">,</span>
+                                          gint         arg_1<span class="gtkdoc opt">,</span>
+                                          gpointer     data2<span class="gtkdoc opt">);</span>
+  <span class="gtkdoc kwc">register</span> GMarshalFunc_VOID__INT callback<span class="gtkdoc opt">;</span>
+  <span class="gtkdoc kwc">register</span> GCClosure <span class="gtkdoc opt">*</span>cc <span class="gtkdoc opt">= (</span>GCClosure<span class="gtkdoc opt">*)</span> closure<span class="gtkdoc opt">;</span>
+  <span class="gtkdoc kwc">register</span> gpointer data1<span class="gtkdoc opt">,</span> data2<span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">n_param_values </span><span class="symbol">==</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span>
+  <span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span> <span class="gtkdoc opt">(</span>n_param_values <span class="gtkdoc opt">==</span> <span class="number">2</span><span class="gtkdoc opt">);</span>
-<span class="normal">  data1 </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Generic-values.html#g-value-peek-pointer">g_value_peek_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">param_values </span><span class="symbol">+</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
-<span class="normal">  data2 </span><span class="symbol">=</span><span class="normal"> closure</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">;</span>
+  data1 <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Generic-values.html#g-value-peek-pointer">g_value_peek_pointer</a></span> <span class="gtkdoc opt">(</span>param_values <span class="gtkdoc opt">+</span> <span class="number">0</span><span class="gtkdoc opt">);</span>
+  data2 <span class="gtkdoc opt">=</span> closure<span class="gtkdoc opt">-&gt;</span>data<span class="gtkdoc opt">;</span>
-<span class="normal">  callback </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GMarshalFunc_VOID__INT</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">marshal_data </span><span class="symbol">?</span><span class="normal"> marshal_data </span><span class="symbol">:</span><span class="normal"> cc</span><span class="symbol">-&gt;</span><span class="normal">callback</span><span class="symbol">);</span>
+  callback <span class="gtkdoc opt">= (</span>GMarshalFunc_VOID__INT<span class="gtkdoc opt">) (</span>marshal_data ? marshal_data <span class="gtkdoc opt">:</span> cc<span class="gtkdoc opt">-&gt;</span>callback<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="function">callback</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data1</span><span class="symbol">,</span>
-<span class="normal">            </span><span class="function">g_marshal_value_peek_int</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">param_values </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="symbol">),</span>
-<span class="normal">            data2</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="function">callback</span> <span class="gtkdoc opt">(</span>data1<span class="gtkdoc opt">,</span>
+            <span class="function">g_marshal_value_peek_int</span> <span class="gtkdoc opt">(</span>param_values <span class="gtkdoc opt">+</span> <span class="number">1</span><span class="gtkdoc opt">),</span>
+            data2<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -236,19 +223,17 @@
 <p>
       </p>
 <p>
-        Of course, there exist other kinds of marshallers. For example, James Henstridge
-        wrote a generic Python marshaller which is used by all Python closures (a Python closure
-        is used to have Python-based callback be invoked by the closure invocation process).
-        This Python marshaller transforms the input GValue list representing the function
-        parameters into a Python tuple which is the equivalent structure in Python (you can
-        look in <code class="function">pyg_closure_marshal</code> in <code class="filename">pygtype.c</code>
-        in the <span class="emphasis"><em>pygobject</em></span> module in the GNOME source code repository).
+        There exist other kinds of marshallers, for example there is a generic
+        Python marshaller which is used by all Python closures (a Python closure
+        is used to invoke a callback written in Python). This Python marshaller
+        transforms the input GValue list representing the function parameters
+        into a Python tuple which is the equivalent structure in Python.
       </p>
 </div>
 </div>
 <div class="footnotes">
 <br><hr style="width:100; text-align:left;margin-left: 0">
-<div id="ftn.id-1.3.5.2.3.2" class="footnote"><p><a href="#id-1.3.5.2.3.2" class="para"><sup class="para">[6] </sup></a>
+<div id="ftn.id-1.3.5.2.3.2" class="footnote"><p><a href="#id-1.3.5.2.3.2" class="para"><sup class="para">[4] </sup></a>
         In practice, closures sit at the boundary of language runtimes: if you are
         writing Python code and one of your Python callbacks receives a signal from
         a GTK+ widget, the C code in GTK+ needs to execute your Python
@@ -256,14 +241,13 @@
         it behaves as a normal C object for GTK+ and as a normal Python object for
         Python code.
       </p></div>
-<div id="ftn.id-1.3.5.2.4.2.2.1.6" class="footnote"><p><a href="#id-1.3.5.2.4.2.2.1.6" class="para"><sup class="para">[7] </sup></a>
+<div id="ftn.id-1.3.5.2.4.2.2.1.6" class="footnote"><p><a href="#id-1.3.5.2.4.2.2.1.6" class="para"><sup class="para">[5] </sup></a>
             Closures are reference counted and notify listeners of their destruction in a two-stage
             process: the invalidation notifiers are invoked before the finalization notifiers.
           </p></div>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>