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-Memory-Allocation.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Memory Allocation: 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-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Dynamic-Loading-of-Modules.html" title="Dynamic Loading of Modules">
 <link rel="next" href="glib-Memory-Slices.html" title="Memory Slices">
-<meta name="generator" content="GTK-Doc V1.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-Memory-Allocation.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">
@@ -250,7 +250,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Memory-Allocation.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">
@@ -286,7 +286,7 @@ This also means that there is no need to check if the call succeeded.</p>
 <a class="link" href="glib-Memory-Slices.html#g-slice-free" title="g_slice_free()"><code class="function">g_slice_free()</code></a>, plain <code class="function">malloc()</code> with <code class="function">free()</code>, and (if you're using C++)
 new with delete and new[] with delete[]. Otherwise bad things can happen,
 since these allocators may use different memory pools (and new/delete call
-constructors and destructors). See also <a class="link" href="glib-Memory-Allocation.html#g-mem-set-vtable" title="g_mem_set_vtable ()"><code class="function">g_mem_set_vtable()</code></a>.</p>
+constructors and destructors).</p>
 </div>
 <div class="refsect1">
 <a name="glib-Memory-Allocation.functions_details"></a><h2>Functions</h2>
@@ -305,7 +305,7 @@ it is normally unnecessary to cast it explicitly, and doing
 so might hide memory allocation errors.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.2.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">
@@ -329,7 +329,6 @@ so might hide memory allocation errors.</p>
 <a name="id-1.4.7.7.2.7"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory, cast to a pointer to <em class="parameter"><code>struct_type</code></em>
 </p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -348,7 +347,7 @@ it is normally unnecessary to cast it explicitly, and doing
 so might hide memory allocation errors.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.3.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">
@@ -372,7 +371,6 @@ so might hide memory allocation errors.</p>
 <a name="id-1.4.7.7.3.7"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory, cast to a pointer to <em class="parameter"><code>struct_type</code></em>
 .</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -388,7 +386,7 @@ the memory, which may have been moved.
 Care is taken to avoid overflow when calculating the size of the allocated block.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.4.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">
@@ -417,7 +415,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block
 <a name="id-1.4.7.7.4.6"></a><h4>Returns</h4>
 <p> a pointer to the new allocated memory, cast to a pointer to <em class="parameter"><code>struct_type</code></em>
 </p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -433,7 +430,7 @@ The function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"
  is 0 of if an overflow occurs.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.5.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">
@@ -457,9 +454,8 @@ The function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"
 <a name="id-1.4.7.7.5.6"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory, cast to a pointer to <em class="parameter"><code>struct_type</code></em>
 </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">
@@ -472,10 +468,10 @@ to 0's, and returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" t
 the program on failure.
 The returned pointer is cast to a pointer to the given type.
 The function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> when <em class="parameter"><code>n_structs</code></em>
- is 0 of if an overflow occurs.</p>
+ is 0 or if an overflow occurs.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.6.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">
@@ -499,9 +495,8 @@ The function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"
 <a name="id-1.4.7.7.6.6"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory, cast to a pointer to <em class="parameter"><code>struct_type</code></em>
 </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">
@@ -517,7 +512,7 @@ It returns the new address of the memory, which may have been moved.
 The function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if an overflow occurs.</p>
 <div class="refsect3">
 <a name="id-1.4.7.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">
@@ -546,9 +541,8 @@ The function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"
 <a name="id-1.4.7.7.7.6"></a><h4>Returns</h4>
 <p> a pointer to the new allocated memory, cast to a pointer to <em class="parameter"><code>struct_type</code></em>
 </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">
@@ -561,7 +555,7 @@ If <em class="parameter"><code>n_bytes</code></em>
  is 0 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.4.7.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">
@@ -577,7 +571,6 @@ If <em class="parameter"><code>n_bytes</code></em>
 <div class="refsect3">
 <a name="id-1.4.7.7.8.6"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -591,7 +584,7 @@ If <em class="parameter"><code>n_bytes</code></em>
  is 0 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.4.7.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">
@@ -607,7 +600,6 @@ If <em class="parameter"><code>n_bytes</code></em>
 <div class="refsect3">
 <a name="id-1.4.7.7.9.6"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -628,7 +620,7 @@ and <em class="parameter"><code>mem</code></em>
  will be freed unless it is <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.4.7.7.10.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">
@@ -651,7 +643,6 @@ and <em class="parameter"><code>mem</code></em>
 <div class="refsect3">
 <a name="id-1.4.7.7.10.6"></a><h4>Returns</h4>
 <p> the new address of the allocated memory</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -664,7 +655,7 @@ g_try_malloc (<em class="parameter"><code><a class="link" href="glib-Basic-Types
 Contrast with <a class="link" href="glib-Memory-Allocation.html#g-malloc" title="g_malloc ()"><code class="function">g_malloc()</code></a>, which aborts the program on failure.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.11.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">
@@ -680,7 +671,6 @@ Contrast with <a class="link" href="glib-Memory-Allocation.html#g-malloc" title=
 <div class="refsect3">
 <a name="id-1.4.7.7.11.6"></a><h4>Returns</h4>
 <p> the allocated memory, 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>
@@ -693,7 +683,7 @@ g_try_malloc0 (<em class="parameter"><code><a class="link" href="glib-Basic-Type
 failure. Contrast with <a class="link" href="glib-Memory-Allocation.html#g-malloc0" title="g_malloc0 ()"><code class="function">g_malloc0()</code></a>, which aborts the program on failure.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.12.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,9 +699,8 @@ failure. Contrast with <a class="link" href="glib-Memory-Allocation.html#g-mallo
 <div class="refsect3">
 <a name="id-1.4.7.7.12.6"></a><h4>Returns</h4>
 <p> the allocated memory, or <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.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">
@@ -728,7 +717,7 @@ on failure.</p>
  is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, behaves the same as <a class="link" href="glib-Memory-Allocation.html#g-try-malloc" title="g_try_malloc ()"><code class="function">g_try_malloc()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.13.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">
@@ -751,7 +740,6 @@ on failure.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.13.7"></a><h4>Returns</h4>
 <p> the allocated memory, 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>
@@ -766,7 +754,7 @@ g_malloc_n (<em class="parameter"><code><a class="link" href="glib-Basic-Types.h
 but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.14.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">
@@ -789,9 +777,8 @@ but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.14.6"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory</p>
-<p></p>
 </div>
-<p class="since">Since 2.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -805,7 +792,7 @@ g_malloc0_n (<em class="parameter"><code><a class="link" href="glib-Basic-Types.
 but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.15.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">
@@ -828,9 +815,8 @@ but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.15.6"></a><h4>Returns</h4>
 <p> a pointer to the allocated memory</p>
-<p></p>
 </div>
-<p class="since">Since 2.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -845,7 +831,7 @@ g_realloc_n (<em class="parameter"><code><a class="link" href="glib-Basic-Types.
 but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.16.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">
@@ -873,9 +859,8 @@ but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.16.6"></a><h4>Returns</h4>
 <p> the new address of the allocated memory</p>
-<p></p>
 </div>
-<p class="since">Since 2.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -889,7 +874,7 @@ g_try_malloc_n (<em class="parameter"><code><a class="link" href="glib-Basic-Typ
 but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.17.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">
@@ -912,9 +897,8 @@ but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.17.6"></a><h4>Returns</h4>
 <p> the allocated memory, or <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.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -928,7 +912,7 @@ g_try_malloc0_n (<em class="parameter"><code><a class="link" href="glib-Basic-Ty
 but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.18.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">
@@ -951,9 +935,8 @@ but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.18.6"></a><h4>Returns</h4>
 <p> the allocated memory, or <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.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -968,7 +951,7 @@ g_try_realloc_n (<em class="parameter"><code><a class="link" href="glib-Basic-Ty
 but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.19.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">
@@ -996,9 +979,8 @@ but care is taken to detect possible overflow during multiplication.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.19.6"></a><h4>Returns</h4>
 <p> the allocated memory, or <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.24</p>
+<p class="since">Since: <a class="link" href="api-index-2-24.html#api-index-2.24">2.24</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1013,7 +995,7 @@ g_free (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#
 against <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> before calling this function.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.20.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">
@@ -1042,9 +1024,10 @@ Otherwise, the variable is destroyed using <em class="parameter"><code>destroy</
 pointer is set to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p>
 <p>A macro is also included that allows this function to be used without
 pointer casts.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
-<a name="id-1.4.7.7.21.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.7.7.21.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">
@@ -1053,8 +1036,9 @@ pointer casts.</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>pp</p></td>
-<td class="parameter_description"><p>a pointer to a variable, struct member etc. holding a pointer</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> a pointer to a variable, struct member etc. holding a
+pointer. </p></td>
+<td class="parameter_annotations"><span class="annotation">[not nullable]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>destroy</p></td>
@@ -1065,7 +1049,7 @@ pointer casts.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.34</p>
+<p class="since">Since: <a class="link" href="api-index-2-34.html#api-index-2.34">2.34</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1097,16 +1081,16 @@ the following example (which only works on GCC and clang):</p>
 8
 9
 10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><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="function">create_object</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="function"><a href="glib-Miscellaneous-Macros.html#g-autoptr">g_autoptr</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"> obj </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-OBJECT:CAPS">G_TYPE_OBJECT</a></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">GObject <span class="gtkdoc opt">*</span>
+<span class="function">create_object</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-autoptr">g_autoptr</a></span><span class="gtkdoc opt">(</span>GObject<span class="gtkdoc opt">)</span> obj <span class="gtkdoc opt">=</span> <span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span> <span class="gtkdoc opt">(</span>G_TYPE_OBJECT<span class="gtkdoc opt">,</span> NULL<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">early_error_case</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>early_error_case<span class="gtkdoc opt">)</span>
+    <span class="keyword">return</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-Memory-Allocation.html#g-steal-pointer">g_steal_pointer</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">obj</span><span class="symbol">);</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="keyword">return</span> <span class="function"><a href="glib-Memory-Allocation.html#g-steal-pointer">g_steal_pointer</a></span> <span class="gtkdoc opt">(&amp;</span>obj<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1132,19 +1116,19 @@ particularly useful for dealing with optional out parameters:</p>
 11
 12
 13</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">get_object</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GObject</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">obj_out</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="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a></span><span class="symbol">)</span><span class="normal"> obj </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-OBJECT:CAPS">G_TYPE_OBJECT</a></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">get_object</span> <span class="gtkdoc opt">(</span>GObject <span class="gtkdoc opt">**</span>obj_out<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>GObject<span class="gtkdoc opt">)</span> obj <span class="gtkdoc opt">=</span> <span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span> <span class="gtkdoc opt">(</span>G_TYPE_OBJECT<span class="gtkdoc opt">,</span> NULL<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">early_error_case</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>early_error_case<span class="gtkdoc opt">)</span>
+    <span class="keyword">return</span> FALSE<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">obj_out</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="symbol">*</span><span class="normal">obj_out </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-steal-pointer">g_steal_pointer</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">obj</span><span class="symbol">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>obj_out<span class="gtkdoc opt">)</span>
+    <span class="gtkdoc opt">*</span>obj_out <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-Memory-Allocation.html#g-steal-pointer">g_steal_pointer</a></span> <span class="gtkdoc opt">(&amp;</span>obj<span class="gtkdoc opt">);</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="keyword">return</span> TRUE<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1157,7 +1141,7 @@ early error case and also in the case that <a class="link" href="glib-Standard-M
 .</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.22.14"></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">
@@ -1165,12 +1149,12 @@ early error case and also in the case that <a class="link" href="glib-Standard-M
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>pp</p></td>
-<td class="parameter_description"><p>a pointer to a pointer</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> a pointer to a pointer. </p></td>
+<td class="parameter_annotations"><span class="annotation">[not nullable]</span></td>
 </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">
@@ -1200,7 +1184,7 @@ not upon exit of the enclosing function scope.</p></li>
 </ul></div>
 <div class="refsect3">
 <a name="id-1.4.7.7.23.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">
@@ -1217,7 +1201,6 @@ not upon exit of the enclosing function scope.</p></li>
 <a name="id-1.4.7.7.23.7"></a><h4>Returns</h4>
 <p> space for <em class="parameter"><code>size</code></em>
 bytes, allocated on the stack</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1227,7 +1210,7 @@ bytes, allocated on the stack</p>
 <p>Wraps <a class="link" href="glib-Memory-Allocation.html#g-alloca" title="g_alloca()"><code class="function">g_alloca()</code></a> in a more typesafe manner.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.24.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">
@@ -1252,7 +1235,6 @@ bytes, allocated on the stack</p>
 <p> Pointer to stack space for <em class="parameter"><code>n_structs</code></em>
 chunks of type <em class="parameter"><code>struct_type</code></em>
 </p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1270,7 +1252,7 @@ chunks of type <em class="parameter"><code>struct_type</code></em>
 The source and destination areas may overlap.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.25.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">
@@ -1301,7 +1283,7 @@ The source and destination areas may overlap.</p>
 <a name="g-memdup"></a><h3>g_memdup ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
 g_memdup (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> mem</code></em>,
-          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> byte_size</code></em>);</pre>
+          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> byte_size</code></em>);</pre>
 <p>Allocates <em class="parameter"><code>byte_size</code></em>
  bytes of memory, and copies <em class="parameter"><code>byte_size</code></em>
  bytes into it
@@ -1310,7 +1292,7 @@ from <em class="parameter"><code>mem</code></em>
  is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> 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.4.7.7.26.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">
@@ -1334,7 +1316,6 @@ from <em class="parameter"><code>mem</code></em>
 <a name="id-1.4.7.7.26.6"></a><h4>Returns</h4>
 <p> a pointer to the newly-allocated copy of the memory, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if <em class="parameter"><code>mem</code></em>
 is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1342,20 +1323,17 @@ is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code
 <a name="g-mem-set-vtable"></a><h3>g_mem_set_vtable ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 g_mem_set_vtable (<em class="parameter"><code><a class="link" href="glib-Memory-Allocation.html#GMemVTable" title="struct GMemVTable"><span class="type">GMemVTable</span></a> *vtable</code></em>);</pre>
-<p>Sets the <a class="link" href="glib-Memory-Allocation.html#GMemVTable" title="struct GMemVTable"><span class="type">GMemVTable</span></a> to use for memory allocation. You can use this
-to provide custom memory allocation routines.</p>
-<p>The <em class="parameter"><code>vtable</code></em>
- only needs to provide <code class="function">malloc()</code>, <code class="function">realloc()</code>, and <code class="function">free()</code>
-functions; GLib can provide default implementations of the others.
-The <code class="function">malloc()</code> and <code class="function">realloc()</code> implementations should return <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on
-failure, GLib will handle error-checking for you. <em class="parameter"><code>vtable</code></em>
- is copied,
-so need not persist after this function has been called.</p>
-<p>Note that this function must be called before using any other GLib
-functions.</p>
+<div class="warning">
+<p><code class="literal">g_mem_set_vtable</code> has been deprecated since version 2.46 and should not be used in newly-written code.</p>
+<p>Use other memory profiling tools instead</p>
+</div>
+<p>This function used to let you override the memory allocation function.
+However, its use was incompatible with the use of global constructors
+in GLib and GIO, because those use the GLib allocators before main is
+reached. Therefore this function is now deprecated and is just a stub.</p>
 <div class="refsect3">
-<a name="id-1.4.7.7.27.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.7.7.27.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">
@@ -1374,16 +1352,19 @@ functions.</p>
 <a name="g-mem-is-system-malloc"></a><h3>g_mem_is_system_malloc ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
 g_mem_is_system_malloc (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<div class="warning">
+<p><code class="literal">g_mem_is_system_malloc</code> has been deprecated since version 2.46 and should not be used in newly-written code.</p>
+<p>GLib always uses the system malloc, so this function always
+returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.</p>
+</div>
 <p>Checks whether the allocator used by <a class="link" href="glib-Memory-Allocation.html#g-malloc" title="g_malloc ()"><code class="function">g_malloc()</code></a> is the system's
 malloc implementation. If it returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> memory allocated with
 <code class="function">malloc()</code> can be used interchangeable with memory allocated using <a class="link" href="glib-Memory-Allocation.html#g-malloc" title="g_malloc ()"><code class="function">g_malloc()</code></a>.
 This function is useful for avoiding an extra copy of allocated memory returned
 by a non-GLib-based API.</p>
-<p>A different allocator can be set using <a class="link" href="glib-Memory-Allocation.html#g-mem-set-vtable" title="g_mem_set_vtable ()"><code class="function">g_mem_set_vtable()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.7.7.28.6"></a><h4>Returns</h4>
 <p> if <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, <code class="function">malloc()</code> and <a class="link" href="glib-Memory-Allocation.html#g-malloc" title="g_malloc ()"><code class="function">g_malloc()</code></a> can be mixed.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1391,14 +1372,13 @@ by a non-GLib-based API.</p>
 <a name="g-mem-profile"></a><h3>g_mem_profile ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 g_mem_profile (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
-<p>Outputs a summary of memory usage.</p>
-<p>It outputs the frequency of allocations of different sizes,
-the total number of bytes which have been allocated,
-the total number of bytes which have been freed,
-and the difference between the previous two values, i.e. the number of bytes
-still in use.</p>
-<p>Note that this function will not output anything unless you have
-previously installed the <a class="link" href="glib-Memory-Allocation.html#glib-mem-profiler-table" title="glib_mem_profiler_table"><span class="type">glib_mem_profiler_table</span></a> with <a class="link" href="glib-Memory-Allocation.html#g-mem-set-vtable" title="g_mem_set_vtable ()"><code class="function">g_mem_set_vtable()</code></a>.</p>
+<div class="warning">
+<p><code class="literal">g_mem_profile</code> has been deprecated since version 2.46 and should not be used in newly-written code.</p>
+<p>Use other memory profiling tools instead</p>
+</div>
+<p>GLib used to support some tools for memory profiling, but this
+no longer works. There are many other useful tools for memory
+profiling these days which can be used instead.</p>
 </div>
 </div>
 <div class="refsect1">
@@ -1429,9 +1409,10 @@ includes the key <code class="literal">gc-friendly</code>.</p>
 <p>A set of functions used to perform memory allocation. The same <a class="link" href="glib-Memory-Allocation.html#GMemVTable" title="struct GMemVTable"><span class="type">GMemVTable</span></a> must
 be used for all allocations in the same program; a call to <a class="link" href="glib-Memory-Allocation.html#g-mem-set-vtable" title="g_mem_set_vtable ()"><code class="function">g_mem_set_vtable()</code></a>,
 if it exists, should be prior to any use of GLib.</p>
+<p>This functions related to this has been deprecated in 2.46, and no longer work.</p>
 <div class="refsect3">
-<a name="id-1.4.7.8.3.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.7.8.3.6"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -1477,15 +1458,16 @@ if it exists, should be prior to any use of GLib.</p>
 <a name="glib-mem-profiler-table"></a><h3>glib_mem_profiler_table</h3>
 <pre class="programlisting">extern GMemVTable *glib_mem_profiler_table;
 </pre>
-<p>A <a class="link" href="glib-Memory-Allocation.html#GMemVTable" title="struct GMemVTable"><span class="type">GMemVTable</span></a> containing profiling variants of the memory
-allocation functions. Use them together with <a class="link" href="glib-Memory-Allocation.html#g-mem-profile" title="g_mem_profile ()"><code class="function">g_mem_profile()</code></a>
-in order to get information about the memory allocation pattern
-of your program.</p>
+<div class="warning">
+<p><code class="literal">glib_mem_profiler_table</code> has been deprecated since version 2.46 and should not be used in newly-written code.</p>
+<p>Use other memory profiling tools instead</p>
+</div>
+<p>Used to be a <a class="link" href="glib-Memory-Allocation.html#GMemVTable" title="struct GMemVTable"><span class="type">GMemVTable</span></a> containing profiling variants of the memory
+allocation functions, but this variable shouldn't be modified anymore.</p>
 </div>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>