glib2 3.1.8-x86-mingw32 → 3.1.9-x86-mingw32

data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html

@@ -181,7 +181,9 @@
     <span class="lineart">├──</span> <a class="link" href="gio-GSettingsSchema-GSettingsSchemaSource.html#GSettingsSchema">GSettingsSchema</a>
     <span class="lineart">├──</span> <a class="link" href="gio-GSettingsSchema-GSettingsSchemaSource.html#GSettingsSchemaKey">GSettingsSchemaKey</a>
     <span class="lineart">├──</span> <a class="link" href="gio-GSettingsSchema-GSettingsSchemaSource.html#GSettingsSchemaSource">GSettingsSchemaSource</a>
-    <span class="lineart">╰──</span> <a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>
+    <span class="lineart">├──</span> <a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>
+    <span class="lineart">├──</span> <a class="link" href="gio-Unix-Mounts.html#GUnixMountEntry">GUnixMountEntry</a>
+    <span class="lineart">╰──</span> <a class="link" href="gio-Unix-Mounts.html#GUnixMountPoint">GUnixMountPoint</a>
 </pre>
 </div>
 <div class="footer">

data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2

@@ -1208,6 +1208,7 @@
     <keyword type="signal" name="The “stop-button” signal" link="GDrive.html#GDrive-stop-button"/>
     <keyword type="function" name="g_unix_mount_free ()" link="gio-Unix-Mounts.html#g-unix-mount-free"/>
     <keyword type="function" name="g_unix_mount_compare ()" link="gio-Unix-Mounts.html#g-unix-mount-compare"/>
+    <keyword type="function" name="g_unix_mount_copy ()" link="gio-Unix-Mounts.html#g-unix-mount-copy" since="2.54"/>
     <keyword type="function" name="g_unix_mount_get_mount_path ()" link="gio-Unix-Mounts.html#g-unix-mount-get-mount-path"/>
     <keyword type="function" name="g_unix_mount_get_device_path ()" link="gio-Unix-Mounts.html#g-unix-mount-get-device-path"/>
     <keyword type="function" name="g_unix_mount_get_fs_type ()" link="gio-Unix-Mounts.html#g-unix-mount-get-fs-type"/>
@@ -1220,6 +1221,7 @@
     <keyword type="function" name="g_unix_mount_guess_should_display ()" link="gio-Unix-Mounts.html#g-unix-mount-guess-should-display"/>
     <keyword type="function" name="g_unix_mount_point_free ()" link="gio-Unix-Mounts.html#g-unix-mount-point-free"/>
     <keyword type="function" name="g_unix_mount_point_compare ()" link="gio-Unix-Mounts.html#g-unix-mount-point-compare"/>
+    <keyword type="function" name="g_unix_mount_point_copy ()" link="gio-Unix-Mounts.html#g-unix-mount-point-copy" since="2.54"/>
     <keyword type="function" name="g_unix_mount_point_get_mount_path ()" link="gio-Unix-Mounts.html#g-unix-mount-point-get-mount-path"/>
     <keyword type="function" name="g_unix_mount_point_get_device_path ()" link="gio-Unix-Mounts.html#g-unix-mount-point-get-device-path"/>
     <keyword type="function" name="g_unix_mount_point_get_fs_type ()" link="gio-Unix-Mounts.html#g-unix-mount-point-get-fs-type"/>
@@ -1240,8 +1242,8 @@
     <keyword type="function" name="g_unix_mount_monitor_new ()" link="gio-Unix-Mounts.html#g-unix-mount-monitor-new" deprecated="2.44:Use g_unix_mount_monitor_get() instead."/>
     <keyword type="function" name="g_unix_mount_monitor_set_rate_limit ()" link="gio-Unix-Mounts.html#g-unix-mount-monitor-set-rate-limit" deprecated="2.44:This function does nothing.  Don't call it." since="2.18"/>
     <keyword type="function" name="g_unix_is_mount_path_system_internal ()" link="gio-Unix-Mounts.html#g-unix-is-mount-path-system-internal"/>
-    <keyword type="struct" name="GUnixMountPoint" link="gio-Unix-Mounts.html#GUnixMountPoint"/>
-    <keyword type="struct" name="GUnixMountEntry" link="gio-Unix-Mounts.html#GUnixMountEntry"/>
+    <keyword type="struct" name="GUnixMountPoint" link="gio-Unix-Mounts.html#GUnixMountPoint-struct"/>
+    <keyword type="struct" name="GUnixMountEntry" link="gio-Unix-Mounts.html#GUnixMountEntry-struct"/>
     <keyword type="struct" name="GUnixMountMonitor" link="gio-Unix-Mounts.html#GUnixMountMonitor-struct"/>
     <keyword type="signal" name="The “mountpoints-changed” signal" link="gio-Unix-Mounts.html#GUnixMountMonitor-mountpoints-changed"/>
     <keyword type="signal" name="The “mounts-changed” signal" link="gio-Unix-Mounts.html#GUnixMountMonitor-mounts-changed"/>
@@ -1294,7 +1296,7 @@
     <keyword type="function" name="g_initable_init ()" link="GInitable.html#g-initable-init" since="2.22"/>
     <keyword type="function" name="g_initable_new ()" link="GInitable.html#g-initable-new" since="2.22"/>
     <keyword type="function" name="g_initable_new_valist ()" link="GInitable.html#g-initable-new-valist" since="2.22"/>
-    <keyword type="function" name="g_initable_newv ()" link="GInitable.html#g-initable-newv" since="2.22"/>
+    <keyword type="function" name="g_initable_newv ()" link="GInitable.html#g-initable-newv" deprecated="" since="2.22"/>
     <keyword type="struct" name="GInitable" link="GInitable.html#GInitable-struct"/>
     <keyword type="struct" name="struct GInitableIface" link="GInitable.html#GInitableIface" since="2.22"/>
     <keyword type="function" name="g_async_initable_init_async ()" link="GAsyncInitable.html#g-async-initable-init-async" since="2.22"/>
@@ -1302,7 +1304,7 @@
     <keyword type="function" name="g_async_initable_new_async ()" link="GAsyncInitable.html#g-async-initable-new-async" since="2.22"/>
     <keyword type="function" name="g_async_initable_new_finish ()" link="GAsyncInitable.html#g-async-initable-new-finish" since="2.22"/>
     <keyword type="function" name="g_async_initable_new_valist_async ()" link="GAsyncInitable.html#g-async-initable-new-valist-async" since="2.22"/>
-    <keyword type="function" name="g_async_initable_newv_async ()" link="GAsyncInitable.html#g-async-initable-newv-async" since="2.22"/>
+    <keyword type="function" name="g_async_initable_newv_async ()" link="GAsyncInitable.html#g-async-initable-newv-async" deprecated="" since="2.22"/>
     <keyword type="struct" name="GAsyncInitable" link="GAsyncInitable.html#GAsyncInitable-struct"/>
     <keyword type="struct" name="struct GAsyncInitableIface" link="GAsyncInitable.html#GAsyncInitableIface" since="2.22"/>
     <keyword type="function" name="g_subprocess_new ()" link="GSubprocess.html#g-subprocess-new" since="2.40"/>
@@ -3172,6 +3174,7 @@
     <keyword type="constant" name="G_BUS_NAME_OWNER_FLAGS_NONE" link="gio-Owning-Bus-Names.html#G-BUS-NAME-OWNER-FLAGS-NONE:CAPS"/>
     <keyword type="constant" name="G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT" link="gio-Owning-Bus-Names.html#G-BUS-NAME-OWNER-FLAGS-ALLOW-REPLACEMENT:CAPS"/>
     <keyword type="constant" name="G_BUS_NAME_OWNER_FLAGS_REPLACE" link="gio-Owning-Bus-Names.html#G-BUS-NAME-OWNER-FLAGS-REPLACE:CAPS"/>
+    <keyword type="constant" name="G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE" link="gio-Owning-Bus-Names.html#G-BUS-NAME-OWNER-FLAGS-DO-NOT-QUEUE:CAPS"/>
     <keyword type="constant" name="G_BUS_NAME_WATCHER_FLAGS_NONE" link="gio-Watching-Bus-Names.html#G-BUS-NAME-WATCHER-FLAGS-NONE:CAPS"/>
     <keyword type="constant" name="G_BUS_NAME_WATCHER_FLAGS_AUTO_START" link="gio-Watching-Bus-Names.html#G-BUS-NAME-WATCHER-FLAGS-AUTO-START:CAPS"/>
     <keyword type="constant" name="G_DBUS_INTERFACE_SKELETON_FLAGS_NONE" link="GDBusInterfaceSkeleton.html#G-DBUS-INTERFACE-SKELETON-FLAGS-NONE:CAPS"/>

data/vendor/local/share/gtk-doc/html/gio/gresource-tool.html

@@ -67,7 +67,7 @@ possible to select which one to operate on with the
 <td><p><span class="term"><code class="option">list</code></span></p></td>
 <td><p>
 Lists resources. If <em class="replaceable"><code>SECTION</code></em> is given, only
-list resourcs in this section. If <em class="replaceable"><code>PATH</code></em> is
+list resources in this section. If <em class="replaceable"><code>PATH</code></em> is
 given, only list matching resources.
 </p></td>
 </tr>

data/vendor/local/share/gtk-doc/html/gio/index.html

@@ -15,7 +15,7 @@
 <div>
 <div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">GIO Reference Manual</p></th></tr></table></div>
 <div><p class="releaseinfo">
-      for GIO 2.52.3
+      for GIO 2.54.1
 
       The latest version of this documentation can be found on-line at
       <a class="ulink" href="https://developer.gnome.org/gio/unstable/" target="_top">https://developer.gnome.org/gio/unstable/</a>.

data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html

@@ -6,7 +6,7 @@
 <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <link rel="up" href="index.html" title="GLib Reference Manual">
-<link rel="prev" href="api-index-2-52.html" title="Index of new symbols in 2.52">
+<link rel="prev" href="api-index-2-54.html" title="Index of new symbols in 2.54">
 <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
@@ -33,7 +33,7 @@
                   <a class="shortcut" href="#glsT">T</a></span></td>
 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
-<td><a accesskey="p" href="api-index-2-52.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="p" href="api-index-2-54.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
 <td><img src="right-insensitive.png" width="16" height="16" border="0"></td>
 </tr></table>
 <div class="glossary">

data/vendor/local/share/gtk-doc/html/glib/api-index-full.html

@@ -230,6 +230,14 @@
 </dt>
 <dd></dd>
 <dt>
+<a class="link" href="glib-String-Utility-Functions.html#g-ascii-string-to-signed" title="g_ascii_string_to_signed ()">g_ascii_string_to_signed</a>, function in <a class="link" href="glib-String-Utility-Functions.html" title="String Utility Functions">String Utility Functions</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="glib-String-Utility-Functions.html#g-ascii-string-to-unsigned" title="g_ascii_string_to_unsigned ()">g_ascii_string_to_unsigned</a>, function in <a class="link" href="glib-String-Utility-Functions.html" title="String Utility Functions">String Utility Functions</a>
+</dt>
+<dd></dd>
+<dt>
 <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strncasecmp" title="g_ascii_strncasecmp ()">g_ascii_strncasecmp</a>, function in <a class="link" href="glib-String-Utility-Functions.html" title="String Utility Functions">String Utility Functions</a>
 </dt>
 <dd></dd>
@@ -4706,6 +4714,14 @@
 </dt>
 <dd></dd>
 <dt>
+<a class="link" href="glib-String-Utility-Functions.html#GNumberParserError" title="enum GNumberParserError">GNumberParserError</a>, enum in <a class="link" href="glib-String-Utility-Functions.html" title="String Utility Functions">String Utility Functions</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR:CAPS" title="G_NUMBER_PARSER_ERROR">G_NUMBER_PARSER_ERROR</a>, macro in <a class="link" href="glib-String-Utility-Functions.html" title="String Utility Functions">String Utility Functions</a>
+</dt>
+<dd></dd>
+<dt>
 <a class="link" href="glib-I18N.html#N-:CAPS" title="N_()">N_</a>, macro in <a class="link" href="glib-I18N.html" title="Internationalization">I18N</a>
 </dt>
 <dd></dd>
@@ -5132,6 +5148,14 @@
 </dt>
 <dd></dd>
 <dt>
+<a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-find" title="g_ptr_array_find ()">g_ptr_array_find</a>, function in <a class="link" href="glib-Pointer-Arrays.html" title="Pointer Arrays">Pointer Arrays</a>
+</dt>
+<dd></dd>
+<dt>
+<a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-find-with-equal-func" title="g_ptr_array_find_with_equal_func ()">g_ptr_array_find_with_equal_func</a>, function in <a class="link" href="glib-Pointer-Arrays.html" title="Pointer Arrays">Pointer Arrays</a>
+</dt>
+<dd></dd>
+<dt>
 <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-foreach" title="g_ptr_array_foreach ()">g_ptr_array_foreach</a>, function in <a class="link" href="glib-Pointer-Arrays.html" title="Pointer Arrays">Pointer Arrays</a>
 </dt>
 <dd></dd>

data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html

@@ -365,7 +365,7 @@ allocation</p></td>
 g_array_ref (<em class="parameter"><code><a class="link" href="glib-Arrays.html#GArray" title="struct GArray"><span class="type">GArray</span></a> *array</code></em>);</pre>
 <p>Atomically increments the reference count of <em class="parameter"><code>array</code></em>
  by one.
-This function is MT-safe and may be called from any thread.</p>
+This function is thread-safe and may be called from any thread.</p>
 <div class="refsect3">
 <a name="g-array-ref.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -395,7 +395,7 @@ g_array_unref (<em class="parameter"><code><a class="link" href="glib-Arrays.htm
 <p>Atomically decrements the reference count of <em class="parameter"><code>array</code></em>
  by one. If the
 reference count drops to 0, all memory allocated by the array is
-released. This function is MT-safe and may be called from any
+released. This function is thread-safe and may be called from any
 thread.</p>
 <div class="refsect3">
 <a name="g-array-unref.parameters"></a><h4>Parameters</h4>
@@ -1040,6 +1040,9 @@ of <em class="parameter"><code>array</code></em>
  will be set to zero.</p>
 <p>If array elements contain dynamically-allocated memory, they should
 be freed separately.</p>
+<p>This function is not thread-safe. If using a <a class="link" href="glib-Arrays.html#GArray" title="struct GArray"><span class="type">GArray</span></a> from multiple
+threads, use only the atomic <a class="link" href="glib-Arrays.html#g-array-ref" title="g_array_ref ()"><code class="function">g_array_ref()</code></a> and <a class="link" href="glib-Arrays.html#g-array-unref" title="g_array_unref ()"><code class="function">g_array_unref()</code></a>
+functions.</p>
 <div class="refsect3">
 <a name="g-array-free.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">

data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html

@@ -735,6 +735,12 @@ the W3C Note
 Both of these documents are profiles of ISO 8601.</p>
 <p>Use <a class="link" href="glib-GDateTime.html#g-date-time-format" title="g_date_time_format ()"><code class="function">g_date_time_format()</code></a> or <a class="link" href="glib-String-Utility-Functions.html#g-strdup-printf" title="g_strdup_printf ()"><code class="function">g_strdup_printf()</code></a> if a different
 variation of ISO 8601 format is required.</p>
+<p>If <em class="parameter"><code>time_</code></em>
+ represents a date which is too large to fit into a <code class="literal">struct tm</code>,
+<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> will be returned. This is platform dependent, but it is safe to assume
+years up to 3000 are supported. The return value of <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-to-iso8601" title="g_time_val_to_iso8601 ()"><code class="function">g_time_val_to_iso8601()</code></a>
+has been nullable since GLib 2.54; before then, GLib would crash under the
+same conditions.</p>
 <div class="refsect3">
 <a name="g-time-val-to-iso8601.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -752,7 +758,10 @@ variation of ISO 8601 format is required.</p>
 </div>
 <div class="refsect3">
 <a name="g-time-val-to-iso8601.returns"></a><h4>Returns</h4>
-<p> a newly allocated string containing an ISO 8601 date</p>
+<p> a newly allocated string containing an ISO 8601 date,
+or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if <em class="parameter"><code>time_</code></em>
+was too large. </p>
+<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-12.html#api-index-2.12">2.12</a></p>
 </div>

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

@@ -1547,7 +1547,7 @@ or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code
 <pre class="programlisting">#define             g_list_previous(list)</pre>
 <p>A convenience macro to get the previous element in a <a class="link" href="glib-Doubly-Linked-Lists.html#GList" title="struct GList"><span class="type">GList</span></a>.
 Note that it is considered perfectly acceptable to access
-<em class="parameter"><code>list-&gt;previous</code></em>
+<em class="parameter"><code>list-&gt;prev</code></em>
  directly.</p>
 <div class="refsect3">
 <a name="g-list-previous.parameters"></a><h4>Parameters</h4>

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

@@ -323,13 +323,17 @@ Here's an example:</p>
 16
 17
 18
-19</pre></td>
+19
+20
+21</pre></td>
         <td class="listing_code"><pre class="programlisting">gint
 <span class="function">foo_open_file</span> <span class="gtkdoc opt">(</span>GError <span class="gtkdoc opt">**</span>error<span class="gtkdoc opt">)</span>
 <span class="gtkdoc opt">{</span>
   gint fd<span class="gtkdoc opt">;</span>
+  <span class="gtkdoc kwb">int</span> saved_errno<span class="gtkdoc opt">;</span>
 
   fd <span class="gtkdoc opt">=</span> <span class="function">open</span> <span class="gtkdoc opt">(</span><span class="string">&quot;file.txt&quot;</span><span class="gtkdoc opt">,</span> O_RDONLY<span class="gtkdoc opt">);</span>
+  saved_errno <span class="gtkdoc opt">=</span> errno<span class="gtkdoc opt">;</span>
 
   <span class="keyword">if</span> <span class="gtkdoc opt">(</span>fd <span class="gtkdoc opt">&lt;</span> <span class="number">0</span><span class="gtkdoc opt">)</span>
     <span class="gtkdoc opt">{</span>
@@ -337,7 +341,7 @@ Here's an example:</p>
                    FOO_ERROR<span class="gtkdoc opt">,</span>                 <span class="gtkdoc slc">// error domain</span>
                    FOO_ERROR_BLAH<span class="gtkdoc opt">,</span>            <span class="gtkdoc slc">// error code</span>
                    <span class="string">&quot;Failed to open file: %s&quot;</span><span class="gtkdoc opt">,</span> <span class="gtkdoc slc">// error message format string</span>
-                   <span class="function"><a href="glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span> <span class="gtkdoc opt">(</span>errno<span class="gtkdoc opt">));</span>
+                   <span class="function"><a href="glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span> <span class="gtkdoc opt">(</span>saved_errno<span class="gtkdoc opt">));</span>
       <span class="keyword">return</span> <span class="gtkdoc opt">-</span><span class="number">1</span><span class="gtkdoc opt">;</span>
     <span class="gtkdoc opt">}</span>
   <span class="keyword">else</span>
@@ -1132,7 +1136,7 @@ to take advantage of this feature is up to you.</p>
 <tr>
 <td class="parameter_name"><p>err</p></td>
 <td class="parameter_description"><p> a return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>format</p></td>

data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html

@@ -1056,14 +1056,14 @@ can use:</p>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting">GVariant <span class="gtkdoc opt">*</span>v <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-GVariant.html#g-variant-new">g_variant_new</a></span> <span class="gtkdoc opt">(</span><span class="string">&apos;u&apos;</span><span class="gtkdoc opt">,</span> <span class="number">40</span><span class="gtkdoc opt">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting">GVariant <span class="gtkdoc opt">*</span>v <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-GVariant.html#g-variant-new">g_variant_new</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;u&quot;</span><span class="gtkdoc opt">,</span> <span class="number">40</span><span class="gtkdoc opt">);</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
 
 <p></p>
-<p>The string 'u' in the first argument tells <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> that the data passed to
+<p>The string "u" in the first argument tells <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> that the data passed to
 the constructor (40) is going to be an unsigned integer.</p>
 <p>More advanced examples of <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> in use can be found in documentation for
 GVariant format strings.</p>
@@ -1242,7 +1242,7 @@ child.</p>
 <a name="id-1.6.19.6.27"></a><h4>Summary</h4>
 <p>To put the entire example together, for our dictionary mapping
 strings to variants (with two entries, as given above), we are
-using 91 bytes of memory for type information, 29 byes of memory
+using 91 bytes of memory for type information, 29 bytes of memory
 for the serialised data, 16 bytes for buffer management and 24
 bytes for the <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance, or a total of 160 bytes, plus
 malloc overhead.  If we were to use <a class="link" href="glib-GVariant.html#g-variant-get-child-value" title="g_variant_get_child_value ()"><code class="function">g_variant_get_child_value()</code></a> to
@@ -1944,7 +1944,7 @@ pointing to the argument following the last.</p>
  must be of the correct width for their
 types specified in <em class="parameter"><code>format_string</code></em>
  when collected into the <span class="type">va_list</span>.
-See the [GVariant varargs documentation][gvariant-varargs.</p>
+See the GVariant varargs documentation.</p>
 <p>These two generalisations allow mixing of multiple calls to
 <a class="link" href="glib-GVariant.html#g-variant-new-va" title="g_variant_new_va ()"><code class="function">g_variant_new_va()</code></a> and <a class="link" href="glib-GVariant.html#g-variant-get-va" title="g_variant_get_va ()"><code class="function">g_variant_get_va()</code></a> within a single actual
 varargs call by the user.</p>
@@ -3718,9 +3718,10 @@ g_variant_new_fixed_array (<em class="parameter"><code>const <a class="link" hre
                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> elements</code></em>,
                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n_elements</code></em>,
                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> element_size</code></em>);</pre>
-<p>Provides access to the serialised data for an array of fixed-sized
-items.</p>
-<p><em class="parameter"><code>value</code></em>
+<p>Constructs a new array <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance, where the elements are
+of <em class="parameter"><code>element_type</code></em>
+ type.</p>
+<p><em class="parameter"><code>elements</code></em>
  must be an array with fixed-sized elements.  Numeric types are
 fixed-size as are tuples containing only other fixed-sized types.</p>
 <p><em class="parameter"><code>element_size</code></em>
@@ -3730,8 +3731,8 @@ you might say sizeof(gint32). This value isn't used except for the purpose
 of a double-check that the form of the serialised data matches the caller's
 expectation.</p>
 <p><em class="parameter"><code>n_elements</code></em>
-, which must be non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is set equal to the number of
-items in the array.</p>
+ must be the length of the <em class="parameter"><code>elements</code></em>
+ array.</p>
 <div class="refsect3">
 <a name="g-variant-new-fixed-array.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -5409,7 +5410,7 @@ freeing the <a class="link" href="glib-GVariant.html#GVariantBuilder" title="str
 <a class="link" href="glib-GVariant.html#GVariantBuilder" title="struct GVariantBuilder"><span class="type">GVariantBuilder</span></a> if you want to abort building the value part-way
 through.  This function need not be called if you call
 <a class="link" href="glib-GVariant.html#g-variant-builder-end" title="g_variant_builder_end ()"><code class="function">g_variant_builder_end()</code></a> and it also doesn't need to be called on
-builders allocated with g_variant_builder_new (see
+builders allocated with <a class="link" href="glib-GVariant.html#g-variant-builder-new" title="g_variant_builder_new ()"><code class="function">g_variant_builder_new()</code></a> (see
 <a class="link" href="glib-GVariant.html#g-variant-builder-unref" title="g_variant_builder_unref ()"><code class="function">g_variant_builder_unref()</code></a> for that).</p>
 <p>This function leaves the <a class="link" href="glib-GVariant.html#GVariantBuilder" title="struct GVariantBuilder"><span class="type">GVariantBuilder</span></a> structure set to all-zeros.
 It is valid to call this function on either an initialised

data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html

@@ -491,7 +491,7 @@ floating point value.</p></li>
 <li class="listitem"><p><code class="literal">s</code>: the type string of <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS" title="G_VARIANT_TYPE_STRING"><code class="literal">G_VARIANT_TYPE_STRING</code></a>; a string.</p></li>
 <li class="listitem"><p><code class="literal">o</code>: the type string of <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-OBJECT-PATH:CAPS" title="G_VARIANT_TYPE_OBJECT_PATH"><code class="literal">G_VARIANT_TYPE_OBJECT_PATH</code></a>; a string in the form
 of a D-Bus object path.</p></li>
-<li class="listitem"><p><code class="literal">g</code>: the type string of <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS" title="G_VARIANT_TYPE_STRING"><code class="literal">G_VARIANT_TYPE_STRING</code></a>; a string in the form of
+<li class="listitem"><p><code class="literal">g</code>: the type string of <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-SIGNATURE:CAPS" title="G_VARIANT_TYPE_SIGNATURE"><code class="literal">G_VARIANT_TYPE_SIGNATURE</code></a>; a string in the form of
 a D-Bus type signature.</p></li>
 <li class="listitem"><p><code class="literal">?</code>: the type string of <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-BASIC:CAPS" title="G_VARIANT_TYPE_BASIC"><code class="literal">G_VARIANT_TYPE_BASIC</code></a>; an indefinite type that
 is a supertype of any of the basic types.</p></li>
@@ -1652,9 +1652,10 @@ That's one number for everyone who was around in the late 1970s.</p>
 <a name="G-VARIANT-TYPE-UINT64:CAPS"></a><h3>G_VARIANT_TYPE_UINT64</h3>
 <pre class="programlisting">#define G_VARIANT_TYPE_UINT64               ((const GVariantType *) "t")
 </pre>
-<p>The type of an integer value that can range from 0 to</p>
-<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>That's a really big number, but a Rubik's
-cube can have a bit more than twice as many possible positions.</p></li></ol></div>
+<p>The type of an integer value that can range from 0
+to 18446744073709551615 (inclusive).  That's a really big number,
+but a Rubik's cube can have a bit more than twice as many possible
+positions.</p>
 </div>
 <hr>
 <div class="refsect2">

data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html

@@ -459,6 +459,9 @@ allocate memory to store the values, which can be a considerable
 space saving, if your set is large. The functions
 <a class="link" href="glib-Hash-Tables.html#g-hash-table-add" title="g_hash_table_add ()"><code class="function">g_hash_table_add()</code></a> and <a class="link" href="glib-Hash-Tables.html#g-hash-table-contains" title="g_hash_table_contains ()"><code class="function">g_hash_table_contains()</code></a> are designed to be
 used when using <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> this way.</p>
+<p><a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> is not designed to be statically initialised with keys and
+values known at compile time. To build a static hash table, use a tool such
+as <a class="ulink" href="https://www.gnu.org/software/gperf/" target="_top">gperf</a>.</p>
 </div>
 <div class="refsect1">
 <a name="glib-Hash-Tables.functions_details"></a><h2>Functions</h2>
@@ -945,7 +948,7 @@ of <em class="parameter"><code>hash_table</code></em>
 <td class="parameter_name"><p>value</p></td>
 <td class="parameter_description"><p> return location for the value associated
 with the key. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -1705,7 +1708,7 @@ pointed to as a result of this advancement. If <a class="link" href="glib-Standa
 <tr>
 <td class="parameter_name"><p>value</p></td>
 <td class="parameter_description"><p> a location to store the value. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>

data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html

@@ -465,7 +465,9 @@ this works for plain files, pipes, and sockets.</p>
 <p>The default encoding for <a class="link" href="glib-IO-Channels.html#GIOChannel" title="struct GIOChannel"><span class="type">GIOChannel</span></a> is UTF-8. If your application
 is reading output from a command using via pipe, you may need to set
 the encoding to the encoding of the current locale (see
-<a class="link" href="glib-Character-Set-Conversion.html#g-get-charset" title="g_get_charset ()"><code class="function">g_get_charset()</code></a>) with the <a class="link" href="glib-IO-Channels.html#g-io-channel-set-encoding" title="g_io_channel_set_encoding ()"><code class="function">g_io_channel_set_encoding()</code></a> function.</p>
+<a class="link" href="glib-Character-Set-Conversion.html#g-get-charset" title="g_get_charset ()"><code class="function">g_get_charset()</code></a>) with the <a class="link" href="glib-IO-Channels.html#g-io-channel-set-encoding" title="g_io_channel_set_encoding ()"><code class="function">g_io_channel_set_encoding()</code></a> function.
+By default, the fd passed will not be closed when the final reference
+to the <a class="link" href="glib-IO-Channels.html#GIOChannel" title="struct GIOChannel"><span class="type">GIOChannel</span></a> data structure is dropped.</p>
 <p>If you want to read raw binary data without interpretation, then
 call the <a class="link" href="glib-IO-Channels.html#g-io-channel-set-encoding" title="g_io_channel_set_encoding ()"><code class="function">g_io_channel_set_encoding()</code></a> function with <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the
 encoding argument.</p>
@@ -1907,8 +1909,7 @@ by <a class="link" href="glib-IO-Channels.html#g-io-channel-new-file" title="g_i
 </div>
 <div class="refsect3">
 <a name="g-io-channel-get-close-on-unref.returns"></a><h4>Returns</h4>
-<p> Whether the channel will be closed on the final unref of
-the GIOChannel data structure.</p>
+<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the channel will be closed, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise.</p>
 </div>
 </div>
 <hr>
@@ -1917,8 +1918,11 @@ the GIOChannel data structure.</p>
 <pre class="programlisting"><span class="returnvalue">void</span>
 g_io_channel_set_close_on_unref (<em class="parameter"><code><a class="link" href="glib-IO-Channels.html#GIOChannel" title="struct GIOChannel"><span class="type">GIOChannel</span></a> *channel</code></em>,
                                  <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> do_close</code></em>);</pre>
+<p>Whether to close the channel on the final unref of the <a class="link" href="glib-IO-Channels.html#GIOChannel" title="struct GIOChannel"><span class="type">GIOChannel</span></a>
+data structure. The default value of this is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for channels
+created by <a class="link" href="glib-IO-Channels.html#g-io-channel-new-file" title="g_io_channel_new_file ()"><code class="function">g_io_channel_new_file()</code></a>, and <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all other channels.</p>
 <p>Setting this flag to <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for a channel you have already closed
-can cause problems.</p>
+can cause problems when the final reference to the <a class="link" href="glib-IO-Channels.html#GIOChannel" title="struct GIOChannel"><span class="type">GIOChannel</span></a> is dropped.</p>
 <div class="refsect3">
 <a name="g-io-channel-set-close-on-unref.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1936,9 +1940,7 @@ can cause problems.</p>
 <tr>
 <td class="parameter_name"><p>do_close</p></td>
 <td class="parameter_description"><p>Whether to close the channel on the final unref of
-the GIOChannel data structure. The default value of
-this is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for channels created by <a class="link" href="glib-IO-Channels.html#g-io-channel-new-file" title="g_io_channel_new_file ()"><code class="function">g_io_channel_new_file()</code></a>,
-and <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all other channels.</p></td>
+the GIOChannel data structure.</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>

data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html

@@ -1164,7 +1164,10 @@ g_log_structured (<em class="parameter"><code>const <a class="link" href="glib-B
 <p>Log a message with structured data. The message will be passed through to
 the log writer set by the application using <a class="link" href="glib-Message-Logging.html#g-log-set-writer-func" title="g_log_set_writer_func ()"><code class="function">g_log_set_writer_func()</code></a>. If the
 message is fatal (i.e. its log level is <a class="link" href="glib-Message-Logging.html#G-LOG-LEVEL-ERROR:CAPS"><code class="literal">G_LOG_LEVEL_ERROR</code></a>), the program will
-be aborted at the end of this function.</p>
+be aborted at the end of this function. If the log writer returns
+<a class="link" href="glib-Message-Logging.html#G-LOG-WRITER-UNHANDLED:CAPS"><code class="literal">G_LOG_WRITER_UNHANDLED</code></a> (failure), no other fallback writers will be tried.
+See the documentation for <a class="link" href="glib-Message-Logging.html#GLogWriterFunc" title="GLogWriterFunc ()"><span class="type">GLogWriterFunc</span></a> for information on chaining
+writers.</p>
 <p>The structured data is provided as key–value pairs, where keys are UTF-8
 strings, and values are arbitrary pointers — typically pointing to UTF-8
 strings, but that is not a requirement. To pass binary (non-nul-terminated)
@@ -1251,8 +1254,8 @@ interpreted as a string.</p>
 
 <p></p>
 <p>Note also that, even if no other structured fields are specified, there
-must always be a "MESSAGE" key before the format string. The "MESSAGE"-format
-pair has to be the last of the key-value pairs, and "MESSAGE" is the only
+must always be a <code class="literal">MESSAGE</code> key before the format string. The <code class="literal">MESSAGE</code>-format
+pair has to be the last of the key-value pairs, and <code class="literal">MESSAGE</code> is the only
 field for which <code class="function">printf()</code>-style formatting is supported.</p>
 <p>The default writer function for <code class="literal">stdout</code> and <code class="literal">stderr</code> will automatically
 append a new-line character after the message, so you should not add one
@@ -1416,6 +1419,12 @@ can write arbitrary binary output, as field values may be arbitrary binary.</p>
  as the <code class="literal">PRIORITY</code> field,
 but is provided separately for convenience of deciding whether or where to
 output the log entry.</p>
+<p>Writer functions should return <a class="link" href="glib-Message-Logging.html#G-LOG-WRITER-HANDLED:CAPS"><code class="literal">G_LOG_WRITER_HANDLED</code></a> if they handled the log
+message successfully or if they deliberately ignored it. If there was an
+error handling the message (for example, if the writer function is meant to
+send messages to a remote logging server and there is a network error), it
+should return <a class="link" href="glib-Message-Logging.html#G-LOG-WRITER-UNHANDLED:CAPS"><code class="literal">G_LOG_WRITER_UNHANDLED</code></a>. This allows writer functions to be
+chained and fall back to simpler handlers in case of failure.</p>
 <div class="refsect3">
 <a name="GLogWriterFunc.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1541,6 +1550,20 @@ g_log_writer_is_journald (<em class="parameter"><code><a class="link" href="glib
  file descriptor is a connection to the
 systemd journal, or something else (like a log file or <code class="literal">stdout</code> or
 <code class="literal">stderr</code>).</p>
+<p>Invalid file descriptors are accepted and return <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>, which allows for
+the following construct without needing any additional error handling:</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1</pre></td>
+        <td class="listing_code"><pre class="programlisting">is_journald <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-Message-Logging.html#g-log-writer-is-journald">g_log_writer_is_journald</a></span> <span class="gtkdoc opt">(</span><span class="function">fileno</span> <span class="gtkdoc opt">(</span>stderr<span class="gtkdoc opt">));</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+<p></p>
 <div class="refsect3">
 <a name="g-log-writer-is-journald.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1806,8 +1829,7 @@ array</p></td>
 <pre class="programlisting">#define G_LOG_DOMAIN    ((gchar*) 0)
 </pre>
 <p>Defines the log domain.</p>
-<p>For applications, this is typically left as the default <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
-(or "") domain. Libraries should define this so that any messages
+<p>Libraries should define this so that any messages
 which they log can be differentiated from messages from other
 libraries and application code. But be careful not to define
 it in any public header files.</p>
@@ -1824,6 +1846,9 @@ it in any public header files.</p>
 </div>
 
 <p></p>
+<p>Applications can choose to leave it as the default <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> (or "")
+domain. However, defining the domain offers the same advantages as
+above.</p>
 </div>
 <hr>
 <div class="refsect2">