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

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

Files changed (1058) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Miscellaneous Utility Functions: GLib Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <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.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -33,7 +33,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="glib-Miscellaneous-Utility-Functions.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
@@ -334,32 +334,26 @@
 </td>
 </tr>
 <tr>
-<td class="function_type">
-<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>
-</td>
+<td class="define_keyword">#define</td>
 <td class="function_name">
-<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-bit-nth-lsf" title="g_bit_nth_lsf ()">g_bit_nth_lsf</a> <span class="c_punctuation">()</span>
+<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-bit-nth-lsf" title="g_bit_nth_lsf()">g_bit_nth_lsf</a><span class="c_punctuation">()</span>
 </td>
 </tr>
 <tr>
-<td class="function_type">
-<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>
-</td>
+<td class="define_keyword">#define</td>
 <td class="function_name">
-<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-bit-nth-msf" title="g_bit_nth_msf ()">g_bit_nth_msf</a> <span class="c_punctuation">()</span>
+<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-bit-nth-msf" title="g_bit_nth_msf()">g_bit_nth_msf</a><span class="c_punctuation">()</span>
 </td>
 </tr>
 <tr>
-<td class="function_type">
-<a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
-</td>
+<td class="define_keyword">#define</td>
 <td class="function_name">
-<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-bit-storage" title="g_bit_storage ()">g_bit_storage</a> <span class="c_punctuation">()</span>
+<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-bit-storage" title="g_bit_storage()">g_bit_storage</a><span class="c_punctuation">()</span>
 </td>
 </tr>
 <tr>
 <td class="function_type">
-<a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
+<a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="returnvalue">guint</span></a>
 </td>
 <td class="function_name">
 <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-spaced-primes-closest" title="g_spaced_primes_closest ()">g_spaced_primes_closest</a> <span class="c_punctuation">()</span>
@@ -375,7 +369,7 @@
 </tr>
 <tr>
 <td class="function_type">
-<a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
+<a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="returnvalue">guint</span></a>
 </td>
 <td class="function_name">
 <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-parse-debug-string" title="g_parse_debug_string ()">g_parse_debug_string</a> <span class="c_punctuation">()</span>
@@ -418,7 +412,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Miscellaneous-Utility-Functions.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
@@ -468,9 +462,8 @@ been called).</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.2.5"></a><h4>Returns</h4>
 <p> human-readable application name. may return <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a></p>
-<p></p>
 </div>
-<p class="since">Since 2.2</p>
+<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -488,7 +481,7 @@ be called once.</p>
 or when displaying an application's name in the task list.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.3.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -501,7 +494,7 @@ or when displaying an application's name in the task list.</p>
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.2</p>
+<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -518,7 +511,6 @@ the last component of <em class="parameter"><code>argv</code></em>
 <a name="id-1.5.14.7.4.6"></a><h4>Returns</h4>
 <p> the name of the program. The returned string belongs
 to GLib and must not be modified or freed.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -531,7 +523,7 @@ in contrast to <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g
 <p>Note that for thread-safety reasons this function can only be called once.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.5.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -563,7 +555,7 @@ except portable.</p>
 environment variables. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.28</p>
+<p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -577,7 +569,7 @@ provided list <em class="parameter"><code>envp</code></em>
 .</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.7.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -593,8 +585,7 @@ for an empty environment list. </p></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>variable</p></td>
-<td class="parameter_description"><p>the environment variable to get, in the GLib file name
-encoding</p></td>
+<td class="parameter_description"><p>the environment variable to get</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@@ -609,9 +600,8 @@ string is owned by <em class="parameter"><code>envp</code></em>
 , and will be freed if <em class="parameter"><code>variable</code></em>
 is
 set or unset again.</p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -628,7 +618,7 @@ g_environ_setenv (<em class="parameter"><code><a class="link" href="glib-Basic-T
 .</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.8.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -667,7 +657,7 @@ environment list. </p></td>
 updated environment list. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -681,7 +671,7 @@ environment <em class="parameter"><code>envp</code></em>
 .</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.9.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -709,7 +699,7 @@ or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code
 updated environment list. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -717,14 +707,14 @@ updated environment list. Free it using <a class="link" href="glib-String-Utilit
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *
 g_getenv (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *variable</code></em>);</pre>
 <p>Returns the value of an environment variable.</p>
-<p>The name and value are in the GLib file name encoding. On UNIX,
-this means the actual bytes which might or might not be in some
-consistent character set and encoding. On Windows, it is in UTF-8.
+<p>On UNIX, the name and value are byte strings which might or might not
+be in some consistent character set and encoding. On Windows, they are
+in UTF-8.
 On Windows, in case the environment variable's value contains
 references to other environment variables, they are expanded.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.10.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -732,8 +722,7 @@ references to other environment variables, they are expanded.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>variable</p></td>
-<td class="parameter_description"><p>the environment variable to get, in the GLib file name
-encoding</p></td>
+<td class="parameter_description"><p>the environment variable to get</p></td>
 <td class="parameter_annotations"> </td>
 </tr></tbody>
 </table></div>
@@ -744,7 +733,6 @@ encoding</p></td>
 the environment variable is not found. The returned string
 may be overwritten by the next call to <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-getenv" title="g_getenv ()"><code class="function">g_getenv()</code></a>, <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-setenv" title="g_setenv ()"><code class="function">g_setenv()</code></a>
 or <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-unsetenv" title="g_unsetenv ()"><code class="function">g_unsetenv()</code></a>.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -754,10 +742,9 @@ or <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-unsetenv" t
 g_setenv (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *variable</code></em>,
           <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *value</code></em>,
           <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> overwrite</code></em>);</pre>
-<p>Sets an environment variable. Both the variable's name and value
-should be in the GLib file name encoding. On UNIX, this means that
-they can be arbitrary byte strings. On Windows, they should be in
-UTF-8.</p>
+<p>Sets an environment variable. On UNIX, both the variable's name and
+value can be arbitrary byte strings, except that the variable's name
+cannot contain '='. On Windows, they should be in UTF-8.</p>
 <p>Note that on some systems, when variables are overwritten, the memory
 used for the previous variables and its value isn't reclaimed.</p>
 <p>You should be mindful of the fact that environment variable handling
@@ -773,7 +760,7 @@ use <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-enviro
 array directly to <code class="function">execvpe()</code>, <a class="link" href="glib-Spawning-Processes.html#g-spawn-async" title="g_spawn_async ()"><code class="function">g_spawn_async()</code></a>, or the like.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.11.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -801,9 +788,8 @@ array directly to <code class="function">execvpe()</code>, <a class="link" href=
 <div class="refsect3">
 <a name="id-1.5.14.7.11.9"></a><h4>Returns</h4>
 <p> <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if the environment variable couldn't be set.</p>
-<p></p>
 </div>
-<p class="since">Since 2.4</p>
+<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -826,7 +812,7 @@ use <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-enviro
 array directly to <code class="function">execvpe()</code>, <a class="link" href="glib-Spawning-Processes.html#g-spawn-async" title="g_spawn_async ()"><code class="function">g_spawn_async()</code></a>, or the like.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.12.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -839,7 +825,7 @@ array directly to <code class="function">execvpe()</code>, <a class="link" href=
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.4</p>
+<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -859,7 +845,7 @@ the UTF-8 encoding that this function and <a class="link" href="glib-Miscellaneo
 list of strings which must be freed with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.8</p>
+<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -873,7 +859,6 @@ consistent on a machine. On Windows, it is always UTF-8.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.14.5"></a><h4>Returns</h4>
 <p> the user name of the current user.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -889,7 +874,6 @@ returned.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.15.5"></a><h4>Returns</h4>
 <p> the user's real name.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -911,9 +895,8 @@ See documentation for CSIDL_INTERNET_CACHE.</p>
 <a name="id-1.5.14.7.16.7"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified
 or freed.</p>
-<p></p>
 </div>
-<p class="since">Since 2.6</p>
+<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -934,9 +917,8 @@ what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-
 <a name="id-1.5.14.7.17.7"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified
 or freed.</p>
-<p></p>
 </div>
-<p class="since">Since 2.6</p>
+<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -957,9 +939,8 @@ what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-
 <a name="id-1.5.14.7.18.7"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified
 or freed.</p>
-<p></p>
 </div>
-<p class="since">Since 2.6</p>
+<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -973,8 +954,8 @@ in the
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>.
 This is the directory
 specified in the <code class="literal">XDG_RUNTIME_DIR</code> environment variable.
-In the case that this variable is not set, GLib will issue a warning
-message to stderr and return the value of <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-cache-dir" title="g_get_user_cache_dir ()"><code class="function">g_get_user_cache_dir()</code></a>.</p>
+In the case that this variable is not set, we return the value of
+<a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-cache-dir" title="g_get_user_cache_dir ()"><code class="function">g_get_user_cache_dir()</code></a>, after verifying that it exists.</p>
 <p>On Windows this is the folder to use for local (as opposed to
 roaming) application data. See documentation for
 CSIDL_LOCAL_APPDATA.  Note that on Windows it thus is the same as
@@ -982,9 +963,8 @@ what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-
 <div class="refsect3">
 <a name="id-1.5.14.7.19.7"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified or freed.</p>
-<p></p>
 </div>
-<p class="since">Since 2.28</p>
+<p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1001,7 +981,7 @@ of the special directory without requiring the session to restart; GLib
 will not reflect any change once the special directories are loaded.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.20.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1019,9 +999,8 @@ will not reflect any change once the special directories are loaded.</p>
 <p> the path to the specified special directory, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 if the logical id was not found. The returned string is owned by
 GLib and should not be modified or freed.</p>
-<p></p>
 </div>
-<p class="since">Since 2.14</p>
+<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1057,7 +1036,7 @@ this function is called.</p>
 not be modified or freed. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.6</p>
+<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1082,7 +1061,7 @@ This information will not roam and is available to anyone using the computer.</p
 not be modified or freed. </p>
 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.6</p>
+<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1096,7 +1075,7 @@ if you just changed the data on disk yourself.</p>
 that were previously returned from <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-special-dir" title="g_get_user_special_dir ()"><code class="function">g_get_user_special_dir()</code></a>
 that can't be freed. We ensure to only leak the data for
 the directories that actually changed value though.</p>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1117,9 +1096,8 @@ returned.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.24.6"></a><h4>Returns</h4>
 <p> the host name of the machine.</p>
-<p></p>
 </div>
-<p class="since">Since 2.8</p>
+<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1145,7 +1123,6 @@ or unset it before calling any functions in GLib.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.25.9"></a><h4>Returns</h4>
 <p> the current user's home directory</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1167,7 +1144,6 @@ string.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.26.8"></a><h4>Returns</h4>
 <p> the directory to use for temporary files.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1186,7 +1162,6 @@ the current directory is the target of a symbolic link.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.27.7"></a><h4>Returns</h4>
 <p> the current directory</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1206,7 +1181,7 @@ components. It returns a pointer into the given file name
 string.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.28.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1223,7 +1198,6 @@ string.</p>
 <a name="id-1.5.14.7.28.7"></a><h4>Returns</h4>
 <p> the name of the file without any leading
 directory components</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1254,7 +1228,7 @@ either. Such paths should be avoided, or need to be handled using
 Windows-specific code.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.29.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1271,7 +1245,6 @@ Windows-specific code.</p>
 <a name="id-1.5.14.7.29.10"></a><h4>Returns</h4>
 <p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>file_name</code></em>
 is absolute</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1286,7 +1259,7 @@ i.e. after the "/" in UNIX or "C:\" under Windows. If <em class="parameter"><cod
 is not an absolute path it returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.30.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1321,7 +1294,7 @@ separator is returned. If <em class="parameter"><code>file_name</code></em>
  is empty, it gets ".".</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.31.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1338,7 +1311,6 @@ separator is returned. If <em class="parameter"><code>file_name</code></em>
 <a name="id-1.5.14.7.31.7"></a><h4>Returns</h4>
 <p> a newly allocated string containing the last
 component of the filename</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1351,7 +1323,7 @@ g_path_get_dirname (<em class="parameter"><code>const <a class="link" href="glib
 The returned string should be freed when no longer needed.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.32.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1367,7 +1339,6 @@ The returned string should be freed when no longer needed.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.32.7"></a><h4>Returns</h4>
 <p> the directory components of the file</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1390,7 +1361,7 @@ path. If the first element is a relative path, the result will
 be a relative path.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.33.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1413,7 +1384,6 @@ be a relative path.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.33.9"></a><h4>Returns</h4>
 <p> a newly-allocated string that must be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1426,7 +1396,7 @@ as a string array, instead of varargs. This function is mainly
 meant for language bindings.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.34.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1442,9 +1412,8 @@ meant for language bindings.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.34.6"></a><h4>Returns</h4>
 <p> a newly-allocated string that must be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.</p>
-<p></p>
 </div>
-<p class="since">Since 2.8</p>
+<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1477,7 +1446,7 @@ copies of the separator, elements consisting only of copies
 of the separator are ignored.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.35.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1505,7 +1474,6 @@ of the separator are ignored.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.35.11"></a><h4>Returns</h4>
 <p> a newly-allocated string that must be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1519,7 +1487,7 @@ as a string array, instead of varargs. This function is mainly
 meant for language bindings.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.36.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1542,9 +1510,8 @@ meant for language bindings.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.36.6"></a><h4>Returns</h4>
 <p> a newly-allocated string that must be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.</p>
-<p></p>
 </div>
-<p class="since">Since 2.8</p>
+<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1561,7 +1528,7 @@ and are displayed rounded to the nearest tenth. E.g. the file size
 formatted.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.37.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1578,9 +1545,8 @@ formatted.</p>
 <a name="id-1.5.14.7.37.9"></a><h4>Returns</h4>
 <p> a newly-allocated formatted string containing a human readable
 file size</p>
-<p></p>
 </div>
-<p class="since">Since 2.30</p>
+<p class="since">Since: <a class="link" href="api-index-2-30.html#api-index-2.30">2.30</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1593,7 +1559,7 @@ g_format_size_full (<em class="parameter"><code><a class="link" href="glib-Basic
 that modify the output. See <a class="link" href="glib-Miscellaneous-Utility-Functions.html#GFormatSizeFlags" title="enum GFormatSizeFlags"><span class="type">GFormatSizeFlags</span></a>.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.38.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1617,9 +1583,8 @@ that modify the output. See <a class="link" href="glib-Miscellaneous-Utility-Fun
 <a name="id-1.5.14.7.38.7"></a><h4>Returns</h4>
 <p> a newly-allocated formatted string containing a human
 readable file size</p>
-<p></p>
 </div>
-<p class="since">Since 2.30</p>
+<p class="since">Since: <a class="link" href="api-index-2-30.html#api-index-2.30">2.30</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1640,7 +1605,7 @@ string "3.1 MB".</p>
 <p>This string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when not needed any longer.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.39.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1657,16 +1622,14 @@ string "3.1 MB".</p>
 <a name="id-1.5.14.7.39.10"></a><h4>Returns</h4>
 <p> a newly-allocated formatted string containing a human
 readable file size</p>
-<p></p>
 </div>
-<p class="since">Since 2.16</p>
+<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="g-find-program-in-path"></a><h3>g_find_program_in_path ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *
 g_find_program_in_path (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *program</code></em>);</pre>
-<div class="warning"><p><code class="literal">g_find_program_in_path</code> is deprecated and should not be used in newly-written code.</p></div>
 <p>Locates the first executable named <em class="parameter"><code>program</code></em>
  in the user's path, in the
 same way that <code class="function">execvp()</code> would locate it. Returns an allocated string
@@ -1688,8 +1651,8 @@ finally in the directories in the <code class="literal">PATH</code> environment
 the program is found, the return value contains the full name
 including the type suffix.</p>
 <div class="refsect3">
-<a name="id-1.5.14.7.40.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.5.14.7.40.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1703,17 +1666,14 @@ including the type suffix.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.5.14.7.40.9"></a><h4>Returns</h4>
+<a name="id-1.5.14.7.40.8"></a><h4>Returns</h4>
 <p> a newly-allocated string with the absolute path, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a></p>
-<p></p>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="g-bit-nth-lsf"></a><h3>g_bit_nth_lsf ()</h3>
-<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>
-g_bit_nth_lsf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> mask</code></em>,
-               <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> nth_bit</code></em>);</pre>
+<a name="g-bit-nth-lsf"></a><h3>g_bit_nth_lsf()</h3>
+<pre class="programlisting">#define             g_bit_nth_lsf(mask, nth_bit)</pre>
 <p>Find the position of the first bit set in <em class="parameter"><code>mask</code></em>
 , searching
 from (but not including) <em class="parameter"><code>nth_bit</code></em>
@@ -1723,7 +1683,7 @@ usually). To start searching from the 0th bit, set <em class="parameter"><code>n
  to -1.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.41.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1746,16 +1706,14 @@ usually). To start searching from the 0th bit, set <em class="parameter"><code>n
 <div class="refsect3">
 <a name="id-1.5.14.7.41.6"></a><h4>Returns</h4>
 <p> the index of the first bit set which is higher than <em class="parameter"><code>nth_bit</code></em>
-</p>
-<p></p>
+, or -1
+if no higher bits are set</p>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="g-bit-nth-msf"></a><h3>g_bit_nth_msf ()</h3>
-<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>
-g_bit_nth_msf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> mask</code></em>,
-               <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> nth_bit</code></em>);</pre>
+<a name="g-bit-nth-msf"></a><h3>g_bit_nth_msf()</h3>
+<pre class="programlisting">#define             g_bit_nth_msf(mask, nth_bit)</pre>
 <p>Find the position of the first bit set in <em class="parameter"><code>mask</code></em>
 , searching
 from (but not including) <em class="parameter"><code>nth_bit</code></em>
@@ -1766,7 +1724,7 @@ usually). To start searching from the last bit, set <em class="parameter"><code>
 -1 or GLIB_SIZEOF_LONG * 8.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.42.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1789,22 +1747,21 @@ usually). To start searching from the last bit, set <em class="parameter"><code>
 <div class="refsect3">
 <a name="id-1.5.14.7.42.6"></a><h4>Returns</h4>
 <p> the index of the first bit set which is lower than <em class="parameter"><code>nth_bit</code></em>
-</p>
-<p></p>
+, or -1
+if no lower bits are set</p>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="g-bit-storage"></a><h3>g_bit_storage ()</h3>
-<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
-g_bit_storage (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> number</code></em>);</pre>
+<a name="g-bit-storage"></a><h3>g_bit_storage()</h3>
+<pre class="programlisting">#define             g_bit_storage(number)</pre>
 <p>Gets the number of bits used to hold <em class="parameter"><code>number</code></em>
 ,
 e.g. if <em class="parameter"><code>number</code></em>
  is 4, 3 bits are needed.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.43.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1812,7 +1769,7 @@ e.g. if <em class="parameter"><code>number</code></em>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>number</p></td>
-<td class="parameter_description"><p>a <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a></p></td>
+<td class="parameter_description"><p>a <a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a></p></td>
 <td class="parameter_annotations"> </td>
 </tr></tbody>
 </table></div>
@@ -1821,14 +1778,13 @@ e.g. if <em class="parameter"><code>number</code></em>
 <a name="id-1.5.14.7.43.6"></a><h4>Returns</h4>
 <p> the number of bits used to hold <em class="parameter"><code>number</code></em>
 </p>
-<p></p>
 </div>
 </div>
 <hr>
 <div class="refsect2">
 <a name="g-spaced-primes-closest"></a><h3>g_spaced_primes_closest ()</h3>
-<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
-g_spaced_primes_closest (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> num</code></em>);</pre>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="returnvalue">guint</span></a>
+g_spaced_primes_closest (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> num</code></em>);</pre>
 <p>Gets the smallest prime number from a built-in array of primes which
 is larger than <em class="parameter"><code>num</code></em>
 . This is used within GLib to calculate the optimum
@@ -1837,7 +1793,7 @@ size of a <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTa
 each prime is approximately 1.5-2 times the previous prime.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.44.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1845,7 +1801,7 @@ each prime is approximately 1.5-2 times the previous prime.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>num</p></td>
-<td class="parameter_description"><p>a <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a></p></td>
+<td class="parameter_description"><p>a <a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a></p></td>
 <td class="parameter_annotations"> </td>
 </tr></tbody>
 </table></div>
@@ -1855,7 +1811,6 @@ each prime is approximately 1.5-2 times the previous prime.</p>
 <p> the smallest prime number from a built-in array of primes
 which is larger than <em class="parameter"><code>num</code></em>
 </p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1893,7 +1848,7 @@ calling <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-atexit
 program.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.45.12"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1910,12 +1865,12 @@ program.</p>
 <hr>
 <div class="refsect2">
 <a name="g-parse-debug-string"></a><h3>g_parse_debug_string ()</h3>
-<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="returnvalue">guint</span></a>
 g_parse_debug_string (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
                       <em class="parameter"><code>const <a class="link" href="glib-Miscellaneous-Utility-Functions.html#GDebugKey" title="struct GDebugKey"><span class="type">GDebugKey</span></a> *keys</code></em>,
-                      <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> nkeys</code></em>);</pre>
+                      <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> nkeys</code></em>);</pre>
 <p>Parses a string containing debugging options
-into a <a class="link" href="glib-Basic-Types.html#guint" title="guint"><code class="literal">guint</code></a> containing bit flags. This is used
+into a <a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><code class="literal">guint</code></a> containing bit flags. This is used
 within GDK and GTK+ to parse the debug options passed on the
 command line or through environment variables.</p>
 <p>If <em class="parameter"><code>string</code></em>
@@ -1930,7 +1885,7 @@ corresponding to "foo" and "bar".</p>
 are printed out to standard error.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.46.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1960,7 +1915,6 @@ strings with bit flags. </p></td>
 <div class="refsect3">
 <a name="id-1.5.14.7.46.8"></a><h4>Returns</h4>
 <p> the combined set of bit flags.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1983,7 +1937,7 @@ data pointer argument and has no return value. It is
 not currently used in GLib or GTK+.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.48.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2002,7 +1956,7 @@ not currently used in GLib or GTK+.</p>
 <a name="g-qsort-with-data"></a><h3>g_qsort_with_data ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 g_qsort_with_data (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> pbase</code></em>,
-                   <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> total_elems</code></em>,
+                   <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint ()"><span class="type">gint</span></a> total_elems</code></em>,
                    <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> size</code></em>,
                    <em class="parameter"><code><a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="type">GCompareDataFunc</span></a> compare_func</code></em>,
                    <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
@@ -2011,7 +1965,7 @@ the comparison routine accepts a user data argument.</p>
 <p>This is guaranteed to be a stable sort since version 2.32.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.49.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2020,8 +1974,8 @@ the comparison routine accepts a user data argument.</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>pbase</p></td>
-<td class="parameter_description"><p>start of array to sort</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> start of array to sort. </p></td>
+<td class="parameter_annotations"><span class="annotation">[not nullable]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>total_elems</p></td>
@@ -2056,7 +2010,7 @@ g_nullify_pointer (<em class="parameter"><code><a class="link" href="glib-Basic-
 <p>Set the pointer at the specified location to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.5.14.7.50.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2064,8 +2018,8 @@ g_nullify_pointer (<em class="parameter"><code><a class="link" href="glib-Basic-
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>nullify_location</p></td>
-<td class="parameter_description"><p>the memory address of the pointer.</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the memory address of the pointer. </p></td>
+<td class="parameter_annotations"><span class="annotation">[not nullable]</span></td>
 </tr></tbody>
 </table></div>
 </div>
@@ -2083,7 +2037,7 @@ every platform has a directory for every logical id in this
 enumeration.</p>
 <div class="refsect3">
 <a name="id-1.5.14.8.2.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -2156,7 +2110,7 @@ enumeration.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.14</p>
+<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2171,7 +2125,7 @@ enumeration.</p>
 The returned string should be freed when no longer needed.</p>
 <div class="refsect3">
 <a name="id-1.5.14.8.3.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2187,7 +2141,6 @@ The returned string should be freed when no longer needed.</p>
 <div class="refsect3">
 <a name="id-1.5.14.8.3.8"></a><h4>Returns</h4>
 <p> the directory components of the file</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -2196,7 +2149,7 @@ The returned string should be freed when no longer needed.</p>
 <p>Flags to modify the format of the string returned by <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-format-size-full" title="g_format_size_full ()"><code class="function">g_format_size_full()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.5.14.8.4.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -2244,7 +2197,7 @@ The returned string should be freed when no longer needed.</p>
 Used in <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-parse-debug-string" title="g_parse_debug_string ()"><code class="function">g_parse_debug_string()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.5.14.8.5.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -2257,7 +2210,7 @@ Used in <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-parse-
 <td class="struct_member_annotations"> </td>
 </tr>
 <tr>
-<td class="struct_member_name"><p><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDebugKey.value"></a>value</code></em>;</p></td>
+<td class="struct_member_name"><p><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDebugKey.value"></a>value</code></em>;</p></td>
 <td class="struct_member_description"><p>the flag</p></td>
 <td class="struct_member_annotations"> </td>
 </tr>
@@ -2268,7 +2221,6 @@ Used in <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-parse-
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>