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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1752) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-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-Quarks.html" title="Quarks">
 <link rel="next" href="glib-Datasets.html" title="Datasets">
-<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">
@@ -108,8 +108,8 @@ The <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="t
 converted to <a href="glib-Quarks.html#GQuark"><span class="type">GQuarks</span></a> anyway.
 </p>
 <p>
-Data lists are used for associating arbitrary data with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObjects</span></a>,
-using <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> and related functions.
+Data lists are used for associating arbitrary data with <span class="type">GObjects</span>,
+using <code class="function">g_object_set_data()</code> and related functions.
 </p>
 <p>
 To create a datalist, use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-init" title="g_datalist_init ()"><code class="function">g_datalist_init()</code></a>.
@@ -695,7 +695,7 @@ Turns on flag values for a data list. This function is used
 to keep a small number of boolean flags in an object with
 a data list without using any additional space. It is
 not generally useful except in circumstances where space
-is very tight. (It is used in the base <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type, for
+is very tight. (It is used in the base <span class="type">GObject</span> type, for
 example.)
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
@@ -791,6 +791,6 @@ flags &amp; ~G_DATALIST_FLAGS_MASK != 0 is an error.
 </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-Lexical-Scanner.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Miscellaneous-Utility-Functions.html" title="Miscellaneous Utility Functions">
 <link rel="next" href="glib-Timers.html" title="Timers">
-<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">
@@ -1556,6 +1556,6 @@ of <a class="link" href="glib-Lexical-Scanner.html#GTokenValue" title="union GTo
 </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-Memory-Allocation.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Dynamic-Loading-of-Modules.html" title="Dynamic Loading of Modules">
 <link rel="next" href="glib-Memory-Slices.html" title="Memory Slices">
-<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">
@@ -1090,6 +1090,6 @@ previously installed the <a class="link" href="glib-Memory-Allocation.html#glib-
 </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-Memory-Slices.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Memory-Allocation.html" title="Memory Allocation">
 <link rel="next" href="glib-IO-Channels.html" title="IO Channels">
-<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">
@@ -73,7 +73,7 @@ memory-waste, scalability and performance problems.
 <p>
 To achieve these goals, the slice allocator uses a sophisticated,
 layered design that has been inspired by Bonwick's slab allocator
-<a href="#ftn.idp7648048" class="footnote"><sup class="footnote"><a name="idp7648048"></a>[1]</sup></a>.
+<a href="#ftn.id-1.4.8.4.3.1" class="footnote"><sup class="footnote"><a name="id-1.4.8.4.3.1"></a>[1]</sup></a>.
 It uses <code class="function">posix_memalign()</code> to optimize allocations of many equally-sized
 chunks, and has per-thread free lists (the so-called magazine layer)
 to quickly satisfy allocation requests of already known structure sizes.
@@ -96,7 +96,7 @@ object size used at allocation time is still available when freeing.
 <p>
 </p>
 <div class="example">
-<a name="idp11567184"></a><p class="title"><b>Example 8. Using the slice allocator</b></p>
+<a name="id-1.4.8.4.5.1"></a><p class="title"><b>Example 8. Using the slice allocator</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -119,24 +119,24 @@ object size used at allocation time is still available when freeing.
 16
 17
 18</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">mem</span><span class="symbol">[</span><span class="number">10000</span><span class="symbol">];</span>
-<span class="usertype">gint</span><span class="normal"> i</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gchar</span> *mem[<span class="number">10000</span>];
+<span class="type">gint</span> i;
-<span class="comment">/* Allocate 10000 blocks. */</span>
-<span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">10000</span><span class="symbol">;</span><span class="normal"> i</span><span class="symbol">++)</span>
-<span class="normal">  </span><span class="cbracket">{</span>
-<span class="normal">    mem</span><span class="symbol">[</span><span class="normal">i</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Slices.html#g-slice-alloc">g_slice_alloc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">50</span><span class="symbol">);</span>
+<span class="comment">/*</span><span class="comment"> Allocate 10000 blocks. </span><span class="comment">*/</span>
+<span class="keyword">for</span> (i = <span class="number">0</span>; i &lt; <span class="number">10000</span>; i++)
+  {
+    mem[i] = <span class="function"><a href="glib-Memory-Slices.html#g-slice-alloc">g_slice_alloc</a></span> (<span class="number">50</span>);
-<span class="normal">    </span><span class="comment">/* Fill in the memory with some junk. */</span>
-<span class="normal">    </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">j </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span><span class="normal"> j </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">50</span><span class="symbol">;</span><span class="normal"> j</span><span class="symbol">++)</span>
-<span class="normal">      mem</span><span class="symbol">[</span><span class="normal">i</span><span class="symbol">][</span><span class="normal">j</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> i </span><span class="symbol">*</span><span class="normal"> j</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="cbracket">}</span>
+    <span class="comment">/*</span><span class="comment"> Fill in the memory with some junk. </span><span class="comment">*/</span>
+    <span class="keyword">for</span> (j = <span class="number">0</span>; j &lt; <span class="number">50</span>; j++)
+      mem[i][j] = i * j;
+  }
-<span class="comment">/* Now free all of the blocks. */</span>
-<span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">&lt;</span><span class="normal"> </span><span class="number">10000</span><span class="symbol">;</span><span class="normal"> i</span><span class="symbol">++)</span>
-<span class="normal">  </span><span class="cbracket">{</span>
-<span class="normal">    </span><span class="function"><a href="glib-Memory-Slices.html#g-slice-free1">g_slice_free1</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">50</span><span class="symbol">,</span><span class="normal"> mem</span><span class="symbol">[</span><span class="normal">i</span><span class="symbol">]);</span>
-<span class="normal">  </span><span class="cbracket">}</span></pre></td>
+<span class="comment">/*</span><span class="comment"> Now free all of the blocks. </span><span class="comment">*/</span>
+<span class="keyword">for</span> (i = <span class="number">0</span>; i &lt; <span class="number">10000</span>; i++)
+  {
+    <span class="function"><a href="glib-Memory-Slices.html#g-slice-free1">g_slice_free1</a></span> (<span class="number">50</span>, mem[i]);
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -148,7 +148,7 @@ object size used at allocation time is still available when freeing.
 <p>
 </p>
 <div class="example">
-<a name="idp7264736"></a><p class="title"><b>Example 9. Using the slice allocator with data structures</b></p>
+<a name="id-1.4.8.4.6.1"></a><p class="title"><b>Example 9. Using the slice allocator with data structures</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -168,21 +168,21 @@ object size used at allocation time is still available when freeing.
 13
 14
 15</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GRealArray</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">array</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting">GRealArray *array;
-<span class="comment">/* Allocate one block, using the g_slice_new() macro. */</span>
-<span class="normal">array </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Slices.html#g-slice-new">g_slice_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GRealArray</span><span class="symbol">);</span>
+<span class="comment">/*</span><span class="comment"> Allocate one block, using the g_slice_new() macro. </span><span class="comment">*/</span>
+array = <span class="preproc">g_slice_new</span> (GRealArray);
-<span class="comment">/* We can now use array just like a normal pointer to a structure. */</span>
-<span class="normal">array</span><span class="symbol">-&gt;</span><span class="normal">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">array</span><span class="symbol">-&gt;</span><span class="normal">len             </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-<span class="normal">array</span><span class="symbol">-&gt;</span><span class="normal">alloc           </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-<span class="normal">array</span><span class="symbol">-&gt;</span><span class="normal">zero_terminated </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">zero_terminated </span><span class="symbol">?</span><span class="normal"> </span><span class="number">1</span><span class="normal"> </span><span class="symbol">:</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
-<span class="normal">array</span><span class="symbol">-&gt;</span><span class="normal">clear           </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">clear </span><span class="symbol">?</span><span class="normal"> </span><span class="number">1</span><span class="normal"> </span><span class="symbol">:</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
-<span class="normal">array</span><span class="symbol">-&gt;</span><span class="normal">elt_size        </span><span class="symbol">=</span><span class="normal"> elt_size</span><span class="symbol">;</span>
+<span class="comment">/*</span><span class="comment"> We can now use array just like a normal pointer to a structure. </span><span class="comment">*/</span>
+array-&gt;data            = <span class="number">NULL</span>;
+array-&gt;len             = <span class="number">0</span>;
+array-&gt;alloc           = <span class="number">0</span>;
+array-&gt;zero_terminated = (zero_terminated ? <span class="number">1</span> : <span class="number">0</span>);
+array-&gt;clear           = (clear ? <span class="number">1</span> : <span class="number">0</span>);
+array-&gt;elt_size        = elt_size;
-<span class="comment">/* We can free the block, so it can be reused. */</span>
-<span class="function"><a href="glib-Memory-Slices.html#g-slice-free">g_slice_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GRealArray</span><span class="symbol">,</span><span class="normal"> array</span><span class="symbol">);</span></pre></td>
+<span class="comment">/*</span><span class="comment"> We can free the block, so it can be reused. </span><span class="comment">*/</span>
+<span class="preproc">g_slice_free</span> (GRealArray, array);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -539,7 +539,7 @@ related debugging options.
 </div>
 <div class="footnotes">
 <br><hr style="width:100; align:left;">
-<div id="ftn.idp7648048" class="footnote"><p><a href="#idp7648048" class="para"><sup class="para">[1] </sup></a>
+<div id="ftn.id-1.4.8.4.3.1" class="footnote"><p><a href="#id-1.4.8.4.3.1" class="para"><sup class="para">[1] </sup></a>
 <a class="ulink" href="http://citeseer.ist.psu.edu/bonwick94slab.html" target="_top">[Bonwick94]</a> Jeff Bonwick, The slab allocator: An object-caching kernel
 memory allocator. USENIX 1994, and
 <a class="ulink" href="http://citeseer.ist.psu.edu/bonwick01magazines.html" target="_top">[Bonwick01]</a> Bonwick and Jonathan Adams, Magazines and vmem: Extending the
@@ -549,6 +549,6 @@ slab allocator to many cpu's and arbitrary resources. USENIX 2001
 </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-Message-Logging.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Warnings-and-Assertions.html" title="Message Output and Debugging Functions">
 <link rel="next" href="glib-utilities.html" title="GLib Utilities">
-<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">
@@ -116,7 +116,7 @@ For example, GTK+ uses this in its Makefile.am:
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">INCLUDES </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">-</span><span class="normal">DG_LOG_DOMAIN</span><span class="symbol">=\</span><span class="string">"Gtk</span><span class="specialchar">\"</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">INCLUDES = -DG_LOG_DOMAIN=\<span class="number">&quot;Gtk</span><span class="symbol">\&quot;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -479,7 +479,7 @@ you want to set a handler for this log level you must combine it with
 <p>
 </p>
 <div class="example">
-<a name="idp21021216"></a><p class="title"><b>Example 10. Adding a log handler for all warning messages in the default
+<a name="id-1.4.12.5.14.6.1"></a><p class="title"><b>Example 10. Adding a log handler for all warning messages in the default
 (application) domain</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -487,8 +487,8 @@ you want to set a handler for this log level you must combine it with
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Message-Logging.html#g-log-set-handler">g_log_set_handler</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-Message-Logging.html#G-LOG-LEVEL-WARNING:CAPS">G_LOG_LEVEL_WARNING</a> </span><span class="symbol">|</span><span class="normal"> <a href="glib-Message-Logging.html#G-LOG-FLAG-FATAL:CAPS">G_LOG_FLAG_FATAL</a></span>
-<span class="normal">                   </span><span class="symbol">|</span><span class="normal"> <a href="glib-Message-Logging.html#G-LOG-FLAG-RECURSION:CAPS">G_LOG_FLAG_RECURSION</a></span><span class="symbol">,</span><span class="normal"> my_log_handler</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"><span class="function"><a href="glib-Message-Logging.html#g-log-set-handler">g_log_set_handler</a></span> (<span class="number">NULL</span>, <span class="number">G_LOG_LEVEL_WARNING</span> | <span class="number">G_LOG_FLAG_FATAL</span>
+                   | <span class="number">G_LOG_FLAG_RECURSION</span>, my_log_handler, <span class="number">NULL</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -500,15 +500,15 @@ you want to set a handler for this log level you must combine it with
 <p>
 </p>
 <div class="example">
-<a name="idp21023440"></a><p class="title"><b>Example 11. Adding a log handler for all critical messages from GTK+</b></p>
+<a name="id-1.4.12.5.14.7.1"></a><p class="title"><b>Example 11. Adding a log handler for all critical messages from GTK+</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Message-Logging.html#g-log-set-handler">g_log_set_handler</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Gtk"</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"> <a href="glib-Message-Logging.html#G-LOG-FLAG-FATAL:CAPS">G_LOG_FLAG_FATAL</a></span>
-<span class="normal">                   </span><span class="symbol">|</span><span class="normal"> <a href="glib-Message-Logging.html#G-LOG-FLAG-RECURSION:CAPS">G_LOG_FLAG_RECURSION</a></span><span class="symbol">,</span><span class="normal"> my_log_handler</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"><span class="function"><a href="glib-Message-Logging.html#g-log-set-handler">g_log_set_handler</a></span> (<span class="number">&quot;Gtk&quot;</span>, <span class="number">G_LOG_LEVEL_CRITICAL</span> | <span class="number">G_LOG_FLAG_FATAL</span>
+                   | <span class="number">G_LOG_FLAG_RECURSION</span>, my_log_handler, <span class="number">NULL</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -520,7 +520,7 @@ you want to set a handler for this log level you must combine it with
 <p>
 </p>
 <div class="example">
-<a name="idp21025664"></a><p class="title"><b>Example 12. Adding a log handler for <span class="emphasis"><em>all</em></span> messages from
+<a name="id-1.4.12.5.14.8.1"></a><p class="title"><b>Example 12. Adding a log handler for <span class="emphasis"><em>all</em></span> messages from
 GLib</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -528,8 +528,8 @@ GLib</b></p>
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Message-Logging.html#g-log-set-handler">g_log_set_handler</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"GLib"</span><span class="symbol">,</span><span class="normal"> <a href="glib-Message-Logging.html#G-LOG-LEVEL-MASK:CAPS">G_LOG_LEVEL_MASK</a> </span><span class="symbol">|</span><span class="normal"> <a href="glib-Message-Logging.html#G-LOG-FLAG-FATAL:CAPS">G_LOG_FLAG_FATAL</a></span>
-<span class="normal">                   </span><span class="symbol">|</span><span class="normal"> <a href="glib-Message-Logging.html#G-LOG-FLAG-RECURSION:CAPS">G_LOG_FLAG_RECURSION</a></span><span class="symbol">,</span><span class="normal"> my_log_handler</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"><span class="function"><a href="glib-Message-Logging.html#g-log-set-handler">g_log_set_handler</a></span> (<span class="number">&quot;GLib&quot;</span>, <span class="number">G_LOG_LEVEL_MASK</span> | <span class="number">G_LOG_FLAG_FATAL</span>
+                   | <span class="number">G_LOG_FLAG_RECURSION</span>, my_log_handler, <span class="number">NULL</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -772,6 +772,6 @@ and log level combination. By default, GLib uses
 </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-Miscellaneous-Macros.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-fundamentals.html" title="GLib Fundamentals">
 <link rel="prev" href="glib-Numerical-Definitions.html" title="Numerical Definitions">
 <link rel="next" href="glib-Atomic-Operations.html" title="Atomic Operations">
-<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">
@@ -107,7 +107,7 @@ needed so often by application programmers.
 <a name="glib-Miscellaneous-Macros.details"></a><h2>Details</h2>
 <div class="refsect2">
 <a name="G-INLINE-FUNC:CAPS"></a><h3>G_INLINE_FUNC</h3>
-<pre class="programlisting">#  define G_INLINE_FUNC
+<pre class="programlisting">#  define G_INLINE_FUNC _GLIB_EXTERN
 </pre>
 <p>
 This macro is used to export function prototypes so they can be linked
@@ -213,8 +213,8 @@ preprocessor argument expansion. For example, the following code:
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> AGE </span><span class="number">27</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">greeting </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-STRINGIFY:CAPS">G_STRINGIFY</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">AGE</span><span class="symbol">)</span><span class="normal"> </span><span class="string">" today!"</span><span class="symbol">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define AGE </span><span class="number">27</span>
+<span class="type">const</span> <span class="type">gchar</span> *greeting = <span class="preproc">G_STRINGIFY</span> (AGE) <span class="number">&quot; today!&quot;</span>;</pre></td>
       </tr>
     </tbody>
   </table>
@@ -232,7 +232,7 @@ is transformed by the preprocessor into (code equivalent to):
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><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">greeting </span><span class="symbol">=</span><span class="normal"> </span><span class="string">"27 today!"</span><span class="symbol">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">const</span> <span class="type">gchar</span> *greeting = <span class="number">&quot;27 today!&quot;</span>;</pre></td>
       </tr>
     </tbody>
   </table>
@@ -270,10 +270,10 @@ the following code:
 2
 3
 4</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="function">GET</span><span class="symbol">(</span><span class="normal">traveller</span><span class="symbol">,</span><span class="normal">method</span><span class="symbol">)</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-PASTE:CAPS">G_PASTE</a></span><span class="symbol">(</span><span class="normal">traveller_get_</span><span class="symbol">,</span><span class="normal"> method</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</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="normal"> </span><span class="function">GET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</span><span class="symbol">,</span><span class="normal"> name</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">quest </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</span><span class="symbol">,</span><span class="normal"> quest</span><span class="symbol">);</span>
-<span class="usertype">GdkColor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">favourite </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</span><span class="symbol">,</span><span class="normal"> favourite_colour</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define GET(traveller,method) </span><span class="preproc">G_PASTE</span><span class="preproc">(traveller_get_, method) (traveller)</span>
+<span class="type">const</span> <span class="type">gchar</span> *name = GET (traveller, name);
+<span class="type">const</span> <span class="type">gchar</span> *quest = GET (traveller, quest);
+<span class="type">GdkColor</span> *favourite = GET (traveller, favourite_colour);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -291,9 +291,9 @@ is transformed by the preprocessor into:
         <td class="listing_lines" align="right"><pre>1
 2
 3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><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="normal"> </span><span class="function">traveller_get_name</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</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">quest </span><span class="symbol">=</span><span class="normal"> </span><span class="function">traveller_get_quest</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</span><span class="symbol">);</span>
-<span class="usertype">GdkColor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">favourite </span><span class="symbol">=</span><span class="normal"> </span><span class="function">traveller_get_favourite_colour</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">traveller</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">const</span> <span class="type">gchar</span> *name = traveller_get_name (traveller);
+<span class="type">const</span> <span class="type">gchar</span> *quest = traveller_get_quest (traveller);
+<span class="type">GdkColor</span> *favourite = traveller_get_favourite_colour (traveller);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -322,7 +322,7 @@ is transformed by the preprocessor into:
 <hr>
 <div class="refsect2">
 <a name="G-STATIC-ASSERT:CAPS"></a><h3>G_STATIC_ASSERT()</h3>
-<pre class="programlisting">#define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __COUNTER__)[(expr) ? 1 : -1]
+<pre class="programlisting">#define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __COUNTER__)[(expr) ? 1 : -1] G_GNUC_UNUSED
 </pre>
 <p>
 The G_STATIC_ASSERT macro lets the programmer check
@@ -384,8 +384,8 @@ the first argument of a comma expression.
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="function">ADD_ONE_TO_INT</span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">\</span>
-<span class="normal">  </span><span class="symbol">(</span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-STATIC-ASSERT-EXPR:CAPS">G_STATIC_ASSERT_EXPR</a></span><span class="symbol">(</span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="symbol">)),</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="symbol">))</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define ADD_ONE_TO_INT(x) \</span>
+<span class="preproc">  (G_STATIC_ASSERT_EXPR(</span><span class="keyword">sizeof</span><span class="preproc"> (x) == </span><span class="keyword">sizeof</span><span class="preproc"> (</span><span class="type">int</span><span class="preproc">)), ((x) + </span><span class="number">1</span><span class="preproc">))</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -682,8 +682,8 @@ argument declaration.
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal"> </span><span class="function">my_unused_function</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS">G_GNUC_UNUSED</a> </span><span class="usertype">gint</span><span class="normal"> unused_argument</span><span class="symbol">,</span>
-<span class="normal">                         </span><span class="usertype">gint</span><span class="normal"> other_argument</span><span class="symbol">)</span><span class="normal"> <a href="glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS">G_GNUC_UNUSED</a></span><span class="symbol">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">void</span> my_unused_function (<span class="number">G_GNUC_UNUSED</span> <span class="type">gint</span> unused_argument,
+                         <span class="type">gint</span> other_argument) <span class="number">G_GNUC_UNUSED</span>;</pre></td>
       </tr>
     </tbody>
   </table>
@@ -723,10 +723,10 @@ See the GNU C documentation for more details.
 2
 3
 4</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gint</span><span class="normal"> </span><span class="function"><a href="glib-String-Utility-Functions.html#g-snprintf">g_snprintf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gchar</span><span class="normal">  </span><span class="symbol">*</span><span class="normal">string</span><span class="symbol">,</span>
-<span class="normal">                 </span><span class="usertype">gulong</span><span class="normal">       n</span><span class="symbol">,</span>
-<span class="normal">                 </span><span class="usertype">gchar</span><span class="normal"> </span><span class="keyword">const</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">format</span><span class="symbol">,</span>
-<span class="normal">                 </span><span class="symbol">...)</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-GNUC-PRINTF:CAPS">G_GNUC_PRINTF</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">3</span><span class="symbol">,</span><span class="normal"> </span><span class="number">4</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gint</span> <span class="function"><a href="glib-String-Utility-Functions.html#g-snprintf">g_snprintf</a></span> (<span class="type">gchar</span>  *string,
+                 <span class="type">gulong</span>       n,
+                 <span class="type">gchar</span> <span class="type">const</span> *format,
+                 ...) <span class="preproc">G_GNUC_PRINTF</span> (<span class="number">3</span>, <span class="number">4</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -809,7 +809,7 @@ See the GNU C documentation for more details.
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="function"><a href="glib-I18N.html#g-dgettext">g_dgettext</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">domain_name</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">msgid</span><span class="symbol">)</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-GNUC-FORMAT:CAPS">G_GNUC_FORMAT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">2</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gchar</span> *<span class="function"><a href="glib-I18N.html#g-dgettext">g_dgettext</a></span> (<span class="type">gchar</span> *domain_name, <span class="type">gchar</span> *msgid) <span class="preproc">G_GNUC_FORMAT</span> (<span class="number">2</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -952,11 +952,11 @@ Sun Studio does not.
 3
 4
 5</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Miscellaneous-Macros.html#G-GNUC-INTERNAL:CAPS">G_GNUC_INTERNAL</a></span>
-<span class="type">void</span><span class="normal"> </span><span class="function">_g_log_fallback_handler</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">log_domain</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">GLogLevelFlags</span><span class="normal">  log_level</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal">    </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
-<span class="normal">                              </span><span class="usertype">gpointer</span><span class="normal">        unused_data</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="number">G_GNUC_INTERNAL</span>
+<span class="type">void</span> _g_log_fallback_handler (<span class="type">const</span> <span class="type">gchar</span>    *log_domain,
+                              <span class="type">GLogLevelFlags</span>  log_level,
+                              <span class="type">const</span> <span class="type">gchar</span>    *message,
+                              <span class="type">gpointer</span>        unused_data);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1061,8 +1061,8 @@ a true value. The compiler may use this information for optimizations.
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</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-Miscellaneous-Macros.html#G-LIKELY:CAPS">G_LIKELY</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">random</span><span class="normal"> </span><span class="symbol">()</span><span class="normal"> </span><span class="symbol">!=</span><span class="normal"> </span><span class="number">1</span><span class="symbol">))</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">"not one"</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span> (<span class="preproc">G_LIKELY</span> (random () != <span class="number">1</span>))
+  <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> (<span class="number">&quot;not one&quot;</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1106,8 +1106,8 @@ a true value. The compiler may use this information for optimizations.
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2</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-Miscellaneous-Macros.html#G-UNLIKELY:CAPS">G_UNLIKELY</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">random</span><span class="normal"> </span><span class="symbol">()</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> </span><span class="number">1</span><span class="symbol">))</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">"a random one"</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span> (<span class="preproc">G_UNLIKELY</span> (random () == <span class="number">1</span>))
+  <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> (<span class="number">&quot;a random one&quot;</span>);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1157,6 +1157,6 @@ Expands to a string identifying the current function.
 </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-Miscellaneous-Utility-Functions.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Hook-Functions.html" title="Hook Functions">
 <link rel="next" href="glib-Lexical-Scanner.html" title="Lexical Scanner">
-<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">
@@ -42,7 +42,7 @@
 const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-application-name" title="g_get_application_name ()">g_get_application_name</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-application-name" title="g_set_application_name ()">g_set_application_name</a>              (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *application_name</code></em>);
-<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-prgname" title="g_get_prgname ()">g_get_prgname</a>                       (<em class="parameter"><code><span class="type">void</span></code></em>);
+const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-prgname" title="g_get_prgname ()">g_get_prgname</a>                       (<em class="parameter"><code><span class="type">void</span></code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-prgname" title="g_set_prgname ()">g_set_prgname</a>                       (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *prgname</code></em>);
 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-environ" title="g_get_environ ()">g_get_environ</a>                       (<em class="parameter"><code><span class="type">void</span></code></em>);
 const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-environ-getenv" title="g_environ_getenv ()">g_environ_getenv</a>                    (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **envp</code></em>,
@@ -166,7 +166,7 @@ been called).
 Sets a human-readable name for the application. This name should be
 localized if possible, and is intended for display to the user.
 Contrast with <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-prgname" title="g_set_prgname ()"><code class="function">g_set_prgname()</code></a>, which sets a non-localized name.
-<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-prgname" title="g_set_prgname ()"><code class="function">g_set_prgname()</code></a> will be called automatically by <a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a>,
+<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-prgname" title="g_set_prgname ()"><code class="function">g_set_prgname()</code></a> will be called automatically by <code class="function">gtk_init()</code>,
 but <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-application-name" title="g_set_application_name ()"><code class="function">g_set_application_name()</code></a> will not.
 </p>
 <p>
@@ -192,12 +192,12 @@ or when displaying an application's name in the task list.
 <hr>
 <div class="refsect2">
 <a name="g-get-prgname"></a><h3>g_get_prgname ()</h3>
-<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_get_prgname                       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_get_prgname                       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>
 Gets the name of the program. This name should <span class="emphasis"><em>not</em></span>
 be localized, contrast with <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-application-name" title="g_get_application_name ()"><code class="function">g_get_application_name()</code></a>.
-(If you are using GDK or GTK+ the program name is set in <a href="http://library.gnome.org/devel/gdk3/gdk-General.html#gdk-init"><code class="function">gdk_init()</code></a>,
-which is called by <a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a>. The program name is found by taking
+(If you are using GDK or GTK+ the program name is set in <code class="function">gdk_init()</code>,
+which is called by <code class="function">gtk_init()</code>. The program name is found by taking
 the last component of <code class="literal">argv[0]</code>.)
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
@@ -1011,46 +1011,39 @@ returned.
 <a name="g-get-home-dir"></a><h3>g_get_home_dir ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_get_home_dir                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>
-Gets the current user's home directory as defined in the
-password database.
+Gets the current user's home directory.
 </p>
 <p>
-Note that in contrast to traditional UNIX tools, this function
-prefers <code class="filename">passwd</code> entries over the <code class="envar">HOME</code>
-environment variable.
+As with most UNIX tools, this function will return the value of the
+<code class="envar">HOME</code> environment variable if it is set to an existing
+absolute path name, falling back to the <code class="filename">passwd</code>
+file in the case that it is unset.
 </p>
 <p>
-One of the reasons for this decision is that applications in many
-cases need special handling to deal with the case where
-<code class="envar">HOME</code> is
+If the path given in <code class="envar">HOME</code> is non-absolute, does not
+exist, or is not a directory, the result is undefined.
 </p>
-<table border="0" summary="Simple list" class="simplelist">
-<tr><td>Not owned by the user</td></tr>
-<tr><td>Not writeable</td></tr>
-<tr><td>Not even readable</td></tr>
-</table>
 <p>
-Since applications are in general <span class="emphasis"><em>not</em></span> written
-to deal with these situations it was considered better to make
-<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-home-dir" title="g_get_home_dir ()"><code class="function">g_get_home_dir()</code></a> not pay attention to <code class="envar">HOME</code> and to
-return the real home directory for the user. If applications
-want to pay attention to <code class="envar">HOME</code>, they can do:
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">homedir </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Utility-Functions.html#g-getenv">g_getenv</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"HOME"</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">homedir</span><span class="symbol">)</span>
-<span class="normal">    homedir </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Utility-Functions.html#g-get-home-dir">g_get_home_dir</a></span><span class="normal"> </span><span class="symbol">();</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
+</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Note</h3>
+<p>
+  Before version 2.36 this function would ignore the
+  <code class="envar">HOME</code> environment variable, taking the value from the
+  <code class="filename">passwd</code> database instead.  This was changed to
+  increase the compatibility of GLib with other programs (and the XDG
+  basedir specification) and to increase testability of programs
+  based on GLib (by making it easier to run them from test
+  frameworks).
+</p>
+<p>
+  If your program has a strong requirement for either the new or the
+  old behaviour (and if you don't wish to increase your GLib
+  dependency to ensure that the new behaviour is in effect) then you
+  should either directly check the <code class="envar">HOME</code> environment
+  variable yourself or unset it before calling any functions in GLib.
+</p>
 </div>
 <p>
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
@@ -2054,6 +2047,6 @@ Set the pointer at the specified location to <a class="link" href="glib-Standard
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>