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

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 (1058) hide show

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Miscellaneous Macros: 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-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.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-Macros.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">
@@ -102,6 +102,12 @@
 <tr>
 <td class="define_keyword">#define</td>
 <td class="function_name">
+<a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-CHECK-VERSION:CAPS" title="G_GNUC_CHECK_VERSION()">G_GNUC_CHECK_VERSION</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
 <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-ALLOC-SIZE:CAPS" title="G_GNUC_ALLOC_SIZE()">G_GNUC_ALLOC_SIZE</a><span class="c_punctuation">()</span>
 </td>
 </tr>
@@ -168,7 +174,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Miscellaneous-Macros.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">
@@ -327,36 +333,40 @@ for non-error cases.</p>
 14
 15
 16
-17</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-GVariant.html#GVariant">GVariant</a> </span><span class="symbol">*</span>
-<span class="function">my_func</span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="glib-Miscellaneous-Macros.html#g-auto">g_auto</a></span><span class="symbol">(</span><span class="normal"><a href="glib-Double-ended-Queues.html#GQueue">GQueue</a></span><span class="symbol">)</span><span class="normal"> queue </span><span class="symbol">=</span><span class="normal"> <a href="glib-Double-ended-Queues.html#G-QUEUE-INIT:CAPS">G_QUEUE_INIT</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Miscellaneous-Macros.html#g-auto">g_auto</a></span><span class="symbol">(</span><span class="normal"><a href="glib-GVariant.html#GVariantBuilder">GVariantBuilder</a></span><span class="symbol">)</span><span class="normal"> builder</span><span class="symbol">;</span>
+17
+18
+19</pre></td>
+        <td class="listing_code"><pre class="programlisting">GVariant <span class="gtkdoc opt">*</span>
+<span class="function">my_func</span><span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="glib-Miscellaneous-Macros.html#g-auto">g_auto</a></span><span class="gtkdoc opt">(</span>GQueue<span class="gtkdoc opt">)</span> queue <span class="gtkdoc opt">=</span> G_QUEUE_INIT<span class="gtkdoc opt">;</span>
+  <span class="function"><a href="glib-Miscellaneous-Macros.html#g-auto">g_auto</a></span><span class="gtkdoc opt">(</span>GVariantBuilder<span class="gtkdoc opt">)</span> builder<span class="gtkdoc opt">;</span>
+  <span class="function"><a href="glib-Miscellaneous-Macros.html#g-auto">g_auto</a></span><span class="gtkdoc opt">(</span>GStrv<span class="gtkdoc opt">)</span> strv<span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-init">g_variant_builder_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> <a href="glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS">G_VARIANT_TYPE_VARDICT</a></span><span class="symbol">);</span>
+  <span class="function"><a href="glib-GVariant.html#g-variant-builder-init">g_variant_builder_init</a></span> <span class="gtkdoc opt">(&amp;</span>builder<span class="gtkdoc opt">,</span> G_VARIANT_TYPE_VARDICT<span class="gtkdoc opt">);</span>
+  strv <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-String-Utility-Functions.html#g-strsplit">g_strsplit</a></span><span class="gtkdoc opt">(</span><span class="string">&quot;a:b:c&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;:&quot;</span><span class="gtkdoc opt">, -</span><span class="number">1</span><span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="symbol">...</span>
+  <span class="gtkdoc opt">...</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error_condition</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>error_condition<span class="gtkdoc opt">)</span>
+    <span class="keyword">return</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  </span><span class="symbol">...</span>
+  <span class="gtkdoc opt">...</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-builder-end">g_variant_builder_end</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">builder</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">return</span> <span class="function"><a href="glib-GVariant.html#g-variant-builder-end">g_variant_builder_end</a></span> <span class="gtkdoc opt">(&amp;</span>builder<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
 <p></p>
-<p>You must initialise the variable in some way -- either by use of an
+<p>You must initialize the variable in some way -- either by use of an
 initialiser or by ensuring that an _init function will be called on
 it unconditionally before it goes out of scope.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.2.13"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.2.13"></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">
@@ -369,7 +379,7 @@ it unconditionally before it goes out of scope.</p>
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -416,31 +426,29 @@ for non-error cases.</p>
 19
 20
 21
-22
-23</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">check_exists</span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dict</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="glib-Miscellaneous-Macros.html#g-autoptr">g_autoptr</a></span><span class="symbol">(</span><span class="normal"><a href="glib-GVariant.html#GVariant">GVariant</a></span><span class="symbol">)</span><span class="normal"> dirname</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Miscellaneous-Macros.html#g-autoptr">g_autoptr</a></span><span class="symbol">(</span><span class="normal"><a href="glib-GVariant.html#GVariant">GVariant</a></span><span class="symbol">)</span><span class="normal"> basename </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Miscellaneous-Macros.html#g-autoptr">g_autoptr</a></span><span class="symbol">(</span><span class="normal"><a href="glib-Basic-Types.html#gchar">gchar</a></span><span class="symbol">)</span><span class="normal"> path </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+22</pre></td>
+        <td class="listing_code"><pre class="programlisting">gboolean
+<span class="function">check_exists</span><span class="gtkdoc opt">(</span>GVariant <span class="gtkdoc opt">*</span>dict<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="glib-Miscellaneous-Macros.html#g-autoptr">g_autoptr</a></span><span class="gtkdoc opt">(</span>GVariant<span class="gtkdoc opt">)</span> dirname<span class="gtkdoc opt">,</span> basename <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
+  g_autofree gchar <span class="gtkdoc opt">*</span>path <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  dirname </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-lookup-value">g_variant_lookup_value</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dict</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"dirname"</span><span class="symbol">,</span><span class="normal"> <a href="glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS">G_VARIANT_TYPE_STRING</a></span><span class="symbol">);</span>
+  dirname <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-GVariant.html#g-variant-lookup-value">g_variant_lookup_value</a></span> <span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">,</span> <span class="string">&quot;dirname&quot;</span><span class="gtkdoc opt">,</span> G_VARIANT_TYPE_STRING<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dirname </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
-<span class="normal">    </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>dirname <span class="gtkdoc opt">==</span> NULL<span class="gtkdoc opt">)</span>
+    <span class="keyword">return</span> FALSE<span class="gtkdoc opt">;</span>
-<span class="normal">  basename </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-lookup-value">g_variant_lookup_value</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dict</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"basename"</span><span class="symbol">,</span><span class="normal"> <a href="glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS">G_VARIANT_TYPE_STRING</a></span><span class="symbol">);</span>
+  basename <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-GVariant.html#g-variant-lookup-value">g_variant_lookup_value</a></span> <span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">,</span> <span class="string">&quot;basename&quot;</span><span class="gtkdoc opt">,</span> G_VARIANT_TYPE_STRING<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">basename </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
-<span class="normal">    </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>basename <span class="gtkdoc opt">==</span> NULL<span class="gtkdoc opt">)</span>
+    <span class="keyword">return</span> FALSE<span class="gtkdoc opt">;</span>
-<span class="normal">  path </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Miscellaneous-Utility-Functions.html#g-build-filename">g_build_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-get-string">g_variant_get_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dirname</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">),</span>
-<span class="normal">                           </span><span class="function"><a href="glib-GVariant.html#g-variant-get-string">g_variant_get_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">basename</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">),</span>
-<span class="normal">                           <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+  path <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-Miscellaneous-Utility-Functions.html#g-build-filename">g_build_filename</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="glib-GVariant.html#g-variant-get-string">g_variant_get_string</a></span> <span class="gtkdoc opt">(</span>dirname<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">),</span>
+                           <span class="function"><a href="glib-GVariant.html#g-variant-get-string">g_variant_get_string</a></span> <span class="gtkdoc opt">(</span>basename<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">),</span>
+                           NULL<span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-File-Utilities.html#g-access">g_access</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">path</span><span class="symbol">,</span><span class="normal"> R_OK</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">return</span> <span class="function"><a href="glib-File-Utilities.html#g-access">g_access</a></span> <span class="gtkdoc opt">(</span>path<span class="gtkdoc opt">,</span> R_OK<span class="gtkdoc opt">) ==</span> <span class="number">0</span><span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -450,9 +458,10 @@ for non-error cases.</p>
 <p>You must initialise the variable in some way -- either by use of an
 initialiser or by ensuring that it is assigned to unconditionally
 before it goes out of scope.</p>
+<p>See also <a class="link" href="glib-Miscellaneous-Macros.html#g-auto" title="g_auto()"><code class="function">g_auto()</code></a>, <a class="link" href="glib-Miscellaneous-Macros.html#g-autofree" title="g_autofree"><code class="function">g_autofree()</code></a> and <a class="link" href="glib-Memory-Allocation.html#g-steal-pointer" title="g_steal_pointer ()"><code class="function">g_steal_pointer()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.3.13"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.3.14"></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">
@@ -465,7 +474,7 @@ before it goes out of scope.</p>
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -484,7 +493,7 @@ type.</p>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Miscellaneous-Macros.html#G-DEFINE-AUTOPTR-CLEANUP-FUNC:CAPS">G_DEFINE_AUTOPTR_CLEANUP_FUNC</a></span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a></span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="symbol">)</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Miscellaneous-Macros.html#G-DEFINE-AUTOPTR-CLEANUP-FUNC:CAPS">G_DEFINE_AUTOPTR_CLEANUP_FUNC</a></span><span class="gtkdoc opt">(</span>GObject<span class="gtkdoc opt">,</span> g_object_unref<span class="gtkdoc opt">)</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -494,8 +503,8 @@ type.</p>
 <p>This macro should be used unconditionally; it is a no-op on compilers
 where cleanup is not supported.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.4.11"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.4.11"></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">
@@ -515,7 +524,7 @@ where cleanup is not supported.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -531,7 +540,7 @@ where cleanup is not supported.</p>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Miscellaneous-Macros.html#G-DEFINE-AUTO-CLEANUP-CLEAR-FUNC:CAPS">G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC</a></span><span class="symbol">(</span><span class="normal"><a href="glib-Double-ended-Queues.html#GQueue">GQueue</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Double-ended-Queues.html#g-queue-clear">g_queue_clear</a></span><span class="symbol">)</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Miscellaneous-Macros.html#G-DEFINE-AUTO-CLEANUP-CLEAR-FUNC:CAPS">G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC</a></span><span class="gtkdoc opt">(</span>GQueue<span class="gtkdoc opt">,</span> g_queue_clear<span class="gtkdoc opt">)</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -541,8 +550,8 @@ where cleanup is not supported.</p>
 <p>This macro should be used unconditionally; it is a no-op on compilers
 where cleanup is not supported.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.5.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.5.10"></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">
@@ -562,7 +571,7 @@ where cleanup is not supported.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -574,7 +583,7 @@ where cleanup is not supported.</p>
 .</p>
 <p>This function will be rarely used.  It is used with pointer-based
 typedefs and non-pointer types where the value of the variable
-represents a resource that must be freed.  Two examples are <a href="https://developer.gnome.org/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>
+represents a resource that must be freed.  Two examples are <a class="link" href="glib-String-Utility-Functions.html#GStrv" title="GStrv"><span class="type">GStrv</span></a>
 and file descriptors.</p>
 <p><em class="parameter"><code>none</code></em>
  specifies the "none" value for the type in question.  It is
@@ -585,7 +594,7 @@ contain this value then the free function will not be called.</p>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Miscellaneous-Macros.html#G-DEFINE-AUTO-CLEANUP-FREE-FUNC:CAPS">G_DEFINE_AUTO_CLEANUP_FREE_FUNC</a></span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/gobject/unstable/gobject-Boxed-Types.html#GStrv">GStrv</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-String-Utility-Functions.html#g-strfreev">g_strfreev</a></span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Miscellaneous-Macros.html#G-DEFINE-AUTO-CLEANUP-FREE-FUNC:CAPS">G_DEFINE_AUTO_CLEANUP_FREE_FUNC</a></span><span class="gtkdoc opt">(</span>GStrv<span class="gtkdoc opt">,</span> g_strfreev<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">)</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -595,8 +604,8 @@ contain this value then the free function will not be called.</p>
 <p>This macro should be used unconditionally; it is a no-op on compilers
 where cleanup is not supported.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.6.11"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.6.11"></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">
@@ -621,7 +630,7 @@ where cleanup is not supported.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -632,8 +641,8 @@ where cleanup is not supported.</p>
 because this macro may use <code class="function">memmove()</code> and GLib does not include
 string.h for you.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.7.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.7.6"></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">
@@ -668,8 +677,8 @@ preprocessor argument expansion. For example, the following code:</p>
       <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="gtkdoc ppc">#define AGE 27</span>
+<span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>greeting <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-Miscellaneous-Macros.html#G-STRINGIFY:CAPS">G_STRINGIFY</a></span> <span class="gtkdoc opt">(</span>AGE<span class="gtkdoc opt">)</span> <span class="string">&quot; today!&quot;</span><span class="gtkdoc opt">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -682,7 +691,7 @@ preprocessor argument expansion. For example, the following code:</p>
     <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="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>greeting <span class="gtkdoc opt">=</span> <span class="string">&quot;27 today!&quot;</span><span class="gtkdoc opt">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -690,8 +699,8 @@ preprocessor argument expansion. For example, the following code:</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.8.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.8.10"></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">
@@ -725,10 +734,10 @@ the following code:</p>
 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="gtkdoc ppc">#define GET(traveller,method) G_PASTE(traveller_get_, method) (traveller)</span>
+<span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>name <span class="gtkdoc opt">=</span> <span class="function">GET</span> <span class="gtkdoc opt">(</span>traveller<span class="gtkdoc opt">,</span> name<span class="gtkdoc opt">);</span>
+<span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>quest <span class="gtkdoc opt">=</span> <span class="function">GET</span> <span class="gtkdoc opt">(</span>traveller<span class="gtkdoc opt">,</span> quest<span class="gtkdoc opt">);</span>
+GdkColor <span class="gtkdoc opt">*</span>favourite <span class="gtkdoc opt">=</span> <span class="function">GET</span> <span class="gtkdoc opt">(</span>traveller<span class="gtkdoc opt">,</span> favourite_colour<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -743,9 +752,9 @@ the following code:</p>
         <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="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>name <span class="gtkdoc opt">=</span> <span class="function">traveller_get_name</span> <span class="gtkdoc opt">(</span>traveller<span class="gtkdoc opt">);</span>
+<span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span>quest <span class="gtkdoc opt">=</span> <span class="function">traveller_get_quest</span> <span class="gtkdoc opt">(</span>traveller<span class="gtkdoc opt">);</span>
+GdkColor <span class="gtkdoc opt">*</span>favourite <span class="gtkdoc opt">=</span> <span class="function">traveller_get_favourite_colour</span> <span class="gtkdoc opt">(</span>traveller<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -753,8 +762,8 @@ the following code:</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.9.10"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.9.10"></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">
@@ -774,7 +783,7 @@ the following code:</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.20</p>
+<p class="since">Since: <a class="link" href="api-index-2-20.html#api-index-2.20">2.20</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -790,8 +799,8 @@ a variable declaration is allowed. For this reason, you should
 not use <a class="link" href="glib-Miscellaneous-Macros.html#G-STATIC-ASSERT:CAPS" title="G_STATIC_ASSERT()"><code class="function">G_STATIC_ASSERT()</code></a> in the middle of blocks of code.</p>
 <p>The macro should only be used once per source code line.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.10.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.10.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">
@@ -804,7 +813,7 @@ not use <a class="link" href="glib-Miscellaneous-Macros.html#G-STATIC-ASSERT:CAP
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.20</p>
+<p class="since">Since: <a class="link" href="api-index-2-20.html#api-index-2.20">2.20</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -824,8 +833,8 @@ it as the first argument of a comma expression.</p>
       <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="gtkdoc ppc">#define ADD_ONE_TO_INT(x) \</span>
+<span class="gtkdoc ppc">  (G_STATIC_ASSERT_EXPR(sizeof (x) == sizeof (int)), ((x) + 1))</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -833,8 +842,8 @@ it as the first argument of a comma expression.</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.11.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.11.8"></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">
@@ -847,7 +856,30 @@ it as the first argument of a comma expression.</p>
 </tr></tbody>
 </table></div>
 </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">
+<a name="G-GNUC-CHECK-VERSION:CAPS"></a><h3>G_GNUC_CHECK_VERSION()</h3>
+<pre class="programlisting">#define             G_GNUC_CHECK_VERSION(major, minor)</pre>
+<p>Expands to a a check for a compiler with __GNUC__ defined and a version
+greater than or equal to the major and minor numbers provided. For example,
+the following would only match on compilers such as GCC 4.8 or newer.</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</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#if G_GNUC_CHECK_VERSION(4, 8)</span>
+<span class="gtkdoc ppc">#endif</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p class="since">Since: <a class="link" href="api-index-2-42.html#api-index-2.42">2.42</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -863,8 +895,8 @@ by the <em class="parameter"><code>xth</code></em>
 semicolon.</p>
 <p>See the GNU C documentation for more details.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.12.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.13.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">
@@ -877,7 +909,7 @@ semicolon.</p>
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.18</p>
+<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -892,8 +924,8 @@ function parameters.</p>
 semicolon.</p>
 <p>See the GNU C documentation for more details.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.13.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.14.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">
@@ -913,7 +945,7 @@ semicolon.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.18</p>
+<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -929,8 +961,8 @@ custom deprecation messages.</p>
 You can enclose it in quotes to prevent this. (The quotes will show up
 in the warning, but it's better than showing the macro expansion.)</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.14.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.15.8"></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">
@@ -944,7 +976,7 @@ such as the name of a function</p></td>
 </tr></tbody>
 </table></div>
 </div>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -965,10 +997,10 @@ semicolon.</p>
 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">gint <span class="function"><a href="glib-String-Utility-Functions.html#g-snprintf">g_snprintf</a></span> <span class="gtkdoc opt">(</span>gchar  <span class="gtkdoc opt">*</span>string<span class="gtkdoc opt">,</span>
+                 gulong       n<span class="gtkdoc opt">,</span>
+                 gchar <span class="gtkdoc kwb">const</span> <span class="gtkdoc opt">*</span>format<span class="gtkdoc opt">,</span>
+                 <span class="gtkdoc opt">...)</span> <span class="function"><a href="glib-Miscellaneous-Macros.html#G-GNUC-PRINTF:CAPS">G_GNUC_PRINTF</a></span> <span class="gtkdoc opt">(</span><span class="number">3</span><span class="gtkdoc opt">,</span> <span class="number">4</span><span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -976,8 +1008,8 @@ semicolon.</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.15.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.16.9"></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">
@@ -1009,8 +1041,8 @@ arguments, with the same syntax as <code class="function">scanf()</code>. It all
 to type-check the arguments passed to the function.</p>
 <p>See the GNU C documentation for details.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.16.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.17.6"></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">
@@ -1051,7 +1083,7 @@ semicolon.</p>
     <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">gchar <span class="gtkdoc opt">*</span><span class="function"><a href="glib-I18N.html#g-dgettext">g_dgettext</a></span> <span class="gtkdoc opt">(</span>gchar <span class="gtkdoc opt">*</span>domain_name<span class="gtkdoc opt">,</span> gchar <span class="gtkdoc opt">*</span>msgid<span class="gtkdoc opt">)</span> <span class="function"><a href="glib-Miscellaneous-Macros.html#G-GNUC-FORMAT:CAPS">G_GNUC_FORMAT</a></span> <span class="gtkdoc opt">(</span><span class="number">2</span><span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1059,8 +1091,8 @@ semicolon.</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.17.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.18.9"></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">
@@ -1084,8 +1116,8 @@ functions declarations as deprecated. Unlike <a class="link" href="glib-Miscella
 is meant to be portable across different compilers and must be placed
 before the function declaration.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.18.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.19.5"></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">
@@ -1098,7 +1130,7 @@ before the function declaration.</p>
 </tr></tbody>
 </table></div>
 </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">
@@ -1109,8 +1141,8 @@ before the function declaration.</p>
 It must be placed before the function declaration. Use of a function
 that has been annotated with this macros will produce a compiler warning.</p>
 <div class="refsect3">
-<a name="id-1.3.8.7.19.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.20.5"></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">
@@ -1130,12 +1162,12 @@ that has been annotated with this macros will produce a compiler warning.</p>
 </tbody>
 </table></div>
 </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">
 <a name="G-LIKELY:CAPS"></a><h3>G_LIKELY()</h3>
-<pre class="programlisting">#define G_LIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 1))
+<pre class="programlisting">#define G_LIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR((expr)), 1))
 </pre>
 <p>Hints the compiler that the expression is likely to evaluate to
 a true value. The compiler may use this information for optimizations.</p>
@@ -1145,8 +1177,8 @@ a true value. The compiler may use this information for optimizations.</p>
       <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="gtkdoc opt">(</span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-LIKELY:CAPS">G_LIKELY</a></span> <span class="gtkdoc opt">(</span><span class="function">random</span> <span class="gtkdoc opt">() !=</span> <span class="number">1</span><span class="gtkdoc opt">))</span>
+  <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;not one&quot;</span><span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1154,8 +1186,8 @@ a true value. The compiler may use this information for optimizations.</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.20.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.21.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">
@@ -1169,17 +1201,16 @@ a true value. The compiler may use this information for optimizations.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.8.7.20.8"></a><h4>Returns</h4>
+<a name="id-1.3.9.7.21.8"></a><h4>Returns</h4>
 <p> the value of <em class="parameter"><code>expr</code></em>
 </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">
 <a name="G-UNLIKELY:CAPS"></a><h3>G_UNLIKELY()</h3>
-<pre class="programlisting">#define G_UNLIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 0))
+<pre class="programlisting">#define G_UNLIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR((expr)), 0))
 </pre>
 <p>Hints the compiler that the expression is unlikely to evaluate to
 a true value. The compiler may use this information for optimizations.</p>
@@ -1189,8 +1220,8 @@ a true value. The compiler may use this information for optimizations.</p>
       <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="gtkdoc opt">(</span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-UNLIKELY:CAPS">G_UNLIKELY</a></span> <span class="gtkdoc opt">(</span><span class="function">random</span> <span class="gtkdoc opt">() ==</span> <span class="number">1</span><span class="gtkdoc opt">))</span>
+  <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;a random one&quot;</span><span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1198,8 +1229,8 @@ a true value. The compiler may use this information for optimizations.</p>
 <p></p>
 <div class="refsect3">
-<a name="id-1.3.8.7.21.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.3.9.7.22.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">
@@ -1213,12 +1244,11 @@ a true value. The compiler may use this information for optimizations.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.8.7.21.8"></a><h4>Returns</h4>
+<a name="id-1.3.9.7.22.8"></a><h4>Returns</h4>
 <p> the value of <em class="parameter"><code>expr</code></em>
 </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">
@@ -1226,24 +1256,25 @@ a true value. The compiler may use this information for optimizations.</p>
 <pre class="programlisting">#define G_STRFUNC     ((const char*) (__PRETTY_FUNCTION__))
 </pre>
 <p>Expands to a string identifying the current function.</p>
-<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>
 </div>
 <div class="refsect1">
 <a name="glib-Miscellaneous-Macros.other_details"></a><h2>Types and Values</h2>
 <div class="refsect2">
 <a name="G-INLINE-FUNC:CAPS"></a><h3>G_INLINE_FUNC</h3>
-<pre class="programlisting">#  define G_INLINE_FUNC _GLIB_EXTERN
+<pre class="programlisting">#  define G_INLINE_FUNC extern
 </pre>
-<p>This macro is used to export function prototypes so they can be linked
-with an external version when no inlining is performed. The file which
-implements the functions should define <code class="literal">G_IMPLEMENTS_INLINES</code>
-before including the headers which contain <a class="link" href="glib-Miscellaneous-Macros.html#G-INLINE-FUNC:CAPS" title="G_INLINE_FUNC"><code class="literal">G_INLINE_FUNC</code></a> declarations.
-Since inlining is very compiler-dependent using these macros correctly
-is very difficult. Their use is strongly discouraged.</p>
-<p>This macro is often mistaken for a replacement for the inline keyword;
-inline is already declared in a portable manner in the GLib headers
-and can be used normally.</p>
+<div class="warning">
+<p><code class="literal">G_INLINE_FUNC</code> has been deprecated since version 2.48 and should not be used in newly-written code.</p>
+<p>Use "static inline" instead</p>
+</div>
+<p>This macro used to be used to conditionally define inline functions
+in a compatible way before this feature was supported in all
+compilers.  These days, GLib requires inlining support from the
+compiler, so your GLib-using programs can safely assume that the
+"inline" keywork works properly.</p>
+<p>Never use this macro anymore.  Just say "static inline".</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1274,25 +1305,25 @@ supported on GCC and clang, the variable must be initialized, etc.</p>
 10
 11
 12</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gboolean">gboolean</a></span>
-<span class="function">operate_on_malloc_buf</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">g_autofree</span><span class="normal"> <a href="glib-Basic-Types.html#guint8">guint8</a></span><span class="symbol">*</span><span class="normal"> membuf </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting">gboolean
+<span class="function">operate_on_malloc_buf</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  g_autofree guint8<span class="gtkdoc opt">*</span> membuf <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
-<span class="normal">  membuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-malloc">g_malloc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">8192</span><span class="symbol">);</span>
+  membuf <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-Memory-Allocation.html#g-malloc">g_malloc</a></span> <span class="gtkdoc opt">(</span><span class="number">8192</span><span class="gtkdoc opt">);</span>
-<span class="normal">  </span><span class="comment">/* Some computation on membuf */</span>
+  <span class="comment">/* Some computation on membuf */</span>
-<span class="normal">  </span><span class="comment">/* membuf will be automatically freed here */</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="comment">/* membuf will be automatically freed here */</span>
+  <span class="keyword">return</span> TRUE<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
 <p></p>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1376,7 +1407,7 @@ guaranteed to not alias with any other pointer when the function returns
 (in practice, this means newly allocated memory).</p>
 <p>Place the attribute after the declaration, just before the semicolon.</p>
 <p>See the GNU C documentation for more details.</p>
-<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">
@@ -1389,7 +1420,7 @@ When called with the <code class="literal">-Wdeprecated-declarations</code> opti
 gcc will generate warnings when deprecated interfaces are used.</p>
 <p>Place the attribute after the declaration, just before the semicolon.</p>
 <p>See the GNU C documentation for more details.</p>
-<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">
@@ -1405,7 +1436,7 @@ are not compiling with <code class="literal">-Wdeprecated-declarations</code> th
 has any effect.)</p>
 <p>This macro can be used either inside or outside of a function body,
 but must appear on a line by itself.</p>
-<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">
@@ -1416,7 +1447,7 @@ gcc to begin outputting warnings again (assuming those warnings
 had been enabled to begin with).</p>
 <p>This macro can be used either inside or outside of a function body,
 but must appear on a line by itself.</p>
-<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">
@@ -1444,8 +1475,8 @@ argument declaration.</p>
       <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="gtkdoc kwb">void</span> <span class="function">my_unused_function</span> <span class="gtkdoc opt">(</span>G_GNUC_UNUSED gint unused_argument<span class="gtkdoc opt">,</span>
+                         gint other_argument<span class="gtkdoc opt">)</span> G_GNUC_UNUSED<span class="gtkdoc opt">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1465,7 +1496,7 @@ the compiler to check that the argument list is terminated with an
 explicit <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p>
 <p>Place the attribute after the declaration, just before the semicolon.</p>
 <p>See the GNU C documentation for more details.</p>
-<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 +1508,7 @@ is gcc. This function attribute makes the compiler emit a warning if the
 result of a function call is ignored.</p>
 <p>Place the attribute after the declaration, just before the semicolon.</p>
 <p>See the GNU C documentation for more details.</p>
-<p class="since">Since 2.10</p>
+<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1546,18 +1577,18 @@ Sun Studio does not.</p>
 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">G_GNUC_INTERNAL
+<span class="gtkdoc kwb">void</span> <span class="function">_g_log_fallback_handler</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">const</span> gchar    <span class="gtkdoc opt">*</span>log_domain<span class="gtkdoc opt">,</span>
+                              GLogLevelFlags  log_level<span class="gtkdoc opt">,</span>
+                              <span class="gtkdoc kwb">const</span> gchar    <span class="gtkdoc opt">*</span>message<span class="gtkdoc opt">,</span>
+                              gpointer        unused_data<span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
 <p></p>
-<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">
@@ -1568,7 +1599,7 @@ Sun Studio does not.</p>
 Types with this attribute will not be subjected to type-based alias
 analysis, but are assumed to alias with any other type, just like char.</p>
 <p>See the GNU C documentation for details.</p>
-<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">
@@ -1579,7 +1610,7 @@ analysis, but are assumed to alias with any other type, just like char.</p>
 functions declarations as deprecated. Unlike <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED:CAPS" title="G_GNUC_DEPRECATED"><code class="literal">G_GNUC_DEPRECATED</code></a>, it is
 meant to be portable across different compilers and must be placed
 before the function declaration.</p>
-<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">
@@ -1591,7 +1622,6 @@ before the function declaration.</p>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>