RubyGems - glib2 - Versions diffs - 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32 - Mend

glib2 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32

Files changed (1752) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-Singly-Linked-Lists.html" title="Singly-Linked Lists">
 <link rel="next" href="glib-Sequences.html" title="Sequences">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -278,7 +278,7 @@ you have to use <a class="link" href="glib-Double-ended-Queues.html#g-queue-init
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GQueue</span><span class="normal"> my_queue </span><span class="symbol">=</span><span class="normal"> <a href="glib-Double-ended-Queues.html#G-QUEUE-INIT:CAPS">G_QUEUE_INIT</a></span><span class="symbol">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">GQueue</span> my_queue = <span class="number">G_QUEUE_INIT</span>;</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1383,6 +1383,6 @@ Removes <em class="parameter"><code>link_</code></em> from <em class="parameter"
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-data-types.html" title="GLib Data Types">
 <link rel="next" href="glib-Singly-Linked-Lists.html" title="Singly-Linked Lists">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -259,16 +259,16 @@ the elements and reverse the list when all elements have been added.
 8
 9
 10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Notice that these are initialized to the empty list. */</span>
-<span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">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="symbol">*</span><span class="normal">number_list </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> Notice that these are initialized to the empty list. </span><span class="comment">*/</span>
+<span class="type">GList</span> *list = <span class="number">NULL</span>, *number_list = <span class="number">NULL</span>;
-<span class="comment">/* This is a list of strings. */</span>
-<span class="normal">list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"first"</span><span class="symbol">);</span>
-<span class="normal">list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"second"</span><span class="symbol">);</span>
+<span class="comment">/*</span><span class="comment"> This is a list of strings. </span><span class="comment">*/</span>
+list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span> (list, <span class="number">&quot;first&quot;</span>);
+list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span> (list, <span class="number">&quot;second&quot;</span>);
-<span class="comment">/* This is a list of integers. */</span>
-<span class="normal">number_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">number_list</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="number">27</span><span class="symbol">));</span>
-<span class="normal">number_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">number_list</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="number">14</span><span class="symbol">));</span></pre></td>
+<span class="comment">/*</span><span class="comment"> This is a list of integers. </span><span class="comment">*/</span>
+number_list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span> (number_list, <span class="preproc">GINT_TO_POINTER</span> (<span class="number">27</span>));
+number_list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-append">g_list_append</a></span> (number_list, <span class="preproc">GINT_TO_POINTER</span> (<span class="number">14</span>));</pre></td>
       </tr>
     </tbody>
   </table>
@@ -328,10 +328,10 @@ may have changed, so make sure you store the new value.
 2
 3
 4</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Notice that it is initialized to the empty list. */</span>
-<span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">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">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">list</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"last"</span><span class="symbol">);</span>
-<span class="normal">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">list</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"first"</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> Notice that it is initialized to the empty list. </span><span class="comment">*/</span>
+<span class="type">GList</span> *list = <span class="number">NULL</span>;
+list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span> (list, <span class="number">&quot;last&quot;</span>);
+list = <span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-prepend">g_list_prepend</a></span> (list, <span class="number">&quot;first&quot;</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -582,9 +582,9 @@ without freeing it.
 <pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList" title="struct GList"><span class="returnvalue">GList</span></a> *             g_list_remove_all                   (<em class="parameter"><code><a class="link" href="glib-Doubly-Linked-Lists.html#GList" title="struct GList"><span class="type">GList</span></a> *list</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> data</code></em>);</pre>
 <p>
-Removes all list nodes with data equal to <em class="parameter"><code>data</code></em>.
-Returns the new head of the list. Contrast with
-<a class="link" href="glib-Doubly-Linked-Lists.html#g-list-remove" title="g_list_remove ()"><code class="function">g_list_remove()</code></a> which removes only the first node
+Removes all list nodes with data equal to <em class="parameter"><code>data</code></em>.
+Returns the new head of the list. Contrast with
+<a class="link" href="glib-Doubly-Linked-Lists.html#g-list-remove" title="g_list_remove ()"><code class="function">g_list_remove()</code></a> which removes only the first node
 matching the given data.
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
@@ -819,7 +819,7 @@ For instance, if <em class="parameter"><code>list</code></em> holds a list of GO
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">another_list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-copy-deep">g_list_copy_deep</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-N-ary-Trees.html#GCopyFunc">GCopyFunc</a></span><span class="symbol">)</span><span class="normal"> <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">another_list = g_list_copy_deep (list, (<span class="type">GCopyFunc</span>) <span class="function">g_object_ref</span>, <span class="number">NULL</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -835,7 +835,7 @@ And, to entirely free the new list, you could do:
     <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-Doubly-Linked-Lists.html#g-list-free-full">g_list_free_full</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">another_list</span><span class="symbol">,</span><span class="normal"> <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Doubly-Linked-Lists.html#g-list-free-full">g_list_free_full</a></span> (another_list, <span class="function">g_object_unref</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1518,6 +1518,6 @@ or -1 if the data is not found</td>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Asynchronous-Queues.html" title="Asynchronous Queues">
 <link rel="next" href="glib-Memory-Allocation.html" title="Memory Allocation">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -101,7 +101,7 @@ it must ensure that it is never unloaded, by calling <a class="link" href="glib-
 <p>
 </p>
 <div class="example">
-<a name="idp7664592"></a><p class="title"><b>Example 7. Calling a function defined in a <span class="structname">GModule</span></b></p>
+<a name="id-1.4.6.4.8.1"></a><p class="title"><b>Example 7. Calling a function defined in a <span class="structname">GModule</span></b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -148,48 +148,48 @@ it must ensure that it is never unloaded, by calling <a class="link" href="glib-
 40
 41
 42</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="comment">/* the function signature for 'say_hello' */</span>
-<span class="keyword">typedef</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal"> SayHelloFunc</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">);</span>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span><span class="comment"> the function signature for 'say_hello' </span><span class="comment">*/</span>
+<span class="type">typedef</span> <span class="type">void</span> (* SayHelloFunc) (<span class="type">const</span> <span class="type">char</span> *message);
-<span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">just_say_hello</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">SayHelloFunc</span><span class="normal">  say_hello</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">GModule</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">module</span><span class="symbol">;</span>
+<span class="type">gboolean</span>
+just_say_hello (<span class="type">const</span> <span class="type">char</span> *filename, <span class="type">GError</span> **error)
+{
+  SayHelloFunc  say_hello;
+  <span class="type">GModule</span>      *module;
-<span class="normal">  module </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-open">g_module_open</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> <a href="glib-Dynamic-Loading-of-Modules.html#G-MODULE-BIND-LAZY:CAPS">G_MODULE_BIND_LAZY</a></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">module</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">,</span><span class="normal"> FOO_ERROR</span><span class="symbol">,</span><span class="normal"> FOO_ERROR_BLAH</span><span class="symbol">,</span>
-<span class="normal">                   </span><span class="string">"%s"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span><span class="normal"> </span><span class="symbol">());</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="normal">    </span><span class="cbracket">}</span>
+  module = <span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-open">g_module_open</a></span> (filename, <span class="number">G_MODULE_BIND_LAZY</span>);
+  <span class="keyword">if</span> (!module)
+    {
+      <span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span> (error, FOO_ERROR, FOO_ERROR_BLAH,
+                   <span class="number">&quot;</span><span class="symbol">%s</span><span class="number">&quot;</span>, <span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span> ());
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-symbol">g_module_symbol</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">module</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"say_hello"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a> </span><span class="symbol">*)&amp;</span><span class="normal">say_hello</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">,</span><span class="normal"> SAY_ERROR</span><span class="symbol">,</span><span class="normal"> SAY_ERROR_OPEN</span><span class="symbol">,</span>
-<span class="normal">                   </span><span class="string">"%s: %s"</span><span class="symbol">,</span><span class="normal"> filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</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-Dynamic-Loading-of-Modules.html#g-module-close">g_module_close</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">module</span><span class="symbol">))</span>
-<span class="normal">        </span><span class="function"><a href="glib-Message-Logging.html#g-warning">g_warning</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%s: %s"</span><span class="symbol">,</span><span class="normal"> filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span><span class="normal"> </span><span class="symbol">());</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="normal">    </span><span class="cbracket">}</span>
+  <span class="keyword">if</span> (!<span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-symbol">g_module_symbol</a></span> (module, <span class="number">&quot;say_hello&quot;</span>, (<span class="type">gpointer</span> *)&amp;say_hello))
+    {
+      <span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span> (error, SAY_ERROR, SAY_ERROR_OPEN,
+                   <span class="number">&quot;</span><span class="symbol">%s</span><span class="number">: </span><span class="symbol">%s</span><span class="number">&quot;</span>, filename, <span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span> ());
+      <span class="keyword">if</span> (!<span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-close">g_module_close</a></span> (module))
+        <span class="preproc">g_warning</span> (<span class="number">&quot;</span><span class="symbol">%s</span><span class="number">: </span><span class="symbol">%s</span><span class="number">&quot;</span>, filename, <span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span> ());
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">say_hello </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="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">,</span><span class="normal"> SAY_ERROR</span><span class="symbol">,</span><span class="normal"> SAY_ERROR_OPEN</span><span class="symbol">,</span>
-<span class="normal">                   </span><span class="string">"symbol say_hello is NULL"</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-Dynamic-Loading-of-Modules.html#g-module-close">g_module_close</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">module</span><span class="symbol">))</span>
-<span class="normal">        </span><span class="function"><a href="glib-Message-Logging.html#g-warning">g_warning</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%s: %s"</span><span class="symbol">,</span><span class="normal"> filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span><span class="normal"> </span><span class="symbol">());</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="normal">    </span><span class="cbracket">}</span>
+  <span class="keyword">if</span> (say_hello == <span class="number">NULL</span>)
+    {
+      <span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span> (error, SAY_ERROR, SAY_ERROR_OPEN,
+                   <span class="number">&quot;symbol say_hello is NULL&quot;</span>);
+      <span class="keyword">if</span> (!<span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-close">g_module_close</a></span> (module))
+        <span class="preproc">g_warning</span> (<span class="number">&quot;</span><span class="symbol">%s</span><span class="number">: </span><span class="symbol">%s</span><span class="number">&quot;</span>, filename, <span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span> ());
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
-<span class="normal">  </span><span class="comment">/* call our function in the module */</span>
-<span class="normal">  </span><span class="function">say_hello</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Hello world!"</span><span class="symbol">);</span>
+  <span class="comment">/*</span><span class="comment"> call our function in the module </span><span class="comment">*/</span>
+  say_hello (<span class="number">&quot;Hello world!&quot;</span>);
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-close">g_module_close</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">module</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="function"><a href="glib-Message-Logging.html#g-warning">g_warning</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%s: %s"</span><span class="symbol">,</span><span class="normal"> filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span><span class="normal"> </span><span class="symbol">());</span>
-<span class="normal">  </span><span class="keyword">return</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="cbracket">}</span></pre></td>
+  <span class="keyword">if</span> (!<span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-close">g_module_close</a></span> (module))
+    <span class="preproc">g_warning</span> (<span class="number">&quot;</span><span class="symbol">%s</span><span class="number">: </span><span class="symbol">%s</span><span class="number">&quot;</span>, filename, <span class="function"><a href="glib-Dynamic-Loading-of-Modules.html#g-module-error">g_module_error</a></span> ());
+  <span class="keyword">return</span> <span class="number">TRUE</span>;
+ }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -578,6 +578,6 @@ Used to declare functions imported from modules.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-IO-Channels.html" title="IO Channels">
 <link rel="next" href="glib-Warnings-and-Assertions.html" title="Message Output and Debugging Functions">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -119,10 +119,10 @@ last argument. For example:
 2
 3
 4</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gboolean</span><span class="normal"> </span><span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></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">filename</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">contents</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">gsize</span><span class="normal">        </span><span class="symbol">*</span><span class="normal">length</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">GError</span><span class="normal">      </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gboolean</span> <span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span> (<span class="type">const</span> <span class="type">gchar</span>  *filename,
+                              <span class="type">gchar</span>       **contents,
+                              <span class="type">gsize</span>        *length,
+                              <span class="type">GError</span>      **error);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -153,22 +153,22 @@ For example:
 14
 15
 16</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contents</span><span class="symbol">;</span>
-<span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">err </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="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo.txt"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">contents</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="symbol">&amp;</span><span class="normal">err</span><span class="symbol">);</span>
-<span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal">contents </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">&amp;&amp;</span><span class="normal"> err </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="symbol">||</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contents </span><span class="symbol">!=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="symbol">&amp;&amp;</span><span class="normal"> err </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">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="normal">    </span><span class="comment">/* Report error to user, and free error */</span>
-<span class="normal">    </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contents </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">fprintf</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stderr</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Unable to read file: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> err</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
-<span class="normal">    </span><span class="function"><a href="glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="cbracket">}</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gchar</span> *contents;
+<span class="type">GError</span> *err = <span class="number">NULL</span>;
+<span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span> (<span class="number">&quot;foo.txt&quot;</span>, &amp;contents, <span class="number">NULL</span>, &amp;err);
+<span class="preproc">g_assert</span> ((contents == <span class="number">NULL</span> &amp;&amp; err != <span class="number">NULL</span>) || (contents != <span class="number">NULL</span> &amp;&amp; err == <span class="number">NULL</span>));
+<span class="keyword">if</span> (err != <span class="number">NULL</span>)
+  {
+    <span class="comment">/*</span><span class="comment"> Report error to user, and free error </span><span class="comment">*/</span>
+    <span class="preproc">g_assert</span> (contents == <span class="number">NULL</span>);
+    fprintf (<span class="number">stderr</span>, <span class="number">&quot;Unable to read file: </span><span class="symbol">%s</span><span class="symbol">\n</span><span class="number">&quot;</span>, err-&gt;message);
+    <span class="function"><a href="glib-Error-Reporting.html#g-error-free">g_error_free</a></span> (err);
+  }
 <span class="keyword">else</span>
-<span class="normal">  </span><span class="cbracket">{</span>
-<span class="normal">    </span><span class="comment">/* Use file contents */</span>
-<span class="normal">    </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contents </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></pre></td>
+  {
+    <span class="comment">/*</span><span class="comment"> Use file contents </span><span class="comment">*/</span>
+    <span class="preproc">g_assert</span> (contents != <span class="number">NULL</span>);
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -194,10 +194,10 @@ argument:
 2
 3
 4</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"foo.txt"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">contents</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#NULL:CAPS">NULL</a></span><span class="symbol">))</span><span class="normal"> </span><span class="comment">/* ignore errors */</span>
-<span class="normal">  </span><span class="comment">/* no error occurred */</span><span class="normal"> </span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span> (<span class="function"><a href="glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span> (<span class="number">&quot;foo.txt&quot;</span>, &amp;contents, <span class="number">NULL</span>, <span class="number">NULL</span>)) <span class="comment">/*</span><span class="comment"> ignore errors </span><span class="comment">*/</span>
+  <span class="comment">/*</span><span class="comment"> no error occurred </span><span class="comment">*/</span> ;
 <span class="keyword">else</span>
-<span class="normal">  </span><span class="comment">/* error */</span><span class="normal"> </span><span class="symbol">;</span></pre></td>
+  <span class="comment">/*</span><span class="comment"> error </span><span class="comment">*/</span> ;</pre></td>
       </tr>
     </tbody>
   </table>
@@ -252,25 +252,25 @@ Here's an example:
 17
 18
 19</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gint">gint</a></span>
-<span class="function">foo_open_file</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">error</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">gint</span><span class="normal"> fd</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gint</span>
+foo_open_file (<span class="type">GError</span> **error)
+{
+  <span class="type">gint</span> fd;
-<span class="normal">  fd </span><span class="symbol">=</span><span class="normal"> </span><span class="function">open</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"file.txt"</span><span class="symbol">,</span><span class="normal"> O_RDONLY</span><span class="symbol">);</span>
+  fd = open (<span class="number">&quot;file.txt&quot;</span>, O_RDONLY);
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fd </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">,</span>
-<span class="normal">                   FOO_ERROR</span><span class="symbol">,</span><span class="normal">                 </span><span class="comment">/* error domain */</span>
-<span class="normal">                   FOO_ERROR_BLAH</span><span class="symbol">,</span><span class="normal">            </span><span class="comment">/* error code */</span>
-<span class="normal">                   </span><span class="string">"Failed to open file: %s"</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">/* error message format string */</span>
-<span class="normal">                   </span><span class="function"><a href="glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
-<span class="normal">      </span><span class="keyword">return</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</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="keyword">return</span><span class="normal"> fd</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">if</span> (fd &lt; <span class="number">0</span>)
+    {
+      <span class="function"><a href="glib-Error-Reporting.html#g-set-error">g_set_error</a></span> (error,
+                   FOO_ERROR,                 <span class="comment">/*</span><span class="comment"> error domain </span><span class="comment">*/</span>
+                   FOO_ERROR_BLAH,            <span class="comment">/*</span><span class="comment"> error code </span><span class="comment">*/</span>
+                   <span class="number">&quot;Failed to open file: </span><span class="symbol">%s</span><span class="number">&quot;</span>, <span class="comment">/*</span><span class="comment"> error message format string </span><span class="comment">*/</span>
+                   <span class="function"><a href="glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span> (errno));
+      <span class="keyword">return</span> -<span class="number">1</span>;
+    }
+  <span class="keyword">else</span>
+    <span class="keyword">return</span> fd;
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -303,21 +303,21 @@ by returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="T
 13
 14
 15</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="symbol">*</span><span class="normal">err </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#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gboolean</span>
+my_function_that_can_fail (<span class="type">GError</span> **err)
+{
+  <span class="preproc">g_return_val_if_fail</span> (err == <span class="number">NULL</span> || *err == <span class="number">NULL</span>, <span class="number">FALSE</span>);
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">))</span>
-<span class="normal">    </span><span class="cbracket">{</span>
-<span class="normal">      </span><span class="comment">/* assert that error was set by the sub-function */</span>
-<span class="normal">      </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="symbol">*</span><span class="normal">err </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="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
-<span class="normal">    </span><span class="cbracket">}</span>
+  <span class="keyword">if</span> (!sub_function_that_can_fail (err))
+    {
+      <span class="comment">/*</span><span class="comment"> assert that error was set by the sub-function </span><span class="comment">*/</span>
+      <span class="preproc">g_assert</span> (err == <span class="number">NULL</span> || *err != <span class="number">NULL</span>);
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
-<span class="normal">  </span><span class="comment">/* otherwise continue, no error occurred */</span>
-<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="symbol">*</span><span class="normal">err </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="cbracket">}</span></pre></td>
+  <span class="comment">/*</span><span class="comment"> otherwise continue, no error occurred </span><span class="comment">*/</span>
+  <span class="preproc">g_assert</span> (err == <span class="number">NULL</span> || *err == <span class="number">NULL</span>);
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -356,27 +356,27 @@ intended for use in this case.
 19
 20
 21</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tmp_error</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gboolean</span>
+my_function_that_can_fail (<span class="type">GError</span> **err)
+{
+  <span class="type">GError</span> *tmp_error;
-<span class="normal">  </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="symbol">*</span><span class="normal">err </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#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
+  <span class="preproc">g_return_val_if_fail</span> (err == <span class="number">NULL</span> || *err == <span class="number">NULL</span>, <span class="number">FALSE</span>);
-<span class="normal">  tmp_error </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">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
+  tmp_error = <span class="number">NULL</span>;
+  sub_function_that_can_fail (&amp;tmp_error);
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tmp_error </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="normal">      </span><span class="comment">/* store tmp_error in err, if err != NULL,</span>
+  <span class="keyword">if</span> (tmp_error != <span class="number">NULL</span>)
+    {
+      <span class="comment">/*</span><span class="comment"> store tmp_error in err, if err != NULL,</span>
 <span class="comment">       * otherwise call g_error_free() on tmp_error</span>
-<span class="comment">       */</span>
-<span class="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">,</span><span class="normal"> tmp_error</span><span class="symbol">);</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="normal">    </span><span class="cbracket">}</span>
+<span class="comment">       </span><span class="comment">*/</span>
+      <span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span> (err, tmp_error);
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
-<span class="normal">  </span><span class="comment">/* otherwise continue, no error occurred */</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="comment">/*</span><span class="comment"> otherwise continue, no error occurred </span><span class="comment">*/</span>
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -408,23 +408,23 @@ Error pileups are always a bug. For example, this code is incorrect:
 15
 16
 17</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tmp_error</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gboolean</span>
+my_function_that_can_fail (<span class="type">GError</span> **err)
+{
+  <span class="type">GError</span> *tmp_error;
-<span class="normal">  </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="symbol">*</span><span class="normal">err </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#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
+  <span class="preproc">g_return_val_if_fail</span> (err == <span class="number">NULL</span> || *err == <span class="number">NULL</span>, <span class="number">FALSE</span>);
-<span class="normal">  tmp_error </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">sub_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function">other_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
+  tmp_error = <span class="number">NULL</span>;
+  sub_function_that_can_fail (&amp;tmp_error);
+  other_function_that_can_fail (&amp;tmp_error);
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tmp_error </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="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">,</span><span class="normal"> tmp_error</span><span class="symbol">);</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="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">if</span> (tmp_error != <span class="number">NULL</span>)
+    {
+      <span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span> (err, tmp_error);
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -462,24 +462,24 @@ are not fatal to <code class="function">my_function_that_can_fail()</code>:
 16
 17
 18</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">my_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">err</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">tmp_error</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gboolean</span>
+my_function_that_can_fail (<span class="type">GError</span> **err)
+{
+  <span class="type">GError</span> *tmp_error;
-<span class="normal">  </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err </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="symbol">*</span><span class="normal">err </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#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
+  <span class="preproc">g_return_val_if_fail</span> (err == <span class="number">NULL</span> || *err == <span class="number">NULL</span>, <span class="number">FALSE</span>);
-<span class="normal">  </span><span class="function">sub_function_that_can_fail</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"> </span><span class="comment">/* ignore errors */</span>
+  sub_function_that_can_fail (<span class="number">NULL</span>); <span class="comment">/*</span><span class="comment"> ignore errors </span><span class="comment">*/</span>
-<span class="normal">  tmp_error </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">other_function_that_can_fail</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">tmp_error</span><span class="symbol">);</span>
+  tmp_error = <span class="number">NULL</span>;
+  other_function_that_can_fail (&amp;tmp_error);
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">tmp_error </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="normal">      </span><span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">err</span><span class="symbol">,</span><span class="normal"> tmp_error</span><span class="symbol">);</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="normal">    </span><span class="cbracket">}</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">if</span> (tmp_error != <span class="number">NULL</span>)
+    {
+      <span class="function"><a href="glib-Error-Reporting.html#g-propagate-error">g_propagate_error</a></span> (err, tmp_error);
+      <span class="keyword">return</span> <span class="number">FALSE</span>;
+    }
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -515,13 +515,13 @@ Error domains and codes are conventionally named as follows:
 5
 6
 7</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="usertype">G_SPAWN_ERROR</span><span class="normal"> </span><span class="function">g_spawn_error_quark</span><span class="normal"> </span><span class="symbol">()</span>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define </span><span class="number">G_SPAWN_ERROR</span><span class="preproc"> </span><span class="function">g_spawn_error_quark</span><span class="preproc"> ()</span>
-<span class="normal"><a href="glib-Quarks.html#GQuark">GQuark</a></span>
-<span class="function">g_spawn_error_quark</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-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"g-spawn-error-quark"</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+<span class="type">GQuark</span>
+<span class="function">g_spawn_error_quark</span> (<span class="type">void</span>)
+{
+  <span class="keyword">return</span> <span class="function"><a href="glib-Quarks.html#g-quark-from-static-string">g_quark_from_static_string</a></span> (<span class="number">&quot;g-spawn-error-quark&quot;</span>);
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1082,6 +1082,6 @@ After the move, add a prefix as with
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>