RubyGems - glib2 - Versions diffs - 2.0.0-x86-mingw32 → 2.0.1-x86-mingw32 - Mend

glib2 2.0.0-x86-mingw32 → 2.0.1-x86-mingw32

Files changed (1463) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Testing</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Bookmark-file-parser.html" title="Bookmark file parser">
@@ -201,7 +201,7 @@ and test cases implicitly. A simple call like
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-test-add-func">g_test_add_func</a></span> (<span class="number">&quot;/misc/assertions&quot;</span>, test_assertions);</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-test-add-func">g_test_add_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/misc/assertions"</span><span class="symbol">,</span><span class="normal"> test_assertions</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1080,9 +1080,9 @@ callback A before callback B will cause <code class="function">B()</code> to be
 <a name="g-test-queue-unref"></a><h3>g_test_queue_unref()</h3>
 <pre class="programlisting">#define             g_test_queue_unref(gobject)</pre>
 <p>
-Enqueue an object to be released with <code class="function">g_object_unref()</code> during
+Enqueue an object to be released with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> during
 the next teardown phase. This is equivalent to calling
-<a class="link" href="glib-Testing.html#g-test-queue-destroy" title="g_test_queue_destroy ()"><code class="function">g_test_queue_destroy()</code></a> with a destroy callback of <code class="function">g_object_unref()</code>.
+<a class="link" href="glib-Testing.html#g-test-queue-destroy" title="g_test_queue_destroy ()"><code class="function">g_test_queue_destroy()</code></a> with a destroy callback of <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
@@ -1134,14 +1134,14 @@ For example:
 6
 7
 8</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> g_main_context_push_thread_default() should fail if the</span>
-<span class="comment">   * context is already owned by another thread.</span>
-<span class="comment">   </span><span class="comment">*/</span>
-  g_test_expect_message (<span class="number">G_LOG_DOMAIN</span>,
-                         <span class="number">G_LOG_LEVEL_CRITICAL</span>,
-                         <span class="number">&quot;assertion*acquired_context*failed&quot;</span>);
-  <span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">g_main_context_push_thread_default</a></span> (bad_context);
-  g_test_assert_expected_messages ();</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/* g_main_context_push_thread_default() should fail if the</span>
+<span class="comment"> * context is already owned by another thread.</span>
+<span class="comment"> */</span>
+<span class="function"><a href="glib-Testing.html#g-test-expect-message">g_test_expect_message</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Message-Logging.html#G-LOG-DOMAIN:CAPS">G_LOG_DOMAIN</a></span><span class="symbol">,</span>
+<span class="normal">                       <a href="glib-Message-Logging.html#G-LOG-LEVEL-CRITICAL:CAPS">G_LOG_LEVEL_CRITICAL</a></span><span class="symbol">,</span>
+<span class="normal">                       </span><span class="string">"assertion*acquired_context*failed"</span><span class="symbol">);</span>
+<span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">g_main_context_push_thread_default</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bad_context</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Testing.html#g-test-assert-expected-messages">g_test_assert_expected_messages</a></span><span class="normal"> </span><span class="symbol">();</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1271,19 +1271,19 @@ termination and validates child program outputs.
 11
 12
 13</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span>
-  test_fork_patterns (<span class="type">void</span>)
-  {
-    <span class="keyword">if</span> (<span class="function"><a href="glib-Testing.html#g-test-trap-fork">g_test_trap_fork</a></span> (<span class="number">0</span>, <span class="number">G_TEST_TRAP_SILENCE_STDOUT</span> | <span class="number">G_TEST_TRAP_SILENCE_STDERR</span>))
-      {
-        <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> (<span class="number">&quot;some stdout text: somagic17</span><span class="symbol">\n</span><span class="number">&quot;</span>);
-        <span class="function"><a href="glib-Warnings-and-Assertions.html#g-printerr">g_printerr</a></span> (<span class="number">&quot;some stderr text: semagic43</span><span class="symbol">\n</span><span class="number">&quot;</span>);
-        exit (<span class="number">0</span>); <span class="comment">/*</span><span class="comment"> successful test run </span><span class="comment">*/</span>
-      }
-    <span class="preproc">g_test_trap_assert_passed</span>();
-    <span class="preproc">g_test_trap_assert_stdout</span> (<span class="number">&quot;*somagic17*&quot;</span>);
-    <span class="preproc">g_test_trap_assert_stderr</span> (<span class="number">&quot;*semagic43*&quot;</span>);
-  }</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="function">test_fork_patterns</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="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Testing.html#g-test-trap-fork">g_test_trap_fork</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Testing.html#G-TEST-TRAP-SILENCE-STDOUT:CAPS">G_TEST_TRAP_SILENCE_STDOUT</a> </span><span class="symbol">|</span><span class="normal"> <a href="glib-Testing.html#G-TEST-TRAP-SILENCE-STDERR:CAPS">G_TEST_TRAP_SILENCE_STDERR</a></span><span class="symbol">))</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"some stdout text: somagic17</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
+<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-printerr">g_printerr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"some stderr text: semagic43</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
+<span class="normal">      </span><span class="function">exit</span><span class="normal"> </span><span class="symbol">(</span><span class="number">0</span><span class="symbol">);</span><span class="normal"> </span><span class="comment">/* successful test run */</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-passed">g_test_trap_assert_passed</a></span><span class="symbol">();</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-stdout">g_test_trap_assert_stdout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"*somagic17*"</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-stderr">g_test_trap_assert_stderr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"*semagic43*"</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1660,7 +1660,7 @@ includes the actual values of <em class="parameter"><code>s1</code></em> and <em
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">g_assert_cmpstr</span> (mystring, ==, <span class="number">&quot;fubar&quot;</span>);</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mystring</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">==,</span><span class="normal"> </span><span class="string">"fubar"</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>

data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>The Main Event Loop</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-core.html" title="GLib Core Application Support">
@@ -284,8 +284,8 @@ boxes. Note that event sources are associated with a particular
 loops associated with that GMainContext.
 </p>
 <p>
-GTK+ contains wrappers of some of these functions, e.g. <code class="function">gtk_main()</code>,
-<code class="function">gtk_main_quit()</code> and <code class="function">gtk_events_pending()</code>.
+GTK+ contains wrappers of some of these functions, e.g. <a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-main"><code class="function">gtk_main()</code></a>,
+<a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-main-quit"><code class="function">gtk_main_quit()</code></a> and <a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-events-pending"><code class="function">gtk_events_pending()</code></a>.
 </p>
 <p>
 </p>
@@ -1568,33 +1568,33 @@ Imagine an extremely simple "garbage collected" system.
 25
 26
 27</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">GList</span> *free_list;
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">free_list</span><span class="symbol">;</span>
-<span class="type">gpointer</span>
-allocate_memory (<span class="type">gsize</span> size)
-{
-  <span class="type">gpointer</span> result = <span class="function"><a href="glib-Memory-Allocation.html#g-malloc">g_malloc</a></span> (size);
-  free_list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span> (free_list, result);
-  <span class="keyword">return</span> result;
-}
+<span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
+<span class="function">allocate_memory</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gsize</span><span class="normal"> size</span><span class="symbol">)</span>
+<span class="cbracket">{</span><span class="normal"> </span>
+<span class="normal">  </span><span class="usertype">gpointer</span><span class="normal"> result </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-malloc">g_malloc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">size</span><span class="symbol">);</span>
+<span class="normal">  free_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">free_list</span><span class="symbol">,</span><span class="normal"> result</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> result</span><span class="symbol">;</span>
+<span class="cbracket">}</span>
 <span class="type">void</span>
-free_allocated_memory (<span class="type">void</span>)
-{
-  <span class="type">GList</span> *l;
-  <span class="keyword">for</span> (l = free_list; l; l = l-&gt;next);
-    <span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span> (l-&gt;data);
-  <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span> (free_list);
-  free_list = <span class="number">NULL</span>;
- }
+<span class="function">free_allocated_memory</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">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">l</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">l </span><span class="symbol">=</span><span class="normal"> free_list</span><span class="symbol">;</span><span class="normal"> l</span><span class="symbol">;</span><span class="normal"> l </span><span class="symbol">=</span><span class="normal"> l</span><span class="symbol">-&gt;</span><span class="normal">next</span><span class="symbol">);</span>
+<span class="normal">    </span><span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">l</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">free_list</span><span class="symbol">);</span>
+<span class="normal">  free_list </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="normal"> </span><span class="cbracket">}</span>
-[...]
+<span class="symbol">[...]</span>
-<span class="keyword">while</span> (<span class="number">TRUE</span>);
- {
-   <span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-context-iteration">g_main_context_iteration</a></span> (<span class="number">NULL</span>, <span class="number">TRUE</span>);
-   free_allocated_memory();
-  }</pre></td>
+<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span><span class="normal"> </span>
+<span class="normal"> </span><span class="cbracket">{</span>
+<span class="normal">   </span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-context-iteration">g_main_context_iteration</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
+<span class="normal">   </span><span class="function">free_allocated_memory</span><span class="symbol">();</span>
+<span class="normal">  </span><span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1646,36 +1646,36 @@ recursive callback. This can be fixed by using <a class="link" href="glib-The-Ma
 28
 29
 30</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span>
-allocate_memory (<span class="type">gsize</span> size)
-{
-  FreeListBlock *block = <span class="preproc">g_new</span> (FreeListBlock, <span class="number">1</span>);
-  block-&gt;mem = <span class="function"><a href="glib-Memory-Allocation.html#g-malloc">g_malloc</a></span> (size);
-  block-&gt;depth = <span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-depth">g_main_depth</a></span> ();
-  free_list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span> (free_list, block);
-  <span class="keyword">return</span> block-&gt;mem;
-}
+        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
+<span class="function">allocate_memory</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gsize</span><span class="normal"> size</span><span class="symbol">)</span>
+<span class="cbracket">{</span><span class="normal"> </span>
+<span class="normal">  </span><span class="usertype">FreeListBlock</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">block </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">FreeListBlock</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
+<span class="normal">  block</span><span class="symbol">-&gt;</span><span class="normal">mem </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-malloc">g_malloc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">size</span><span class="symbol">);</span>
+<span class="normal">  block</span><span class="symbol">-&gt;</span><span class="normal">depth </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-depth">g_main_depth</a></span><span class="normal"> </span><span class="symbol">();</span><span class="normal">   </span>
+<span class="normal">  free_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">free_list</span><span class="symbol">,</span><span class="normal"> block</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> block</span><span class="symbol">-&gt;</span><span class="normal">mem</span><span class="symbol">;</span>
+<span class="cbracket">}</span>
 <span class="type">void</span>
-free_allocated_memory (<span class="type">void</span>)
-{
-  <span class="type">GList</span> *l;
-  <span class="type">int</span> depth = <span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-depth">g_main_depth</a></span> ();
-  <span class="keyword">for</span> (l = free_list; l; );
-    {
-      <span class="type">GList</span> *next = l-&gt;next;
-      FreeListBlock *block = l-&gt;data;
-      <span class="keyword">if</span> (block-&gt;depth &gt; depth)
-        {
-          <span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span> (block-&gt;mem);
-          <span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span> (block);
-          free_list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-delete-link">g_list_delete_link</a></span> (free_list, l);
-        }
-      l = next;
-    }
-  }</pre></td>
+<span class="function">free_allocated_memory</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">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">l</span><span class="symbol">;</span>
+<span class="normal">  </span>
+<span class="normal">  </span><span class="type">int</span><span class="normal"> depth </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-depth">g_main_depth</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">l </span><span class="symbol">=</span><span class="normal"> free_list</span><span class="symbol">;</span><span class="normal"> l</span><span class="symbol">;</span><span class="normal"> </span><span class="symbol">);</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">next </span><span class="symbol">=</span><span class="normal"> l</span><span class="symbol">-&gt;</span><span class="normal">next</span><span class="symbol">;</span>
+<span class="normal">      </span><span class="usertype">FreeListBlock</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">block </span><span class="symbol">=</span><span class="normal"> l</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">;</span>
+<span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">block</span><span class="symbol">-&gt;</span><span class="normal">depth </span><span class="symbol">&gt;</span><span class="normal"> depth</span><span class="symbol">)</span>
+<span class="normal">        </span><span class="cbracket">{</span>
+<span class="normal">          </span><span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">block</span><span class="symbol">-&gt;</span><span class="normal">mem</span><span class="symbol">);</span>
+<span class="normal">          </span><span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">block</span><span class="symbol">);</span>
+<span class="normal">          free_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-delete-link">g_list_delete_link</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">free_list</span><span class="symbol">,</span><span class="normal"> l</span><span class="symbol">);</span>
+<span class="normal">        </span><span class="cbracket">}</span>
+<span class="normal">              </span>
+<span class="normal">      l </span><span class="symbol">=</span><span class="normal"> next</span><span class="symbol">;</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1700,7 +1700,7 @@ following techniques:
 </p>
 <div class="orderedlist"><ol class="orderedlist" type="1">
 <li class="listitem"><p>
-    Use <code class="function">gtk_widget_set_sensitive()</code> or modal dialogs to prevent
+    Use <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-set-sensitive"><code class="function">gtk_widget_set_sensitive()</code></a> or modal dialogs to prevent
     the user from interacting with elements while the main
     loop is recursing.
   </p></li>
@@ -1971,7 +1971,7 @@ started while the non-default context is active.
 <p>
 Beware that libraries that predate this function may not correctly
 handle being used from a thread with a thread-default context. Eg,
-see <code class="function">g_file_supports_thread_contexts()</code>.
+see <a href="../gio/GFile.html#g-file-supports-thread-contexts"><code class="function">g_file_supports_thread_contexts()</code></a>.
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
@@ -2846,7 +2846,7 @@ representing an event source.
 <a name="GSourceDummyMarshal"></a><h3>GSourceDummyMarshal ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                (*GSourceDummyMarshal)              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>
-This is just a placeholder for <span class="type">GClosureMarshal</span>,
+This is just a placeholder for <a href="../gobject/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a>,
 which cannot be used here for dependency reasons.
 </p>
 </div>
@@ -3147,35 +3147,35 @@ before the dispatch of your idle handler.
 27
 28
 29</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">gboolean</span>
-idle_callback (<span class="type">gpointer</span> data)
-{
-  SomeWidget *self = data;
-  <span class="preproc">GDK_THREADS_ENTER</span> ();
-  <span class="comment">/*</span><span class="comment"> do stuff with self </span><span class="comment">*/</span>
-  self-&gt;idle_id = <span class="number">0</span>;
-  <span class="preproc">GDK_THREADS_LEAVE</span> ();
-  <span class="keyword">return</span> G_SOURCE_REMOVE;
-}
-<span class="type">static</span> <span class="type">void</span>
-some_widget_do_stuff_later (SomeWidget *self)
-{
-  self-&gt;idle_id = <span class="function"><a href="glib-The-Main-Event-Loop.html#g-idle-add">g_idle_add</a></span> (idle_callback, self);
-}
-<span class="type">static</span> <span class="type">void</span>
-some_widget_finalize (<span class="type">GObject</span> *object)
-{
-  SomeWidget *self = SOME_WIDGET (object);
-  <span class="keyword">if</span> (self-&gt;idle_id)
-    <span class="function"><a href="glib-The-Main-Event-Loop.html#g-source-remove">g_source_remove</a></span> (self-&gt;idle_id);
-  <span class="preproc">G_OBJECT_CLASS</span> (parent_class)-&gt;finalize (object);
-}</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="glib-Basic-Types.html#gboolean">gboolean</a> </span>
+<span class="function">idle_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">SomeWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="normal">   </span>
+<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gdk3/gdk2-Threads.html#GDK-THREADS-ENTER:CAPS">GDK_THREADS_ENTER</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span><span class="comment">/* do stuff with self */</span>
+<span class="normal">  self</span><span class="symbol">-&gt;</span><span class="normal">idle_id </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gdk3/gdk2-Threads.html#GDK-THREADS-LEAVE:CAPS">GDK_THREADS_LEAVE</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">   </span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="glib-The-Main-Event-Loop.html#G-SOURCE-REMOVE:CAPS">G_SOURCE_REMOVE</a></span><span class="symbol">;</span>
+<span class="cbracket">}</span>
+<span class="normal"> </span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span>
+<span class="function">some_widget_do_stuff_later</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">SomeWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  self</span><span class="symbol">-&gt;</span><span class="normal">idle_id </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-idle-add">g_idle_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">idle_callback</span><span class="symbol">,</span><span class="normal"> self</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
+<span class="normal"> </span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span>
+<span class="function">some_widget_finalize</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">object</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">SomeWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self </span><span class="symbol">=</span><span class="normal"> </span><span class="function">SOME_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
+<span class="normal">   </span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">-&gt;</span><span class="normal">idle_id</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-source-remove">g_source_remove</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">self</span><span class="symbol">-&gt;</span><span class="normal">idle_id</span><span class="symbol">);</span>
+<span class="normal">   </span>
+<span class="normal">  </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">parent_class</span><span class="symbol">)-&gt;</span><span class="function">finalize</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -3210,20 +3210,20 @@ has already been destroy within the callback.
 12
 13
 14</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">gboolean</span>
-idle_callback (<span class="type">gpointer</span> data)
-{
-  SomeWidget *self = data;
-  <span class="preproc">GDK_THREADS_ENTER</span> ();
-  <span class="keyword">if</span> (!<span class="function"><a href="glib-The-Main-Event-Loop.html#g-source-is-destroyed">g_source_is_destroyed</a></span> (<span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-current-source">g_main_current_source</a></span> ()))
-    {
-      <span class="comment">/*</span><span class="comment"> do stuff with self </span><span class="comment">*/</span>
-    }
-  <span class="preproc">GDK_THREADS_LEAVE</span> ();
-  <span class="keyword">return</span> <span class="number">FALSE</span>;
-}</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="glib-Basic-Types.html#gboolean">gboolean</a> </span>
+<span class="function">idle_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">SomeWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">self </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="normal">  </span>
+<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gdk3/gdk2-Threads.html#GDK-THREADS-ENTER:CAPS">GDK_THREADS_ENTER</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-source-is-destroyed">g_source_is_destroyed</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-current-source">g_main_current_source</a></span><span class="normal"> </span><span class="symbol">()))</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      </span><span class="comment">/* do stuff with self */</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gdk3/gdk2-Threads.html#GDK-THREADS-LEAVE:CAPS">GDK_THREADS_LEAVE</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -3952,7 +3952,7 @@ its own prepare/check functions indicate that it is ready.)
 </p>
 <p>
 If you don't need <em class="parameter"><code>child_source</code></em> to do anything on its own when it
-triggers, you can call <code class="function">g_source_set_dummy_callback()</code> on it to set a
+triggers, you can call <a href="../gobject/gobject-Closures.html#g-source-set-dummy-callback"><code class="function">g_source_set_dummy_callback()</code></a> on it to set a
 callback that does nothing (except return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if appropriate).
 </p>
 <p>

data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Thread Pools</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Threads.html" title="Threads">

data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Threads</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-The-Main-Event-Loop.html" title="The Main Event Loop">
@@ -230,7 +230,7 @@ you must coordinate accesses to the same <a class="link" href="glib-Hash-Tables.
 threads. The two notable exceptions from this rule are <a class="link" href="glib-The-Main-Event-Loop.html#GMainLoop" title="GMainLoop"><span class="type">GMainLoop</span></a>
 and <a class="link" href="glib-Asynchronous-Queues.html#GAsyncQueue" title="GAsyncQueue"><span class="type">GAsyncQueue</span></a>, which <span class="emphasis"><em>are</em></span> thread-safe and
 need no further application-level locking to be accessed from
-multiple threads. Most refcounting functions such as <code class="function">g_object_ref()</code>
+multiple threads. Most refcounting functions such as <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>
 are also thread-safe.
 </p>
 </div>
@@ -625,17 +625,17 @@ access. Take for example the following function:
 11
 12</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
-  give_me_next_number (<span class="type">void</span>)
-  {
-    <span class="type">static</span> <span class="type">int</span> current_number = <span class="number">0</span>;
+<span class="function">give_me_next_number</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="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-    <span class="comment">/*</span><span class="comment"> now do a very complicated calculation to calculate the new</span>
-<span class="comment">     * number, this might for example be a random number generator</span>
-<span class="comment">     </span><span class="comment">*/</span>
-    current_number = calc_next_number (current_number);
+<span class="normal">  </span><span class="comment">/* now do a very complicated calculation to calculate the new</span>
+<span class="comment">   * number, this might for example be a random number generator</span>
+<span class="comment">   */</span>
+<span class="normal">  current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
-    <span class="keyword">return</span> current_number;
-  }</pre></td>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> current_number</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -671,18 +671,18 @@ access. A <a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><
 12
 13</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
-  give_me_next_number (<span class="type">void</span>)
-  {
-    <span class="type">static</span> <span class="type">GMutex</span> mutex;
-    <span class="type">static</span> <span class="type">int</span> current_number = <span class="number">0</span>;
-    <span class="type">int</span> ret_val;
-    <span class="preproc">g_mutex_lock</span> (&amp;mutex);
-    ret_val = current_number = calc_next_number (current_number);
-    <span class="preproc">g_mutex_unlock</span> (&amp;mutex);
-    <span class="keyword">return</span> ret_val;
-  }</pre></td>
+<span class="function">give_me_next_number</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="keyword">static</span><span class="normal"> </span><span class="usertype">GMutex</span><span class="normal"> mutex</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">mutex</span><span class="symbol">);</span>
+<span class="normal">  ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">mutex</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -733,15 +733,15 @@ statically allocated.
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">typedef</span> <span class="type">struct</span> {
-    <span class="type">GMutex</span> m;
-    ...
-  } Blob;
+        <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="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GMutex</span><span class="normal"> m</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="symbol">...</span>
+<span class="cbracket">}</span><span class="normal"> Blob</span><span class="symbol">;</span>
-Blob *b;
+<span class="usertype">Blob</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
-b = <span class="preproc">g_new</span> (Blob, <span class="number">1</span>);
-g_mutex_init (&amp;b-&gt;m);</pre></td>
+<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">Blob</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Threads.html#g-mutex-init">g_mutex_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b</span><span class="symbol">-&gt;</span><span class="normal">m</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -932,20 +932,20 @@ of the variable you intend to protect with the lock. Look at our
 12
 13
 14</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">G_LOCK_DEFINE</span> (current_number);
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Threads.html#G-LOCK-DEFINE:CAPS">G_LOCK_DEFINE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
-  <span class="type">int</span>
-  give_me_next_number (<span class="type">void</span>)
-  {
-    <span class="type">static</span> <span class="type">int</span> current_number = <span class="number">0</span>;
-    <span class="type">int</span> ret_val;
+<span class="type">int</span>
+<span class="function">give_me_next_number</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="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
-    <span class="preproc">G_LOCK</span> (current_number);
-    ret_val = current_number = calc_next_number (current_number);
-    <span class="preproc">G_UNLOCK</span> (current_number);
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#G-LOCK:CAPS">G_LOCK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
+<span class="normal">  ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#G-UNLOCK:CAPS">G_UNLOCK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
-    <span class="keyword">return</span> ret_val;
-  }</pre></td>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1126,15 +1126,15 @@ statically allocated.
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">typedef</span> <span class="type">struct</span> {
-    GRecMutex m;
-    ...
-  } Blob;
+        <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="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GRecMutex</span><span class="normal"> m</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="symbol">...</span>
+<span class="cbracket">}</span><span class="normal"> Blob</span><span class="symbol">;</span>
-Blob *b;
+<span class="usertype">Blob</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
-b = <span class="preproc">g_new</span> (Blob, <span class="number">1</span>);
-g_rec_mutex_init (&amp;b-&gt;m);</pre></td>
+<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">Blob</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Threads.html#g-rec-mutex-init">g_rec_mutex_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b</span><span class="symbol">-&gt;</span><span class="normal">m</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1385,15 +1385,15 @@ allocated.
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">typedef</span> <span class="type">struct</span> {
-    GRWLock l;
-    ...
-  } Blob;
+        <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="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GRWLock</span><span class="normal"> l</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="symbol">...</span>
+<span class="cbracket">}</span><span class="normal"> Blob</span><span class="symbol">;</span>
-Blob *b;
+<span class="usertype">Blob</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
-b = <span class="preproc">g_new</span> (Blob, <span class="number">1</span>);
-g_rw_lock_init (&amp;b-&gt;l);</pre></td>
+<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">Blob</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Threads.html#g-rw-lock-init">g_rw_lock_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b</span><span class="symbol">-&gt;</span><span class="normal">l</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1662,33 +1662,33 @@ threads to wake up to collect the data.
 25
 26
 27</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span> current_data = <span class="number">NULL</span>;
-  <span class="type">GMutex</span> data_mutex;
-  <span class="type">GCond</span> data_cond;
-  <span class="type">void</span>
-  push_data (<span class="type">gpointer</span> data)
-  {
-    <span class="preproc">g_mutex_lock</span> (&amp;data_mutex);
-    current_data = data;
-    <span class="preproc">g_cond_signal</span> (&amp;data_cond);
-    <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
-  }
-  <span class="type">gpointer</span>
-  pop_data (<span class="type">void</span>)
-  {
-    <span class="type">gpointer</span> data;
-    <span class="preproc">g_mutex_lock</span> (&amp;data_mutex);
-    <span class="keyword">while</span> (!current_data)
-      <span class="preproc">g_cond_wait</span> (&amp;data_cond, &amp;data_mutex);
-    data = current_data;
-    current_data = <span class="number">NULL</span>;
-    <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">gpointer</span><span class="normal"> current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="usertype">GMutex</span><span class="normal"> data_mutex</span><span class="symbol">;</span>
+<span class="usertype">GCond</span><span class="normal"> data_cond</span><span class="symbol">;</span>
-    <span class="keyword">return</span> data;
-  }</pre></td>
+<span class="type">void</span>
+<span class="function">push_data</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">  current_data </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-cond-signal">g_cond_signal</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_cond</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
+<span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
+<span class="function">pop_data</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">gpointer</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_data</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="function"><a href="glib-Threads.html#g-cond-wait">g_cond_wait</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_cond</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">  data </span><span class="symbol">=</span><span class="normal"> current_data</span><span class="symbol">;</span>
+<span class="normal">  current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1938,31 +1938,31 @@ documentation for <a class="link" href="glib-Threads.html#GCond" title="struct G
 23
 24
 25</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span>
-pop_data_timed (<span class="type">void</span>)
-{
-  <span class="type">gint64</span> end_time;
-  <span class="type">gpointer</span> data;
-  <span class="preproc">g_mutex_lock</span> (&amp;data_mutex);
-  end_time = <span class="function"><a href="glib-Date-and-Time-Functions.html#g-get-monotonic-time">g_get_monotonic_time</a></span> () + <span class="number">5</span> * <span class="number">G_TIME_SPAN_SECOND</span>;
-  <span class="keyword">while</span> (!current_data)
-    <span class="keyword">if</span> (!g_cond_wait_until (&amp;data_cond, &amp;data_mutex, end_time))
-      {
-        <span class="comment">// timeout has passed.</span>
-        <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
-        <span class="keyword">return</span> <span class="number">NULL</span>;
-      }
-  <span class="comment">// there is data for us</span>
-  data = current_data;
-  current_data = <span class="number">NULL</span>;
-  <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
-  <span class="keyword">return</span> data;
-}</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
+<span class="function">pop_data_timed</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">gint64</span><span class="normal"> end_time</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">  end_time </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Date-and-Time-Functions.html#g-get-monotonic-time">g_get_monotonic_time</a></span><span class="normal"> </span><span class="symbol">()</span><span class="normal"> </span><span class="symbol">+</span><span class="normal"> </span><span class="number">5</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> <a href="glib-GDateTime.html#G-TIME-SPAN-SECOND:CAPS">G_TIME_SPAN_SECOND</a></span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_data</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-Threads.html#g-cond-wait-until">g_cond_wait_until</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_cond</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data_mutex</span><span class="symbol">,</span><span class="normal"> end_time</span><span class="symbol">))</span>
+<span class="normal">      </span><span class="cbracket">{</span>
+<span class="normal">        </span><span class="comment">// timeout has passed.</span>
+<span class="normal">        </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">        </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="normal">      </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="comment">// there is data for us</span>
+<span class="normal">  data </span><span class="symbol">=</span><span class="normal"> current_data</span><span class="symbol">;</span>
+<span class="normal">  current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2139,35 +2139,35 @@ examples below.
 27
 28
 29</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">GPrivate</span> name_key = G_PRIVATE_INIT (<span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span>);
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GPrivate</span><span class="normal"> name_key </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#G-PRIVATE-INIT:CAPS">G_PRIVATE_INIT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="symbol">);</span>
 <span class="comment">// return value should not be freed</span>
-<span class="type">const</span> <span class="type">gchar</span> *
-get_local_name (<span class="type">void</span>)
-{
-  <span class="keyword">return</span> <span class="preproc">g_private_get</span> (&amp;name_key);
-}
+<span class="keyword">const</span><span class="normal"> <a href="glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span>
+<span class="function">get_local_name</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="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-private-get">g_private_get</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">name_key</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
 <span class="type">void</span>
-set_local_name (<span class="type">const</span> <span class="type">gchar</span> *name)
-{
-  g_private_replace (&amp;name_key, <span class="function"><a href="glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> (name));
-}
+<span class="function">set_local_name</span><span class="normal"> </span><span class="symbol">(</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">name</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-private-replace">g_private_replace</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">name_key</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">name</span><span class="symbol">));</span>
+<span class="cbracket">}</span>
-<span class="type">static</span> <span class="type">GPrivate</span> count_key;   <span class="comment">// no free function</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="usertype">GPrivate</span><span class="normal"> count_key</span><span class="symbol">;</span><span class="normal">   </span><span class="comment">// no free function</span>
-<span class="type">gint</span>
-get_local_count (<span class="type">void</span>)
-{
-  <span class="keyword">return</span> <span class="preproc">GPOINTER_TO_INT</span> (<span class="preproc">g_private_get</span> (&amp;count_key));
-}
+<span class="normal"><a href="glib-Basic-Types.html#gint">gint</a></span>
+<span class="function">get_local_count</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="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Type-Conversion-Macros.html#GPOINTER-TO-INT:CAPS">GPOINTER_TO_INT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Threads.html#g-private-get">g_private_get</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">count_key</span><span class="symbol">));</span>
+<span class="cbracket">}</span>
 <span class="type">void</span>
-set_local_count (<span class="type">gint</span> count)
-{
-  <span class="preproc">g_private_set</span> (&amp;count_key, <span class="preproc">GINT_TO_POINTER</span> (count));
-}</pre></td>
+<span class="function">set_local_count</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gint</span><span class="normal"> count</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-private-set">g_private_set</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">count_key</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS">GINT_TO_POINTER</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">count</span><span class="symbol">));</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2369,7 +2369,7 @@ A <a class="link" href="glib-Threads.html#GOnce" title="struct GOnce"><span clas
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">GOnce</span> my_once = <span class="number">G_ONCE_INIT</span>;</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">GOnce</span><span class="normal"> my_once </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-ONCE-INIT:CAPS">G_ONCE_INIT</a></span><span class="symbol">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2414,15 +2414,15 @@ Calling <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code c
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span>
-  get_debug_flags (<span class="type">void</span>)
-  {
-    <span class="type">static</span> <span class="type">GOnce</span> my_once = <span class="number">G_ONCE_INIT</span>;
+        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
+<span class="function">get_debug_flags</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="keyword">static</span><span class="normal"> </span><span class="usertype">GOnce</span><span class="normal"> my_once </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-ONCE-INIT:CAPS">G_ONCE_INIT</a></span><span class="symbol">;</span>
-    <span class="preproc">g_once</span> (&amp;my_once, parse_debug_flags, <span class="number">NULL</span>);
+<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-once">g_once</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">my_once</span><span class="symbol">,</span><span class="normal"> parse_debug_flags</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-    <span class="keyword">return</span> my_once.retval;
-  }</pre></td>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> my_once</span><span class="symbol">.</span><span class="normal">retval</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2486,16 +2486,16 @@ like this:
 8
 9
 10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">gsize</span> initialization_value = <span class="number">0</span>;
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">gsize</span><span class="normal"> initialization_value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-  <span class="keyword">if</span> (<span class="function"><a href="glib-Threads.html#g-once-init-enter">g_once_init_enter</a></span> (&amp;initialization_value))
-    {
-      <span class="type">gsize</span> setup_value = <span class="number">42</span>; <span class="comment">/*</span><span class="comment">* initialization code here *</span><span class="comment">*/</span>
+<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Threads.html#g-once-init-enter">g_once_init_enter</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">initialization_value</span><span class="symbol">))</span>
+<span class="normal">  </span><span class="cbracket">{</span>
+<span class="normal">    </span><span class="usertype">gsize</span><span class="normal"> setup_value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">42</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/** initialization code here **/</span>
-      <span class="function"><a href="glib-Threads.html#g-once-init-leave">g_once_init_leave</a></span> (&amp;initialization_value, setup_value);
-    }
+<span class="normal">    </span><span class="function"><a href="glib-Threads.html#g-once-init-leave">g_once_init_leave</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">initialization_value</span><span class="symbol">,</span><span class="normal"> setup_value</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="cbracket">}</span>
-  <span class="comment">/*</span><span class="comment">* use initialization_value here *</span><span class="comment">*/</span></pre></td>
+<span class="comment">/** use initialization_value here **/</span></pre></td>
       </tr>
     </tbody>
   </table>