glib2 3.1.8-x64-mingw32 → 3.1.9-x64-mingw32

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

@@ -159,6 +159,8 @@ g_initable_init (<em class="parameter"><code><a class="link" href="GInitable.htm
                  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
                  <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>Initializes the object implementing the interface.</p>
+<p>This method is intended for language bindings. If writing in C,
+<a class="link" href="GInitable.html#g-initable-new" title="g_initable_new ()"><code class="function">g_initable_new()</code></a> should typically be used instead.</p>
 <p>The object must be initialized before any real use after initial
 construction, either with this function or <a class="link" href="GAsyncInitable.html#g-async-initable-init-async" title="g_async_initable_init_async ()"><code class="function">g_async_initable_init_async()</code></a>.</p>
 <p>Implementations may also support cancellation. If <em class="parameter"><code>cancellable</code></em>
@@ -173,11 +175,22 @@ the object doesn't support cancellable initialization the error
 error, then all operations on the object except <a href="../gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> and
 <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> are considered to be invalid, and have undefined
 behaviour. See the introduction for more details.</p>
-<p>Implementations of this method must be idempotent, i.e. multiple calls
-to this function with the same argument should return the same results.
-Only the first call initializes the object, further calls return the result
-of the first call. This is so that it's safe to implement the singleton
-pattern in the GObject constructor function.</p>
+<p>Callers should not assume that a class which implements <a class="link" href="GInitable.html" title="GInitable"><span class="type">GInitable</span></a> can be
+initialized multiple times, unless the class explicitly documents itself as
+supporting this. Generally, a class’ implementation of <code class="function">init()</code> can assume
+(and assert) that it will only be called once. Previously, this documentation
+recommended all <a class="link" href="GInitable.html" title="GInitable"><span class="type">GInitable</span></a> implementations should be idempotent; that
+recommendation was relaxed in GLib 2.54.</p>
+<p>If a class explicitly supports being initialized multiple times, it is
+recommended that the method is idempotent: multiple calls with the same
+arguments should return the same results. Only the first call initializes
+the object; further calls return the result of the first call.</p>
+<p>One reason why a class might need to support idempotent initialization is if
+it is designed to be used via the singleton pattern, with a
+<a href="../gobject-The-Base-Object-Type.html#GObjectClass.constructor"><span class="type">GObjectClass.constructor</span></a> that sometimes returns an existing instance.
+In this pattern, a caller would expect to be able to call <a class="link" href="GInitable.html#g-initable-init" title="g_initable_init ()"><code class="function">g_initable_init()</code></a>
+on the result of <a href="../gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a>, regardless of whether it is in fact a new
+instance.</p>
 <div class="refsect3">
 <a name="g-initable-init.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -343,6 +356,11 @@ g_initable_newv (<em class="parameter"><code><a href="../gobject-Type-Informatio
                  <em class="parameter"><code><a href="../gobject-The-Base-Object-Type.html#GParameter"><span class="type">GParameter</span></a> *parameters</code></em>,
                  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
                  <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<div class="warning">
+<p><code class="literal">g_initable_newv</code> has been deprecated since version 2.54 and should not be used in newly-written code.</p>
+<p>Use <a href="../gobject-The-Base-Object-Type.html#g-object-new-with-properties"><code class="function">g_object_new_with_properties()</code></a> and
+<a class="link" href="GInitable.html#g-initable-init" title="g_initable_init ()"><code class="function">g_initable_init()</code></a> instead. See <a href="../gobject-The-Base-Object-Type.html#GParameter"><span class="type">GParameter</span></a> for more information.</p>
+</div>
 <p>Helper function for constructing <a class="link" href="GInitable.html" title="GInitable"><span class="type">GInitable</span></a> object. This is
 similar to <a href="../gobject-The-Base-Object-Type.html#g-object-newv"><code class="function">g_object_newv()</code></a> but also initializes the object
 and returns <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, setting an error on failure.</p>

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

@@ -673,7 +673,7 @@ as many bytes as requested. Zero is returned on end of file
 <p>Any outstanding i/o request with higher priority (lower numerical value) will
 be executed before an outstanding request with lower priority. Default
 priority is <a href="../glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT:CAPS"><code class="literal">G_PRIORITY_DEFAULT</code></a>.</p>
-<p>The asyncronous methods have a default fallback that uses threads to implement
+<p>The asynchronous methods have a default fallback that uses threads to implement
 asynchronicity, so they are optional for inheriting classes. However, if you
 override one you must override all.</p>
 <div class="refsect3">
@@ -898,7 +898,7 @@ When the operation is finished <em class="parameter"><code>callback</code></em>
 You can then call <a class="link" href="GInputStream.html#g-input-stream-close-finish" title="g_input_stream_close_finish ()"><code class="function">g_input_stream_close_finish()</code></a> to get the result of the 
 operation.</p>
 <p>For behaviour details see <a class="link" href="GInputStream.html#g-input-stream-close" title="g_input_stream_close ()"><code class="function">g_input_stream_close()</code></a>.</p>
-<p>The asyncronous methods have a default fallback that uses threads to implement
+<p>The asynchronous methods have a default fallback that uses threads to implement
 asynchronicity, so they are optional for inheriting classes. However, if you
 override one you must override all.</p>
 <div class="refsect3">
@@ -1163,7 +1163,8 @@ values include 4096 and 8192.</p></td>
 </div>
 <div class="refsect3">
 <a name="g-input-stream-read-bytes.returns"></a><h4>Returns</h4>
-<p> a new <a href="../glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</p>
+<p> a new <a href="../glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-34.html#api-index-2.34">2.34</a></p>
 </div>
@@ -1280,7 +1281,8 @@ ignore.</p></td>
 </div>
 <div class="refsect3">
 <a name="g-input-stream-read-bytes-finish.returns"></a><h4>Returns</h4>
-<p> the newly-allocated <a href="../glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</p>
+<p> the newly-allocated <a href="../glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-34.html#api-index-2.34">2.34</a></p>
 </div>

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

@@ -610,7 +610,7 @@ The returned object should be unreffed with
 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 g_mount_can_unmount (<em class="parameter"><code><a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> *mount</code></em>);</pre>
 <p>Checks if <em class="parameter"><code>mount</code></em>
- can be mounted.</p>
+ can be unmounted.</p>
 <div class="refsect3">
 <a name="g-mount-can-unmount.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -955,7 +955,7 @@ ignore.</p></td>
 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 g_mount_can_eject (<em class="parameter"><code><a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> *mount</code></em>);</pre>
 <p>Checks if <em class="parameter"><code>mount</code></em>
- can be eject.</p>
+ can be ejected.</p>
 <div class="refsect3">
 <a name="g-mount-can-eject.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">

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

@@ -191,8 +191,10 @@ GNetworkMonitor requires
 <div class="refsect1">
 <a name="GNetworkMonitor.description"></a><h2>Description</h2>
 <p><a class="link" href="GNetworkMonitor.html" title="GNetworkMonitor"><span class="type">GNetworkMonitor</span></a> provides an easy-to-use cross-platform API
-for monitoring network connectivity. On Linux, the implementation
-is based on the kernel's netlink interface.</p>
+for monitoring network connectivity. On Linux, the available
+implementations are based on the kernel's netlink interface and
+on NetworkManager.</p>
+<p>There is also an implementation for use inside Flatpak sandboxes.</p>
 </div>
 <div class="refsect1">
 <a name="GNetworkMonitor.functions_details"></a><h2>Functions</h2>

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

@@ -136,6 +136,9 @@ GProxyResolver is implemented by
 <p><a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> provides synchronous and asynchronous network proxy
 resolution. <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> is used within <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> through
 the method <a class="link" href="GSocketConnectable.html#g-socket-connectable-proxy-enumerate" title="g_socket_connectable_proxy_enumerate ()"><code class="function">g_socket_connectable_proxy_enumerate()</code></a>.</p>
+<p>Implementations of <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> based on libproxy and GNOME settings can
+be found in glib-networking. GIO comes with an implementation for use inside
+Flatpak portals.</p>
 </div>
 <div class="refsect1">
 <a name="GProxyResolver.functions_details"></a><h2>Functions</h2>

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

@@ -256,6 +256,12 @@ the resource file, rather than an (uncompressed) copy if it. For this, the gdk-p
 program must be in the PATH, or the <code class="literal">GDK_PIXBUF_PIXDATA</code> environment variable must be
 set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will
 abort.</p>
+<p>Resource files will be exported in the GResource namespace using the
+combination of the given <code class="literal">prefix</code> and the filename from the <code class="literal">file</code> element.
+The <code class="literal">alias</code> attribute can be used to alter the filename to expose them at a
+different location in the resource namespace. Typically, this is used to
+include files from a different source directory without exposing the source
+directory in the resource namespace, as in the example below.</p>
 <p>Resource bundles are created by the glib-compile-resources program
 which takes an XML file that describes the bundle, and a set of files that the XML references. These
 are combined into a binary resource bundle.</p>
@@ -271,13 +277,15 @@ are combined into a binary resource bundle.</p>
 5
 6
 7
-8</pre></td>
+8
+9</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">&lt;?</span>xml version<span class="gtkdoc opt">=</span><span class="string">&quot;1.0&quot;</span> encoding<span class="gtkdoc opt">=</span><span class="string">&quot;UTF-8&quot;</span><span class="gtkdoc opt">?&gt;</span>
 <span class="gtkdoc opt">&lt;</span>gresources<span class="gtkdoc opt">&gt;</span>
   <span class="gtkdoc opt">&lt;</span>gresource prefix<span class="gtkdoc opt">=</span><span class="string">&quot;/org/gtk/Example&quot;</span><span class="gtkdoc opt">&gt;</span>
     <span class="gtkdoc opt">&lt;</span>file<span class="gtkdoc opt">&gt;</span>data<span class="gtkdoc opt">/</span>splashscreen<span class="gtkdoc opt">.</span>png<span class="gtkdoc opt">&lt;/</span>file<span class="gtkdoc opt">&gt;</span>
     <span class="gtkdoc opt">&lt;</span>file compressed<span class="gtkdoc opt">=</span><span class="string">&quot;true&quot;</span><span class="gtkdoc opt">&gt;</span>dialog<span class="gtkdoc opt">.</span>ui<span class="gtkdoc opt">&lt;/</span>file<span class="gtkdoc opt">&gt;</span>
     <span class="gtkdoc opt">&lt;</span>file preprocess<span class="gtkdoc opt">=</span><span class="string">&quot;xml-stripblanks&quot;</span><span class="gtkdoc opt">&gt;</span>menumarkup<span class="gtkdoc opt">.</span>xml<span class="gtkdoc opt">&lt;/</span>file<span class="gtkdoc opt">&gt;</span>
+    <span class="gtkdoc opt">&lt;</span>file alias<span class="gtkdoc opt">=</span><span class="string">&quot;example.css&quot;</span><span class="gtkdoc opt">&gt;</span>data<span class="gtkdoc opt">/</span>example<span class="gtkdoc opt">.</span>css<span class="gtkdoc opt">&lt;/</span>file<span class="gtkdoc opt">&gt;</span>
   <span class="gtkdoc opt">&lt;/</span>gresource<span class="gtkdoc opt">&gt;</span>
 <span class="gtkdoc opt">&lt;/</span>gresources<span class="gtkdoc opt">&gt;</span></pre></td>
       </tr>
@@ -293,10 +301,12 @@ are combined into a binary resource bundle.</p>
       <tr>
         <td class="listing_lines" align="right"><pre>1
 2
-3</pre></td>
+3
+4</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">/</span>org<span class="gtkdoc opt">/</span>gtk<span class="gtkdoc opt">/</span>Example<span class="gtkdoc opt">/</span>data<span class="gtkdoc opt">/</span>splashscreen<span class="gtkdoc opt">.</span>png
 <span class="gtkdoc opt">/</span>org<span class="gtkdoc opt">/</span>gtk<span class="gtkdoc opt">/</span>Example<span class="gtkdoc opt">/</span>dialog<span class="gtkdoc opt">.</span>ui
-<span class="gtkdoc opt">/</span>org<span class="gtkdoc opt">/</span>gtk<span class="gtkdoc opt">/</span>Example<span class="gtkdoc opt">/</span>menumarkup<span class="gtkdoc opt">.</span>xml</pre></td>
+<span class="gtkdoc opt">/</span>org<span class="gtkdoc opt">/</span>gtk<span class="gtkdoc opt">/</span>Example<span class="gtkdoc opt">/</span>menumarkup<span class="gtkdoc opt">.</span>xml
+<span class="gtkdoc opt">/</span>org<span class="gtkdoc opt">/</span>gtk<span class="gtkdoc opt">/</span>Example<span class="gtkdoc opt">/</span>example<span class="gtkdoc opt">.</span>css</pre></td>
       </tr>
     </tbody>
   </table>
@@ -318,19 +328,21 @@ register the resource so its files can be accessed using
 using API calls like <a class="link" href="GResource.html#g-resources-open-stream" title="g_resources_open_stream ()"><code class="function">g_resources_open_stream()</code></a> to stream the data or <a class="link" href="GResource.html#g-resources-lookup-data" title="g_resources_lookup_data ()"><code class="function">g_resources_lookup_data()</code></a> to get a direct pointer
 to the data. You can also use URIs like "resource:///org/gtk/Example/data/splashscreen.png" with <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to access
 the resource data.</p>
+<p>Some higher-level APIs, such as <a href="../gtk4/GtkApplication.html#GtkApplication-struct"><span class="type">GtkApplication</span></a>, will automatically load
+resources from certain well-known paths in the resource namespace as a
+convenience. See the documentation for those APIs for details.</p>
 <p>There are two forms of the generated source, the default version uses the compiler support for constructor
 and destructor functions (where available) to automatically create and register the <a class="link" href="GResource.html" title="GResource"><span class="type">GResource</span></a> on startup
-or library load time. If you pass --manual-register two functions to register/unregister the resource is instead
-created. This requires an explicit initialization call in your application/library, but it works on all platforms,
-even on the minor ones where this is not available. (Constructor support is available for at least Win32, Mac OS and Linux.)</p>
+or library load time. If you pass <code class="literal">--manual-register</code>, two functions to register/unregister the resource are created
+instead. This requires an explicit initialization call in your application/library, but it works on all platforms,
+even on the minor ones where constructors are not supported. (Constructor support is available for at least Win32, Mac OS and Linux.)</p>
 <p>Note that resource data can point directly into the data segment of e.g. a library, so if you are unloading libraries
 during runtime you need to be very careful with keeping around pointers to data from a resource, as this goes away
 when the library is unloaded. However, in practice this is not generally a problem, since most resource accesses
-is for your own resources, and resource data is often used once, during parsing, and then released.</p>
+are for your own resources, and resource data is often used once, during parsing, and then released.</p>
 <p>When debugging a program or testing a change to an installed version, it is often useful to be able to
 replace resources in the program or library, without recompiling, for debugging or quick hacking and testing
-purposes.</p>
-<p>Since GLib 2.50, it is possible to use the <code class="literal">G_RESOURCE_OVERLAYS</code> environment variable to selectively overlay
+purposes. Since GLib 2.50, it is possible to use the <code class="literal">G_RESOURCE_OVERLAYS</code> environment variable to selectively overlay
 resources with replacements from the filesystem.  It is a colon-separated list of substitutions to perform
 during resource lookups.</p>
 <p>A substitution has the form</p>
@@ -1054,8 +1066,8 @@ or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</
 </tr>
 <tr>
 <td class="parameter_name"><p>flags</p></td>
-<td class="parameter_description"><p> a location to place the flags about the file,
-or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </p></td>
+<td class="parameter_description"><p> a location to place the <a class="link" href="GResource.html#GResourceFlags" title="enum GResourceFlags"><span class="type">GResourceFlags</span></a> about the file,
+or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the flags are not needed. </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>
 </tr>
 <tr>

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

@@ -1244,8 +1244,7 @@ have.</p>
 <a name="g-settings-sync"></a><h3>g_settings_sync ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 g_settings_sync (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
-<p>Ensures that all pending operations for the given are complete for
-the default backend.</p>
+<p>Ensures that all pending operations are complete for the default backend.</p>
 <p>Writes made to a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> are handled asynchronously.  For this
 reason, it is very unlikely that the changes have it to disk by the
 time <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> returns.</p>

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

@@ -1351,9 +1351,9 @@ pointer, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="litera
 </tr>
 <tr>
 <td class="parameter_name"><p>messages</p></td>
-<td class="parameter_description"><p> a pointer which
-may be filled with an array of <a href="GSocketControlMessage.html#GSocketControlMessage-struct"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages][<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_description"><p> a pointer
+which may be filled with an array of <a href="GSocketControlMessage.html#GSocketControlMessage-struct"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages][<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>
 <tr>
 <td class="parameter_name"><p>num_messages</p></td>

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

@@ -522,7 +522,7 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
 <tr>
 <td class="parameter_name"><p>source_object</p></td>
 <td class="parameter_description"><p> location where <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> pointer will be stored, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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="Don't free data after the code is done."><span class="acronym">transfer none</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="Don't free data after the code is done."><span class="acronym">transfer none</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>cancellable</p></td>
@@ -622,7 +622,7 @@ g_socket_listener_accept_finish (<em class="parameter"><code><a class="link" hre
 <tr>
 <td class="parameter_name"><p>source_object</p></td>
 <td class="parameter_description"><p> Optional <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> identifying this source. </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="Don't free data after the code is done."><span class="acronym">transfer none</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="Don't free data after the code is done."><span class="acronym">transfer none</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>error</p></td>
@@ -678,7 +678,7 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
 <tr>
 <td class="parameter_name"><p>source_object</p></td>
 <td class="parameter_description"><p> location where <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> pointer will be stored, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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="Don't free data after the code is done."><span class="acronym">transfer none</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="Don't free data after the code is done."><span class="acronym">transfer none</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>cancellable</p></td>
@@ -779,7 +779,7 @@ g_socket_listener_accept_socket_finish
 <tr>
 <td class="parameter_name"><p>source_object</p></td>
 <td class="parameter_description"><p> Optional <a href="../gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> identifying this source. </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="Don't free data after the code is done."><span class="acronym">transfer none</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="Don't free data after the code is done."><span class="acronym">transfer none</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>error</p></td>

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

@@ -360,8 +360,12 @@ the process 'environ' and using the functions <a href="../glib-Miscellaneous-Uti
 <a href="../glib-Miscellaneous-Utility-Functions.html#g-environ-unsetenv"><code class="function">g_environ_unsetenv()</code></a>, etc.</p>
 <p>As an alternative, you can use <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-setenv" title="g_subprocess_launcher_setenv ()"><code class="function">g_subprocess_launcher_setenv()</code></a>,
 <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-unsetenv" title="g_subprocess_launcher_unsetenv ()"><code class="function">g_subprocess_launcher_unsetenv()</code></a>, etc.</p>
-<p>Pass <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to inherit the parent  process' environment. Pass an
-empty array to set an empty environment.</p>
+<p>Pass an empty array to set an empty environment. Pass <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to inherit the
+parent process’ environment. As of GLib 2.54, the parent process’ environment
+will be copied when <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-set-environ" title="g_subprocess_launcher_set_environ ()"><code class="function">g_subprocess_launcher_set_environ()</code></a> is called.
+Previously, it was copied when the subprocess was executed. This means the
+copied environment may now be modified (using <a class="link" href="GSubprocessLauncher.html#g-subprocess-launcher-setenv" title="g_subprocess_launcher_setenv ()"><code class="function">g_subprocess_launcher_setenv()</code></a>,
+etc.) before launching the subprocess.</p>
 <p>On UNIX, all strings in this array can be arbitrary byte strings.
 On Windows, they should be in UTF-8.</p>
 <div class="refsect3">

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

@@ -812,7 +812,7 @@ argument should have been filled in by using
 </tr>
 <tr>
 <td class="struct_member_name"><p><em class="structfield"><code><a name="GTlsInteractionClass.request-certificate-async"></a>request_certificate_async</code></em> ()</p></td>
-<td class="struct_member_description"><p>ask for a certificate asyncronously.</p></td>
+<td class="struct_member_description"><p>ask for a certificate asynchronously.</p></td>
 <td class="struct_member_annotations"> </td>
 </tr>
 <tr>

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

@@ -9422,7 +9422,7 @@ g_native_socket_address_new, function in GNativeSocketAddress
 </dt>
 <dd></dd>
 <dt>
-<a class="link" href="gio-Unix-Mounts.html#GUnixMountEntry" title="GUnixMountEntry">GUnixMountEntry</a>, struct in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
+<a class="link" href="gio-Unix-Mounts.html#GUnixMountEntry-struct" title="GUnixMountEntry">GUnixMountEntry</a>, struct in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
 </dt>
 <dd></dd>
 <dt>
@@ -9438,7 +9438,7 @@ g_native_socket_address_new, function in GNativeSocketAddress
 </dt>
 <dd></dd>
 <dt>
-<a class="link" href="gio-Unix-Mounts.html#GUnixMountPoint" title="GUnixMountPoint">GUnixMountPoint</a>, struct in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
+<a class="link" href="gio-Unix-Mounts.html#GUnixMountPoint-struct" title="GUnixMountPoint">GUnixMountPoint</a>, struct in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
 </dt>
 <dd></dd>
 <dt>
@@ -9610,6 +9610,10 @@ g_native_socket_address_new, function in GNativeSocketAddress
 </dt>
 <dd></dd>
 <dt>
+<a class="link" href="gio-Unix-Mounts.html#g-unix-mount-copy" title="g_unix_mount_copy ()">g_unix_mount_copy</a>, function in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
+</dt>
+<dd></dd>
+<dt>
 <a class="link" href="gio-Unix-Mounts.html#g-unix-mount-free" title="g_unix_mount_free ()">g_unix_mount_free</a>, function in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
 </dt>
 <dd></dd>
@@ -9678,6 +9682,10 @@ g_native_socket_address_new, function in GNativeSocketAddress
 </dt>
 <dd></dd>
 <dt>
+<a class="link" href="gio-Unix-Mounts.html#g-unix-mount-point-copy" title="g_unix_mount_point_copy ()">g_unix_mount_point_copy</a>, function in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
+</dt>
+<dd></dd>
+<dt>
 <a class="link" href="gio-Unix-Mounts.html#g-unix-mount-point-free" title="g_unix_mount_point_free ()">g_unix_mount_point_free</a>, function in <a class="link" href="gio-Unix-Mounts.html" title="Unix Mounts">Unix Mounts</a>
 </dt>
 <dd></dd>

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

@@ -34,6 +34,7 @@
 <div class="cmdsynopsis"><p><code class="command">gdbus</code>   monitor  [ --system  |   --session  |   --address <em class="replaceable"><code>address</code></em> ]  --dest <em class="replaceable"><code>bus_name</code></em>  [ --object-path <em class="replaceable"><code>/path/to/object</code></em> ]</p></div>
 <div class="cmdsynopsis"><p><code class="command">gdbus</code>   call  [ --system  |   --session  |   --address <em class="replaceable"><code>address</code></em> ]  --dest <em class="replaceable"><code>bus_name</code></em>   --object-path <em class="replaceable"><code>/path/to/object</code></em>   --method <em class="replaceable"><code>org.project.InterfaceName.MethodName</code></em>  [ --timeout <em class="replaceable"><code>seconds</code></em> ]  ARG1   ARG2... </p></div>
 <div class="cmdsynopsis"><p><code class="command">gdbus</code>   emit  [ --system  |   --session  |   --address <em class="replaceable"><code>address</code></em> ]  --object-path <em class="replaceable"><code>/path/to/object</code></em>   --signal <em class="replaceable"><code>org.project.InterfaceName.SignalName</code></em>  [ --dest <em class="replaceable"><code>unique_bus_name</code></em> ]  ARG1   ARG2... </p></div>
+<div class="cmdsynopsis"><p><code class="command">gdbus</code>   wait  [ --system  |   --session  |   --address <em class="replaceable"><code>address</code></em> ]  --activate <em class="replaceable"><code>bus_name</code></em>  [ --timeout <em class="replaceable"><code>seconds</code></em> ]  <em class="replaceable"><code>bus_name</code></em> </p></div>
 <div class="cmdsynopsis"><p><code class="command">gdbus</code>   help </p></div>
 </div>
 <div class="refsect1">
@@ -92,6 +93,15 @@
         </p></td>
 </tr>
 <tr>
+<td><p><span class="term"><code class="option">wait</code></span></p></td>
+<td><p>
+          Waits until <em class="replaceable"><code>bus_name</code></em> is owned by some
+          process on the bus. If the <code class="option">--activate</code> is specified,
+          that bus name will be auto-started first. It may be the same as the
+          bus name being waited for, or different.
+        </p></td>
+</tr>
+<tr>
 <td><p><span class="term"><code class="option">help</code></span></p></td>
 <td><p>
           Prints help and exit.
@@ -277,6 +287,34 @@ $ gdbus emit --session --object-path /foo --signal org.bar.Foo "['foo', 'bar', '
 <pre class="programlisting">
 $ gdbus emit --session --object-path /bar --signal org.bar.Bar someString --dest :1.42
 </pre>
+<p>
+  Waiting for a well-known name to be owned on the bus; this will
+  <span class="emphasis"><em>not</em></span> auto-start the service:
+</p>
+<pre class="programlisting">
+$ gdbus wait --session org.bar.SomeName
+</pre>
+<p>
+  Auto-starting then waiting for a well-known name to be owned on the bus:
+</p>
+<pre class="programlisting">
+$ gdbus wait --session --activate org.bar.SomeName
+</pre>
+<p>
+  Auto-starting a different service, then waiting for a well-known name to be
+  owned on the bus. This is useful in situations where
+  <em class="replaceable"><code>SomeName</code></em> is not directly activatable:
+</p>
+<pre class="programlisting">
+$ gdbus wait --session --activate org.bar.PrerequisiteName org.bar.SomeName
+</pre>
+<p>
+  Waiting for a well-known name and giving up after 30 seconds. By default,
+  the timeout is disabled; or set <code class="option">--timeout</code> to 0 to disable it:
+</p>
+<pre class="programlisting">
+$ gdbus wait --session --timeout 30 org.bar.SomeName
+</pre>
 </div>
 <div class="refsect1">
 <a name="id-1.4.26.6.9"></a><h2>Bugs</h2>

data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html

@@ -581,8 +581,8 @@ method.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>string_builder</p></td>
-<td class="parameter_description"><p> A <a href="../glib-Strings.html#GString"><span class="type">GString</span></a> to to append XML data to. </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>]</span></td>
+<td class="parameter_description"><p>A <a href="../glib-Strings.html#GString"><span class="type">GString</span></a> to to append XML data to.</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 </tbody>
 </table></div>
@@ -703,8 +703,8 @@ handling the <code class="literal">org.freedesktop.DBus.Introspectable.Introspec
 </tr>
 <tr>
 <td class="parameter_name"><p>string_builder</p></td>
-<td class="parameter_description"><p> A <a href="../glib-Strings.html#GString"><span class="type">GString</span></a> to to append XML data to. </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>]</span></td>
+<td class="parameter_description"><p>A <a href="../glib-Strings.html#GString"><span class="type">GString</span></a> to to append XML data to.</p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 </tbody>
 </table></div>

data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html

@@ -351,7 +351,11 @@ g_dbus_gvariant_to_gvalue (<em class="parameter"><code><a href="../glib-GVariant
 <p>Converts a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to a <a href="../gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. If <em class="parameter"><code>value</code></em>
  is floating, it is consumed.</p>
 <p>The rules specified in the <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvalue-to-gvariant" title="g_dbus_gvalue_to_gvariant ()"><code class="function">g_dbus_gvalue_to_gvariant()</code></a> function are
-used - this function is essentially its reverse form.</p>
+used - this function is essentially its reverse form. So, a <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>
+containing any basic or string array type will be converted to a <a href="../gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
+containing a basic value or string array. Any other <a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> (handle,
+variant, tuple, dict entry) will be converted to a <a href="../gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing that
+<a href="../glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.</p>
 <p>The conversion never fails - a valid <a href="../gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> is always returned in
 <em class="parameter"><code>out_gvalue</code></em>
 .</p>

data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html

@@ -198,7 +198,7 @@ ep <span class="gtkdoc opt">=</span> <span class="function"><a href="gio-Extensi
 5
 6</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="gtkdoc slc">// Implement an extension point</span>
-<span class="function"><a href="../gobject-Type-Information.html#G-DEFINE-TYPE:CAPS">G_DEFINE_TYPE</a></span> <span class="gtkdoc opt">(</span>MyExampleImpl<span class="gtkdoc opt">,</span> my_example_impl<span class="gtkdoc opt">,</span> MY_TYPE_EXAMPLE<span class="gtkdoc opt">);</span>
+<span class="function"><a href="../gobject-Type-Information.html#G-DEFINE-TYPE:CAPS">G_DEFINE_TYPE</a></span> <span class="gtkdoc opt">(</span>MyExampleImpl<span class="gtkdoc opt">,</span> my_example_impl<span class="gtkdoc opt">,</span> MY_TYPE_EXAMPLE<span class="gtkdoc opt">)</span>
 <span class="function"><a href="gio-Extension-Points.html#g-io-extension-point-implement">g_io_extension_point_implement</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;my-extension-point&quot;</span><span class="gtkdoc opt">,</span>
                                 <span class="function">my_example_impl_get_type</span> <span class="gtkdoc opt">(),</span>
                                 <span class="string">&quot;my-example&quot;</span><span class="gtkdoc opt">,</span>

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

@@ -96,6 +96,8 @@ g_io_error_from_errno (<em class="parameter"><code><a href="../glib-Basic-Types.
 value <a class="link" href="gio-GIOError.html#G-IO-ERROR-FAILED:CAPS"><code class="literal">G_IO_ERROR_FAILED</code></a> is returned for error codes not currently
 handled (but note that future GLib releases may return a more
 specific value instead).</p>
+<p>As <code class="literal">errno</code> is global and may be modified by intermediate function
+calls, you should save its value as soon as the call which sets it</p>
 <div class="refsect3">
 <a name="g-io-error-from-errno.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">