gobject-introspection 3.1.8-x86-mingw32 → 3.1.9-x86-mingw32

data/vendor/local/share/gir-1.0/GModule-2.0.gir

@@ -59,16 +59,6 @@ If @module refers to the application itself, "main" is returned.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="name_utf8" c:identifier="g_module_name_utf8">
-        <return-value transfer-ownership="none">
-          <type name="utf8" c:type="const gchar*"/>
-        </return-value>
-        <parameters>
-          <instance-parameter name="module" transfer-ownership="none">
-            <type name="Module" c:type="GModule*"/>
-          </instance-parameter>
-        </parameters>
-      </method>
       <method name="symbol" c:identifier="g_module_symbol">
         <doc xml:space="preserve">Gets a symbol pointer from a module, such as one exported
 by #G_MODULE_EXPORT. Note that a valid symbol can be %NULL.</doc>
@@ -170,21 +160,6 @@ returned.</doc>
           </parameter>
         </parameters>
       </function>
-      <function name="open_utf8"
-                c:identifier="g_module_open_utf8"
-                introspectable="0">
-        <return-value>
-          <type name="Module" c:type="GModule*"/>
-        </return-value>
-        <parameters>
-          <parameter name="file_name" transfer-ownership="none">
-            <type name="utf8" c:type="const gchar*"/>
-          </parameter>
-          <parameter name="flags" transfer-ownership="none">
-            <type name="ModuleFlags" c:type="GModuleFlags"/>
-          </parameter>
-        </parameters>
-      </function>
       <function name="supported" c:identifier="g_module_supported">
         <doc xml:space="preserve">Checks if modules are supported on the current platform.</doc>
         <return-value transfer-ownership="none">

data/vendor/local/share/gir-1.0/GObject-2.0.gir

@@ -3902,7 +3902,7 @@ zeros before this function is called.</doc>
 to the #GObject implementation and should never be accessed directly.</doc>
       <constructor name="new"
                    c:identifier="g_object_new"
-                   shadowed-by="newv"
+                   shadowed-by="new_with_properties"
                    introspectable="0">
         <doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties.
 
@@ -3956,11 +3956,54 @@ which are not explicitly specified are set to their default values.</doc>
           </parameter>
         </parameters>
       </constructor>
-      <constructor name="newv" c:identifier="g_object_newv" shadows="new">
+      <constructor name="new_with_properties"
+                   c:identifier="g_object_new_with_properties"
+                   shadows="new"
+                   version="2.54">
+        <doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties using
+the provided arrays. Both arrays must have exactly @n_properties elements,
+and the names and values correspond by index.
+
+Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY)
+which are not explicitly specified are set to their default values.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new instance of
+@object_type</doc>
+          <type name="Object" c:type="GObject*"/>
+        </return-value>
+        <parameters>
+          <parameter name="object_type" transfer-ownership="none">
+            <doc xml:space="preserve">the object type to instantiate</doc>
+            <type name="GType" c:type="GType"/>
+          </parameter>
+          <parameter name="n_properties" transfer-ownership="none">
+            <doc xml:space="preserve">the number of properties</doc>
+            <type name="guint" c:type="guint"/>
+          </parameter>
+          <parameter name="names" transfer-ownership="none">
+            <doc xml:space="preserve">the names of each property to be set</doc>
+            <array length="1" zero-terminated="0" c:type="char*">
+              <type name="utf8" c:type="char"/>
+            </array>
+          </parameter>
+          <parameter name="values" transfer-ownership="none">
+            <doc xml:space="preserve">the values of each property to be set</doc>
+            <array length="1" zero-terminated="0" c:type="GValue">
+              <type name="Value" c:type="GValue"/>
+            </array>
+          </parameter>
+        </parameters>
+      </constructor>
+      <constructor name="newv"
+                   c:identifier="g_object_newv"
+                   deprecated="1"
+                   deprecated-version="2.54">
         <doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties.
 
 Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY)
 which are not explicitly specified are set to their default values.</doc>
+        <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() instead.
+deprecated. See #GParameter for more information.</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new instance of
 @object_type</doc>
@@ -4827,6 +4870,37 @@ See g_object_get().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="getv" c:identifier="g_object_getv" version="2.54">
+        <doc xml:space="preserve">Gets @n_properties properties for an @object.
+Obtained properties will be set to @values. All properties must be valid.
+Warnings will be emitted and undefined behaviour may result if invalid
+properties are passed in.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="object" transfer-ownership="none">
+            <doc xml:space="preserve">a #GObject</doc>
+            <type name="Object" c:type="GObject*"/>
+          </instance-parameter>
+          <parameter name="n_properties" transfer-ownership="none">
+            <doc xml:space="preserve">the number of properties</doc>
+            <type name="guint" c:type="guint"/>
+          </parameter>
+          <parameter name="names" transfer-ownership="none">
+            <doc xml:space="preserve">the names of each property to get</doc>
+            <array length="0" zero-terminated="0" c:type="gchar*">
+              <type name="utf8" c:type="gchar"/>
+            </array>
+          </parameter>
+          <parameter name="values" transfer-ownership="none">
+            <doc xml:space="preserve">the values of each property to get</doc>
+            <array length="0" zero-terminated="0" c:type="GValue">
+              <type name="Value" c:type="GValue"/>
+            </array>
+          </parameter>
+        </parameters>
+      </method>
       <method name="is_floating"
               c:identifier="g_object_is_floating"
               version="2.10">
@@ -5341,6 +5415,40 @@ with the same @quark.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="setv"
+              c:identifier="g_object_setv"
+              version="2.54"
+              introspectable="0">
+        <doc xml:space="preserve">Sets @n_properties properties for an @object.
+Properties to be set will be taken from @values. All properties must be
+valid. Warnings will be emitted and undefined behaviour may result if invalid
+properties are passed in.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="object" transfer-ownership="none">
+            <doc xml:space="preserve">a #GObject</doc>
+            <type name="Object" c:type="GObject*"/>
+          </instance-parameter>
+          <parameter name="n_properties" transfer-ownership="none">
+            <doc xml:space="preserve">the number of properties</doc>
+            <type name="guint" c:type="guint"/>
+          </parameter>
+          <parameter name="names" transfer-ownership="none">
+            <doc xml:space="preserve">the names of each property to be set</doc>
+            <array length="0" zero-terminated="0" c:type="gchar*">
+              <type name="utf8" c:type="gchar"/>
+            </array>
+          </parameter>
+          <parameter name="values" transfer-ownership="none">
+            <doc xml:space="preserve">the values of each property to be set</doc>
+            <array length="0" zero-terminated="0" c:type="GValue">
+              <type name="Value" c:type="GValue"/>
+            </array>
+          </parameter>
+        </parameters>
+      </method>
       <method name="steal_data" c:identifier="g_object_steal_data">
         <doc xml:space="preserve">Remove a specified datum from the object's data associations,
 without invoking the association's destroy handler.</doc>
@@ -7348,9 +7456,13 @@ g_param_type_register_static().</doc>
         </array>
       </field>
     </class>
-    <record name="Parameter" c:type="GParameter">
+    <record name="Parameter"
+            c:type="GParameter"
+            deprecated="1"
+            deprecated-version="2.54">
       <doc xml:space="preserve">The GParameter struct is an auxiliary structure used
 to hand parameter name/value pairs to g_object_newv().</doc>
+      <doc-deprecated xml:space="preserve">This type is not introspectable.</doc-deprecated>
       <field name="name" writable="1">
         <doc xml:space="preserve">the parameter name</doc>
         <type name="utf8" c:type="const gchar*"/>
@@ -12128,6 +12240,28 @@ definition  than to write one yourself using g_enum_register_static().</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="enum_to_string"
+              c:identifier="g_enum_to_string"
+              version="2.54">
+      <doc xml:space="preserve">Pretty-prints @value in the form of the enum’s name.
+
+This is intended to be used for debugging purposes. The format of the output
+may change in the future.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a newly-allocated text string</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </return-value>
+      <parameters>
+        <parameter name="g_enum_type" transfer-ownership="none">
+          <doc xml:space="preserve">the type identifier of a #GEnumClass type</doc>
+          <type name="GType" c:type="GType"/>
+        </parameter>
+        <parameter name="value" transfer-ownership="none">
+          <doc xml:space="preserve">the value</doc>
+          <type name="gint" c:type="gint"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="flags_complete_type_info"
               c:identifier="g_flags_complete_type_info">
       <doc xml:space="preserve">This function is meant to be called from the complete_type_info()
@@ -12237,6 +12371,29 @@ definition than to write one yourself using g_flags_register_static().</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="flags_to_string"
+              c:identifier="g_flags_to_string"
+              version="2.54">
+      <doc xml:space="preserve">Pretty-prints @value in the form of the flag names separated by ` | ` and
+sorted. Any extra bits will be shown at the end as a hexadecimal number.
+
+This is intended to be used for debugging purposes. The format of the output
+may change in the future.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a newly-allocated text string</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </return-value>
+      <parameters>
+        <parameter name="flags_type" transfer-ownership="none">
+          <doc xml:space="preserve">the type identifier of a #GFlagsClass type</doc>
+          <type name="GType" c:type="GType"/>
+        </parameter>
+        <parameter name="value" transfer-ownership="none">
+          <doc xml:space="preserve">the value</doc>
+          <type name="guint" c:type="guint"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="gtype_get_type" c:identifier="g_gtype_get_type">
       <return-value transfer-ownership="none">
         <type name="GType" c:type="GType"/>

data/vendor/local/share/gir-1.0/Gio-2.0.gir

@@ -4557,7 +4557,7 @@ reproduced here:
   "[A-Z][a-z][0-9]_-." and must not begin with a digit.
 
 - Application identifiers must contain at least one '.' (period)
-  character (and thus at least three elements).
+  character (and thus at least two elements).
 
 - Application identifiers must not begin or end with a '.' (period)
   character.
@@ -7189,13 +7189,17 @@ the value, and other property value pairs, and ended by %NULL.</doc>
       </function>
       <function name="newv_async"
                 c:identifier="g_async_initable_newv_async"
-                version="2.22">
+                version="2.22"
+                deprecated="1"
+                deprecated-version="2.54">
         <doc xml:space="preserve">Helper function for constructing #GAsyncInitable object. This is
 similar to g_object_newv() but also initializes the object asynchronously.
 
 When the initialization is finished, @callback will be called. You can
 then call g_async_initable_new_finish() to get the new object and check
 for any errors.</doc>
+        <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
+g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -7248,6 +7252,9 @@ interface. This must be done before any real use of the object after
 initial construction. If the object also implements #GInitable you can
 optionally call g_initable_init() instead.
 
+This method is intended for language bindings. If writing in C,
+g_async_initable_new_async() should typically be used instead.
+
 When the initialization is finished, @callback will be called. You can
 then call g_async_initable_init_finish() to get the result of the
 initialization.
@@ -7265,11 +7272,11 @@ g_object_ref() and g_object_unref() are considered to be invalid, and
 have undefined behaviour. They will often fail with g_critical() or
 g_warning(), but this must not be relied on.
 
-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.
+Callers should not assume that a class which implements #GAsyncInitable can
+be initialized multiple times; for more information, see g_initable_init().
+If a class explicitly supports being initialized multiple times,
+implementation requires yielding all subsequent calls to init_async() on the
+results of the first call.
 
 For classes that also support the #GInitable interface, the default
 implementation of this method will run the g_initable_init() function
@@ -7344,6 +7351,9 @@ interface. This must be done before any real use of the object after
 initial construction. If the object also implements #GInitable you can
 optionally call g_initable_init() instead.
 
+This method is intended for language bindings. If writing in C,
+g_async_initable_new_async() should typically be used instead.
+
 When the initialization is finished, @callback will be called. You can
 then call g_async_initable_init_finish() to get the result of the
 initialization.
@@ -7361,11 +7371,11 @@ g_object_ref() and g_object_unref() are considered to be invalid, and
 have undefined behaviour. They will often fail with g_critical() or
 g_warning(), but this must not be relied on.
 
-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.
+Callers should not assume that a class which implements #GAsyncInitable can
+be initialized multiple times; for more information, see g_initable_init().
+If a class explicitly supports being initialized multiple times,
+implementation requires yielding all subsequent calls to init_async() on the
+results of the first call.
 
 For classes that also support the #GInitable interface, the default
 implementation of this method will run the g_initable_init() function
@@ -8693,6 +8703,13 @@ the connection was disconnected.</doc>
         <doc xml:space="preserve">If another message bus connection owns the name and have
 specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.</doc>
       </member>
+      <member name="do_not_queue"
+              value="4"
+              c:identifier="G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE"
+              glib:nick="do-not-queue">
+        <doc xml:space="preserve">If another message bus connection owns the name, immediately
+return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54)</doc>
+      </member>
     </bitfield>
     <callback name="BusNameVanishedCallback"
               c:type="GBusNameVanishedCallback"
@@ -13907,10 +13924,7 @@ method.</doc>
             <doc xml:space="preserve">Indentation level.</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
-          <parameter name="string_builder"
-                     direction="out"
-                     caller-allocates="1"
-                     transfer-ownership="none">
+          <parameter name="string_builder" transfer-ownership="none">
             <doc xml:space="preserve">A #GString to to append XML data to.</doc>
             <type name="GLib.String" c:type="GString*"/>
           </parameter>
@@ -14125,7 +14139,7 @@ emitted immediately.
 
 For example, an exported D-Bus interface may queue up property
 changes and emit the
-`org.freedesktop.DBus.Properties::Propert``
+`org.freedesktop.DBus.Properties::PropertiesChanged`
 signal later (e.g. in an idle handler). This technique is useful
 for collapsing multiple property changes into one.</doc>
         <return-value transfer-ownership="none">
@@ -14245,7 +14259,7 @@ emitted immediately.
 
 For example, an exported D-Bus interface may queue up property
 changes and emit the
-`org.freedesktop.DBus.Properties::Propert``
+`org.freedesktop.DBus.Properties::PropertiesChanged`
 signal later (e.g. in an idle handler). This technique is useful
 for collapsing multiple property changes into one.</doc>
         <return-value transfer-ownership="none">
@@ -16591,10 +16605,7 @@ handling the `org.freedesktop.DBus.Introspectable.Introspect`  method.</doc>
             <doc xml:space="preserve">Indentation level.</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
-          <parameter name="string_builder"
-                     direction="out"
-                     caller-allocates="1"
-                     transfer-ownership="none">
+          <parameter name="string_builder" transfer-ownership="none">
             <doc xml:space="preserve">A #GString to to append XML data to.</doc>
             <type name="GLib.String" c:type="GString*"/>
           </parameter>
@@ -20897,7 +20908,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -20987,7 +21000,9 @@ well.</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -21020,7 +21035,9 @@ g_data_input_stream_read_line_async().</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -21053,7 +21070,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -21185,7 +21204,9 @@ does not consume the stop character.</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -21282,7 +21303,9 @@ g_data_input_stream_read_until_async().</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -21326,7 +21349,9 @@ specified.</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -21431,7 +21456,9 @@ g_data_input_stream_read_upto_async() again.</doc>
           <parameter name="length"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #gsize to get the length of the data read in</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -27644,6 +27671,10 @@ If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
 will be copied as symlinks, otherwise the target of the
 @source symlink will be copied.
 
+If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
+that is possible to copy is copied, not just the default subset (which,
+for instance, does not include the owner, see #GFileInfo).
+
 If @cancellable is not %NULL, then the operation can be cancelled by
 triggering the cancellable object from another thread. If the operation
 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
@@ -27714,9 +27745,7 @@ file), see g_file_dup().</doc>
           </parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="copy_async"
-                      invoker="copy_async"
-                      introspectable="0">
+      <virtual-method name="copy_async" invoker="copy_async">
         <doc xml:space="preserve">Copies the file @source to the location specified by @destination
 asynchronously. For details of the behaviour, see g_file_copy().
 
@@ -27759,6 +27788,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1"
+                     scope="notified"
                      closure="5">
             <doc xml:space="preserve">function to callback with progress
     information, or %NULL if progress information is not needed</doc>
@@ -27767,7 +27797,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
           <parameter name="progress_callback_data"
                      transfer-ownership="none"
                      nullable="1"
-                     allow-none="1">
+                     allow-none="1"
+                     closure="4">
             <doc xml:space="preserve">user data to pass to @progress_callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -27784,7 +27815,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1"
-                     closure="7">
+                     closure="6">
             <doc xml:space="preserve">the data to pass to callback function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -31280,6 +31311,10 @@ If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
 will be copied as symlinks, otherwise the target of the
 @source symlink will be copied.
 
+If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
+that is possible to copy is copied, not just the default subset (which,
+for instance, does not include the owner, see #GFileInfo).
+
 If @cancellable is not %NULL, then the operation can be cancelled by
 triggering the cancellable object from another thread. If the operation
 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
@@ -31350,9 +31385,7 @@ file), see g_file_dup().</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="copy_async"
-              c:identifier="g_file_copy_async"
-              introspectable="0">
+      <method name="copy_async" c:identifier="g_file_copy_async">
         <doc xml:space="preserve">Copies the file @source to the location specified by @destination
 asynchronously. For details of the behaviour, see g_file_copy().
 
@@ -31395,6 +31428,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1"
+                     scope="notified"
                      closure="5">
             <doc xml:space="preserve">function to callback with progress
     information, or %NULL if progress information is not needed</doc>
@@ -31403,7 +31437,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
           <parameter name="progress_callback_data"
                      transfer-ownership="none"
                      nullable="1"
-                     allow-none="1">
+                     allow-none="1"
+                     closure="4">
             <doc xml:space="preserve">user data to pass to @progress_callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -31419,7 +31454,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
           <parameter name="user_data"
                      transfer-ownership="none"
                      nullable="1"
-                     allow-none="1">
+                     allow-none="1"
+                     closure="6">
             <doc xml:space="preserve">the data to pass to callback function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -39555,8 +39591,8 @@ to be used as icon.</doc>
           </parameters>
         </callback>
       </field>
-      <field name="copy_async" introspectable="0">
-        <callback name="copy_async" introspectable="0">
+      <field name="copy_async">
+        <callback name="copy_async">
           <return-value transfer-ownership="none">
             <type name="none" c:type="void"/>
           </return-value>
@@ -39589,6 +39625,7 @@ to be used as icon.</doc>
                        transfer-ownership="none"
                        nullable="1"
                        allow-none="1"
+                       scope="notified"
                        closure="6">
               <doc xml:space="preserve">function to callback with progress
     information, or %NULL if progress information is not needed</doc>
@@ -39598,7 +39635,8 @@ to be used as icon.</doc>
             <parameter name="progress_callback_data"
                        transfer-ownership="none"
                        nullable="1"
-                       allow-none="1">
+                       allow-none="1"
+                       closure="5">
               <doc xml:space="preserve">user data to pass to @progress_callback</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -39615,7 +39653,7 @@ to be used as icon.</doc>
                        transfer-ownership="none"
                        nullable="1"
                        allow-none="1"
-                       closure="8">
+                       closure="7">
               <doc xml:space="preserve">the data to pass to callback function</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -46858,10 +46896,14 @@ the value, and other property value pairs, and ended by %NULL.</doc>
       <function name="newv"
                 c:identifier="g_initable_newv"
                 version="2.22"
+                deprecated="1"
+                deprecated-version="2.54"
                 throws="1">
         <doc xml:space="preserve">Helper function for constructing #GInitable object. This is
 similar to g_object_newv() but also initializes the object
 and returns %NULL, setting an error on failure.</doc>
+        <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
+g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a newly allocated
      #GObject, or %NULL on error</doc>
@@ -46894,6 +46936,9 @@ and returns %NULL, setting an error on failure.</doc>
       <virtual-method name="init" invoker="init" version="2.22" throws="1">
         <doc xml:space="preserve">Initializes the object implementing the interface.
 
+This method is intended for language bindings. If writing in C,
+g_initable_new() should typically be used instead.
+
 The object must be initialized before any real use after initial
 construction, either with this function or g_async_initable_init_async().
 
@@ -46909,11 +46954,24 @@ error, then all operations on the object except g_object_ref() and
 g_object_unref() are considered to be invalid, and have undefined
 behaviour. See the [introduction][ginitable] for more details.
 
-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.</doc>
+Callers should not assume that a class which implements #GInitable can be
+initialized multiple times, unless the class explicitly documents itself as
+supporting this. Generally, a class’ implementation of init() can assume
+(and assert) that it will only be called once. Previously, this documentation
+recommended all #GInitable implementations should be idempotent; that
+recommendation was relaxed in GLib 2.54.
+
+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.
+
+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
+#GObjectClass.constructor that sometimes returns an existing instance.
+In this pattern, a caller would expect to be able to call g_initable_init()
+on the result of g_object_new(), regardless of whether it is in fact a new
+instance.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if successful. If an error has occurred, this function will
     return %FALSE and set @error appropriately if present.</doc>
@@ -46939,6 +46997,9 @@ pattern in the GObject constructor function.</doc>
               throws="1">
         <doc xml:space="preserve">Initializes the object implementing the interface.
 
+This method is intended for language bindings. If writing in C,
+g_initable_new() should typically be used instead.
+
 The object must be initialized before any real use after initial
 construction, either with this function or g_async_initable_init_async().
 
@@ -46954,11 +47015,24 @@ error, then all operations on the object except g_object_ref() and
 g_object_unref() are considered to be invalid, and have undefined
 behaviour. See the [introduction][ginitable] for more details.
 
-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.</doc>
+Callers should not assume that a class which implements #GInitable can be
+initialized multiple times, unless the class explicitly documents itself as
+supporting this. Generally, a class’ implementation of init() can assume
+(and assert) that it will only be called once. Previously, this documentation
+recommended all #GInitable implementations should be idempotent; that
+recommendation was relaxed in GLib 2.54.
+
+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.
+
+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
+#GObjectClass.constructor that sometimes returns an existing instance.
+In this pattern, a caller would expect to be able to call g_initable_init()
+on the result of g_object_new(), regardless of whether it is in fact a new
+instance.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if successful. If an error has occurred, this function will
     return %FALSE and set @error appropriately if present.</doc>
@@ -47100,7 +47174,7 @@ operation.
 
 For behaviour details see g_input_stream_close().
 
-The asyncronous methods have a default fallback that uses threads to implement
+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.</doc>
         <return-value transfer-ownership="none">
@@ -47195,7 +47269,7 @@ Any outstanding i/o request with higher priority (lower numerical value) will
 be executed before an outstanding request with lower priority. Default
 priority is %G_PRIORITY_DEFAULT.
 
-The asyncronous methods have a default fallback that uses threads to implement
+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.</doc>
         <return-value transfer-ownership="none">
@@ -47475,7 +47549,7 @@ operation.
 
 For behaviour details see g_input_stream_close().
 
-The asyncronous methods have a default fallback that uses threads to implement
+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.</doc>
         <return-value transfer-ownership="none">
@@ -47786,7 +47860,7 @@ Any outstanding i/o request with higher priority (lower numerical value) will
 be executed before an outstanding request with lower priority. Default
 priority is %G_PRIORITY_DEFAULT.
 
-The asyncronous methods have a default fallback that uses threads to implement
+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.</doc>
         <return-value transfer-ownership="none">
@@ -52143,7 +52217,7 @@ and the #GAsyncReady data to see if the operation was completed
 successfully.  If an @error is present when g_mount_unmount_with_operation_finish()
 is called, then it will be filled with any error information.</doc>
       <virtual-method name="can_eject" invoker="can_eject">
-        <doc xml:space="preserve">Checks if @mount can be eject.</doc>
+        <doc xml:space="preserve">Checks if @mount can be ejected.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the @mount can be ejected.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -52156,7 +52230,7 @@ is called, then it will be filled with any error information.</doc>
         </parameters>
       </virtual-method>
       <virtual-method name="can_unmount" invoker="can_unmount">
-        <doc xml:space="preserve">Checks if @mount can be mounted.</doc>
+        <doc xml:space="preserve">Checks if @mount can be unmounted.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the @mount can be unmounted.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -52824,7 +52898,7 @@ and #GAsyncResult data returned in the @callback.</doc>
         </parameters>
       </virtual-method>
       <method name="can_eject" c:identifier="g_mount_can_eject">
-        <doc xml:space="preserve">Checks if @mount can be eject.</doc>
+        <doc xml:space="preserve">Checks if @mount can be ejected.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the @mount can be ejected.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -52837,7 +52911,7 @@ and #GAsyncResult data returned in the @callback.</doc>
         </parameters>
       </method>
       <method name="can_unmount" c:identifier="g_mount_can_unmount">
-        <doc xml:space="preserve">Checks if @mount can be mounted.</doc>
+        <doc xml:space="preserve">Checks if @mount can be unmounted.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the @mount can be unmounted.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -55259,8 +55333,11 @@ depending on what @addr was created with.</doc>
                glib:get-type="g_network_monitor_get_type"
                glib:type-struct="NetworkMonitorInterface">
       <doc xml:space="preserve">#GNetworkMonitor provides an easy-to-use cross-platform API
-for monitoring network connectivity. On Linux, the implementation
-is based on the kernel's netlink interface.</doc>
+for monitoring network connectivity. On Linux, the available
+implementations are based on the kernel's netlink interface and
+on NetworkManager.
+
+There is also an implementation for use inside Flatpak sandboxes.</doc>
       <prerequisite name="Initable"/>
       <function name="get_default"
                 c:identifier="g_network_monitor_get_default"
@@ -60553,7 +60630,11 @@ specify one.</doc>
                glib:type-struct="ProxyResolverInterface">
       <doc xml:space="preserve">#GProxyResolver provides synchronous and asynchronous network proxy
 resolution. #GProxyResolver is used within #GSocketClient through
-the method g_socket_connectable_proxy_enumerate().</doc>
+the method g_socket_connectable_proxy_enumerate().
+
+Implementations of #GProxyResolver based on libproxy and GNOME settings can
+be found in glib-networking. GIO comes with an implementation for use inside
+Flatpak portals.</doc>
       <function name="get_default"
                 c:identifier="g_proxy_resolver_get_default"
                 version="2.26">
@@ -62792,6 +62873,13 @@ program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable mu
 set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will
 abort.
 
+Resource files will be exported in the GResource namespace using the
+combination of the given `prefix` and the filename from the `file` element.
+The `alias` 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.
+
 Resource bundles are created by the [glib-compile-resources][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.
@@ -62804,6 +62892,7 @@ An example resource description:
     &lt;file&gt;data/splashscreen.png&lt;/file&gt;
     &lt;file compressed="true"&gt;dialog.ui&lt;/file&gt;
     &lt;file preprocess="xml-stripblanks"&gt;menumarkup.xml&lt;/file&gt;
+    &lt;file alias="example.css"&gt;data/example.css&lt;/file&gt;
   &lt;/gresource&gt;
 &lt;/gresources&gt;
 ]|
@@ -62813,6 +62902,7 @@ This will create a resource bundle with the following files:
 /org/gtk/Example/data/splashscreen.png
 /org/gtk/Example/dialog.ui
 /org/gtk/Example/menumarkup.xml
+/org/gtk/Example/example.css
 ]|
 
 Note that all resources in the process share the same namespace, so use Java-style
@@ -62833,22 +62923,24 @@ using API calls like g_resources_open_stream() to stream the data or g_resources
 to the data. You can also use URIs like "resource:///org/gtk/Example/data/splashscreen.png" with #GFile to access
 the resource data.
 
+Some higher-level APIs, such as #GtkApplication, will automatically load
+resources from certain well-known paths in the resource namespace as a
+convenience. See the documentation for those APIs for details.
+
 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 #GResource 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.)
+or library load time. If you pass `--manual-register`, 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.)
 
 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.
+are for your own resources, and resource data is often used once, during parsing, and then released.
 
 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.
-
-Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
+purposes. Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
 resources with replacements from the filesystem.  It is a colon-separated list of substitutions to perform
 during resource lookups.
 
@@ -64026,8 +64118,7 @@ of your whole loop.</doc-deprecated>
         </return-value>
       </function>
       <function name="sync" c:identifier="g_settings_sync">
-        <doc xml:space="preserve">Ensures that all pending operations for the given are complete for
-the default backend.
+        <doc xml:space="preserve">Ensures that all pending operations are complete for the default backend.
 
 Writes made to a #GSettings are handled asynchronously.  For this
 reason, it is very unlikely that the changes have it to disk by the
@@ -69773,10 +69864,11 @@ the peer, or -1 on error</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="full"
+                     nullable="1"
                      optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">a pointer which
-   may be filled with an array of #GSocketControlMessages, or %NULL</doc>
+            <doc xml:space="preserve">a pointer
+   which may be filled with an array of #GSocketControlMessages, or %NULL</doc>
             <array length="4"
                    zero-terminated="0"
                    c:type="GSocketControlMessage***">
@@ -73417,6 +73509,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="none"
+                     nullable="1"
                      optional="1"
                      allow-none="1">
             <doc xml:space="preserve">location where #GObject pointer will be stored, or %NULL</doc>
@@ -73494,6 +73587,7 @@ to get the result of the operation.</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="none"
+                     nullable="1"
                      optional="1"
                      allow-none="1">
             <doc xml:space="preserve">Optional #GObject identifying this source</doc>
@@ -73532,6 +73626,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="none"
+                     nullable="1"
                      optional="1"
                      allow-none="1">
             <doc xml:space="preserve">location where #GObject pointer will be stored, or %NULL.</doc>
@@ -73609,6 +73704,7 @@ to get the result of the operation.</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="none"
+                     nullable="1"
                      optional="1"
                      allow-none="1">
             <doc xml:space="preserve">Optional #GObject identifying this source</doc>
@@ -75573,8 +75669,12 @@ g_environ_unsetenv(), etc.
 As an alternative, you can use g_subprocess_launcher_setenv(),
 g_subprocess_launcher_unsetenv(), etc.
 
-Pass %NULL to inherit the parent  process' environment. Pass an
-empty array to set an empty environment.
+Pass an empty array to set an empty environment. Pass %NULL to inherit the
+parent process’ environment. As of GLib 2.54, the parent process’ environment
+will be copied when g_subprocess_launcher_set_environ() is called.
+Previously, it was copied when the subprocess was executed. This means the
+copied environment may now be modified (using g_subprocess_launcher_setenv(),
+etc.) before launching the subprocess.
 
 On UNIX, all strings in this array can be arbitrary byte strings.
 On Windows, they should be in UTF-8.</doc>
@@ -86827,13 +86927,17 @@ g_app_info_remove_supports_type().</doc>
     <function name="async_initable_newv_async"
               c:identifier="g_async_initable_newv_async"
               moved-to="AsyncInitable.newv_async"
-              version="2.22">
+              version="2.22"
+              deprecated="1"
+              deprecated-version="2.54">
       <doc xml:space="preserve">Helper function for constructing #GAsyncInitable object. This is
 similar to g_object_newv() but also initializes the object asynchronously.
 
 When the initialization is finished, @callback will be called. You can
 then call g_async_initable_new_finish() to get the new object and check
 for any errors.</doc>
+      <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
+g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -88261,7 +88365,11 @@ See the g_dbus_gvariant_to_gvalue() function for how to convert a
       <doc xml:space="preserve">Converts a #GVariant to a #GValue. If @value is floating, it is consumed.
 
 The rules specified in the g_dbus_gvalue_to_gvariant() function are
-used - this function is essentially its reverse form.
+used - this function is essentially its reverse form. So, a #GVariant
+containing any basic or string array type will be converted to a #GValue
+containing a basic value or string array. Any other #GVariant (handle,
+variant, tuple, dict entry) will be converted to a #GValue containing that
+#GVariant.
 
 The conversion never fails - a valid #GValue is always returned in
 @out_gvalue.</doc>
@@ -88657,10 +88765,14 @@ with the type system prior to calling g_icon_new_for_string().</doc>
               c:identifier="g_initable_newv"
               moved-to="Initable.newv"
               version="2.22"
+              deprecated="1"
+              deprecated-version="2.54"
               throws="1">
       <doc xml:space="preserve">Helper function for constructing #GInitable object. This is
 similar to g_object_newv() but also initializes the object
 and returns %NULL, setting an error on failure.</doc>
+      <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
+g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">a newly allocated
      #GObject, or %NULL on error</doc>
@@ -88694,7 +88806,10 @@ and returns %NULL, setting an error on failure.</doc>
       <doc xml:space="preserve">Converts errno.h error codes into GIO error codes. The fallback
 value %G_IO_ERROR_FAILED is returned for error codes not currently
 handled (but note that future GLib releases may return a more
-specific value instead).</doc>
+specific value instead).
+
+As %errno is global and may be modified by intermediate function
+calls, you should save its value as soon as the call which sets it</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">#GIOErrorEnum value for the given errno.h error number.</doc>
         <type name="IOErrorEnum" c:type="GIOErrorEnum"/>
@@ -89433,8 +89548,8 @@ globally registered resources and if found returns information about it.
                    transfer-ownership="full"
                    optional="1"
                    allow-none="1">
-          <doc xml:space="preserve">a location to place the flags about the file,
-   or %NULL if the length is not needed</doc>
+          <doc xml:space="preserve">a location to place the #GResourceFlags about the file,
+   or %NULL if the flags are not needed</doc>
           <type name="guint32" c:type="guint32*"/>
         </parameter>
       </parameters>