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

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

Files changed (1058) hide show

data/vendor/local/share/gtk-doc/html/gobject/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>