gobject-introspection 3.2.1-x64-mingw32 → 3.2.2-x64-mingw32

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

@@ -2633,8 +2633,8 @@ but used automatically by GLib when specifying a %NULL marshaller.</doc>
       <function name="new" c:identifier="g_cclosure_new" introspectable="0">
         <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
 the last parameter.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a new #GCClosure</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
           <type name="Closure" c:type="GClosure*"/>
         </return-value>
         <parameters>
@@ -2711,8 +2711,8 @@ after the object is is freed.</doc>
                 introspectable="0">
         <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
 the first parameter.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a new #GCClosure</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
           <type name="Closure" c:type="GClosure*"/>
         </return-value>
         <parameters>
@@ -2903,8 +2903,8 @@ In the case of C programs, a closure usually just holds a pointer
 to a function and maybe a data argument, and the marshaller
 converts between #GValue and native C types. The GObject
 library provides the #GCClosure type for this purpose. Bindings for
-other languages need marshallers which convert between #GValue&lt;!--
---&gt;s and suitable representations in the runtime of the language in
+other languages need marshallers which convert between #GValues
+and suitable representations in the runtime of the language in
 order to use functions written in that languages as callbacks.
 
 Within GObject, closures play an important role in the
@@ -3059,8 +3059,8 @@ MyClosure *my_closure_new (gpointer data)
   return my_closure;
 }
 ]|</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a newly allocated #GClosure</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a floating reference to a new #GClosure</doc>
           <type name="Closure" c:type="GClosure*"/>
         </return-value>
         <parameters>
@@ -4084,7 +4084,9 @@ interface property.
 This function is meant to be called from the interface's default
 vtable initialization function (the @class_init member of
 #GTypeInfo.) It must not be called after after @class_init has
-been called for any object types implementing this interface.</doc>
+been called for any object types implementing this interface.
+
+If @pspec is a floating reference, it will be consumed.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -4462,9 +4464,13 @@ g_object_bind_property_with_closures() instead.</doc>
     or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="notify" transfer-ownership="none" scope="async">
-            <doc xml:space="preserve">function to be called when disposing the binding, to free the
-    resources used by the transformation functions</doc>
+          <parameter name="notify"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     scope="async">
+            <doc xml:space="preserve">a function to call when disposing the binding, to free
+    resources used by the transformation functions, or %NULL if not required</doc>
             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
           </parameter>
         </parameters>
@@ -4781,7 +4787,8 @@ of three properties: an integer, a string and an object:
       <method name="get_data" c:identifier="g_object_get_data">
         <doc xml:space="preserve">Gets a named field from the objects table of associations (see g_object_set_data()).</doc>
         <return-value transfer-ownership="none" nullable="1">
-          <doc xml:space="preserve">the data if found, or %NULL if no such data exists.</doc>
+          <doc xml:space="preserve">the data if found,
+         or %NULL if no such data exists.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </return-value>
         <parameters>
@@ -4997,7 +5004,12 @@ and then notify a change on the "foo" property with:
         </parameters>
       </method>
       <method name="ref" c:identifier="g_object_ref">
-        <doc xml:space="preserve">Increases the reference count of @object.</doc>
+        <doc xml:space="preserve">Increases the reference count of @object.
+
+Since GLib 2.56, if `GLIB_VERSION_MAX_ALLOWED` is 2.56 or greater, the type
+of @object will be propagated to the return type (using the GCC typeof()
+extension), so any casting the caller needs to do on the return type must be
+explicit.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the same @object</doc>
           <type name="Object" c:type="gpointer"/>
@@ -5017,7 +5029,10 @@ In other words, if the object is floating, then this call "assumes
 ownership" of the floating reference, converting it to a normal
 reference by clearing the floating flag while leaving the reference
 count unchanged.  If the object is not floating, then this call
-adds a new normal reference increasing the reference count by one.</doc>
+adds a new normal reference increasing the reference count by one.
+
+Since GLib 2.56, the type of @object will be propagated to the return type
+under the same conditions as for g_object_ref().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">@object</doc>
           <type name="Object" c:type="gpointer"/>
@@ -5084,7 +5099,8 @@ to match the one used with g_object_add_weak_pointer().</doc>
       </method>
       <method name="replace_data"
               c:identifier="g_object_replace_data"
-              version="2.34">
+              version="2.34"
+              introspectable="0">
         <doc xml:space="preserve">Compares the user data for the key @key on @object with
 @oldval, and if they are the same, replaces @oldval with
 @newval.
@@ -5095,7 +5111,7 @@ operation, for user data on an object.
 If the previous value was replaced then ownership of the
 old value (@oldval) is passed to the caller, including
 the registered destroy notify for it (passed out in @old_destroy).
-Its up to the caller to free this as he wishes, which may
+It’s up to the caller to free this as needed, which may
 or may not include using @old_destroy as sometimes replacement
 should not destroy the object in the normal way.</doc>
         <return-value transfer-ownership="none">
@@ -5135,8 +5151,10 @@ should not destroy the object in the normal way.</doc>
             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
           </parameter>
           <parameter name="old_destroy"
+                     direction="out"
+                     caller-allocates="0"
                      transfer-ownership="none"
-                     nullable="1"
+                     optional="1"
                      allow-none="1"
                      scope="async">
             <doc xml:space="preserve">destroy notify for the existing value</doc>
@@ -5146,7 +5164,8 @@ should not destroy the object in the normal way.</doc>
       </method>
       <method name="replace_qdata"
               c:identifier="g_object_replace_qdata"
-              version="2.34">
+              version="2.34"
+              introspectable="0">
         <doc xml:space="preserve">Compares the user data for the key @quark on @object with
 @oldval, and if they are the same, replaces @oldval with
 @newval.
@@ -5157,7 +5176,7 @@ operation, for user data on an object.
 If the previous value was replaced then ownership of the
 old value (@oldval) is passed to the caller, including
 the registered destroy notify for it (passed out in @old_destroy).
-Its up to the caller to free this as he wishes, which may
+It’s up to the caller to free this as needed, which may
 or may not include using @old_destroy as sometimes replacement
 should not destroy the object in the normal way.</doc>
         <return-value transfer-ownership="none">
@@ -5197,8 +5216,10 @@ should not destroy the object in the normal way.</doc>
             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
           </parameter>
           <parameter name="old_destroy"
+                     direction="out"
+                     caller-allocates="0"
                      transfer-ownership="none"
-                     nullable="1"
+                     optional="1"
                      allow-none="1"
                      scope="async">
             <doc xml:space="preserve">destroy notify for the existing value</doc>
@@ -5300,7 +5321,11 @@ Note that the @destroy callback is not called if @data is %NULL.</doc>
             <doc xml:space="preserve">data to associate with that key</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="destroy" transfer-ownership="none" scope="async">
+          <parameter name="destroy"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     scope="async">
             <doc xml:space="preserve">function to call when the association is destroyed</doc>
             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
           </parameter>
@@ -5385,7 +5410,11 @@ with the same @quark.</doc>
             <doc xml:space="preserve">An opaque user data pointer</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="destroy" transfer-ownership="none" scope="async">
+          <parameter name="destroy"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     scope="async">
             <doc xml:space="preserve">Function to invoke with @data as argument, when @data
           needs to be freed</doc>
             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
@@ -5453,7 +5482,8 @@ properties are passed in.</doc>
         <doc xml:space="preserve">Remove a specified datum from the object's data associations,
 without invoking the association's destroy handler.</doc>
         <return-value transfer-ownership="full" nullable="1">
-          <doc xml:space="preserve">the data if found, or %NULL if no such data exists.</doc>
+          <doc xml:space="preserve">the data if found, or %NULL
+         if no such data exists.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </return-value>
         <parameters>
@@ -5687,9 +5717,8 @@ detail strings for the notify signal.</doc>
             glib:is-gtype-struct-for="Object">
       <doc xml:space="preserve">The class structure for the GObject type.
 
-&lt;example&gt;
-&lt;title&gt;Implementing singletons using a constructor&lt;/title&gt;
-&lt;programlisting&gt;
+|[&lt;!-- language="C" --&gt;
+// Example of implementing a singleton using a constructor.
 static MySingleton *the_singleton = NULL;
 
 static GObject*
@@ -5711,7 +5740,7 @@ my_singleton_constructor (GType                  type,
 
   return object;
 }
-&lt;/programlisting&gt;&lt;/example&gt;</doc>
+]|</doc>
       <field name="g_type_class">
         <doc xml:space="preserve">the parent class</doc>
         <type name="TypeClass" c:type="GTypeClass"/>
@@ -6136,7 +6165,7 @@ a #GObjectClass.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="PARAM_STATIC_STRINGS"
-              value="0"
+              value="224"
               c:type="G_PARAM_STATIC_STRINGS">
       <doc xml:space="preserve">#GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB.
 
@@ -6353,7 +6382,7 @@ e.g. a tooltip. The @nick and @blurb should ideally be localized.</doc>
               version="2.38">
         <doc xml:space="preserve">Gets the default value of @pspec as a pointer to a #GValue.
 
-The #GValue will remain value for the life of @pspec.</doc>
+The #GValue will remain valid for the life of @pspec.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a pointer to a #GValue which must not be modified</doc>
           <type name="Value" c:type="const GValue*"/>
@@ -8413,12 +8442,18 @@ in the given type plugin. If the interface was already registered
 for the type in this plugin, nothing will be done.
 
 As long as any instances of the type exist, the type plugin will
-not be unloaded.</doc>
+not be unloaded.
+
+Since 2.56 if @module is %NULL this will call g_type_add_interface_static()
+instead. This can be used when making a static build of the module.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="module" transfer-ownership="none">
+          <instance-parameter name="module"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #GTypeModule</doc>
             <type name="TypeModule" c:type="GTypeModule*"/>
           </instance-parameter>
@@ -8445,13 +8480,19 @@ the #GType identifier for the type is returned, otherwise the type
 is newly registered, and the resulting #GType identifier returned.
 
 As long as any instances of the type exist, the type plugin will
-not be unloaded.</doc>
+not be unloaded.
+
+Since 2.56 if @module is %NULL this will call g_type_register_static()
+instead. This can be used when making a static build of the module.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the new or existing type ID</doc>
           <type name="GType" c:type="GType"/>
         </return-value>
         <parameters>
-          <instance-parameter name="module" transfer-ownership="none">
+          <instance-parameter name="module"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #GTypeModule</doc>
             <type name="TypeModule" c:type="GTypeModule*"/>
           </instance-parameter>
@@ -8477,13 +8518,19 @@ the #GType identifier for the type is returned, otherwise the type
 is newly registered, and the resulting #GType identifier returned.
 
 As long as any instances of the type exist, the type plugin will
-not be unloaded.</doc>
+not be unloaded.
+
+Since 2.56 if @module is %NULL this will call g_type_register_static()
+instead. This can be used when making a static build of the module.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the new or existing type ID</doc>
           <type name="GType" c:type="GType"/>
         </return-value>
         <parameters>
-          <instance-parameter name="module" transfer-ownership="none">
+          <instance-parameter name="module"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #GTypeModule</doc>
             <type name="TypeModule" c:type="GTypeModule*"/>
           </instance-parameter>
@@ -8511,13 +8558,19 @@ then reloaded, and reinitialized), @module and @parent_type must
 be the same as they were previously.
 
 As long as any instances of the type exist, the type plugin will
-not be unloaded.</doc>
+not be unloaded.
+
+Since 2.56 if @module is %NULL this will call g_type_register_static()
+instead. This can be used when making a static build of the module.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the new or existing type ID</doc>
           <type name="GType" c:type="GType"/>
         </return-value>
         <parameters>
-          <instance-parameter name="module" transfer-ownership="none">
+          <instance-parameter name="module"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #GTypeModule</doc>
             <type name="TypeModule" c:type="GTypeModule*"/>
           </instance-parameter>
@@ -9243,10 +9296,11 @@ reference count.</doc>
       <method name="dup_variant"
               c:identifier="g_value_dup_variant"
               version="2.26">
-        <doc xml:space="preserve">Get the contents of a variant #GValue, increasing its refcount.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">variant contents of @value, should be unrefed using
-  g_variant_unref() when no longer needed</doc>
+        <doc xml:space="preserve">Get the contents of a variant #GValue, increasing its refcount. The returned
+#GVariant is never floating.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">variant contents of @value (may be %NULL);
+   should be unreffed using g_variant_unref() when no longer needed</doc>
           <type name="GLib.Variant" c:type="GVariant*"/>
         </return-value>
         <parameters>
@@ -9541,8 +9595,8 @@ Get the contents of a %G_TYPE_CHAR #GValue.</doc>
               c:identifier="g_value_get_variant"
               version="2.26">
         <doc xml:space="preserve">Get the contents of a variant #GValue.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">variant contents of @value</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">variant contents of @value (may be %NULL)</doc>
           <type name="GLib.Variant" c:type="GVariant*"/>
         </return-value>
         <parameters>
@@ -10463,6 +10517,7 @@ contents.</doc>
       </method>
       <method name="free"
               c:identifier="g_value_array_free"
+              introspectable="0"
               deprecated="1"
               deprecated-version="2.32">
         <doc xml:space="preserve">Free a #GValueArray including its contents.</doc>
@@ -10641,7 +10696,9 @@ C qsort() function.</doc>
     </record>
     <callback name="ValueTransform" c:type="GValueTransform">
       <doc xml:space="preserve">The type of value transformation functions which can be registered with
-g_value_register_transform_func().</doc>
+g_value_register_transform_func().
+
+@dest_value will be initialized to the correct destination type.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -11980,8 +12037,8 @@ but used automatically by GLib when specifying a %NULL marshaller.</doc>
               introspectable="0">
       <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
 the last parameter.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a new #GCClosure</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
         <type name="Closure" c:type="GClosure*"/>
       </return-value>
       <parameters>
@@ -12061,8 +12118,8 @@ after the object is is freed.</doc>
               introspectable="0">
       <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
 the first parameter.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a new #GCClosure</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
         <type name="Closure" c:type="GClosure*"/>
       </return-value>
       <parameters>
@@ -14785,8 +14842,8 @@ signal id for you.</doc>
       <doc xml:space="preserve">Creates a new closure which invokes the function found at the offset
 @struct_offset in the class structure of the interface or classed type
 identified by @itype.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a new #GCClosure</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
         <type name="Closure" c:type="GClosure*"/>
       </return-value>
       <parameters>
@@ -15110,7 +15167,7 @@ G_TYPE_CHECK_INSTANCE() macro.</doc>
       </return-value>
       <parameters>
         <parameter name="value" transfer-ownership="none">
-          <type name="Value" c:type="GValue*"/>
+          <type name="Value" c:type="const GValue*"/>
         </parameter>
       </parameters>
     </function>
@@ -15121,7 +15178,7 @@ G_TYPE_CHECK_INSTANCE() macro.</doc>
       </return-value>
       <parameters>
         <parameter name="value" transfer-ownership="none">
-          <type name="Value" c:type="GValue*"/>
+          <type name="Value" c:type="const GValue*"/>
         </parameter>
         <parameter name="type" transfer-ownership="none">
           <type name="GType" c:type="GType"/>

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

@@ -2388,7 +2388,7 @@ being swallowed by Exec key unquoting. See the specification for exact quoting r
         <parameters>
           <parameter name="commandline" transfer-ownership="none">
             <doc xml:space="preserve">the commandline to use</doc>
-            <type name="utf8" c:type="const char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
           <parameter name="application_name"
                      transfer-ownership="none"
@@ -2535,7 +2535,7 @@ required.</doc>
             <doc xml:space="preserve">the uri to show</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
-          <parameter name="launch_context"
+          <parameter name="context"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
@@ -2561,13 +2561,18 @@ dialog to the user.</doc>
             <doc xml:space="preserve">the uri to show</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
-          <parameter name="launch_context" transfer-ownership="none">
+          <parameter name="context"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">an optional #GAppLaunchContext</doc>
             <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
           </parameter>
           <parameter name="cancellable"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
+            <doc xml:space="preserve">a #GCancellable</doc>
             <type name="Cancellable" c:type="GCancellable*"/>
           </parameter>
           <parameter name="callback"
@@ -2704,9 +2709,9 @@ See g_app_info_can_delete().</doc>
       <virtual-method name="equal" invoker="equal">
         <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>
+Note that the check &lt;emphasis&gt;may not&lt;/emphasis&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"/>
@@ -2844,7 +2849,7 @@ the application.</doc>
       </virtual-method>
       <virtual-method name="launch" invoker="launch" throws="1">
         <doc xml:space="preserve">Launches the application. Passes @files to the launched application
-as arguments, using the optional @launch_context to get information
+as arguments, using the optional @context to get information
 about the details of the launcher (like what screen it is on).
 On error, @error will be set accordingly.
 
@@ -2869,7 +2874,7 @@ environment variable with the path of the launched desktop file and
 process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,
 should it be inherited by further processes. The `DISPLAY` and
 `DESKTOP_STARTUP_ID` environment variables are also set, based
-on information provided in @launch_context.</doc>
+on information provided in @context.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -2888,7 +2893,7 @@ on information provided in @launch_context.</doc>
               <type name="File"/>
             </type>
           </parameter>
-          <parameter name="launch_context"
+          <parameter name="context"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
@@ -2899,7 +2904,7 @@ on information provided in @launch_context.</doc>
       </virtual-method>
       <virtual-method name="launch_uris" invoker="launch_uris" throws="1">
         <doc xml:space="preserve">Launches the application. This passes the @uris to the launched application
-as arguments, using the optional @launch_context to get information
+as arguments, using the optional @context to get information
 about the details of the launcher (like what screen it is on).
 On error, @error will be set accordingly.
 
@@ -2926,7 +2931,7 @@ no way to detect this.</doc>
               <type name="utf8"/>
             </type>
           </parameter>
-          <parameter name="launch_context"
+          <parameter name="context"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
@@ -2970,7 +2975,7 @@ no way to detect this.</doc>
           <parameter name="extension" transfer-ownership="none">
             <doc xml:space="preserve">a string containing the file extension
     (without the dot).</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </virtual-method>
@@ -3139,9 +3144,9 @@ See g_app_info_can_delete().</doc>
       <method name="equal" c:identifier="g_app_info_equal">
         <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>
+Note that the check &lt;emphasis&gt;may not&lt;/emphasis&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"/>
@@ -3165,7 +3170,7 @@ started.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a string containing the @appinfo's commandline,
     or %NULL if this information is not available</doc>
-          <type name="filename" c:type="char*"/>
+          <type name="filename" c:type="const char*"/>
         </return-value>
         <parameters>
           <instance-parameter name="appinfo" transfer-ownership="none">
@@ -3210,7 +3215,7 @@ no display name is available.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a string containing the @appinfo's application
 binaries name</doc>
-          <type name="filename" c:type="char*"/>
+          <type name="filename" c:type="const char*"/>
         </return-value>
         <parameters>
           <instance-parameter name="appinfo" transfer-ownership="none">
@@ -3290,7 +3295,7 @@ the application.</doc>
       </method>
       <method name="launch" c:identifier="g_app_info_launch" throws="1">
         <doc xml:space="preserve">Launches the application. Passes @files to the launched application
-as arguments, using the optional @launch_context to get information
+as arguments, using the optional @context to get information
 about the details of the launcher (like what screen it is on).
 On error, @error will be set accordingly.
 
@@ -3315,7 +3320,7 @@ environment variable with the path of the launched desktop file and
 process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,
 should it be inherited by further processes. The `DISPLAY` and
 `DESKTOP_STARTUP_ID` environment variables are also set, based
-on information provided in @launch_context.</doc>
+on information provided in @context.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -3334,7 +3339,7 @@ on information provided in @launch_context.</doc>
               <type name="File"/>
             </type>
           </parameter>
-          <parameter name="launch_context"
+          <parameter name="context"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
@@ -3347,7 +3352,7 @@ on information provided in @launch_context.</doc>
               c:identifier="g_app_info_launch_uris"
               throws="1">
         <doc xml:space="preserve">Launches the application. This passes the @uris to the launched application
-as arguments, using the optional @launch_context to get information
+as arguments, using the optional @context to get information
 about the details of the launcher (like what screen it is on).
 On error, @error will be set accordingly.
 
@@ -3374,7 +3379,7 @@ no way to detect this.</doc>
               <type name="utf8"/>
             </type>
           </parameter>
-          <parameter name="launch_context"
+          <parameter name="context"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
@@ -3418,7 +3423,7 @@ no way to detect this.</doc>
           <parameter name="extension" transfer-ownership="none">
             <doc xml:space="preserve">a string containing the file extension
     (without the dot).</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </method>
@@ -3664,7 +3669,7 @@ if there is no default icon.</doc>
                 <type name="File"/>
               </type>
             </parameter>
-            <parameter name="launch_context"
+            <parameter name="context"
                        transfer-ownership="none"
                        nullable="1"
                        allow-none="1">
@@ -3722,7 +3727,7 @@ if there is no default icon.</doc>
                 <type name="utf8"/>
               </type>
             </parameter>
-            <parameter name="launch_context"
+            <parameter name="context"
                        transfer-ownership="none"
                        nullable="1"
                        allow-none="1">
@@ -3778,7 +3783,7 @@ if there is no default icon.</doc>
             <parameter name="extension" transfer-ownership="none">
               <doc xml:space="preserve">a string containing the file extension
     (without the dot).</doc>
-              <type name="filename" c:type="char*"/>
+              <type name="filename" c:type="const char*"/>
             </parameter>
           </parameters>
         </callback>
@@ -4113,10 +4118,10 @@ the child process when @context is used to launch an application.
 This is a %NULL-terminated array of strings, where each string has
 the form `KEY=VALUE`.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the
-    child's environment</doc>
+          <doc xml:space="preserve">
+    the child's environment</doc>
           <array c:type="char**">
-            <type name="utf8"/>
+            <type name="filename"/>
           </array>
         </return-value>
         <parameters>
@@ -4188,11 +4193,11 @@ environment when @context is used to launch an application.</doc>
           </instance-parameter>
           <parameter name="variable" transfer-ownership="none">
             <doc xml:space="preserve">the environment variable to set</doc>
-            <type name="utf8" c:type="const char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
             <doc xml:space="preserve">the value for to set the variable to.</doc>
-            <type name="utf8" c:type="const char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </method>
@@ -4211,7 +4216,7 @@ when @context is used to launch an application.</doc>
           </instance-parameter>
           <parameter name="variable" transfer-ownership="none">
             <doc xml:space="preserve">the environment variable to remove</doc>
-            <type name="utf8" c:type="const char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </method>
@@ -5292,6 +5297,10 @@ Upon return to the mainloop, g_application_run() will return,
 calling only the 'shutdown' function before doing so.
 
 The hold count is ignored.
+Take care if your code has called g_application_hold() on the application and
+is therefore still expecting it to exist.
+(Note that you may have called g_application_hold() indirectly, for example
+through gtk_application_add_window().)
 
 The result of calling g_application_run() again after it returns is
 unspecified.</doc>
@@ -5467,9 +5476,10 @@ what their exit status will be.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">the argv from main(), or %NULL</doc>
+            <doc xml:space="preserve">
+    the argv from main(), or %NULL</doc>
             <array length="0" zero-terminated="0" c:type="char**">
-              <type name="utf8" c:type="char*"/>
+              <type name="filename"/>
             </array>
           </parameter>
         </parameters>
@@ -5650,6 +5660,81 @@ zero.  Any timeouts currently in progress are not impacted.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="set_option_context_description"
+              c:identifier="g_application_set_option_context_description"
+              version="2.56">
+        <doc xml:space="preserve">Adds a description to the @application option context.
+
+See g_option_context_set_description() for more information.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="application" transfer-ownership="none">
+            <doc xml:space="preserve">the #GApplication</doc>
+            <type name="Application" c:type="GApplication*"/>
+          </instance-parameter>
+          <parameter name="description"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a string to be shown in `--help` output
+ after the list of options, or %NULL</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_option_context_parameter_string"
+              c:identifier="g_application_set_option_context_parameter_string"
+              version="2.56">
+        <doc xml:space="preserve">Sets the parameter string to be used by the commandline handling of @application.
+
+This function registers the argument to be passed to g_option_context_new()
+when the internal #GOptionContext of @application is created.
+
+See g_option_context_new() for more information about @parameter_string.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="application" transfer-ownership="none">
+            <doc xml:space="preserve">the #GApplication</doc>
+            <type name="Application" c:type="GApplication*"/>
+          </instance-parameter>
+          <parameter name="parameter_string"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a string which is displayed
+  in the first line of `--help` output, after the usage summary `programname [OPTION...]`.</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_option_context_summary"
+              c:identifier="g_application_set_option_context_summary"
+              version="2.56">
+        <doc xml:space="preserve">Adds a summary to the @application option context.
+
+See g_option_context_set_summary() for more information.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="application" transfer-ownership="none">
+            <doc xml:space="preserve">the #GApplication</doc>
+            <type name="Application" c:type="GApplication*"/>
+          </instance-parameter>
+          <parameter name="summary"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a string to be shown in `--help` output
+ before the list of options, or %NULL</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_resource_base_path"
               c:identifier="g_application_set_resource_base_path"
               version="2.42">
@@ -6414,7 +6499,7 @@ the invoking process rather than the local process.</doc>
           </instance-parameter>
           <parameter name="arg" transfer-ownership="none">
             <doc xml:space="preserve">an argument from @cmdline</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -6433,10 +6518,10 @@ use g_option_context_parse_strv().
 The return value is %NULL-terminated and should be freed using
 g_strfreev().</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the string array
-containing the arguments (the argv)</doc>
+          <doc xml:space="preserve">
+     the string array containing the arguments (the argv)</doc>
           <array length="0" zero-terminated="0" c:type="gchar**">
-            <type name="utf8"/>
+            <type name="filename"/>
           </array>
         </return-value>
         <parameters>
@@ -6469,7 +6554,7 @@ The return value should not be modified or freed and is valid for as
 long as @cmdline exists.</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the current directory, or %NULL</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </return-value>
         <parameters>
           <instance-parameter name="cmdline" transfer-ownership="none">
@@ -6498,10 +6583,10 @@ long as @cmdline exists.
 See g_application_command_line_getenv() if you are only interested
 in the value of a single environment variable.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the environment
-strings, or %NULL if they were not sent</doc>
+          <doc xml:space="preserve">
+    the environment strings, or %NULL if they were not sent</doc>
           <array c:type="gchar**">
-            <type name="utf8"/>
+            <type name="filename"/>
           </array>
         </return-value>
         <parameters>
@@ -6643,7 +6728,7 @@ long as @cmdline exists.</doc>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
             <doc xml:space="preserve">the environment variable to get</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -7537,12 +7622,21 @@ will return %FALSE and set @error appropriately if present.</doc>
     </record>
     <callback name="AsyncReadyCallback" c:type="GAsyncReadyCallback">
       <doc xml:space="preserve">Type definition for a function that will be called back when an asynchronous
-operation within GIO has been completed.</doc>
+operation within GIO has been completed. #GAsyncReadyCallback
+callbacks from #GTask are guaranteed to be invoked in a later
+iteration of the
+[thread-default main context][g-main-context-push-thread-default]
+where the #GTask was created. All other users of
+#GAsyncReadyCallback must likewise call it asynchronously in a
+later iteration of the main context.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
-        <parameter name="source_object" transfer-ownership="none">
+        <parameter name="source_object"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">the object the asynchronous operation was started with.</doc>
           <type name="GObject.Object" c:type="GObject*"/>
         </parameter>
@@ -7572,13 +7666,16 @@ Asynchronous operations are broken up into two separate operations
 which are chained together by a #GAsyncReadyCallback. To begin
 an asynchronous operation, provide a #GAsyncReadyCallback to the
 asynchronous function. This callback will be triggered when the
-operation has completed, and will be passed a #GAsyncResult instance
-filled with the details of the operation's success or failure, the
-object the asynchronous function was started for and any error codes
-returned. The asynchronous callback function is then expected to call
-the corresponding "_finish()" function, passing the object the
-function was called for, the #GAsyncResult instance, and (optionally)
-an @error to grab any error conditions that may have occurred.
+operation has completed, and must be run in a later iteration of
+the [thread-default main context][g-main-context-push-thread-default]
+from where the operation was initiated. It will be passed a
+#GAsyncResult instance filled with the details of the operation's
+success or failure, the object the asynchronous function was
+started for and any error codes returned. The asynchronous callback
+function is then expected to call the corresponding "_finish()"
+function, passing the object the function was called for, the
+#GAsyncResult instance, and (optionally) an @error to grab any
+error conditions that may have occurred.
 
 The "_finish()" function for an operation takes the generic result
 (of type #GAsyncResult) and returns the specific result that the
@@ -7649,9 +7746,9 @@ higher priority. It is recommended to choose priorities between
 as a default.</doc>
       <virtual-method name="get_source_object" invoker="get_source_object">
         <doc xml:space="preserve">Gets the source object from a #GAsyncResult.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a new reference to the source object for the @res,
-   or %NULL if there is none.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a new reference to the source
+   object for the @res, or %NULL if there is none.</doc>
           <type name="GObject.Object" c:type="GObject*"/>
         </return-value>
         <parameters>
@@ -7699,9 +7796,9 @@ pointer indicating the function @res was created by).</doc>
       <method name="get_source_object"
               c:identifier="g_async_result_get_source_object">
         <doc xml:space="preserve">Gets the source object from a #GAsyncResult.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a new reference to the source object for the @res,
-   or %NULL if there is none.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a new reference to the source
+   object for the @res, or %NULL if there is none.</doc>
           <type name="GObject.Object" c:type="GObject*"/>
         </return-value>
         <parameters>
@@ -7799,9 +7896,9 @@ to enable subclasses to chain up correctly.</doc>
       </field>
       <field name="get_source_object">
         <callback name="get_source_object">
-          <return-value transfer-ownership="full">
-            <doc xml:space="preserve">a new reference to the source object for the @res,
-   or %NULL if there is none.</doc>
+          <return-value transfer-ownership="full" nullable="1">
+            <doc xml:space="preserve">a new reference to the source
+   object for the @res, or %NULL if there is none.</doc>
             <type name="GObject.Object" c:type="GObject*"/>
           </return-value>
           <parameters>
@@ -7990,7 +8087,7 @@ of bytes that are required to fill the buffer.</doc>
       <virtual-method name="fill_finish" invoker="fill_finish" throws="1">
         <doc xml:space="preserve">Finishes an asynchronous read.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
+          <doc xml:space="preserve">a #gssize of the read stream, or `-1` on an error.</doc>
           <type name="gssize" c:type="gssize"/>
         </return-value>
         <parameters>
@@ -8108,7 +8205,7 @@ of bytes that are required to fill the buffer.</doc>
               throws="1">
         <doc xml:space="preserve">Finishes an asynchronous read.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
+          <doc xml:space="preserve">a #gssize of the read stream, or `-1` on an error.</doc>
           <type name="gssize" c:type="gssize"/>
         </return-value>
         <parameters>
@@ -8352,7 +8449,7 @@ smaller than its current contents.</doc>
       <field name="fill_finish">
         <callback name="fill_finish" throws="1">
           <return-value transfer-ownership="none">
-            <doc xml:space="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
+            <doc xml:space="preserve">a #gssize of the read stream, or `-1` on an error.</doc>
             <type name="gssize" c:type="gssize"/>
           </return-value>
           <parameters>
@@ -8716,7 +8813,7 @@ return an error from g_bus_own_name() rather than entering the waiting queue for
               version="2.26">
       <doc xml:space="preserve">Invoked when the name being watched is known not to have to have a owner.
 
-This is also invoked when the #GDBusConection on which the watch was
+This is also invoked when the #GDBusConnection on which the watch was
 established has been closed.  In that case, @connection will be
 %NULL.</doc>
       <return-value transfer-ownership="none">
@@ -8990,7 +9087,7 @@ same time as the cancellable operation is finished and the
 signal handler is removed. See #GCancellable::cancelled for
 details on how to use this.
 
-If @cancellable is %NULL or @handler_id is %0 this function does
+If @cancellable is %NULL or @handler_id is `0` this function does
 nothing.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -9004,7 +9101,7 @@ nothing.</doc>
             <type name="Cancellable" c:type="GCancellable*"/>
           </instance-parameter>
           <parameter name="handler_id" transfer-ownership="none">
-            <doc xml:space="preserve">Handler id of the handler to be disconnected, or %0.</doc>
+            <doc xml:space="preserve">Handler id of the handler to be disconnected, or `0`.</doc>
             <type name="gulong" c:type="gulong"/>
           </parameter>
         </parameters>
@@ -10392,8 +10489,12 @@ g_action_group_list_actions() to get the initial list.</doc>
             <doc xml:space="preserve">A #GDBusConnection</doc>
             <type name="DBusConnection" c:type="GDBusConnection*"/>
           </parameter>
-          <parameter name="bus_name" transfer-ownership="none">
-            <doc xml:space="preserve">the bus name which exports the action group</doc>
+          <parameter name="bus_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the bus name which exports the action
+    group or %NULL if @connection is not a message bus connection</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="object_path" transfer-ownership="none">
@@ -10771,7 +10872,7 @@ Here is an example for exporting a subtree:
 ## An example for file descriptor passing # {#gdbus-unix-fd-client}
 
 Here is an example for passing UNIX file descriptors:
-[gdbus-unix-fd-client.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-unix-fd-client.c)
+[gdbus-unix-fd-client.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-unix-fd-client.c)
 
 ## An example for exporting a GObject # {#gdbus-export}
 
@@ -11138,7 +11239,9 @@ not compatible with the D-Bus protocol, the operation fails with
 
 If @reply_type is non-%NULL then the reply will be checked for having this type and an
 error will be raised if it does not match.  Said another way, if you give a @reply_type
-then any non-%NULL return value will be of this type.
+then any non-%NULL return value will be of this type. Unless it’s
+%G_VARIANT_TYPE_UNIT, the @reply_type will be a tuple containing one or more
+values.
 
 If the @parameters #GVariant is floating, it is consumed. This allows
 convenient 'inline' use of g_variant_new(), e.g.:
@@ -11209,7 +11312,8 @@ the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">the expected type of the reply, or %NULL</doc>
+            <doc xml:space="preserve">the expected type of the reply (which will be a
+    tuple), or %NULL</doc>
             <type name="GLib.VariantType" c:type="const GVariantType*"/>
           </parameter>
           <parameter name="flags" transfer-ownership="none">
@@ -11697,7 +11801,9 @@ does.</doc>
 
 If the parameters GVariant is floating, it is consumed.
 
-This can only fail if @parameters is not compatible with the D-Bus protocol.</doc>
+This can only fail if @parameters is not compatible with the D-Bus protocol
+(%G_IO_ERROR_INVALID_ARGUMENT), or if @connection has been closed
+(%G_IO_ERROR_CLOSED).</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE unless @error is set</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -13414,7 +13520,9 @@ exists.</doc>
           </parameter>
           <parameter name="entries" transfer-ownership="none">
             <doc xml:space="preserve">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
-            <type name="DBusErrorEntry" c:type="const GDBusErrorEntry*"/>
+            <array length="3" zero-terminated="0" c:type="GDBusErrorEntry*">
+              <type name="DBusErrorEntry" c:type="GDBusErrorEntry"/>
+            </array>
           </parameter>
           <parameter name="num_entries" transfer-ownership="none">
             <doc xml:space="preserve">Number of items to register.</doc>
@@ -14139,7 +14247,7 @@ emitted immediately.
 
 For example, an exported D-Bus interface may queue up property
 changes and emit the
-`org.freedesktop.DBus.Properties::PropertiesChanged`
+`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">
@@ -14259,7 +14367,7 @@ emitted immediately.
 
 For example, an exported D-Bus interface may queue up property
 changes and emit the
-`org.freedesktop.DBus.Properties::PropertiesChanged`
+`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">
@@ -14757,8 +14865,12 @@ the thread default main context unchanged.</doc>
             <doc xml:space="preserve">a #GDBusConnection</doc>
             <type name="DBusConnection" c:type="GDBusConnection*"/>
           </parameter>
-          <parameter name="bus_name" transfer-ownership="none">
-            <doc xml:space="preserve">the bus name which exports the menu model</doc>
+          <parameter name="bus_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the bus name which exports the menu model
+    or %NULL if @connection is not a message bus connection</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="object_path" transfer-ownership="none">
@@ -15781,7 +15893,7 @@ passive_filter (GDBusConnection *connection
                 gboolean         incoming,
                 gpointer         user_data)
 {
-  /&lt;!-- --&gt;* inspect @message *&lt;!-- --&gt;/
+  // inspect @message
   return message;
 }
 ]|
@@ -15814,10 +15926,10 @@ modifying_filter (GDBusConnection *connection
 
   error = NULL;
   copy = g_dbus_message_copy (message, &amp;error);
-  /&lt;!-- --&gt;* handle @error being is set *&lt;!-- --&gt;/
+  // handle @error being set
   g_object_unref (message);
 
-  /&lt;!-- --&gt;* modify @copy *&lt;!-- --&gt;/
+  // modify @copy
 
   return copy;
 }
@@ -16442,7 +16554,7 @@ 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;/
+// Do not free @invocation here; returning a value does that
 ]|
 
 This method will take ownership of @invocation. See
@@ -17875,7 +17987,8 @@ that @manager was constructed in.</doc>
             <type name="GLib.Variant"/>
           </parameter>
           <parameter name="invalidated_properties" transfer-ownership="none">
-            <doc xml:space="preserve">A %NULL terminated array of properties that was invalidated.</doc>
+            <doc xml:space="preserve">A %NULL terminated
+  array of properties that were invalidated.</doc>
             <array>
               <type name="utf8"/>
             </array>
@@ -18807,7 +18920,7 @@ interface on a remote object. A #GDBusProxy can be constructed for
 both well-known and unique names.
 
 By default, #GDBusProxy will cache all properties (and listen to
-changes) of the remote object, and proxy all signals that gets
+changes) of the remote object, and proxy all signals that get
 emitted. This behaviour can be changed by passing suitable
 #GDBusProxyFlags when the proxy is created. If the proxy is for a
 well-known name, the property cache is flushed when the name owner
@@ -18849,7 +18962,8 @@ An example using a proxy for a well-known name can be found in
                    throws="1">
         <doc xml:space="preserve">Finishes creating a #GDBusProxy.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().</doc>
+          <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set.
+   Free with g_object_unref().</doc>
           <type name="DBusProxy" c:type="GDBusProxy*"/>
         </return-value>
         <parameters>
@@ -18865,7 +18979,8 @@ An example using a proxy for a well-known name can be found in
                    throws="1">
         <doc xml:space="preserve">Finishes creating a #GDBusProxy.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().</doc>
+          <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set.
+   Free with g_object_unref().</doc>
           <type name="DBusProxy" c:type="GDBusProxy*"/>
         </return-value>
         <parameters>
@@ -18883,7 +18998,8 @@ An example using a proxy for a well-known name can be found in
 
 #GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set. Free with g_object_unref().</doc>
+          <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set.
+   Free with g_object_unref().</doc>
           <type name="DBusProxy" c:type="GDBusProxy*"/>
         </return-value>
         <parameters>
@@ -18947,7 +19063,8 @@ and g_dbus_proxy_new_finish() for the asynchronous version.
 
 #GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set. Free with g_object_unref().</doc>
+          <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set.
+   Free with g_object_unref().</doc>
           <type name="DBusProxy" c:type="GDBusProxy*"/>
         </return-value>
         <parameters>
@@ -19535,10 +19652,10 @@ blocking IO.
 If @proxy has an expected interface (see
 #GDBusProxy:g-interface-info) and @property_name is referenced by
 it, then @value is checked against the type of the property.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A reference to the #GVariant instance that holds the value
-for @property_name or %NULL if the value is not in the cache. The
-returned reference must be freed with g_variant_unref().</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">A reference to the #GVariant instance
+   that holds the value for @property_name or %NULL if the value is not in
+   the cache. The returned reference must be freed with g_variant_unref().</doc>
           <type name="GLib.Variant" c:type="GVariant*"/>
         </return-value>
         <parameters>
@@ -19556,8 +19673,9 @@ returned reference must be freed with g_variant_unref().</doc>
               c:identifier="g_dbus_proxy_get_cached_property_names"
               version="2.26">
         <doc xml:space="preserve">Gets the names of all cached properties on @proxy.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A %NULL-terminated array of strings or %NULL if
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">A
+         %NULL-terminated array of strings or %NULL if
          @proxy has no cached properties. Free the returned array with
          g_strfreev().</doc>
           <array c:type="gchar**">
@@ -19626,9 +19744,9 @@ See the #GDBusProxy:g-default-timeout property for more details.</doc>
         <doc xml:space="preserve">Returns the #GDBusInterfaceInfo, if any, specifying the interface
 that @proxy conforms to. See the #GDBusProxy:g-interface-info
 property for more details.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A #GDBusInterfaceInfo or %NULL. Do not unref the returned
-object, it is owned by @proxy.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">A #GDBusInterfaceInfo or %NULL.
+   Do not unref the returned object, it is owned by @proxy.</doc>
           <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
         </return-value>
         <parameters>
@@ -19675,8 +19793,9 @@ object, it is owned by @proxy.</doc>
 no-one currently owns that name. You may connect to the
 #GObject::notify signal to track changes to the
 #GDBusProxy:g-name-owner property.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">The name owner or %NULL if no name owner exists. Free with g_free().</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">The name owner or %NULL if no name
+   owner exists. Free with g_free().</doc>
           <type name="utf8" c:type="gchar*"/>
         </return-value>
         <parameters>
@@ -19798,7 +19917,8 @@ details.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">Minimum interface this proxy conforms to or %NULL to unset.</doc>
+            <doc xml:space="preserve">Minimum interface this proxy conforms to
+   or %NULL to unset.</doc>
             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
           </parameter>
         </parameters>
@@ -21173,6 +21293,8 @@ an error occurred.</doc>
       </method>
       <method name="read_until"
               c:identifier="g_data_input_stream_read_until"
+              deprecated="1"
+              deprecated-version="2.56"
               throws="1">
         <doc xml:space="preserve">Reads a string from the data input stream, up to the first
 occurrence of any of the stop characters.
@@ -21185,6 +21307,8 @@ inconsistent with g_data_input_stream_read_until_async().  Both
 functions will be marked as deprecated in a future release.  Use
 g_data_input_stream_read_upto() instead, but note that that function
 does not consume the stop character.</doc>
+        <doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto() instead, which has more
+    consistent behaviour regarding the stop character.</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a string with the data that was read
     before encountering any of the stop characters. Set @length to
@@ -21221,7 +21345,9 @@ does not consume the stop character.</doc>
       </method>
       <method name="read_until_async"
               c:identifier="g_data_input_stream_read_until_async"
-              version="2.20">
+              version="2.20"
+              deprecated="1"
+              deprecated-version="2.56">
         <doc xml:space="preserve">The asynchronous version of g_data_input_stream_read_until().
 It is an error to have two outstanding calls to this function.
 
@@ -21237,6 +21363,8 @@ Don't use this function in new code.  Its functionality is
 inconsistent with g_data_input_stream_read_until().  Both functions
 will be marked as deprecated in a future release.  Use
 g_data_input_stream_read_upto_async() instead.</doc>
+        <doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto_async() instead, which
+    has more consistent behaviour regarding the stop character.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -21281,9 +21409,13 @@ g_data_input_stream_read_upto_async() instead.</doc>
       <method name="read_until_finish"
               c:identifier="g_data_input_stream_read_until_finish"
               version="2.20"
+              deprecated="1"
+              deprecated-version="2.56"
               throws="1">
         <doc xml:space="preserve">Finish an asynchronous call started by
 g_data_input_stream_read_until_async().</doc>
+        <doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto_finish() instead, which
+    has more consistent behaviour regarding the stop character.</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a string with the data that was read
     before encountering any of the stop characters. Set @length to
@@ -21324,7 +21456,9 @@ g_data_input_stream_read_byte() to get it before calling
 g_data_input_stream_read_upto() again.
 
 Note that @stop_chars may contain '\0' if @stop_chars_len is
-specified.</doc>
+specified.
+
+The returned string will always be nul-terminated on success.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a string with the data that was read
     before encountering any of the stop characters. Set @length to
@@ -21436,7 +21570,9 @@ g_data_input_stream_read_upto_async().
 
 Note that this function does not consume the stop character. You
 have to use g_data_input_stream_read_byte() to get it before calling
-g_data_input_stream_read_upto_async() again.</doc>
+g_data_input_stream_read_upto_async() again.
+
+The returned string will always be nul-terminated on success.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a string with the data that was read
     before encountering any of the stop characters. Set @length to
@@ -25719,7 +25855,7 @@ non-%NULL.)</doc>
               version="2.48">
         <doc xml:space="preserve">Sets the certificate database that is used to verify peer certificates.
 This is set to the default database by default. See
-g_dtls_backend_get_default_database(). If set to %NULL, then
+g_tls_backend_get_default_database(). If set to %NULL, then
 peer certificate validation will always set the
 %G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
 #GDtlsConnection::accept-certificate will always be emitted on
@@ -25985,7 +26121,7 @@ g_dtls_connection_set_certificate().</doc>
                 transfer-ownership="none">
         <doc xml:space="preserve">The certificate database to use when verifying this TLS connection.
 If no certificate database is set, then the default database will be
-used. See g_dtls_backend_get_default_database().</doc>
+used. See g_tls_backend_get_default_database().</doc>
         <type name="TlsDatabase"/>
       </property>
       <property name="interaction"
@@ -27332,6 +27468,7 @@ To construct a #GFile, you can use:
 - g_file_new_for_commandline_arg() for a command line argument.
 - g_file_new_tmp() to create a temporary file from a template.
 - g_file_parse_name() from a UTF-8 string gotten from g_file_get_parse_name().
+- g_file_new_build_filename() to create a file from path elements.
 
 One way to think of a #GFile is as an abstraction of a pathname. For
 normal files the system pathname is what is stored internally, but as
@@ -27399,6 +27536,30 @@ has been modified from the version on the file system. See the
 HTTP 1.1
 [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)
 for HTTP Etag headers, which are a very similar concept.</doc>
+      <function name="new_build_filename"
+                c:identifier="g_file_new_build_filename"
+                version="2.56"
+                introspectable="0">
+        <doc xml:space="preserve">Constructs a #GFile from a series of elements using the correct
+separator for filenames.
+
+Using this function is equivalent to calling g_build_filename(),
+followed by g_file_new_for_path() on the result.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GFile</doc>
+          <type name="File" c:type="GFile*"/>
+        </return-value>
+        <parameters>
+          <parameter name="first_element" transfer-ownership="none">
+            <doc xml:space="preserve">the first element in the path</doc>
+            <type name="filename" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="..." transfer-ownership="none">
+            <doc xml:space="preserve">remaining elements in path, terminated by %NULL</doc>
+            <varargs/>
+          </parameter>
+        </parameters>
+      </function>
       <function name="new_for_commandline_arg"
                 c:identifier="g_file_new_for_commandline_arg">
         <doc xml:space="preserve">Creates a #GFile with the given argument from the command line.
@@ -27423,7 +27584,7 @@ for you there.  It is also always possible to use this function with
         <parameters>
           <parameter name="arg" transfer-ownership="none">
             <doc xml:space="preserve">a command line string</doc>
-            <type name="utf8" c:type="const char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </function>
@@ -27448,11 +27609,11 @@ See also g_application_command_line_create_file_for_arg().</doc>
         <parameters>
           <parameter name="arg" transfer-ownership="none">
             <doc xml:space="preserve">a command line string</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
           <parameter name="cwd" transfer-ownership="none">
             <doc xml:space="preserve">the current working directory of the commandline</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </function>
@@ -27469,7 +27630,7 @@ operation if @path is malformed.</doc>
           <parameter name="path" transfer-ownership="none">
             <doc xml:space="preserve">a string containing a relative or absolute path.
     The string must be encoded in the glib filename encoding.</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </function>
@@ -27516,7 +27677,7 @@ a temporary file could not be created.</doc>
                      allow-none="1">
             <doc xml:space="preserve">Template for the file
   name, as in g_file_open_tmp(), or %NULL for a default template</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
           <parameter name="iostream"
                      direction="out"
@@ -28949,7 +29110,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
           <parameter name="symlink_value" transfer-ownership="none">
             <doc xml:space="preserve">a string with the path for the target
     of the new symlink</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
           <parameter name="cancellable"
                      transfer-ownership="none"
@@ -30465,14 +30626,14 @@ This call does no blocking I/O.</doc>
           </instance-parameter>
           <parameter name="relative_path" transfer-ownership="none">
             <doc xml:space="preserve">a given relative path string</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </virtual-method>
       <virtual-method name="set_attribute" invoker="set_attribute" throws="1">
         <doc xml:space="preserve">Sets an attribute in the file with attribute name @attribute to @value.
 
-Some attributes can be unset by setting @attribute to
+Some attributes can be unset by setting @type to
 %G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
 
 If @cancellable is not %NULL, then the operation can be cancelled by
@@ -32339,7 +32500,7 @@ This call does no blocking I/O.</doc>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
             <doc xml:space="preserve">string containing the child's basename</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </method>
@@ -32617,6 +32778,136 @@ This call does no blocking I/O.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="load_bytes"
+              c:identifier="g_file_load_bytes"
+              version="2.56"
+              throws="1">
+        <doc xml:space="preserve">Loads the contents of @file and returns it as #GBytes.
+
+If @file is a resource:// based URI, the resulting bytes will reference the
+embedded resource instead of a copy. Otherwise, this is equivalent to calling
+g_file_load_contents() and g_bytes_new_take().
+
+For resources, @etag_out will be set to %NULL.
+
+The data contained in the resulting #GBytes is always zero-terminated, but
+this is not included in the #GBytes length. The resulting #GBytes should be
+freed with g_bytes_unref() when no longer in use.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a #GBytes or %NULL and @error is set</doc>
+          <type name="GLib.Bytes" c:type="GBytes*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GFile</doc>
+            <type name="File" c:type="GFile*"/>
+          </instance-parameter>
+          <parameter name="cancellable"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GCancellable or %NULL</doc>
+            <type name="Cancellable" c:type="GCancellable*"/>
+          </parameter>
+          <parameter name="etag_out"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a location to place the current
+    entity tag for the file, or %NULL if the entity tag is not needed</doc>
+            <type name="utf8" c:type="gchar**"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="load_bytes_async"
+              c:identifier="g_file_load_bytes_async"
+              version="2.56">
+        <doc xml:space="preserve">Asynchronously loads the contents of @file as #GBytes.
+
+If @file is a resource:// based URI, the resulting bytes will reference the
+embedded resource instead of a copy. Otherwise, this is equivalent to calling
+g_file_load_contents_async() and g_bytes_new_take().
+
+@callback should call g_file_load_bytes_finish() to get the result of this
+asynchronous operation.
+
+See g_file_load_bytes() for more information.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GFile</doc>
+            <type name="File" c:type="GFile*"/>
+          </instance-parameter>
+          <parameter name="cancellable"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GCancellable or %NULL</doc>
+            <type name="Cancellable" c:type="GCancellable*"/>
+          </parameter>
+          <parameter name="callback"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     scope="async"
+                     closure="2">
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the
+    request is satisfied</doc>
+            <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
+          </parameter>
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the data to pass to callback function</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="load_bytes_finish"
+              c:identifier="g_file_load_bytes_finish"
+              version="2.56"
+              throws="1">
+        <doc xml:space="preserve">Completes an asynchronous request to g_file_load_bytes_async().
+
+For resources, @etag_out will be set to %NULL.
+
+The data contained in the resulting #GBytes is always zero-terminated, but
+this is not included in the #GBytes length. The resulting #GBytes should be
+freed with g_bytes_unref() when no longer in use.
+
+See g_file_load_bytes() for more information.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a #GBytes or %NULL and @error is set</doc>
+          <type name="GLib.Bytes" c:type="GBytes*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GFile</doc>
+            <type name="File" c:type="GFile*"/>
+          </instance-parameter>
+          <parameter name="result" transfer-ownership="none">
+            <doc xml:space="preserve">a #GAsyncResult provided to the callback</doc>
+            <type name="AsyncResult" c:type="GAsyncResult*"/>
+          </parameter>
+          <parameter name="etag_out"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a location to place the current
+    entity tag for the file, or %NULL if the entity tag is not needed</doc>
+            <type name="utf8" c:type="gchar**"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="load_contents"
               c:identifier="g_file_load_contents"
               throws="1">
@@ -32806,8 +33097,12 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
             <doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
             <type name="Cancellable" c:type="GCancellable*"/>
           </parameter>
-          <parameter name="read_more_callback" transfer-ownership="none">
-            <doc xml:space="preserve">a #GFileReadMoreCallback to receive partial data
+          <parameter name="read_more_callback"
+                     transfer-ownership="none"
+                     scope="call"
+                     closure="3">
+            <doc xml:space="preserve">a
+    #GFileReadMoreCallback to receive partial data
     and to specify whether further data should be read</doc>
             <type name="FileReadMoreCallback" c:type="GFileReadMoreCallback"/>
           </parameter>
@@ -32817,7 +33112,8 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
                      allow-none="1"
                      scope="async"
                      closure="3">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call
+    when the request is satisfied</doc>
             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"
@@ -33040,7 +33336,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
           <parameter name="symlink_value" transfer-ownership="none">
             <doc xml:space="preserve">a string with the path for the target
     of the new symlink</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
           <parameter name="cancellable"
                      transfer-ownership="none"
@@ -33729,6 +34025,26 @@ g_file_open_readwrite_async().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="peek_path" c:identifier="g_file_peek_path" version="2.56">
+        <doc xml:space="preserve">Exactly like g_file_get_path(), but caches the result via
+g_object_set_qdata_full().  This is useful for example in C
+applications which mix `g_file_*` APIs with native ones.  It
+also avoids an extra duplicated string when possible, so will be
+generally more efficient.
+
+This call does no blocking I/O.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">string containing the #GFile's path,
+    or %NULL if no such path exists. The returned string is owned by @file.</doc>
+          <type name="filename" c:type="const char*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">input #GFile</doc>
+            <type name="File" c:type="GFile*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="poll_mountable"
               c:identifier="g_file_poll_mountable"
               version="2.22">
@@ -33832,7 +34148,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
         <doc xml:space="preserve">Utility function to check if a particular file exists. This is
 implemented using g_file_query_info() and as such does blocking I/O.
 
-Note that in many cases it is racy to first check for file existence
+Note that in many cases it is [racy to first check for file existence](https://en.wikipedia.org/wiki/Time_of_check_to_time_of_use)
 and then execute something based on the outcome of that, because the
 file might have been created or removed in between the operations. The
 general approach to handling that is to not check, but just do the
@@ -34905,7 +35221,7 @@ This call does no blocking I/O.</doc>
           </instance-parameter>
           <parameter name="relative_path" transfer-ownership="none">
             <doc xml:space="preserve">a given relative path string</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </method>
@@ -34914,7 +35230,7 @@ This call does no blocking I/O.</doc>
               throws="1">
         <doc xml:space="preserve">Sets an attribute in the file with attribute name @attribute to @value.
 
-Some attributes can be unset by setting @attribute to
+Some attributes can be unset by setting @type to
 %G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
 
 If @cancellable is not %NULL, then the operation can be cancelled by
@@ -38136,7 +38452,7 @@ to be used as icon.</doc>
             </parameter>
             <parameter name="relative_path" transfer-ownership="none">
               <doc xml:space="preserve">a given relative path string</doc>
-              <type name="filename" c:type="char*"/>
+              <type name="filename" c:type="const char*"/>
             </parameter>
           </parameters>
         </callback>
@@ -39516,7 +39832,7 @@ to be used as icon.</doc>
             <parameter name="symlink_value" transfer-ownership="none">
               <doc xml:space="preserve">a string with the path for the target
     of the new symlink</doc>
-              <type name="filename" c:type="char*"/>
+              <type name="filename" c:type="const char*"/>
             </parameter>
             <parameter name="cancellable"
                        transfer-ownership="none"
@@ -41403,7 +41719,7 @@ in @result.</doc>
         <doc xml:space="preserve">Gets the name for a file.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a string containing the file name.</doc>
-          <type name="filename" c:type="char*"/>
+          <type name="filename" c:type="const char*"/>
         </return-value>
         <parameters>
           <instance-parameter name="info" transfer-ownership="none">
@@ -41974,7 +42290,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_NAME.</doc>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
             <doc xml:space="preserve">a string containing a name.</doc>
-            <type name="filename" c:type="char*"/>
+            <type name="filename" c:type="const char*"/>
           </parameter>
         </parameters>
       </method>
@@ -43660,7 +43976,8 @@ should be read, or %FALSE otherwise.</doc>
         <parameter name="callback_data"
                    transfer-ownership="none"
                    nullable="1"
-                   allow-none="1">
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">data passed to the callback.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -44624,7 +44941,7 @@ or %NULL on error.</doc>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
             <doc xml:space="preserve">filename of the shared library module.</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </constructor>
@@ -44651,7 +44968,15 @@ points actually implemented must be returned by g_io_module_query()
 
 When installing a module that implements g_io_module_query() you must
 run gio-querymodules in order to build the cache files required for
-lazy loading.</doc>
+lazy loading.
+
+Since 2.56, this function should be named `g_io_&lt;modulename&gt;_query`, where
+`modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
+everything after the first dot removed, and with `-` replaced with `_`
+throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
+Using the new symbol names avoids name clashes when building modules
+statically. The old symbol names continue to be supported, but cannot be used
+for static builds.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">A %NULL-terminated array of strings,
     listing the supported extension points of the module. The array
@@ -44666,7 +44991,15 @@ lazy loading.</doc>
 
 This function is run after the module has been loaded into GIO,
 to initialize the module. Typically, this function will call
-g_io_extension_point_implement().</doc>
+g_io_extension_point_implement().
+
+Since 2.56, this function should be named `g_io_&lt;modulename&gt;_load`, where
+`modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
+everything after the first dot removed, and with `-` replaced with `_`
+throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
+Using the new symbol names avoids name clashes when building modules
+statically. The old symbol names continue to be supported, but cannot be used
+for static builds.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44681,7 +45014,15 @@ g_io_extension_point_implement().</doc>
         <doc xml:space="preserve">Required API for GIO modules to implement.
 
 This function is run when the module is being unloaded from GIO,
-to finalize the module.</doc>
+to finalize the module.
+
+Since 2.56, this function should be named `g_io_&lt;modulename&gt;_unload`, where
+`modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
+everything after the first dot removed, and with `-` replaced with `_`
+throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
+Using the new symbol names avoids name clashes when building modules
+statically. The old symbol names continue to be supported, but cannot be used
+for static builds.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -48589,15 +48930,23 @@ thread in which it is appropriate to use it depends on the particular
 implementation, but typically it will be from the thread that owns
 the [thread-default main context][g-main-context-push-thread-default]
 in effect at the time that the model was created.</doc>
-      <virtual-method name="get_item">
-        <return-value transfer-ownership="none" nullable="1">
-          <type name="gpointer" c:type="gpointer"/>
+      <virtual-method name="get_item" version="2.44">
+        <doc xml:space="preserve">Get the item at @position. If @position is greater than the number of
+items in @list, %NULL is returned.
+
+%NULL is never returned for an index that is smaller than the length
+of the list.  See g_list_model_get_n_items().</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the object at @position.</doc>
+          <type name="GObject.Object" c:type="gpointer"/>
         </return-value>
         <parameters>
           <instance-parameter name="list" transfer-ownership="none">
+            <doc xml:space="preserve">a #GListModel</doc>
             <type name="ListModel" c:type="GListModel*"/>
           </instance-parameter>
           <parameter name="position" transfer-ownership="none">
+            <doc xml:space="preserve">the position of the item to fetch</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
         </parameters>
@@ -48651,7 +49000,7 @@ items in @list, %NULL is returned.
 of the list.  See g_list_model_get_n_items().</doc>
         <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the item at @position.</doc>
-          <type name="GObject.Object" c:type="gpointer"/>
+          <type name="gpointer" c:type="gpointer"/>
         </return-value>
         <parameters>
           <instance-parameter name="list" transfer-ownership="none">
@@ -48834,14 +49183,17 @@ were added in their place.</doc>
       </field>
       <field name="get_item">
         <callback name="get_item">
-          <return-value transfer-ownership="none" nullable="1">
-            <type name="gpointer" c:type="gpointer"/>
+          <return-value transfer-ownership="full" nullable="1">
+            <doc xml:space="preserve">the object at @position.</doc>
+            <type name="GObject.Object" c:type="gpointer"/>
           </return-value>
           <parameters>
             <parameter name="list" transfer-ownership="none">
+              <doc xml:space="preserve">a #GListModel</doc>
               <type name="ListModel" c:type="GListModel*"/>
             </parameter>
             <parameter name="position" transfer-ownership="none">
+              <doc xml:space="preserve">the position of the item to fetch</doc>
               <type name="guint" c:type="guint"/>
             </parameter>
           </parameters>
@@ -52211,9 +52563,9 @@ and #GTask. To unmount a #GMount instance, first call
 g_mount_unmount_with_operation() with (at least) the #GMount instance and a
 #GAsyncReadyCallback.  The callback will be fired when the
 operation has resolved (either with success or failure), and a
-#GAsyncReady structure will be passed to the callback.  That
+#GAsyncResult structure will be passed to the callback.  That
 callback should then call g_mount_unmount_with_operation_finish() with the #GMount
-and the #GAsyncReady data to see if the operation was completed
+and the #GAsyncResult 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">
@@ -53616,8 +53968,11 @@ will need to emit the #GMount::changed signal on @mount manually.</doc>
         </return-value>
       </glib:signal>
       <glib:signal name="pre-unmount" when="last" version="2.22">
-        <doc xml:space="preserve">This signal is emitted when the #GMount is about to be
-unmounted.</doc>
+        <doc xml:space="preserve">This signal may be emitted when the #GMount is about to be
+unmounted.
+
+This signal depends on the backend and is only emitted if
+GIO was used to unmount.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -54343,7 +54698,9 @@ passed, see each method taking a #GMountOperation for details.</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
           <parameter name="choices" transfer-ownership="none">
-            <type name="utf8" c:type="const char*"/>
+            <array c:type="char*">
+              <type name="utf8"/>
+            </array>
           </parameter>
         </parameters>
       </virtual-method>
@@ -54363,7 +54720,7 @@ passed, see each method taking a #GMountOperation for details.</doc>
           </parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="show_processes" introspectable="0">
+      <virtual-method name="show_processes" version="2.22">
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -54376,11 +54733,13 @@ passed, see each method taking a #GMountOperation for details.</doc>
           </parameter>
           <parameter name="processes" transfer-ownership="none">
             <array name="GLib.Array" c:type="GArray*">
-              <type name="gpointer" c:type="gpointer"/>
+              <type name="GLib.Pid"/>
             </array>
           </parameter>
           <parameter name="choices" transfer-ownership="none">
-            <type name="utf8" c:type="const gchar*"/>
+            <array c:type="gchar*">
+              <type name="utf8"/>
+            </array>
           </parameter>
         </parameters>
       </virtual-method>
@@ -54827,7 +55186,9 @@ primary text in a #GtkMessageDialog.</doc>
               <type name="utf8" c:type="const char*"/>
             </parameter>
             <parameter name="choices" transfer-ownership="none">
-              <type name="utf8" c:type="const char*"/>
+              <array c:type="char*">
+                <type name="utf8"/>
+              </array>
             </parameter>
           </parameters>
         </callback>
@@ -54862,8 +55223,8 @@ primary text in a #GtkMessageDialog.</doc>
           </parameters>
         </callback>
       </field>
-      <field name="show_processes" introspectable="0">
-        <callback name="show_processes" introspectable="0">
+      <field name="show_processes">
+        <callback name="show_processes">
           <return-value transfer-ownership="none">
             <type name="none" c:type="void"/>
           </return-value>
@@ -54876,11 +55237,13 @@ primary text in a #GtkMessageDialog.</doc>
             </parameter>
             <parameter name="processes" transfer-ownership="none">
               <array name="GLib.Array" c:type="GArray*">
-                <type name="gpointer" c:type="gpointer"/>
+                <type name="GLib.Pid"/>
               </array>
             </parameter>
             <parameter name="choices" transfer-ownership="none">
-              <type name="utf8" c:type="const gchar*"/>
+              <array c:type="gchar*">
+                <type name="utf8"/>
+              </array>
             </parameter>
           </parameters>
         </callback>
@@ -55157,7 +55520,7 @@ If no port is specified in @host_and_port then @default_port will be
 used as the port number to connect to.
 
 In general, @host_and_port is expected to be provided by the user
-(allowing them to give the hostname, and a port overide if necessary)
+(allowing them to give the hostname, and a port override if necessary)
 and @default_port is expected to be provided by the application.
 
 (The port component of @host_and_port can also be specified as a
@@ -55468,7 +55831,7 @@ See g_network_monitor_can_reach_async().</doc>
           <instance-parameter name="monitor" transfer-ownership="none">
             <type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
           </instance-parameter>
-          <parameter name="available" transfer-ownership="none">
+          <parameter name="network_available" transfer-ownership="none">
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
         </parameters>
@@ -55703,16 +56066,12 @@ See also #GNetworkMonitor:network-available.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <glib:signal name="network-changed" when="last" version="2.32">
-        <doc xml:space="preserve">Emitted when the network configuration changes. If @available is
-%TRUE, then some hosts may be reachable that were not reachable
-before, while others that were reachable before may no longer be
-reachable. If @available is %FALSE, then no remote hosts are
-reachable.</doc>
+        <doc xml:space="preserve">Emitted when the network configuration changes.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <parameter name="available" transfer-ownership="none">
+          <parameter name="network_available" transfer-ownership="none">
             <doc xml:space="preserve">the current value of #GNetworkMonitor:network-available</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
@@ -55737,7 +56096,7 @@ reachable.</doc>
             <parameter name="monitor" transfer-ownership="none">
               <type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
             </parameter>
-            <parameter name="available" transfer-ownership="none">
+            <parameter name="network_available" transfer-ownership="none">
               <type name="gboolean" c:type="gboolean"/>
             </parameter>
           </parameters>
@@ -56320,8 +56679,12 @@ was sent on is activated.</doc>
       </method>
       <method name="set_urgent"
               c:identifier="g_notification_set_urgent"
-              version="2.40">
+              version="2.40"
+              deprecated="1"
+              deprecated-version="2.42">
         <doc xml:space="preserve">Deprecated in favor of g_notification_set_priority().</doc>
+        <doc-deprecated xml:space="preserve">Since 2.42, this has been deprecated in favour of
+   g_notification_set_priority().</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -57161,7 +57524,9 @@ or g_output_stream_write_all().</doc>
           <parameter name="bytes_written"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">location to store the number of bytes that was
     written to the stream</doc>
             <type name="gsize" c:type="gsize*"/>
@@ -57341,7 +57706,9 @@ or g_output_stream_write_all().</doc>
           <parameter name="bytes_written"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">location to store the number of bytes that was
     written to the stream</doc>
             <type name="gsize" c:type="gsize*"/>
@@ -57460,7 +57827,9 @@ g_output_stream_write().</doc>
           <parameter name="bytes_written"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">location to store the number of bytes that was
     written to the stream</doc>
             <type name="gsize" c:type="gsize*"/>
@@ -57569,7 +57938,9 @@ g_output_stream_write_async().</doc>
           <parameter name="bytes_written"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">location to store the number of bytes that was written to the stream</doc>
             <type name="gsize" c:type="gsize*"/>
           </parameter>
@@ -59449,7 +59820,10 @@ Note that since this method never blocks, you cannot actually
 use @cancellable to cancel it. However, it will return an error
 if @cancellable has already been cancelled when you call, which
 may happen if you call this method after a source triggers due
-to having been cancelled.</doc>
+to having been cancelled.
+
+Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
+transports like D/TLS require that you send the same @buffer and @count.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of bytes written, or -1 on error (including
   %G_IO_ERROR_WOULD_BLOCK).</doc>
@@ -59564,7 +59938,10 @@ Note that since this method never blocks, you cannot actually
 use @cancellable to cancel it. However, it will return an error
 if @cancellable has already been cancelled when you call, which
 may happen if you call this method after a source triggers due
-to having been cancelled.</doc>
+to having been cancelled.
+
+Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
+transports like D/TLS require that you send the same @buffer and @count.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of bytes written, or -1 on error (including
   %G_IO_ERROR_WOULD_BLOCK).</doc>
@@ -60398,7 +60775,7 @@ if the creator didn't specify this).</doc>
            glib:get-type="g_proxy_address_enumerator_get_type"
            glib:type-struct="ProxyAddressEnumeratorClass">
       <doc xml:space="preserve">A subclass of #GSocketAddressEnumerator that takes another address
-enumerator and wraps its results in #GProxyAddress&lt;!-- --&gt;es as
+enumerator and wraps its results in #GProxyAddresses as
 directed by the default #GProxyResolver.</doc>
       <property name="connectable"
                 writable="1"
@@ -62972,7 +63349,11 @@ This will keep a reference to @data while the resource lives, so
 the data should not be modified or freed.
 
 If you want to use this resource in the global resource namespace you need
-to register it with g_resources_register().</doc>
+to register it with g_resources_register().
+
+Note: @data must be backed by memory that is at least pointer aligned.
+Otherwise this function will internally create a copy of the memory since
+GLib 2.56, or in older versions fail and exit the process.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #GResource, or %NULL on error</doc>
           <type name="Resource" c:type="GResource*"/>
@@ -63207,7 +63588,7 @@ to register it with g_resources_register().</doc>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
             <doc xml:space="preserve">the path of a filename to load, in the GLib filename encoding</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </function>
@@ -63315,7 +63696,8 @@ usually cause the stream to resize by introducing zero bytes.</doc>
         </parameters>
       </virtual-method>
       <virtual-method name="can_truncate" invoker="can_truncate">
-        <doc xml:space="preserve">Tests if the stream can be truncated.</doc>
+        <doc xml:space="preserve">Tests if the length of the stream can be adjusted with
+g_seekable_truncate().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -63384,7 +63766,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
         </parameters>
       </virtual-method>
       <virtual-method name="truncate_fn" invoker="truncate" throws="1">
-        <doc xml:space="preserve">Truncates a stream with a given #offset.
+        <doc xml:space="preserve">Sets the length of the stream to @offset. If the stream was previously
+larger than @offset, the extra data is discarded. If the stream was
+previouly shorter than @offset, it is extended with NUL ('\0') bytes.
 
 If @cancellable is not %NULL, then the operation can be cancelled by
 triggering the cancellable object from another thread. If the operation
@@ -63403,7 +63787,7 @@ partial result will be returned, without an error.</doc>
             <type name="Seekable" c:type="GSeekable*"/>
           </instance-parameter>
           <parameter name="offset" transfer-ownership="none">
-            <doc xml:space="preserve">a #goffset.</doc>
+            <doc xml:space="preserve">new length for @seekable, in bytes.</doc>
             <type name="gint64" c:type="goffset"/>
           </parameter>
           <parameter name="cancellable"
@@ -63429,7 +63813,8 @@ partial result will be returned, without an error.</doc>
         </parameters>
       </method>
       <method name="can_truncate" c:identifier="g_seekable_can_truncate">
-        <doc xml:space="preserve">Tests if the stream can be truncated.</doc>
+        <doc xml:space="preserve">Tests if the length of the stream can be adjusted with
+g_seekable_truncate().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -63498,7 +63883,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
         </parameters>
       </method>
       <method name="truncate" c:identifier="g_seekable_truncate" throws="1">
-        <doc xml:space="preserve">Truncates a stream with a given #offset.
+        <doc xml:space="preserve">Sets the length of the stream to @offset. If the stream was previously
+larger than @offset, the extra data is discarded. If the stream was
+previouly shorter than @offset, it is extended with NUL ('\0') bytes.
 
 If @cancellable is not %NULL, then the operation can be cancelled by
 triggering the cancellable object from another thread. If the operation
@@ -63517,7 +63904,7 @@ partial result will be returned, without an error.</doc>
             <type name="Seekable" c:type="GSeekable*"/>
           </instance-parameter>
           <parameter name="offset" transfer-ownership="none">
-            <doc xml:space="preserve">a #goffset.</doc>
+            <doc xml:space="preserve">new length for @seekable, in bytes.</doc>
             <type name="gint64" c:type="goffset"/>
           </parameter>
           <parameter name="cancellable"
@@ -63625,7 +64012,7 @@ partial result will be returned, without an error.</doc>
               <type name="Seekable" c:type="GSeekable*"/>
             </parameter>
             <parameter name="offset" transfer-ownership="none">
-              <doc xml:space="preserve">a #goffset.</doc>
+              <doc xml:space="preserve">new length for @seekable, in bytes.</doc>
               <type name="gint64" c:type="goffset"/>
             </parameter>
             <parameter name="cancellable"
@@ -63670,7 +64057,7 @@ When creating a GSettings instance, you have to specify a schema
 that describes the keys in your settings and their types and default
 values, as well as some other information.
 
-Normally, a schema has as fixed path that determines where the settings
+Normally, a schema has a fixed path that determines where the settings
 are stored in the conceptual global tree of settings. However, schemas
 can also be '[relocatable][gsettings-relocatable]', i.e. not equipped with
 a fixed path. This is
@@ -64087,7 +64474,7 @@ characters.</doc>
                 version="2.28"
                 deprecated="1"
                 deprecated-version="2.40">
-        <doc xml:space="preserve">&lt;!-- --&gt;</doc>
+        <doc xml:space="preserve">Deprecated.</doc>
         <doc-deprecated xml:space="preserve">Use g_settings_schema_source_list_schemas() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a list of relocatable
@@ -64103,7 +64490,7 @@ characters.</doc>
                 version="2.26"
                 deprecated="1"
                 deprecated-version="2.40">
-        <doc xml:space="preserve">&lt;!-- --&gt;</doc>
+        <doc xml:space="preserve">Deprecated.</doc>
         <doc-deprecated xml:space="preserve">Use g_settings_schema_source_list_schemas() instead.
 If you used g_settings_list_schemas() to check for the presence of
 a particular schema, use g_settings_schema_source_lookup() instead
@@ -64239,7 +64626,7 @@ function also establishes a binding between the writability of
 a boolean property by that name). See g_settings_bind_writable()
 for more details about writable bindings.
 
-Note that the lifecycle of the binding is tied to the object,
+Note that the lifecycle of the binding is tied to @object,
 and that you can have only one binding per object property.
 If you bind the same property twice on the same object, the second
 binding overrides the first one.</doc>
@@ -64279,7 +64666,7 @@ and the property @property of @object.
 The binding uses the provided mapping functions to map between
 settings and property values.
 
-Note that the lifecycle of the binding is tied to the object,
+Note that the lifecycle of the binding is tied to @object,
 and that you can have only one binding per object property.
 If you bind the same property twice on the same object, the second
 binding overrides the first one.</doc>
@@ -64352,7 +64739,7 @@ When the @inverted argument is %TRUE, the binding inverts the
 value as it passes from the setting to the object, i.e. @property
 will be set to %TRUE if the key is not writable.
 
-Note that the lifecycle of the binding is tied to the object,
+Note that the lifecycle of the binding is tied to @object,
 and that you can have only one binding per object property.
 If you bind the same property twice on the same object, the second
 binding overrides the first one.</doc>
@@ -65439,6 +65826,7 @@ If @value is floating then this function consumes the reference.</doc>
                 writable="1"
                 construct-only="1"
                 transfer-ownership="none">
+        <doc xml:space="preserve">The name of the context that the settings are stored in.</doc>
         <type name="SettingsBackend"/>
       </property>
       <property name="delay-apply" version="2.28" transfer-ownership="none">
@@ -65635,12 +66023,12 @@ The semantics of the interface are very precisely defined and
 implementations must carefully adhere to the expectations of
 callers that are documented on each of the interface methods.
 
-Some of the GSettingsBackend functions accept or return a #GTree.
+Some of the #GSettingsBackend functions accept or return a #GTree.
 These trees always have strings as keys and #GVariant as values.
 g_settings_backend_create_tree() is a convenience function to create
 suitable trees.
 
-The GSettingsBackend API is exported to allow third-party
+The #GSettingsBackend API is exported to allow third-party
 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
@@ -66536,7 +66924,7 @@ initialise_plugin (const gchar *dir)
   ...
 
   plugin-&gt;schema_source =
-    g_settings_new_schema_source_from_directory (dir,
+    g_settings_schema_source_new_from_directory (dir,
       g_settings_schema_source_get_default (), FALSE, NULL);
 
   ...
@@ -66997,7 +67385,7 @@ returned by g_settings_schema_source_get_default().</doc>
         <parameters>
           <parameter name="directory" transfer-ownership="none">
             <doc xml:space="preserve">the filename of a directory</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
           <parameter name="parent"
                      transfer-ownership="none"
@@ -67138,7 +67526,7 @@ from different directories, depending on which directories were given
 in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all
 lookups performed against the default source should probably be done
 recursively.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the default schema source</doc>
           <type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
         </return-value>
@@ -67608,9 +67996,10 @@ g_simple_async_result_complete() will finish an I/O task directly
 from the point where it is called. g_simple_async_result_complete_in_idle()
 will finish it from an idle handler in the
 [thread-default main context][g-main-context-push-thread-default]
-. g_simple_async_result_run_in_thread() will run the
-job in a separate thread and then deliver the result to the
-thread-default main context.
+where the #GSimpleAsyncResult was created.
+g_simple_async_result_run_in_thread() will run the job in a
+separate thread and then use
+g_simple_async_result_complete_in_idle() to deliver the result.
 
 To set the results of an asynchronous function,
 g_simple_async_result_set_op_res_gpointer(),
@@ -69464,7 +69853,7 @@ In case the protocol is unknown, -1 is returned.</doc>
               c:identifier="g_socket_get_remote_address"
               version="2.22"
               throws="1">
-        <doc xml:space="preserve">Try to get the remove address of a connected socket. This is only
+        <doc xml:space="preserve">Try to get the remote address of a connected socket. This is only
 useful for connection oriented sockets that have been connected.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a #GSocketAddress or %NULL on error.
@@ -69573,7 +69962,10 @@ to bind to based on @group.
 
 If @source_specific is %TRUE, source-specific multicast as defined
 in RFC 4604 is used. Note that on older platforms this may fail
-with a %G_IO_ERROR_NOT_SUPPORTED error.</doc>
+with a %G_IO_ERROR_NOT_SUPPORTED error.
+
+To bind to a given source-specific multicast address, use
+g_socket_join_multicast_group_ssm() instead.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -69600,6 +69992,55 @@ with a %G_IO_ERROR_NOT_SUPPORTED error.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="join_multicast_group_ssm"
+              c:identifier="g_socket_join_multicast_group_ssm"
+              version="2.56"
+              throws="1">
+        <doc xml:space="preserve">Registers @socket to receive multicast messages sent to @group.
+@socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have
+been bound to an appropriate interface and port with
+g_socket_bind().
+
+If @iface is %NULL, the system will automatically pick an interface
+to bind to based on @group.
+
+If @source_specific is not %NULL, use source-specific multicast as
+defined in RFC 4604. Note that on older platforms this may fail
+with a %G_IO_ERROR_NOT_SUPPORTED error.
+
+Note that this function can be called multiple times for the same
+@group with different @source_specific in order to receive multicast
+packets from more than one source.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="socket" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSocket.</doc>
+            <type name="Socket" c:type="GSocket*"/>
+          </instance-parameter>
+          <parameter name="group" transfer-ownership="none">
+            <doc xml:space="preserve">a #GInetAddress specifying the group address to join.</doc>
+            <type name="InetAddress" c:type="GInetAddress*"/>
+          </parameter>
+          <parameter name="source_specific"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GInetAddress specifying the
+source-specific multicast address or %NULL to ignore.</doc>
+            <type name="InetAddress" c:type="GInetAddress*"/>
+          </parameter>
+          <parameter name="iface"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">Name of the interface to use, or %NULL</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="leave_multicast_group"
               c:identifier="g_socket_leave_multicast_group"
               version="2.32"
@@ -69609,7 +70050,10 @@ and @source_specific (which must all have the same values they had
 when you joined the group).
 
 @socket remains bound to its address and port, and can still receive
-unicast messages after calling this.</doc>
+unicast messages after calling this.
+
+To unbind to a given source-specific multicast address, use
+g_socket_leave_multicast_group_ssm() instead.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -69636,6 +70080,46 @@ unicast messages after calling this.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="leave_multicast_group_ssm"
+              c:identifier="g_socket_leave_multicast_group_ssm"
+              version="2.56"
+              throws="1">
+        <doc xml:space="preserve">Removes @socket from the multicast group defined by @group, @iface,
+and @source_specific (which must all have the same values they had
+when you joined the group).
+
+@socket remains bound to its address and port, and can still receive
+unicast messages after calling this.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="socket" transfer-ownership="none">
+            <doc xml:space="preserve">a #GSocket.</doc>
+            <type name="Socket" c:type="GSocket*"/>
+          </instance-parameter>
+          <parameter name="group" transfer-ownership="none">
+            <doc xml:space="preserve">a #GInetAddress specifying the group address to leave.</doc>
+            <type name="InetAddress" c:type="GInetAddress*"/>
+          </parameter>
+          <parameter name="source_specific"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GInetAddress specifying the
+source-specific multicast address or %NULL to ignore.</doc>
+            <type name="InetAddress" c:type="GInetAddress*"/>
+          </parameter>
+          <parameter name="iface"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">Name of the interface to use, or %NULL</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="listen"
               c:identifier="g_socket_listen"
               version="2.22"
@@ -70955,7 +71439,7 @@ struct sockaddr</doc>
            glib:get-type="g_socket_address_enumerator_get_type"
            glib:type-struct="SocketAddressEnumeratorClass">
       <doc xml:space="preserve">Enumerator type for objects that contain or generate
-#GSocketAddress&lt;!-- --&gt;es.</doc>
+#GSocketAddress instances.</doc>
       <virtual-method name="next" invoker="next" throws="1">
         <doc xml:space="preserve">Retrieves the next #GSocketAddress from @enumerator. Note that this
 may block for some amount of time. (Eg, a #GNetworkAddress may need
@@ -73474,7 +73958,7 @@ or g_socket_listener_add_inet_port().</doc>
             <type name="SocketListener" c:type="GSocketListener*"/>
           </instance-parameter>
           <parameter name="event" transfer-ownership="none">
-            <type name="SocketListenerEvent" c:type="GSocketListenerEvent*"/>
+            <type name="SocketListenerEvent" c:type="GSocketListenerEvent"/>
           </parameter>
           <parameter name="socket" transfer-ownership="none">
             <type name="Socket" c:type="GSocket*"/>
@@ -73974,7 +74458,7 @@ the order they happen in is undefined.</doc>
               <type name="SocketListener" c:type="GSocketListener*"/>
             </parameter>
             <parameter name="event" transfer-ownership="none">
-              <type name="SocketListenerEvent" c:type="GSocketListenerEvent*"/>
+              <type name="SocketListenerEvent" c:type="GSocketListenerEvent"/>
             </parameter>
             <parameter name="socket" transfer-ownership="none">
               <type name="Socket" c:type="GSocket*"/>
@@ -74794,7 +75278,7 @@ The argument list is expected to be %NULL-terminated.</doc>
           <parameter name="argv" transfer-ownership="none">
             <doc xml:space="preserve">commandline arguments for the subprocess</doc>
             <array c:type="gchar**">
-              <type name="utf8"/>
+              <type name="filename"/>
             </array>
           </parameter>
           <parameter name="flags" transfer-ownership="none">
@@ -74874,14 +75358,20 @@ attempt to interact with the pipes while the operation is in progress
           <parameter name="stdout_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">data read from the subprocess stdout</doc>
             <type name="GLib.Bytes" c:type="GBytes**"/>
           </parameter>
           <parameter name="stderr_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">data read from the subprocess stderr</doc>
             <type name="GLib.Bytes" c:type="GBytes**"/>
           </parameter>
@@ -74950,14 +75440,20 @@ invocation with g_subprocess_communicate_finish().</doc>
           <parameter name="stdout_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">Return location for stdout data</doc>
             <type name="GLib.Bytes" c:type="GBytes**"/>
           </parameter>
           <parameter name="stderr_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">Return location for stderr data</doc>
             <type name="GLib.Bytes" c:type="GBytes**"/>
           </parameter>
@@ -74993,14 +75489,20 @@ process as UTF-8, and returns it as a regular NUL terminated string.</doc>
           <parameter name="stdout_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">data read from the subprocess stdout</doc>
             <type name="utf8" c:type="char**"/>
           </parameter>
           <parameter name="stderr_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">data read from the subprocess stderr</doc>
             <type name="utf8" c:type="char**"/>
           </parameter>
@@ -75069,14 +75571,20 @@ invocation with g_subprocess_communicate_utf8_finish().</doc>
           <parameter name="stdout_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">Return location for stdout data</doc>
             <type name="utf8" c:type="char**"/>
           </parameter>
           <parameter name="stderr_buf"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
             <doc xml:space="preserve">Return location for stderr data</doc>
             <type name="utf8" c:type="char**"/>
           </parameter>
@@ -75502,7 +76010,7 @@ g_subprocess_wait_async().</doc>
               c:type="GSubprocessFlags">
       <doc xml:space="preserve">Flags to define the behaviour of a #GSubprocess.
 
-Note that the default for stdin is to redirect from /dev/null.  For
+Note that the default for stdin is to redirect from `/dev/null`.  For
 stdout and stderr the default are for them to inherit the
 corresponding descriptor from the calling process.
 
@@ -75543,7 +76051,7 @@ example, you may not request both %G_SUBPROCESS_FLAGS_STDOUT_PIPE and
               c:identifier="G_SUBPROCESS_FLAGS_STDOUT_SILENCE"
               glib:nick="stdout-silence">
         <doc xml:space="preserve">silence the stdout of the spawned
-  process (ie: redirect to /dev/null).</doc>
+  process (ie: redirect to `/dev/null`).</doc>
       </member>
       <member name="stderr_pipe"
               value="16"
@@ -75558,7 +76066,7 @@ example, you may not request both %G_SUBPROCESS_FLAGS_STDOUT_PIPE and
               c:identifier="G_SUBPROCESS_FLAGS_STDERR_SILENCE"
               glib:nick="stderr-silence">
         <doc xml:space="preserve">silence the stderr of the spawned
-  process (ie: redirect to /dev/null).</doc>
+  process (ie: redirect to `/dev/null`).</doc>
       </member>
       <member name="stderr_merge"
               value="64"
@@ -75620,8 +76128,9 @@ environment of processes launched from this launcher.
 On UNIX, the returned string can be an arbitrary byte string.
 On Windows, it will be UTF-8.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the value of the environment variable, %NULL if unset</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">the value of the environment variable,
+    %NULL if unset</doc>
+          <type name="filename" c:type="const gchar*"/>
         </return-value>
         <parameters>
           <instance-parameter name="self" transfer-ownership="none">
@@ -75630,7 +76139,7 @@ On Windows, it will be UTF-8.</doc>
           </instance-parameter>
           <parameter name="variable" transfer-ownership="none">
             <doc xml:space="preserve">the environment variable to get</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -75652,7 +76161,7 @@ of the launching process at the time of launch.</doc>
           </instance-parameter>
           <parameter name="cwd" transfer-ownership="none">
             <doc xml:space="preserve">the cwd for launched processes</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -75687,9 +76196,10 @@ On Windows, they should be in UTF-8.</doc>
             <type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
           </instance-parameter>
           <parameter name="env" transfer-ownership="none">
-            <doc xml:space="preserve">the replacement environment</doc>
+            <doc xml:space="preserve">
+    the replacement environment</doc>
             <array c:type="gchar**">
-              <type name="utf8" c:type="gchar*"/>
+              <type name="filename"/>
             </array>
           </parameter>
         </parameters>
@@ -75741,12 +76251,13 @@ On Windows, they should be in UTF-8.</doc>
             <type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
           </instance-parameter>
           <parameter name="variable" transfer-ownership="none">
-            <doc xml:space="preserve">the environment variable to set, must not contain '='</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <doc xml:space="preserve">the environment variable to set,
+    must not contain '='</doc>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
             <doc xml:space="preserve">the new value for the variable</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
           <parameter name="overwrite" transfer-ownership="none">
             <doc xml:space="preserve">whether to change the variable if it already exists</doc>
@@ -75799,7 +76310,7 @@ On Windows, they should be in UTF-8.</doc>
           <parameter name="argv" transfer-ownership="none">
             <doc xml:space="preserve">Command line arguments</doc>
             <array c:type="gchar**">
-              <type name="utf8"/>
+              <type name="filename"/>
             </array>
           </parameter>
         </parameters>
@@ -75821,8 +76332,9 @@ containing '='. On Windows, it should be in UTF-8.</doc>
             <type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
           </instance-parameter>
           <parameter name="variable" transfer-ownership="none">
-            <doc xml:space="preserve">the environment variable to unset, must not contain '='</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <doc xml:space="preserve">the environment variable to unset,
+    must not contain '='</doc>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -75875,11 +76387,13 @@ task object around through your asynchronous operation.
 Eventually, you will call a method such as
 g_task_return_pointer() or g_task_return_error(), which will
 save the value you give it and then invoke the task's callback
-function (waiting until the next iteration of the main
-loop first, if necessary). The caller will pass the #GTask back
-to the operation's finish function (as a #GAsyncResult), and
-you can use g_task_propagate_pointer() or the like to extract
-the return value.
+function in the
+[thread-default main context][g-main-context-push-thread-default]
+where it was created (waiting until the next iteration of the main
+loop first, if necessary). The caller will pass the #GTask back to
+the operation's finish function (as a #GAsyncResult), and you can
+can use g_task_propagate_pointer() or the like to extract the
+return value.
 
 Here is an example for using GTask as a GAsyncResult:
 |[&lt;!-- language="C" --&gt;
@@ -76118,9 +76632,10 @@ Here is an example for chained asynchronous operations:
 ## Asynchronous operations from synchronous ones
 
 You can use g_task_run_in_thread() to turn a synchronous
-operation into an asynchronous one, by running it in a thread
-which will then dispatch the result back to the caller's
-#GMainContext when it completes.
+operation into an asynchronous one, by running it in a thread.
+When it completes, the result will be dispatched to the
+[thread-default main context][g-main-context-push-thread-default]
+where the #GTask was created.
 
 Running a task in a thread:
   |[&lt;!-- language="C" --&gt;
@@ -76332,7 +76847,7 @@ in several ways:
   whether the task's callback can be invoked directly, or
   if it needs to be sent to another #GMainContext, or delayed
   until the next iteration of the current #GMainContext.)
-- The "finish" functions for #GTask-based operations are generally
+- The "finish" functions for #GTask based operations are generally
   much simpler than #GSimpleAsyncResult ones, normally consisting
   of only a single call to g_task_propagate_pointer() or the like.
   Since g_task_propagate_pointer() "steals" the return value from
@@ -76683,7 +77198,7 @@ g_task_set_return_on_cancel() for more details.</doc>
               version="2.36">
         <doc xml:space="preserve">Gets the source object from @task. Like
 g_async_result_get_source_object(), but does not ref the object.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">@task's source object, or %NULL</doc>
           <type name="GObject.Object" c:type="gpointer"/>
         </return-value>
@@ -78104,7 +78619,7 @@ support is available, and vice-versa.</doc>
         <doc xml:space="preserve">Gets the #GType of @backend’s #GDtlsClientConnection implementation.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the #GType of @backend’s #GDtlsClientConnection
-  implementation.</doc>
+  implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS.</doc>
           <type name="GType" c:type="GType"/>
         </return-value>
         <parameters>
@@ -78120,7 +78635,7 @@ support is available, and vice-versa.</doc>
         <doc xml:space="preserve">Gets the #GType of @backend’s #GDtlsServerConnection implementation.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the #GType of @backend’s #GDtlsServerConnection
-  implementation.</doc>
+  implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS.</doc>
           <type name="GType" c:type="GType"/>
         </return-value>
         <parameters>
@@ -78327,7 +78842,7 @@ g_tls_certificate_new_from_pem().</doc>
         <parameters>
           <parameter name="file" transfer-ownership="none">
             <doc xml:space="preserve">file containing a PEM-encoded certificate to import</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </constructor>
@@ -78357,12 +78872,12 @@ g_tls_certificate_new_from_pem().</doc>
           <parameter name="cert_file" transfer-ownership="none">
             <doc xml:space="preserve">file containing one or more PEM-encoded
     certificates to import</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
           <parameter name="key_file" transfer-ownership="none">
             <doc xml:space="preserve">file containing a PEM-encoded private key
     to import</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </constructor>
@@ -78419,7 +78934,7 @@ and its contents when you are done with it.</doc>
         <parameters>
           <parameter name="file" transfer-ownership="none">
             <doc xml:space="preserve">file containing PEM-encoded certificates to import</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </function>
@@ -78889,12 +79404,16 @@ known.</doc>
       </method>
       <method name="get_use_ssl3"
               c:identifier="g_tls_client_connection_get_use_ssl3"
-              version="2.28">
-        <doc xml:space="preserve">Gets whether @conn will use SSL 3.0 rather than the
-highest-supported version of TLS; see
-g_tls_client_connection_set_use_ssl3().</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">whether @conn will use SSL 3.0</doc>
+              version="2.28"
+              deprecated="1"
+              deprecated-version="2.56">
+        <doc xml:space="preserve">Gets whether @conn will force the lowest-supported TLS protocol
+version rather than attempt to negotiate the highest mutually-
+supported version of TLS; see g_tls_client_connection_set_use_ssl3().</doc>
+        <doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this function does not
+actually indicate whether it is enabled.</doc-deprecated>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether @conn will use the lowest-supported TLS protocol version</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
@@ -78942,12 +79461,19 @@ performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.</doc>
       </method>
       <method name="set_use_ssl3"
               c:identifier="g_tls_client_connection_set_use_ssl3"
-              version="2.28">
-        <doc xml:space="preserve">If @use_ssl3 is %TRUE, this forces @conn to use SSL 3.0 rather than
-trying to properly negotiate the right version of TLS or SSL to use.
-This can be used when talking to servers that do not implement the
-fallbacks correctly and which will therefore fail to handshake with
-a "modern" TLS handshake attempt.</doc>
+              version="2.28"
+              deprecated="1"
+              deprecated-version="2.56">
+        <doc xml:space="preserve">If @use_ssl3 is %TRUE, this forces @conn to use the lowest-supported
+TLS protocol version rather than trying to properly negotiate the
+highest mutually-supported protocol version with the peer. This can
+be used when talking to broken TLS servers that exhibit protocol
+version intolerance.
+
+Be aware that SSL 3.0 is generally disabled by the #GTlsBackend, so
+the lowest-supported protocol version is probably not SSL 3.0.</doc>
+        <doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this function does not
+generally enable or disable it, despite its name.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -78957,7 +79483,7 @@ a "modern" TLS handshake attempt.</doc>
             <type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
           </instance-parameter>
           <parameter name="use_ssl3" transfer-ownership="none">
-            <doc xml:space="preserve">whether to use SSL 3.0</doc>
+            <doc xml:space="preserve">whether to use the lowest-supported protocol version</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
         </parameters>
@@ -79017,19 +79543,23 @@ virtual hosts.</doc>
       </property>
       <property name="use-ssl3"
                 version="2.28"
+                deprecated="1"
+                deprecated-version="2.56"
                 writable="1"
                 construct="1"
                 transfer-ownership="none">
-        <doc xml:space="preserve">If %TRUE, tells the connection to use a fallback version of TLS
+        <doc xml:space="preserve">If %TRUE, forces the connection to use a fallback version of TLS
 or SSL, rather than trying to negotiate the best version of TLS
 to use. This can be used when talking to servers that don't
 implement version negotiation correctly and therefore refuse to
-handshake at all with a "modern" TLS handshake.
-
-Despite the property name, the fallback version is not
-necessarily SSL 3.0; if SSL 3.0 has been disabled, the
-#GTlsClientConnection will use the next highest available version
-(normally TLS 1.0) as the fallback version.</doc>
+handshake at all with a modern TLS handshake.
+
+Despite the property name, the fallback version is usually not
+SSL 3.0, because SSL 3.0 is generally disabled by the #GTlsBackend.
+#GTlsClientConnection will use the next-highest available version
+as the fallback version.</doc>
+        <doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this property does not
+generally enable or disable it, despite its name.</doc-deprecated>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="validation-flags"
@@ -80090,7 +80620,7 @@ g_tls_database_lookup_certificate_for_handle() for more information.</doc>
                       version="2.30"
                       throws="1">
         <doc xml:space="preserve">Finish an asynchronous lookup of a certificate by its handle. See
-g_tls_database_lookup_certificate_handle() for more information.
+g_tls_database_lookup_certificate_by_handle() for more information.
 
 If the handle is no longer valid, or does not point to a certificate in
 this database, then %NULL will be returned.</doc>
@@ -80374,7 +80904,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
 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
+certificate in the chain by its #GTlsCertificate:issuer property. The chain may initially
 consist of one or more certificates. After the verification process is
 complete, @chain may be modified by adding missing certificates, or removing
 extra certificates. If a certificate anchor was found, then it is added to
@@ -80684,7 +81214,7 @@ g_tls_database_lookup_certificate_for_handle() for more information.</doc>
               version="2.30"
               throws="1">
         <doc xml:space="preserve">Finish an asynchronous lookup of a certificate by its handle. See
-g_tls_database_lookup_certificate_handle() for more information.
+g_tls_database_lookup_certificate_by_handle() for more information.
 
 If the handle is no longer valid, or does not point to a certificate in
 this database, then %NULL will be returned.</doc>
@@ -80966,7 +81496,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
 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
+certificate in the chain by its #GTlsCertificate:issuer property. The chain may initially
 consist of one or more certificates. After the verification process is
 complete, @chain may be modified by adding missing certificates, or removing
 extra certificates. If a certificate anchor was found, then it is added to
@@ -81655,7 +82185,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
                  glib:type-name="GTlsDatabaseLookupFlags"
                  glib:get-type="g_tls_database_lookup_flags_get_type"
                  c:type="GTlsDatabaseLookupFlags">
-      <doc xml:space="preserve">Flags for g_tls_database_lookup_certificate_handle(),
+      <doc xml:space="preserve">Flags for g_tls_database_lookup_certificate_for_handle(),
 g_tls_database_lookup_certificate_issuer(),
 and g_tls_database_lookup_certificates_issued_by().</doc>
       <member name="none"
@@ -81780,7 +82310,7 @@ The certificates in @anchors must be PEM encoded.</doc>
         <parameters>
           <parameter name="anchors" transfer-ownership="none">
             <doc xml:space="preserve">filename of anchor certificate authorities.</doc>
-            <type name="filename" c:type="gchar*"/>
+            <type name="filename" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </function>
@@ -82763,7 +83293,9 @@ considered part of the password in this case.)</doc>
           </instance-parameter>
           <parameter name="value" transfer-ownership="none">
             <doc xml:space="preserve">the value for the password</doc>
-            <type name="guint8" c:type="guchar*"/>
+            <array length="1" zero-terminated="0" c:type="guchar*">
+              <type name="guint8" c:type="guchar"/>
+            </array>
           </parameter>
           <parameter name="length" transfer-ownership="none">
             <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -82908,7 +83440,9 @@ considered part of the password in this case.)</doc>
           </instance-parameter>
           <parameter name="value" transfer-ownership="none">
             <doc xml:space="preserve">the new password value</doc>
-            <type name="guint8" c:type="const guchar*"/>
+            <array length="1" zero-terminated="0" c:type="guchar*">
+              <type name="guint8" c:type="guchar"/>
+            </array>
           </parameter>
           <parameter name="length" transfer-ownership="none">
             <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -82938,7 +83472,9 @@ considered part of the password in this case.)</doc>
           </instance-parameter>
           <parameter name="value" transfer-ownership="none">
             <doc xml:space="preserve">the value for the password</doc>
-            <type name="guint8" c:type="guchar*"/>
+            <array length="1" zero-terminated="0" c:type="guchar*">
+              <type name="guint8" c:type="guchar"/>
+            </array>
           </parameter>
           <parameter name="length" transfer-ownership="none">
             <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -83030,7 +83566,9 @@ g_tls_password_get_flags().</doc>
             </parameter>
             <parameter name="value" transfer-ownership="none">
               <doc xml:space="preserve">the value for the password</doc>
-              <type name="guint8" c:type="guchar*"/>
+              <array length="2" zero-terminated="0" c:type="guchar*">
+                <type name="guint8" c:type="guchar"/>
+              </array>
             </parameter>
             <parameter name="length" transfer-ownership="none">
               <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -84335,7 +84873,7 @@ other words, in code
 then the expression
 |[&lt;!-- language="C" --&gt;
   (g_file_has_prefix (volume_activation_root, mount_root) ||
-      g_file_equal (volume_activation_root, mount_root))
+   g_file_equal (volume_activation_root, mount_root))
 ]|
 will always be %TRUE.
 
@@ -84785,7 +85323,7 @@ other words, in code
 then the expression
 |[&lt;!-- language="C" --&gt;
   (g_file_has_prefix (volume_activation_root, mount_root) ||
-      g_file_equal (volume_activation_root, mount_root))
+   g_file_equal (volume_activation_root, mount_root))
 ]|
 will always be %TRUE.
 
@@ -85966,7 +86504,10 @@ its elements have been unreffed with g_object_unref().</doc>
         </parameters>
       </glib:signal>
       <glib:signal name="mount-pre-unmount" when="last">
-        <doc xml:space="preserve">Emitted when a mount is about to be removed.</doc>
+        <doc xml:space="preserve">May be emitted when a mount is about to be removed.
+
+This signal depends on the backend and is only emitted if
+GIO was used to unmount.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -86679,7 +87220,7 @@ being swallowed by Exec key unquoting. See the specification for exact quoting r
       <parameters>
         <parameter name="commandline" transfer-ownership="none">
           <doc xml:space="preserve">the commandline to use</doc>
-          <type name="utf8" c:type="const char*"/>
+          <type name="filename" c:type="const char*"/>
         </parameter>
         <parameter name="application_name"
                    transfer-ownership="none"
@@ -86834,7 +87375,7 @@ required.</doc>
           <doc xml:space="preserve">the uri to show</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
-        <parameter name="launch_context"
+        <parameter name="context"
                    transfer-ownership="none"
                    nullable="1"
                    allow-none="1">
@@ -86861,13 +87402,18 @@ dialog to the user.</doc>
           <doc xml:space="preserve">the uri to show</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
-        <parameter name="launch_context" transfer-ownership="none">
+        <parameter name="context"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">an optional #GAppLaunchContext</doc>
           <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
         </parameter>
         <parameter name="cancellable"
                    transfer-ownership="none"
                    nullable="1"
                    allow-none="1">
+          <doc xml:space="preserve">a #GCancellable</doc>
           <type name="Cancellable" c:type="GCancellable*"/>
         </parameter>
         <parameter name="callback"
@@ -87896,10 +88442,10 @@ g_list_free_full (list, g_free).</doc>
       <doc xml:space="preserve">Escape @string so it can appear in a D-Bus address as the value
 part of a key-value pair.
 
-For instance, if @string is "/run/bus-for-:0",
-this function would return "/run/bus-for-%3A0",
+For instance, if @string is `/run/bus-for-:0`,
+this function would return `/run/bus-for-%3A0`,
 which could be used in a D-Bus address like
-"unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0".</doc>
+`unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0`.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">a copy of @string with all
     non-optionally-escaped bytes escaped</doc>
@@ -88245,7 +88791,9 @@ exists.</doc>
         </parameter>
         <parameter name="entries" transfer-ownership="none">
           <doc xml:space="preserve">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
-          <type name="DBusErrorEntry" c:type="const GDBusErrorEntry*"/>
+          <array length="3" zero-terminated="0" c:type="GDBusErrorEntry*">
+            <type name="DBusErrorEntry" c:type="GDBusErrorEntry"/>
+          </array>
         </parameter>
         <parameter name="num_entries" transfer-ownership="none">
           <doc xml:space="preserve">Number of items to register.</doc>
@@ -88580,7 +89128,7 @@ for you there.  It is also always possible to use this function with
       <parameters>
         <parameter name="arg" transfer-ownership="none">
           <doc xml:space="preserve">a command line string</doc>
-          <type name="utf8" c:type="const char*"/>
+          <type name="filename" c:type="const char*"/>
         </parameter>
       </parameters>
     </function>
@@ -88606,11 +89154,11 @@ See also g_application_command_line_create_file_for_arg().</doc>
       <parameters>
         <parameter name="arg" transfer-ownership="none">
           <doc xml:space="preserve">a command line string</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
         <parameter name="cwd" transfer-ownership="none">
           <doc xml:space="preserve">the current working directory of the commandline</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -88629,7 +89177,7 @@ operation if @path is malformed.</doc>
         <parameter name="path" transfer-ownership="none">
           <doc xml:space="preserve">a string containing a relative or absolute path.
     The string must be encoded in the glib filename encoding.</doc>
-          <type name="filename" c:type="char*"/>
+          <type name="filename" c:type="const char*"/>
         </parameter>
       </parameters>
     </function>
@@ -88679,7 +89227,7 @@ a temporary file could not be created.</doc>
                    allow-none="1">
           <doc xml:space="preserve">Template for the file
   name, as in g_file_open_tmp(), or %NULL for a default template</doc>
-          <type name="filename" c:type="char*"/>
+          <type name="filename" c:type="const char*"/>
         </parameter>
         <parameter name="iostream"
                    direction="out"
@@ -88936,7 +89484,7 @@ which allows delayed/lazy loading of modules.</doc>
         <parameter name="dirname" transfer-ownership="none">
           <doc xml:space="preserve">pathname for a directory containing modules
     to load.</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -88963,7 +89511,7 @@ which allows delayed/lazy loading of modules.</doc>
         <parameter name="dirname" transfer-ownership="none">
           <doc xml:space="preserve">pathname for a directory containing modules
     to load.</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
         <parameter name="scope" transfer-ownership="none">
           <doc xml:space="preserve">a scope to use when scanning the modules.</doc>
@@ -88992,7 +89540,7 @@ use g_io_modules_load_all_in_directory().</doc>
         <parameter name="dirname" transfer-ownership="none">
           <doc xml:space="preserve">pathname for a directory containing modules
     to scan.</doc>
-          <type name="filename" c:type="char*"/>
+          <type name="filename" c:type="const char*"/>
         </parameter>
       </parameters>
     </function>
@@ -89017,7 +89565,7 @@ use g_io_modules_load_all_in_directory().</doc>
         <parameter name="dirname" transfer-ownership="none">
           <doc xml:space="preserve">pathname for a directory containing modules
     to scan.</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
         <parameter name="scope" transfer-ownership="none">
           <doc xml:space="preserve">a scope to use when scanning the modules</doc>
@@ -89480,7 +90028,7 @@ to register it with g_resources_register().</doc>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
           <doc xml:space="preserve">the path of a filename to load, in the GLib filename encoding</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -89660,7 +90208,7 @@ from different directories, depending on which directories were given
 in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all
 lookups performed against the default source should probably be done
 recursively.</doc>
-      <return-value transfer-ownership="none">
+      <return-value transfer-ownership="none" nullable="1">
         <doc xml:space="preserve">the default schema source</doc>
         <type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
       </return-value>
@@ -89892,7 +90440,7 @@ The certificates in @anchors must be PEM encoded.</doc>
       <parameters>
         <parameter name="anchors" transfer-ownership="none">
           <doc xml:space="preserve">filename of anchor certificate authorities.</doc>
-          <type name="filename" c:type="gchar*"/>
+          <type name="filename" c:type="const gchar*"/>
         </parameter>
       </parameters>
     </function>