gobject-introspection 3.1.1-x64-mingw32 → 3.1.2-x64-mingw32

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

@@ -2702,7 +2702,11 @@ See g_app_info_can_delete().</doc>
         </parameters>
       </virtual-method>
       <virtual-method name="equal" invoker="equal">
-        <doc xml:space="preserve">Checks if two #GAppInfos are equal.</doc>
+        <doc xml:space="preserve">Checks if two #GAppInfos are equal.
+
+Note that the check &lt;em&gt;may not&lt;/em&gt; compare each individual field, and
+only does an identity check. In case detecting changes in the contents
+is needed, program code must additionally compare relevant fields.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -3133,7 +3137,11 @@ See g_app_info_can_delete().</doc>
         </parameters>
       </method>
       <method name="equal" c:identifier="g_app_info_equal">
-        <doc xml:space="preserve">Checks if two #GAppInfos are equal.</doc>
+        <doc xml:space="preserve">Checks if two #GAppInfos are equal.
+
+Note that the check &lt;em&gt;may not&lt;/em&gt; compare each individual field, and
+only does an identity check. In case detecting changes in the contents
+is needed, program code must additionally compare relevant fields.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -4420,7 +4428,7 @@ examples below.
 
 If used, the expected form of an application identifier is very close
 to that of of a
-[DBus bus name](http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-interface).
+[D-Bus bus name](http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-interface).
 Examples include: "com.example.MyApp", "org.example.internal-apps.Calculator".
 For details on valid application identifiers, see g_application_id_is_valid().
 
@@ -10796,7 +10804,8 @@ Here is an example for exporting a #GObject:
                    throws="1">
         <doc xml:space="preserve">Synchronously connects and sets up a D-Bus client connection for
 exchanging D-Bus messages with an endpoint specified by @address
-which must be in the D-Bus address format.
+which must be in the
+[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
 
 This constructor can only be used to initiate client-side
 connections - use g_dbus_connection_new_sync() if you need to act
@@ -10971,7 +10980,8 @@ version.</doc>
                 version="2.26">
         <doc xml:space="preserve">Asynchronously connects and sets up a D-Bus client connection for
 exchanging D-Bus messages with an endpoint specified by @address
-which must be in the D-Bus address format.
+which must be in the
+[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
 
 This constructor can only be used to initiate client-side
 connections - use g_dbus_connection_new() if you need to act as the
@@ -15801,7 +15811,7 @@ modifying_filter (GDBusConnection *connection
 If the returned #GDBusMessage is different from @message and cannot
 be sent on @connection (it could use features, such as file
 descriptors, not compatible with @connection), then a warning is
-logged to &lt;emphasis&gt;standard error&lt;/emphasis&gt;. Applications can
+logged to standard error. Applications can
 check this ahead of time using g_dbus_message_to_blob() passing a
 #GDBusCapabilityFlags value obtained from @connection.</doc>
       <return-value transfer-ownership="full" nullable="1">
@@ -16234,7 +16244,9 @@ If the call was GetAll, %NULL will be returned.</doc>
               version="2.26">
         <doc xml:space="preserve">Finishes handling a D-Bus method call by returning an error.
 
-This method will free @invocation, you cannot use it afterwards.</doc>
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -16270,7 +16282,9 @@ If you are writing an application intended to be portable,
 always register errors with g_dbus_error_register_error()
 or use g_dbus_method_invocation_return_dbus_error().
 
-This method will free @invocation, you cannot use it afterwards.
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.
 
 Since 2.48, if the method call requested for a reply not to be sent
 then this call will free @invocation but otherwise do nothing (as per
@@ -16306,7 +16320,9 @@ the recommendations of the D-Bus specification).</doc>
               version="2.26">
         <doc xml:space="preserve">Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
 
-This method will free @invocation, you cannot use it afterwards.</doc>
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -16336,7 +16352,9 @@ This method will free @invocation, you cannot use it afterwards.</doc>
         <doc xml:space="preserve">Like g_dbus_method_invocation_return_error() but intended for
 language bindings.
 
-This method will free @invocation, you cannot use it afterwards.</doc>
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -16369,7 +16387,9 @@ This method will free @invocation, you cannot use it afterwards.</doc>
         <doc xml:space="preserve">Like g_dbus_method_invocation_return_error() but takes a #GError
 instead of the error domain, error code and message.
 
-This method will free @invocation, you cannot use it afterwards.</doc>
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -16390,9 +16410,30 @@ This method will free @invocation, you cannot use it afterwards.</doc>
         <doc xml:space="preserve">Finishes handling a D-Bus method call by returning @parameters.
 If the @parameters GVariant is floating, it is consumed.
 
-It is an error if @parameters is not of the right format.
+It is an error if @parameters is not of the right format: it must be a tuple
+containing the out-parameters of the D-Bus method. Even if the method has a
+single out-parameter, it must be contained in a tuple. If the method has no
+out-parameters, @parameters may be %NULL or an empty tuple.
+
+|[&lt;!-- language="C" --&gt;
+GDBusMethodInvocation *invocation = some_invocation;
+g_autofree gchar *result_string = NULL;
+g_autoptr (GError) error = NULL;
+
+result_string = calculate_result (&amp;error);
 
-This method will free @invocation, you cannot use it afterwards.
+if (error != NULL)
+  g_dbus_method_invocation_return_gerror (invocation, error);
+else
+  g_dbus_method_invocation_return_value (invocation,
+                                         g_variant_new ("(s)", result_string));
+
+/&lt;!-- --&gt;* Do not free @invocation here; returning a value does that *&lt;!-- --&gt;/
+]|
+
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.
 
 Since 2.48, if the method call requested for a reply not to be sent
 then this call will sink @parameters and free @invocation, but
@@ -16422,7 +16463,9 @@ specification).</doc>
 
 This method is only available on UNIX.
 
-This method will free @invocation, you cannot use it afterwards.</doc>
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -16454,7 +16497,9 @@ This method will free @invocation, you cannot use it afterwards.</doc>
         <doc xml:space="preserve">Like g_dbus_method_invocation_return_gerror() but takes ownership
 of @error so the caller does not need to free it.
 
-This method will free @invocation, you cannot use it afterwards.</doc>
+This method will take ownership of @invocation. See
+#GDBusInterfaceVTable for more information about the ownership of
+@invocation.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -19998,7 +20043,7 @@ This flag is only meaningful in proxies for well-known names.</doc>
               value="8"
               c:identifier="G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES"
               glib:nick="get-invalidated-properties">
-        <doc xml:space="preserve">If set, the property value for any &lt;emphasis&gt;invalidated property&lt;/emphasis&gt; will be (asynchronously) retrieved upon receiving the &lt;ulink url="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties"&gt;PropertiesChanged&lt;/ulink&gt; D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.</doc>
+        <doc xml:space="preserve">If set, the property value for any __invalidated property__ will be (asynchronously) retrieved upon receiving the [`PropertiesChanged`](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.</doc>
       </member>
       <member name="do_not_auto_start_at_construction"
               value="16"
@@ -20152,8 +20197,9 @@ g_object_unref().</doc>
       <method name="get_client_address"
               c:identifier="g_dbus_server_get_client_address"
               version="2.26">
-        <doc xml:space="preserve">Gets a D-Bus address string that can be used by clients to connect
-to @server.</doc>
+        <doc xml:space="preserve">Gets a
+[D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses)
+string that can be used by clients to connect to @server.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">A D-Bus address string. Do not free, the string is owned
 by @server.</doc>
@@ -26815,6 +26861,15 @@ resolution thumbnail without metadata. Corresponding
 for this key should contain a #GIcon.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
+    <constant name="FILE_ATTRIBUTE_RECENT_MODIFIED"
+              value="recent::modified"
+              c:type="G_FILE_ATTRIBUTE_RECENT_MODIFIED"
+              version="2.52">
+      <doc xml:space="preserve">A key in the "recent" namespace for getting time, when the metadata for the
+file in `recent:///` was last changed. Corresponding #GFileAttributeType is
+%G_FILE_ATTRIBUTE_TYPE_INT64.</doc>
+      <type name="utf8" c:type="gchar*"/>
+    </constant>
     <constant name="FILE_ATTRIBUTE_SELINUX_CONTEXT"
               value="selinux::context"
               c:type="G_FILE_ATTRIBUTE_SELINUX_CONTEXT">
@@ -27047,8 +27102,8 @@ image. Corresponding #GFileAttributeType is
               c:type="G_FILE_ATTRIBUTE_TIME_ACCESS">
       <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was last
 accessed. Corresponding #GFileAttributeType is
-%G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
-file was last accessed.</doc>
+%G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
+file was last accessed, in seconds since the UNIX epoch.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="FILE_ATTRIBUTE_TIME_ACCESS_USEC"
@@ -27065,7 +27120,8 @@ the file was last accessed. This should be used in conjunction with
               c:type="G_FILE_ATTRIBUTE_TIME_CHANGED">
       <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was last
 changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
-and contains the UNIX time since the file was last changed.
+and contains the time since the file was last changed, in seconds since the
+UNIX epoch.
 
 This corresponds to the traditional UNIX ctime.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -27084,7 +27140,8 @@ the file was last changed. This should be used in conjunction with
               c:type="G_FILE_ATTRIBUTE_TIME_CREATED">
       <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was created.
 Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
-and contains the UNIX time since the file was created.
+and contains the time since the file was created, in seconds since the UNIX
+epoch.
 
 This corresponds to the NTFS ctime.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -27103,14 +27160,14 @@ the file was created. This should be used in conjunction with
               c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED">
       <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was last
 modified. Corresponding #GFileAttributeType is
-%G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
-file was modified.</doc>
+%G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
+file was modified, in seconds since the UNIX epoch.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="FILE_ATTRIBUTE_TIME_MODIFIED_USEC"
               value="time::modified-usec"
               c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC">
-      <doc xml:space="preserve">A key in the "time" namespace for getting the miliseconds of the time
+      <doc xml:space="preserve">A key in the "time" namespace for getting the microseconds of the time
 the file was last modified. This should be used in conjunction with
 #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
 %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
@@ -27121,7 +27178,7 @@ the file was last modified. This should be used in conjunction with
               c:type="G_FILE_ATTRIBUTE_TRASH_DELETION_DATE"
               version="2.24">
       <doc xml:space="preserve">A key in the "trash" namespace.  When requested against
-items in "trash:///", will return the date and time when the file
+items in `trash:///`, will return the date and time when the file
 was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss.
 Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -27130,7 +27187,7 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
               value="trash::item-count"
               c:type="G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT">
       <doc xml:space="preserve">A key in the "trash" namespace.  When requested against
-"trash:///" returns the number of (toplevel) items in the trash folder.
+`trash:///` returns the number of (toplevel) items in the trash folder.
 Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
@@ -27139,7 +27196,7 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
               c:type="G_FILE_ATTRIBUTE_TRASH_ORIG_PATH"
               version="2.24">
       <doc xml:space="preserve">A key in the "trash" namespace.  When requested against
-items in "trash:///", will return the original path to the file before it
+items in `trash:///`, will return the original path to the file before it
 was trashed. Corresponding #GFileAttributeType is
 %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -56306,7 +56363,7 @@ the result of the operation.
 
 For behaviour details see g_output_stream_close().
 
-The asyncronous methods have a default fallback that uses threads
+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">
@@ -56604,7 +56661,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
+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.
 
@@ -56804,7 +56861,7 @@ the result of the operation.
 
 For behaviour details see g_output_stream_close().
 
-The asyncronous methods have a default fallback that uses threads
+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">
@@ -56956,7 +57013,7 @@ result of the operation.</doc>
         </parameters>
       </method>
       <method name="has_pending" c:identifier="g_output_stream_has_pending">
-        <doc xml:space="preserve">Checks if an ouput stream has pending actions.</doc>
+        <doc xml:space="preserve">Checks if an output stream has pending actions.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if @stream has pending actions.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -57466,7 +57523,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
+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.
 
@@ -63126,6 +63183,12 @@ bundle.</doc>
         <doc xml:space="preserve">No flags set.</doc>
       </member>
     </bitfield>
+    <constant name="SETTINGS_BACKEND_EXTENSION_POINT_NAME"
+              value="gsettings-backend"
+              c:type="G_SETTINGS_BACKEND_EXTENSION_POINT_NAME">
+      <doc xml:space="preserve">Extension point for #GSettingsBackend functionality.</doc>
+      <type name="utf8" c:type="gchar*"/>
+    </constant>
     <interface name="Seekable"
                c:symbol-prefix="seekable"
                c:type="GSeekable"
@@ -65282,11 +65345,10 @@ If @value is floating then this function consumes the reference.</doc>
         </parameters>
       </method>
       <property name="backend"
-                introspectable="0"
                 writable="1"
                 construct-only="1"
                 transfer-ownership="none">
-        <type/>
+        <type name="SettingsBackend"/>
       </property>
       <property name="delay-apply" version="2.28" transfer-ownership="none">
         <doc xml:space="preserve">Whether the #GSettings object is in 'delay-apply' mode. See
@@ -65460,7 +65522,14 @@ callbacks when the writability of "x" changes.</doc>
         </parameters>
       </glib:signal>
     </class>
-    <record name="SettingsBackend" c:type="GSettingsBackend" disguised="1">
+    <class name="SettingsBackend"
+           c:symbol-prefix="settings_backend"
+           c:type="GSettingsBackend"
+           parent="GObject.Object"
+           abstract="1"
+           glib:type-name="GSettingsBackend"
+           glib:get-type="g_settings_backend_get_type"
+           glib:type-struct="SettingsBackendClass">
       <doc xml:space="preserve">The #GSettingsBackend interface defines a generic interface for
 non-strictly-typed data that is stored in a hierarchy. To implement
 an alternative storage backend for #GSettings, you need to implement
@@ -65485,6 +65554,637 @@ implementations, but does not carry the same stability guarantees
 as the public GIO API. For this reason, you have to define the
 C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including
 `gio/gsettingsbackend.h`.</doc>
+      <function name="flatten_tree"
+                c:identifier="g_settings_backend_flatten_tree"
+                version="2.26">
+        <doc xml:space="preserve">Calculate the longest common prefix of all keys in a tree and write
+out an array of the key names relative to that prefix and,
+optionally, the value to store at each of those keys.
+
+You must free the value returned in @path, @keys and @values using
+g_free().  You should not attempt to free or unref the contents of
+@keys or @values.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <parameter name="tree" transfer-ownership="none">
+            <doc xml:space="preserve">a #GTree containing the changes</doc>
+            <type name="GLib.Tree" c:type="GTree*"/>
+          </parameter>
+          <parameter name="path"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full">
+            <doc xml:space="preserve">the location to save the path</doc>
+            <type name="utf8" c:type="gchar**"/>
+          </parameter>
+          <parameter name="keys"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="container">
+            <doc xml:space="preserve">the
+       location to save the relative keys</doc>
+            <array c:type="gchar***">
+              <type name="utf8" c:type="gchar**"/>
+            </array>
+          </parameter>
+          <parameter name="values"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="container"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">
+         the location to save the values, or %NULL</doc>
+            <array c:type="GVariant***">
+              <type name="GLib.Variant" c:type="GVariant**"/>
+            </array>
+          </parameter>
+        </parameters>
+      </function>
+      <function name="get_default"
+                c:identifier="g_settings_backend_get_default"
+                version="2.28">
+        <doc xml:space="preserve">Returns the default #GSettingsBackend. It is possible to override
+the default by setting the `GSETTINGS_BACKEND` environment variable
+to the name of a settings backend.
+
+The user gets a reference to the backend.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">the default #GSettingsBackend</doc>
+          <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+        </return-value>
+      </function>
+      <virtual-method name="get_permission" introspectable="0">
+        <return-value>
+          <type name="Permission" c:type="GPermission*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="path" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="get_writable">
+        <return-value transfer-ownership="none">
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="read">
+        <return-value transfer-ownership="full">
+          <type name="GLib.Variant" c:type="GVariant*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="expected_type" transfer-ownership="none">
+            <type name="GLib.VariantType" c:type="const GVariantType*"/>
+          </parameter>
+          <parameter name="default_value" transfer-ownership="none">
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="read_user_value">
+        <return-value transfer-ownership="full">
+          <type name="GLib.Variant" c:type="GVariant*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="expected_type" transfer-ownership="none">
+            <type name="GLib.VariantType" c:type="const GVariantType*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="reset">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="subscribe">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="name" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="sync">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="unsubscribe">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="name" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="write">
+        <return-value transfer-ownership="none">
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="value" transfer-ownership="none">
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <virtual-method name="write_tree">
+        <return-value transfer-ownership="none">
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="tree" transfer-ownership="none">
+            <type name="GLib.Tree" c:type="GTree*"/>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
+      <method name="changed"
+              c:identifier="g_settings_backend_changed"
+              version="2.26">
+        <doc xml:space="preserve">Signals that a single key has possibly changed.  Backend
+implementations should call this if a key has possibly changed its
+value.
+
+@key must be a valid key (ie starting with a slash, not containing
+'//', and not ending with a slash).
+
+The implementation must call this function during any call to
+g_settings_backend_write(), before the call returns (except in the
+case that no keys are actually changed and it cares to detect this
+fact).  It may not rely on the existence of a mainloop for
+dispatching the signal later.
+
+The implementation may call this function at any other time it likes
+in response to other events (such as changes occurring outside of the
+program).  These calls may originate from a mainloop or may originate
+in response to any other action (including from calls to
+g_settings_backend_write()).
+
+In the case that this call is in response to a call to
+g_settings_backend_write() then @origin_tag must be set to the same
+value that was passed to that call.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <doc xml:space="preserve">the name of the key</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the origin tag</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="changed_tree"
+              c:identifier="g_settings_backend_changed_tree"
+              version="2.26">
+        <doc xml:space="preserve">This call is a convenience wrapper.  It gets the list of changes from
+@tree, computes the longest common prefix and calls
+g_settings_backend_changed().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="tree" transfer-ownership="none">
+            <doc xml:space="preserve">a #GTree containing the changes</doc>
+            <type name="GLib.Tree" c:type="GTree*"/>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the origin tag</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="keys_changed"
+              c:identifier="g_settings_backend_keys_changed"
+              version="2.26">
+        <doc xml:space="preserve">Signals that a list of keys have possibly changed.  Backend
+implementations should call this if keys have possibly changed their
+values.
+
+@path must be a valid path (ie starting and ending with a slash and
+not containing '//').  Each string in @items must form a valid key
+name when @path is prefixed to it (ie: each item must not start or
+end with '/' and must not contain '//').
+
+The meaning of this signal is that any of the key names resulting
+from the contatenation of @path with each item in @items may have
+changed.
+
+The same rules for when notifications must occur apply as per
+g_settings_backend_changed().  These two calls can be used
+interchangeably if exactly one item has changed (although in that
+case g_settings_backend_changed() is definitely preferred).
+
+For efficiency reasons, the implementation should strive for @path to
+be as long as possible (ie: the longest common prefix of all of the
+keys that were changed) but this is not strictly required.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="path" transfer-ownership="none">
+            <doc xml:space="preserve">the path containing the changes</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="items" transfer-ownership="none">
+            <doc xml:space="preserve">the %NULL-terminated list of changed keys</doc>
+            <array c:type="gchar**">
+              <type name="utf8" c:type="gchar*"/>
+            </array>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the origin tag</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="path_changed"
+              c:identifier="g_settings_backend_path_changed"
+              version="2.26">
+        <doc xml:space="preserve">Signals that all keys below a given path may have possibly changed.
+Backend implementations should call this if an entire path of keys
+have possibly changed their values.
+
+@path must be a valid path (ie starting and ending with a slash and
+not containing '//').
+
+The meaning of this signal is that any of the key which has a name
+starting with @path may have changed.
+
+The same rules for when notifications must occur apply as per
+g_settings_backend_changed().  This call might be an appropriate
+reasponse to a 'reset' call but implementations are also free to
+explicitly list the keys that were affected by that call if they can
+easily do so.
+
+For efficiency reasons, the implementation should strive for @path to
+be as long as possible (ie: the longest common prefix of all of the
+keys that were changed) but this is not strictly required.  As an
+example, if this function is called with the path of "/" then every
+single key in the application will be notified of a possible change.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="path" transfer-ownership="none">
+            <doc xml:space="preserve">the path containing the changes</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="origin_tag"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the origin tag</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="path_writable_changed"
+              c:identifier="g_settings_backend_path_writable_changed"
+              version="2.26">
+        <doc xml:space="preserve">Signals that the writability of all keys below a given path may have
+changed.
+
+Since GSettings performs no locking operations for itself, this call
+will always be made in response to external events.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="path" transfer-ownership="none">
+            <doc xml:space="preserve">the name of the path</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="writable_changed"
+              c:identifier="g_settings_backend_writable_changed"
+              version="2.26">
+        <doc xml:space="preserve">Signals that the writability of a single key has possibly changed.
+
+Since GSettings performs no locking operations for itself, this call
+will always be made in response to external events.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="backend" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
+            <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+          </instance-parameter>
+          <parameter name="key" transfer-ownership="none">
+            <doc xml:space="preserve">the name of the key</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <field name="parent_instance">
+        <type name="GObject.Object" c:type="GObject"/>
+      </field>
+      <field name="priv" readable="0" private="1">
+        <type name="SettingsBackendPrivate" c:type="GSettingsBackendPrivate*"/>
+      </field>
+    </class>
+    <record name="SettingsBackendClass"
+            c:type="GSettingsBackendClass"
+            glib:is-gtype-struct-for="SettingsBackend">
+      <doc xml:space="preserve">Class structure for #GSettingsBackend.</doc>
+      <field name="parent_class">
+        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
+      </field>
+      <field name="read">
+        <callback name="read">
+          <return-value transfer-ownership="full">
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="key" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+            <parameter name="expected_type" transfer-ownership="none">
+              <type name="GLib.VariantType" c:type="const GVariantType*"/>
+            </parameter>
+            <parameter name="default_value" transfer-ownership="none">
+              <type name="gboolean" c:type="gboolean"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="get_writable">
+        <callback name="get_writable">
+          <return-value transfer-ownership="none">
+            <type name="gboolean" c:type="gboolean"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="key" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="write">
+        <callback name="write">
+          <return-value transfer-ownership="none">
+            <type name="gboolean" c:type="gboolean"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="key" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+            <parameter name="value" transfer-ownership="none">
+              <type name="GLib.Variant" c:type="GVariant*"/>
+            </parameter>
+            <parameter name="origin_tag"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
+              <type name="gpointer" c:type="gpointer"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="write_tree">
+        <callback name="write_tree">
+          <return-value transfer-ownership="none">
+            <type name="gboolean" c:type="gboolean"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="tree" transfer-ownership="none">
+              <type name="GLib.Tree" c:type="GTree*"/>
+            </parameter>
+            <parameter name="origin_tag"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
+              <type name="gpointer" c:type="gpointer"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="reset">
+        <callback name="reset">
+          <return-value transfer-ownership="none">
+            <type name="none" c:type="void"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="key" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+            <parameter name="origin_tag"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
+              <type name="gpointer" c:type="gpointer"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="subscribe">
+        <callback name="subscribe">
+          <return-value transfer-ownership="none">
+            <type name="none" c:type="void"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="name" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="unsubscribe">
+        <callback name="unsubscribe">
+          <return-value transfer-ownership="none">
+            <type name="none" c:type="void"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="name" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="sync">
+        <callback name="sync">
+          <return-value transfer-ownership="none">
+            <type name="none" c:type="void"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="get_permission" introspectable="0">
+        <callback name="get_permission" introspectable="0">
+          <return-value>
+            <type name="Permission" c:type="GPermission*"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="path" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="read_user_value">
+        <callback name="read_user_value">
+          <return-value transfer-ownership="full">
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </return-value>
+          <parameters>
+            <parameter name="backend" transfer-ownership="none">
+              <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+            </parameter>
+            <parameter name="key" transfer-ownership="none">
+              <type name="utf8" c:type="const gchar*"/>
+            </parameter>
+            <parameter name="expected_type" transfer-ownership="none">
+              <type name="GLib.VariantType" c:type="const GVariantType*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="padding" readable="0" private="1">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="23">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+    </record>
+    <record name="SettingsBackendPrivate"
+            c:type="GSettingsBackendPrivate"
+            disguised="1">
     </record>
     <bitfield name="SettingsBindFlags"
               glib:type-name="GSettingsBindFlags"
@@ -69053,7 +69753,8 @@ 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 to a #GSocketAddress
     pointer, or %NULL</doc>
             <type name="SocketAddress" c:type="GSocketAddress**"/>
@@ -69072,7 +69773,8 @@ 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>
             <array length="4"
@@ -74871,6 +75573,9 @@ 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.
+
 On UNIX, all strings in this array can be arbitrary byte strings.
 On Windows, they should be in UTF-8.</doc>
         <return-value transfer-ownership="none">
@@ -79565,8 +80270,8 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
                       invoker="verify_chain"
                       version="2.30"
                       throws="1">
-        <doc xml:space="preserve">Verify's a certificate chain after looking up and adding any missing
-certificates to the chain.
+        <doc xml:space="preserve">Determines the validity of a certificate chain after looking up and
+adding any missing certificates to the chain.
 
 @chain is a chain of #GTlsCertificate objects each pointing to the next
 certificate in the chain by its %issuer property. The chain may initially
@@ -79587,6 +80292,15 @@ host by host basis.
 Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
 used.
 
+If @chain is found to be valid, then the return value will be 0. If
+@chain is found to be invalid, then the return value will indicate
+the problems found. If the function is unable to determine whether
+@chain is valid or not (eg, because @cancellable is triggered
+before it completes) then the return value will be
+%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
+accordingly. @error is not set when @chain is successfully analyzed
+but found to be invalid.
+
 This function can block, use g_tls_database_verify_chain_async() to perform
 the verification operation asynchronously.</doc>
         <return-value transfer-ownership="none">
@@ -79638,9 +80352,9 @@ result of verification.</doc>
       <virtual-method name="verify_chain_async"
                       invoker="verify_chain_async"
                       version="2.30">
-        <doc xml:space="preserve">Asynchronously verify's a certificate chain after looking up and adding
-any missing certificates to the chain. See g_tls_database_verify_chain()
-for more information.</doc>
+        <doc xml:space="preserve">Asynchronously determines the validity of a certificate chain after
+looking up and adding any missing certificates to the chain. See
+g_tls_database_verify_chain() for more information.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -79707,7 +80421,16 @@ for more information.</doc>
                       version="2.30"
                       throws="1">
         <doc xml:space="preserve">Finish an asynchronous verify chain operation. See
-g_tls_database_verify_chain() for more information. *</doc>
+g_tls_database_verify_chain() for more information.
+
+If @chain is found to be valid, then the return value will be 0. If
+@chain is found to be invalid, then the return value will indicate
+the problems found. If the function is unable to determine whether
+@chain is valid or not (eg, because @cancellable is triggered
+before it completes) then the return value will be
+%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
+accordingly. @error is not set when @chain is successfully analyzed
+but found to be invalid.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the appropriate #GTlsCertificateFlags which represents the
 result of verification.</doc>
@@ -80139,8 +80862,8 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
               c:identifier="g_tls_database_verify_chain"
               version="2.30"
               throws="1">
-        <doc xml:space="preserve">Verify's a certificate chain after looking up and adding any missing
-certificates to the chain.
+        <doc xml:space="preserve">Determines the validity of a certificate chain after looking up and
+adding any missing certificates to the chain.
 
 @chain is a chain of #GTlsCertificate objects each pointing to the next
 certificate in the chain by its %issuer property. The chain may initially
@@ -80161,6 +80884,15 @@ host by host basis.
 Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
 used.
 
+If @chain is found to be valid, then the return value will be 0. If
+@chain is found to be invalid, then the return value will indicate
+the problems found. If the function is unable to determine whether
+@chain is valid or not (eg, because @cancellable is triggered
+before it completes) then the return value will be
+%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
+accordingly. @error is not set when @chain is successfully analyzed
+but found to be invalid.
+
 This function can block, use g_tls_database_verify_chain_async() to perform
 the verification operation asynchronously.</doc>
         <return-value transfer-ownership="none">
@@ -80212,9 +80944,9 @@ result of verification.</doc>
       <method name="verify_chain_async"
               c:identifier="g_tls_database_verify_chain_async"
               version="2.30">
-        <doc xml:space="preserve">Asynchronously verify's a certificate chain after looking up and adding
-any missing certificates to the chain. See g_tls_database_verify_chain()
-for more information.</doc>
+        <doc xml:space="preserve">Asynchronously determines the validity of a certificate chain after
+looking up and adding any missing certificates to the chain. See
+g_tls_database_verify_chain() for more information.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -80280,7 +81012,16 @@ for more information.</doc>
               version="2.30"
               throws="1">
         <doc xml:space="preserve">Finish an asynchronous verify chain operation. See
-g_tls_database_verify_chain() for more information. *</doc>
+g_tls_database_verify_chain() for more information.
+
+If @chain is found to be valid, then the return value will be 0. If
+@chain is found to be invalid, then the return value will indicate
+the problems found. If the function is unable to determine whether
+@chain is valid or not (eg, because @cancellable is triggered
+before it completes) then the return value will be
+%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
+accordingly. @error is not set when @chain is successfully analyzed
+but found to be invalid.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the appropriate #GTlsCertificateFlags which represents the
 result of verification.</doc>
@@ -86994,11 +87735,33 @@ g_mount_guess_content_type().</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="content_type_is_mime_type"
+              c:identifier="g_content_type_is_mime_type"
+              version="2.52">
+      <doc xml:space="preserve">Determines if @type is a subset of @mime_type.
+Convenience wrapper around g_content_type_is_a().</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if @type is a kind of @mime_type,
+    %FALSE otherwise.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="type" transfer-ownership="none">
+          <doc xml:space="preserve">a content type string</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="mime_type" transfer-ownership="none">
+          <doc xml:space="preserve">a mime type string</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="content_type_is_unknown"
               c:identifier="g_content_type_is_unknown">
       <doc xml:space="preserve">Checks if the content type is the generic "unknown" type.
 On UNIX this is the "application/octet-stream" mimetype,
-while on win32 it is "*".</doc>
+while on win32 it is "*" and on OSX it is a dynamic type
+or octet-stream.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE if the type is the unknown type.</doc>
         <type name="gboolean" c:type="gboolean"/>
@@ -87052,7 +87815,10 @@ which could be used in a D-Bus address like
               throws="1">
       <doc xml:space="preserve">Synchronously looks up the D-Bus address for the well-known message
 bus instance specified by @bus_type. This may involve using various
-platform specific mechanisms.</doc>
+platform specific mechanisms.
+
+The returned address will be in the
+[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">a valid D-Bus address string for @bus_type or %NULL if
     @error is set</doc>
@@ -87077,7 +87843,8 @@ platform specific mechanisms.</doc>
               version="2.26">
       <doc xml:space="preserve">Asynchronously connects to an endpoint specified by @address and
 sets up the connection so it is in a state to run the client-side
-of the D-Bus authentication conversation.
+of the D-Bus authentication conversation. @address must be in the
+[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
 
 When the operation is finished, @callback will be invoked. You can
 then call g_dbus_address_get_stream_finish() to get the result of
@@ -87149,7 +87916,8 @@ g_dbus_address_get_stream_sync() for the synchronous version.</doc>
               throws="1">
       <doc xml:space="preserve">Synchronously connects to an endpoint specified by @address and
 sets up the connection so it is in a state to run the client-side
-of the D-Bus authentication conversation.
+of the D-Bus authentication conversation. @address must be in the
+[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
 
 This is a synchronous failable function. See
 g_dbus_address_get_stream() for the asynchronous version.</doc>
@@ -87517,7 +88285,8 @@ The conversion never fails - a valid #GValue is always returned in
     <function name="dbus_is_address"
               c:identifier="g_dbus_is_address"
               version="2.26">
-      <doc xml:space="preserve">Checks if @string is a D-Bus address.
+      <doc xml:space="preserve">Checks if @string is a
+[D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
 
 This doesn't check if @string is actually supported by #GDBusServer
 or #GDBusConnection - use g_dbus_is_supported_address() to do more
@@ -87596,9 +88365,10 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</doc>
               c:identifier="g_dbus_is_supported_address"
               version="2.26"
               throws="1">
-      <doc xml:space="preserve">Like g_dbus_is_address() but also checks if the library suppors the
+      <doc xml:space="preserve">Like g_dbus_is_address() but also checks if the library supports the
 transports in @string and that key/value pairs for each transport
-are valid.</doc>
+are valid. See the specification of the
+[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE if @string is a valid D-Bus address that is
 supported by this library, %FALSE if @error is set.</doc>
@@ -88207,6 +88977,88 @@ of the request.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="keyfile_settings_backend_new"
+              c:identifier="g_keyfile_settings_backend_new">
+      <doc xml:space="preserve">Creates a keyfile-backed #GSettingsBackend.
+
+The filename of the keyfile to use is given by @filename.
+
+All settings read to or written from the backend must fall under the
+path given in @root_path (which must start and end with a slash and
+not contain two consecutive slashes).  @root_path may be "/".
+
+If @root_group is non-%NULL then it specifies the name of the keyfile
+group used for keys that are written directly below @root_path.  For
+example, if @root_path is "/apps/example/" and @root_group is
+"toplevel", then settings the key "/apps/example/enabled" to a value
+of %TRUE will cause the following to appear in the keyfile:
+
+|[
+  [toplevel]
+  enabled=true
+]|
+
+If @root_group is %NULL then it is not permitted to store keys
+directly below the @root_path.
+
+For keys not stored directly below @root_path (ie: in a sub-path),
+the name of the subpath (with the final slash stripped) is used as
+the name of the keyfile group.  To continue the example, if
+"/apps/example/profiles/default/font-size" were set to
+12 then the following would appear in the keyfile:
+
+|[
+  [profiles/default]
+  font-size=12
+]|
+
+The backend will refuse writes (and return writability as being
+%FALSE) for keys outside of @root_path and, in the event that
+@root_group is %NULL, also for keys directly under @root_path.
+Writes will also be refused if the backend detects that it has the
+inability to rewrite the keyfile (ie: the containing directory is not
+writable).
+
+There is no checking done for your key namespace clashing with the
+syntax of the key file format.  For example, if you have '[' or ']'
+characters in your path names or '=' in your key names you may be in
+trouble.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a keyfile-backed #GSettingsBackend</doc>
+        <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+      </return-value>
+      <parameters>
+        <parameter name="filename" transfer-ownership="none">
+          <doc xml:space="preserve">the filename of the keyfile</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="root_path" transfer-ownership="none">
+          <doc xml:space="preserve">the path under which all settings keys appear</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="root_group"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">the group name corresponding to
+             @root_path, or %NULL</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="memory_settings_backend_new"
+              c:identifier="g_memory_settings_backend_new"
+              version="2.28">
+      <doc xml:space="preserve">Creates a memory-backed #GSettingsBackend.
+
+This backend allows changes to settings, but does not write them
+to any backing storage, so the next time you run your application,
+the memory backend will start out with the default values again.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a newly created #GSettingsBackend</doc>
+        <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+      </return-value>
+    </function>
     <function name="network_monitor_get_default"
               c:identifier="g_network_monitor_get_default"
               moved-to="NetworkMonitor.get_default"
@@ -88228,6 +89080,18 @@ functions (without calling any GLib networking functions first).</doc>
         <type name="none" c:type="void"/>
       </return-value>
     </function>
+    <function name="null_settings_backend_new"
+              c:identifier="g_null_settings_backend_new"
+              version="2.28">
+      <doc xml:space="preserve">Creates a readonly #GSettingsBackend.
+
+This backend does not allow changes to settings, so all settings
+will always have their default values.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a newly created #GSettingsBackend</doc>
+        <type name="SettingsBackend" c:type="GSettingsBackend*"/>
+      </return-value>
+    </function>
     <function name="pollable_source_new"
               c:identifier="g_pollable_source_new"
               version="2.28">