RubyGems - gobject-introspection - Versions diffs - 3.0.9-x86-mingw32 → 3.1.0-x86-mingw32 - Mend

gobject-introspection 3.0.9-x86-mingw32 → 3.1.0-x86-mingw32

Files changed (91) hide show

data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc CHANGED Viewed

@@ -21,4 +21,4 @@ Libs.private:
 Name: gobject-introspection
 Description: GObject Introspection
-Version: 1.48.0
+Version: 1.50.0

data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc CHANGED Viewed

@@ -20,4 +20,4 @@ Libs.private:
 Name: gobject-introspection
 Description: GObject Introspection
-Version: 1.48.0
+Version: 1.50.0

data/vendor/local/share/gir-1.0/GIRepository-2.0.gir CHANGED Viewed

@@ -431,7 +431,10 @@ print_attributes (GIBaseInfo *info)
             <doc xml:space="preserve">a #GIBaseInfo</doc>
             <type name="BaseInfo" c:type="GIBaseInfo*"/>
           </instance-parameter>
-          <parameter name="iterator" transfer-ownership="none">
+          <parameter name="iterator"
+                     direction="inout"
+                     caller-allocates="0"
+                     transfer-ownership="full">
             <doc xml:space="preserve">a #GIAttributeIter structure, must be initialized; see below</doc>
             <type name="AttributeIter" c:type="GIAttributeIter*"/>
           </parameter>
@@ -1758,7 +1761,7 @@ g_base_info_unref() when done.</doc>
       <doc xml:space="preserve">See whether the caller owns the return value of this callable.
 #GITransfer contains a list of possible transfer values.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%TRUE if the caller owns the return value, %FALSE otherwise.</doc>
+        <doc xml:space="preserve">the transfer mode for the return value of the callable</doc>
         <type name="Transfer" c:type="GITransfer"/>
       </return-value>
       <parameters>
@@ -1773,7 +1776,7 @@ g_base_info_unref() when done.</doc>
       <doc xml:space="preserve">Obtains the ownership transfer for the instance argument.
 #GITransfer contains a list of possible transfer values.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the transfer</doc>
+        <doc xml:space="preserve">the transfer mode of the instance argument</doc>
         <type name="Transfer" c:type="GITransfer"/>
       </return-value>
       <parameters>
@@ -1922,7 +1925,10 @@ similar API.</doc>
           <doc xml:space="preserve">a #GICallableInfo</doc>
           <type name="CallableInfo" c:type="GICallableInfo*"/>
         </parameter>
-        <parameter name="iterator" transfer-ownership="none">
+        <parameter name="iterator"
+                   direction="inout"
+                   caller-allocates="0"
+                   transfer-ownership="full">
           <doc xml:space="preserve">a #GIAttributeIter structure, must be initialized; see below</doc>
           <type name="AttributeIter" c:type="GIAttributeIter*"/>
         </parameter>

data/vendor/local/share/gir-1.0/GLib-2.0.gir CHANGED Viewed

@@ -1827,15 +1827,15 @@ set to either a #GFileError or #GBookmarkFileError.</doc>
           </instance-parameter>
           <parameter name="file" transfer-ownership="none">
             <doc xml:space="preserve">a relative path to a filename to open and parse</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="gchar*"/>
           </parameter>
           <parameter name="full_path"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">return location for a string containing the full path
-  of the file, or %NULL</doc>
-            <type name="utf8" c:type="gchar**"/>
+            <doc xml:space="preserve">return location for a string
+   containing the full path of the file, or %NULL</doc>
+            <type name="filename" c:type="gchar**"/>
           </parameter>
         </parameters>
       </method>
@@ -1856,8 +1856,9 @@ or #GBookmarkFileError.</doc>
             <type name="BookmarkFile" c:type="GBookmarkFile*"/>
           </instance-parameter>
           <parameter name="filename" transfer-ownership="none">
-            <doc xml:space="preserve">the path of a filename to load, in the GLib file name encoding</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <doc xml:space="preserve">the path of a filename to load, in the
+    GLib file name encoding</doc>
+            <type name="filename" c:type="gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -2336,7 +2337,7 @@ guaranteed to be atomic by using g_file_set_contents() internally.</doc>
           </instance-parameter>
           <parameter name="filename" transfer-ownership="none">
             <doc xml:space="preserve">path of the output file</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="gchar*"/>
           </parameter>
         </parameters>
       </method>
@@ -3358,7 +3359,7 @@ date to include new hashing algorithm types.</doc>
         <doc xml:space="preserve">Use the SHA-256 hashing algorithm</doc>
       </member>
       <member name="sha512" value="3" c:identifier="G_CHECKSUM_SHA512">
-        <doc xml:space="preserve">Use the SHA-512 hashing algorithm</doc>
+        <doc xml:space="preserve">Use the SHA-512 hashing algorithm (Since: 2.36)</doc>
       </member>
     </enumeration>
     <callback name="ChildWatchFunc" c:type="GChildWatchFunc">
@@ -4147,7 +4148,7 @@ The date must be valid.</doc>
       <method name="get_sunday_week_of_year"
               c:identifier="g_date_get_sunday_week_of_year">
         <doc xml:space="preserve">Returns the week of the year during which this date falls, if
-weeks are understood to being on Sunday. The date must be valid.
+weeks are understood to begin on Sunday. The date must be valid.
 Can return 0 if the day is before the first Sunday of the year.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">week number</doc>
@@ -6015,7 +6016,7 @@ filenames, the returned name is in UTF-8.</doc>
           <doc xml:space="preserve">The entry's name or %NULL if there are no
   more entries. The return value is owned by GLib and
   must not be modified or freed.</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </return-value>
         <parameters>
           <instance-parameter name="dir" transfer-ownership="none">
@@ -8916,7 +8917,7 @@ access the channel after it is closed).</doc>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
             <doc xml:space="preserve">A string containing the name of a file</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <type name="filename" c:type="gchar*"/>
           </parameter>
           <parameter name="mode" transfer-ownership="none">
             <doc xml:space="preserve">One of "r", "w", "a", "r+", "w+", "a+". These have
@@ -11077,6 +11078,31 @@ or not a key exists.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="load_from_bytes"
+              c:identifier="g_key_file_load_from_bytes"
+              version="2.50"
+              throws="1">
+        <doc xml:space="preserve">Loads a key file from the data in @bytes into an empty #GKeyFile structure.
+If the object cannot be created then %error is set to a #GKeyFileError.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if a key file could be loaded, %FALSE otherwise</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="key_file" transfer-ownership="none">
+            <doc xml:space="preserve">an empty #GKeyFile struct</doc>
+            <type name="KeyFile" c:type="GKeyFile*"/>
+          </instance-parameter>
+          <parameter name="bytes" transfer-ownership="none">
+            <doc xml:space="preserve">a #GBytes</doc>
+            <type name="Bytes" c:type="GBytes*"/>
+          </parameter>
+          <parameter name="flags" transfer-ownership="none">
+            <doc xml:space="preserve">flags from #GKeyFileFlags</doc>
+            <type name="KeyFileFlags" c:type="GKeyFileFlags"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="load_from_data"
               c:identifier="g_key_file_load_from_data"
               version="2.6"
@@ -11930,7 +11956,10 @@ AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\"
       <type name="gchar" c:type="gchar"/>
     </constant>
     <constant name="LOG_FATAL_MASK" value="0" c:type="G_LOG_FATAL_MASK">
-      <doc xml:space="preserve">GLib log levels that are considered fatal by default.</doc>
+      <doc xml:space="preserve">GLib log levels that are considered fatal by default.
+This is not used if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="LOG_LEVEL_USER_SHIFT"
@@ -12833,6 +12862,27 @@ a user data argument.</doc>
         </parameters>
       </function>
     </record>
+    <record name="LogField" c:type="GLogField" version="2.50">
+      <doc xml:space="preserve">Structure representing a single field in a structured log entry. See
+g_log_structured() for details.
+Log fields may contain arbitrary values, including binary with embedded nul
+bytes. If the field contains a string, the string must be UTF-8 encoded and
+have a trailing nul byte. Otherwise, @length must be set to a non-negative
+value.</doc>
+      <field name="key" writable="1">
+        <doc xml:space="preserve">field name (UTF-8 string)</doc>
+        <type name="utf8" c:type="const gchar*"/>
+      </field>
+      <field name="value" writable="1">
+        <doc xml:space="preserve">field value (arbitrary bytes)</doc>
+        <type name="gpointer" c:type="gconstpointer"/>
+      </field>
+      <field name="length" writable="1">
+        <doc xml:space="preserve">length of @value, in bytes, or -1 if it is nul-terminated</doc>
+        <type name="gssize" c:type="gssize"/>
+      </field>
+    </record>
     <callback name="LogFunc" c:type="GLogFunc">
       <doc xml:space="preserve">Specifies the prototype of log handler functions.
@@ -12840,7 +12890,10 @@ The default log handler, g_log_default_handler(), automatically appends a
 new-line character to @message when printing it. It is advised that any
 custom log handler functions behave similarly, so that logging calls in user
 code do not need modifying to add a new-line character to the message if the
-log handler is changed.</doc>
+log handler is changed.
+This is not used if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -12913,6 +12966,64 @@ levels using g_log_set_handler() and g_log_set_fatal_mask().</doc>
         <doc xml:space="preserve">a mask including all log levels</doc>
       </member>
     </bitfield>
+    <callback name="LogWriterFunc" c:type="GLogWriterFunc" version="2.50">
+      <doc xml:space="preserve">Writer function for log entries. A log entry is a collection of one or more
+#GLogFields, using the standard [field names from journal
+specification](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html).
+See g_log_structured() for more information.
+Writer functions must ignore fields which they do not recognise, unless they
+can write arbitrary binary output, as field values may be arbitrary binary.
+@log_level is guaranteed to be included in @fields as the `PRIORITY` field,
+but is provided separately for convenience of deciding whether or where to
+output the log entry.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%G_LOG_WRITER_HANDLED if the log entry was handled successfully;
+   %G_LOG_WRITER_UNHANDLED otherwise</doc>
+        <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level of the message</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">fields forming the message</doc>
+          <array length="2" zero-terminated="0" c:type="GLogField*">
+            <type name="LogField" c:type="GLogField"/>
+          </array>
+        </parameter>
+        <parameter name="n_fields" transfer-ownership="none">
+          <doc xml:space="preserve">number of @fields</doc>
+          <type name="gsize" c:type="gsize"/>
+        </parameter>
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="3">
+          <doc xml:space="preserve">user data passed to g_log_set_writer_func()</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+      </parameters>
+    </callback>
+    <enumeration name="LogWriterOutput"
+                 version="2.50"
+                 c:type="GLogWriterOutput">
+      <doc xml:space="preserve">Return values from #GLogWriterFuncs to indicate whether the given log entry
+was successfully handled by the writer, or whether there was an error in
+handling it (and hence a fallback writer should be used).
+If a #GLogWriterFunc ignores a log entry, it should return
+%G_LOG_WRITER_HANDLED.</doc>
+      <member name="handled" value="1" c:identifier="G_LOG_WRITER_HANDLED">
+        <doc xml:space="preserve">Log writer has handled the log entry.</doc>
+      </member>
+      <member name="unhandled" value="0" c:identifier="G_LOG_WRITER_UNHANDLED">
+        <doc xml:space="preserve">Log writer could not handle the log entry.</doc>
+      </member>
+    </enumeration>
     <constant name="MAJOR_VERSION" value="2" c:type="GLIB_MAJOR_VERSION">
       <doc xml:space="preserve">The major version number of the GLib library.
@@ -12964,7 +13075,7 @@ linked against at application run time.</doc>
       <doc xml:space="preserve">The maximum value which can be held in a #guint8.</doc>
       <type name="guint8" c:type="guint8"/>
     </constant>
-    <constant name="MICRO_VERSION" value="1" c:type="GLIB_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="2" c:type="GLIB_MICRO_VERSION">
       <doc xml:space="preserve">The micro version number of the GLib library.
 Like #gtk_micro_version, but from the headers used at
@@ -12991,7 +13102,7 @@ linked against at application run time.</doc>
       <doc xml:space="preserve">The minimum value which can be held in a #gint8.</doc>
       <type name="gint8" c:type="gint8"/>
     </constant>
-    <constant name="MINOR_VERSION" value="48" c:type="GLIB_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="50" c:type="GLIB_MINOR_VERSION">
       <doc xml:space="preserve">The minor version number of the GLib library.
 Like #gtk_minor_version, but from the headers used at
@@ -13436,9 +13547,20 @@ the context used by functions like g_idle_add().
 Normally you would call this function shortly after creating a new
 thread, passing it a #GMainContext which will be run by a
 #GMainLoop in that thread, to set a new default context for all
-async operations in that thread. (In this case, you don't need to
-ever call g_main_context_pop_thread_default().) In some cases
-however, you may want to schedule a single operation in a
+async operations in that thread. In this case you may not need to
+ever call g_main_context_pop_thread_default(), assuming you want the
+new #GMainContext to be the default for the whole lifecycle of the
+thread.
+If you don't have control over how the new thread was created (e.g.
+in the new thread isn't newly created, or if the thread life
+cycle is managed by a #GThreadPool), it is always suggested to wrap
+the logic that needs to use the new #GMainContext inside a
+g_main_context_push_thread_default() / g_main_context_pop_thread_default()
+pair, otherwise threads that are re-used will end up never explicitly
+releasing the #GMainContext reference they hold.
+In some cases you may want to schedule a single operation in a
 non-default context, or temporarily use a non-default context in
 the main thread. In that case, you can wrap the call to the
 asynchronous operation inside a
@@ -13847,8 +13969,9 @@ to the #GFileError value #G_FILE_ERROR_INVAL.</doc>
         </return-value>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
-            <doc xml:space="preserve">The path of the file to load, in the GLib filename encoding</doc>
-            <type name="utf8" c:type="const gchar*"/>
+            <doc xml:space="preserve">The path of the file to load, in the GLib
+    filename encoding</doc>
+            <type name="filename" c:type="gchar*"/>
           </parameter>
           <parameter name="writable" transfer-ownership="none">
             <doc xml:space="preserve">whether the mapping should be writable</doc>
@@ -17139,6 +17262,11 @@ and all memory allocated by the @group is released.</doc>
       <doc xml:space="preserve">The value of pi (ratio of circle's circumference to its diameter).</doc>
       <type name="gdouble" c:type="gdouble"/>
     </constant>
+    <constant name="PID_FORMAT" value="p" c:type="G_PID_FORMAT" version="2.50">
+      <doc xml:space="preserve">A format specifier that can be used in printf()-style format strings
+when printing a #GPid.</doc>
+      <type name="utf8" c:type="gchar*"/>
+    </constant>
     <constant name="PI_2" value="1.570796" c:type="G_PI_2">
       <doc xml:space="preserve">Pi divided by 2.</doc>
       <type name="gdouble" c:type="gdouble"/>
@@ -19320,7 +19448,7 @@ preceded by a letter.
 Note that, unless you set the #G_REGEX_RAW flag, all the strings passed
 to these functions must be encoded in UTF-8. The lengths and the positions
 inside the strings are in bytes and not in characters, so, for instance,
-"\xc3\xa0" (i.e. "&amp;agrave;") is two bytes long but it is treated as a
+"\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a
 single character. If you set #G_REGEX_RAW the strings can be non-valid
 UTF-8 strings and a byte is treated as a character, so "\xc3\xa0" is two
 bytes and two characters long.
@@ -19409,7 +19537,11 @@ the initial setup of the #GRegex structure.</doc>
       <method name="get_compile_flags"
               c:identifier="g_regex_get_compile_flags"
               version="2.26">
-        <doc xml:space="preserve">Returns the compile options that @regex was created with.</doc>
+        <doc xml:space="preserve">Returns the compile options that @regex was created with.
+Depending on the version of PCRE that is used, this may or may not
+include flags set by option expressions such as `(?i)` found at the
+top-level within the compiled pattern.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">flags from #GRegexCompileFlags</doc>
           <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
@@ -28007,6 +28139,21 @@ See &lt;ulink url="http://www.unicode.org/unicode/reports/tr14/"&gt;http://www.u
               c:identifier="G_UNICODE_BREAK_REGIONAL_INDICATOR">
         <doc xml:space="preserve">Regional Indicator (RI). Since: 2.36</doc>
       </member>
+      <member name="emoji_base"
+              value="40"
+              c:identifier="G_UNICODE_BREAK_EMOJI_BASE">
+        <doc xml:space="preserve">Emoji Base (EB). Since: 2.50</doc>
+      </member>
+      <member name="emoji_modifier"
+              value="41"
+              c:identifier="G_UNICODE_BREAK_EMOJI_MODIFIER">
+        <doc xml:space="preserve">Emoji Modifier (EM). Since: 2.50</doc>
+      </member>
+      <member name="zero_width_joiner"
+              value="42"
+              c:identifier="G_UNICODE_BREAK_ZERO_WIDTH_JOINER">
+        <doc xml:space="preserve">Zero Width Joiner (ZWJ). Since: 2.50</doc>
+      </member>
     </enumeration>
     <enumeration name="UnicodeScript" c:type="GUnicodeScript">
       <doc xml:space="preserve">The #GUnicodeScript enumeration identifies different writing
@@ -28593,11 +28740,33 @@ url="http://www.unicode.org/reports/tr24/"&gt;Unicode Standard Annex
               c:identifier="G_UNICODE_SCRIPT_SIGNWRITING">
         <doc xml:space="preserve">Signwriting. Since: 2.48</doc>
       </member>
+      <member name="adlam" value="132" c:identifier="G_UNICODE_SCRIPT_ADLAM">
+        <doc xml:space="preserve">Adlam. Since: 2.50</doc>
+      </member>
+      <member name="bhaiksuki"
+              value="133"
+              c:identifier="G_UNICODE_SCRIPT_BHAIKSUKI">
+        <doc xml:space="preserve">Bhaiksuki. Since: 2.50</doc>
+      </member>
+      <member name="marchen"
+              value="134"
+              c:identifier="G_UNICODE_SCRIPT_MARCHEN">
+        <doc xml:space="preserve">Marchen. Since: 2.50</doc>
+      </member>
+      <member name="newa" value="135" c:identifier="G_UNICODE_SCRIPT_NEWA">
+        <doc xml:space="preserve">Newa. Since: 2.50</doc>
+      </member>
+      <member name="osage" value="136" c:identifier="G_UNICODE_SCRIPT_OSAGE">
+        <doc xml:space="preserve">Osage. Since: 2.50</doc>
+      </member>
+      <member name="tangut" value="137" c:identifier="G_UNICODE_SCRIPT_TANGUT">
+        <doc xml:space="preserve">Tangut. Since: 2.50</doc>
+      </member>
     </enumeration>
     <enumeration name="UnicodeType" c:type="GUnicodeType">
       <doc xml:space="preserve">These are the possible character classifications from the
 Unicode specification.
-See &lt;ulink url="http://www.unicode.org/Public/UNIDATA/UnicodeData.html"&gt;http://www.unicode.org/Public/UNIDATA/UnicodeData.html&lt;/ulink&gt;.</doc>
+See &lt;ulink url="http://www.unicode.org/reports/tr44/#General_Category_Values"&gt;Unicode Character Database&lt;/unlink&gt;.</doc>
       <member name="control" value="0" c:identifier="G_UNICODE_CONTROL">
         <doc xml:space="preserve">General category "Other, Control" (Cc)</doc>
       </member>
@@ -28819,10 +28988,36 @@ using functions deprecated in later releases will not).</doc>
             glib:type-name="GVariant"
             glib:get-type="intern"
             c:symbol-prefix="variant">
-      <doc xml:space="preserve">#GVariant is a variant datatype; it stores a value along with
-information about the type of that value.  The range of possible
-values is determined by the type.  The type system used by #GVariant
-is #GVariantType.
+      <doc xml:space="preserve">#GVariant is a variant datatype; it can contain one or more values
+along with information about the type of the values.
+A #GVariant may contain simple types, like an integer, or a boolean value;
+or complex types, like an array of two strings, or a dictionary of key
+value pairs. A #GVariant is also immutable: once it's been created neither
+its type nor its content can be modified further.
+GVariant is useful whenever data needs to be serialized, for example when
+sending method parameters in DBus, or when saving settings using GSettings.
+When creating a new #GVariant, you pass the data you want to store in it
+along with a string representing the type of data you wish to pass to it.
+For instance, if you want to create a #GVariant holding an integer value you
+can use:
+|[&lt;!-- language="C" --&gt;
+  GVariant *v = g_variant_new ('u', 40);
+]|
+The string 'u' in the first argument tells #GVariant that the data passed to
+the constructor (40) is going to be an unsigned integer.
+More advanced examples of #GVariant in use can be found in documentation for
+[GVariant format strings][gvariant-format-strings-pointers].
+The range of possible values is determined by the type.
+The type system used by #GVariant is #GVariantType.
 #GVariant instances always have a type and a value (which are given
 at construction time).  The type and value of a #GVariant instance
@@ -30248,6 +30443,9 @@ If the array contains a nul terminator character somewhere other than
 the last byte then the returned string is the string, up to the first
 such nul character.
+g_variant_get_fixed_array() should be used instead if the array contains
+arbitrary data that could not be nul-terminated or could contain nul bytes.
 It is an error to call this function with a @value that is not an
 array of bytes.
@@ -31503,11 +31701,26 @@ following functions.
 #GVariantBuilder is not threadsafe in any way.  Do not attempt to
 access it from more than one thread.</doc>
-      <field name="x" readable="0" private="1">
-        <array zero-terminated="0" c:type="gsize" fixed-size="16">
-          <type name="gsize" c:type="gsize"/>
-        </array>
-      </field>
+      <union name="u" c:type="u">
+        <record name="s" c:type="s">
+          <field name="partial_magic" writable="1">
+            <type name="gsize" c:type="gsize"/>
+          </field>
+          <field name="type" writable="1">
+            <type name="VariantType" c:type="const GVariantType*"/>
+          </field>
+          <field name="y" writable="1">
+            <array zero-terminated="0" c:type="gsize" fixed-size="14">
+              <type name="gsize" c:type="gsize"/>
+            </array>
+          </field>
+        </record>
+        <field name="x" writable="1">
+          <array zero-terminated="0" c:type="gsize" fixed-size="16">
+            <type name="gsize" c:type="gsize"/>
+          </array>
+        </field>
+      </union>
       <constructor name="new"
                    c:identifier="g_variant_builder_new"
                    version="2.24">
@@ -31711,7 +31924,10 @@ subcontainer).</doc>
 It is not permissible to use @builder in any way after this call
 except for reference counting operations (in the case of a
 heap-allocated #GVariantBuilder) or by reinitialising it with
-g_variant_builder_init() (in the case of stack-allocated).
+g_variant_builder_init() (in the case of stack-allocated). This
+means that for the stack-allocated builders there is no need to
+call g_variant_builder_clear() after the call to
+g_variant_builder_end().
 It is an error to call this function in any way that would create an
 inconsistent value to be constructed (ie: insufficient number of
@@ -31998,11 +32214,26 @@ key is not found.  Each returns the new dictionary as a floating
     return result;
   }
 ]|</doc>
-      <field name="x" readable="0" private="1">
-        <array zero-terminated="0" c:type="gsize" fixed-size="16">
-          <type name="gsize" c:type="gsize"/>
-        </array>
-      </field>
+      <union name="u" c:type="u">
+        <record name="s" c:type="s">
+          <field name="asv" writable="1">
+            <type name="Variant" c:type="GVariant*"/>
+          </field>
+          <field name="partial_magic" writable="1">
+            <type name="gsize" c:type="gsize"/>
+          </field>
+          <field name="y" writable="1">
+            <array zero-terminated="0" c:type="gsize" fixed-size="14">
+              <type name="gsize" c:type="gsize"/>
+            </array>
+          </field>
+        </record>
+        <field name="x" writable="1">
+          <array zero-terminated="0" c:type="gsize" fixed-size="16">
+            <type name="gsize" c:type="gsize"/>
+          </array>
+        </field>
+      </union>
       <constructor name="new" c:identifier="g_variant_dict_new" version="2.40">
         <doc xml:space="preserve">Allocates and initialises a new #GVariantDict.
@@ -33499,6 +33730,18 @@ function passed to g_atexit().</doc>
  Windows Server 2008 R2.</doc>
       </member>
     </enumeration>
+    <function name="abort" c:identifier="g_abort" version="2.50">
+      <doc xml:space="preserve">A wrapper for the POSIX abort() function.
+On Windows it is a function that makes extra effort (including a call
+to abort()) to ensure that a debugger-catchable exception is thrown
+before the program terminates.
+See your C library manual for more details about abort().</doc>
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+    </function>
     <function name="access" c:identifier="g_access" version="2.8">
       <doc xml:space="preserve">A wrapper for the POSIX access() function. This function is used to
 test a pathname for one or several of read, write or execute
@@ -33520,8 +33763,9 @@ See your C library manual for more details about access().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">as in access()</doc>
@@ -34794,12 +35038,12 @@ string.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the name of the file without any leading
     directory components</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="file_name" transfer-ownership="none">
           <doc xml:space="preserve">the name of the file</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -34964,13 +35208,14 @@ No attempt is made to force the resulting filename to be an absolute
 path. If the first element is a relative path, the result will
 be a relative path.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a newly-allocated string that must be freed with g_free().</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <doc xml:space="preserve">a newly-allocated string that must be freed with
+    g_free().</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="first_element" transfer-ownership="none">
           <doc xml:space="preserve">the first element in the path</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="..." transfer-ownership="none">
           <doc xml:space="preserve">remaining elements in path, terminated by %NULL</doc>
@@ -34985,14 +35230,16 @@ be a relative path.</doc>
 as a string array, instead of varargs. This function is mainly
 meant for language bindings.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a newly-allocated string that must be freed with g_free().</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <doc xml:space="preserve">a newly-allocated string that must be freed
+    with g_free().</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="args" transfer-ownership="none">
-          <doc xml:space="preserve">%NULL-terminated array of strings containing the path elements.</doc>
+          <doc xml:space="preserve">%NULL-terminated
+    array of strings containing the path elements.</doc>
           <array c:type="gchar**">
-            <type name="utf8" c:type="gchar*"/>
+            <type name="filename"/>
           </array>
         </parameter>
       </parameters>
@@ -35025,17 +35272,18 @@ Other than for determination of the number of leading and trailing
 copies of the separator, elements consisting only of copies
 of the separator are ignored.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a newly-allocated string that must be freed with g_free().</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <doc xml:space="preserve">a newly-allocated string that must be freed with
+    g_free().</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="separator" transfer-ownership="none">
           <doc xml:space="preserve">a string used to separator the elements of the path.</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="first_element" transfer-ownership="none">
           <doc xml:space="preserve">the first element in the path</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="..." transfer-ownership="none">
           <doc xml:space="preserve">remaining elements in path, terminated by %NULL</doc>
@@ -35048,8 +35296,9 @@ of the separator are ignored.</doc>
 as a string array, instead of varargs. This function is mainly
 meant for language bindings.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a newly-allocated string that must be freed with g_free().</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <doc xml:space="preserve">a newly-allocated string that must be freed
+    with g_free().</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="separator" transfer-ownership="none">
@@ -35057,9 +35306,10 @@ meant for language bindings.</doc>
           <type name="utf8" c:type="const gchar*"/>
         </parameter>
         <parameter name="args" transfer-ownership="none">
-          <doc xml:space="preserve">%NULL-terminated array of strings containing the path elements.</doc>
+          <doc xml:space="preserve">%NULL-terminated
+    array of strings containing the path elements.</doc>
           <array c:type="gchar**">
-            <type name="utf8" c:type="gchar*"/>
+            <type name="filename"/>
           </array>
         </parameter>
       </parameters>
@@ -35182,8 +35432,9 @@ See your C library manual for more details about chdir().</doc>
       </return-value>
       <parameters>
         <parameter name="path" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -35410,8 +35661,9 @@ See your C library manual for more details about chmod().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">as in chmod()</doc>
@@ -35554,6 +35806,34 @@ The hexadecimal string returned will be in lower case.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="compute_hmac_for_bytes"
+              c:identifier="g_compute_hmac_for_bytes"
+              version="2.50">
+      <doc xml:space="preserve">Computes the HMAC for a binary @data. This is a
+convenience wrapper for g_hmac_new(), g_hmac_get_string()
+and g_hmac_unref().
+The hexadecimal string returned will be in lower case.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">the HMAC of the binary data as a string in hexadecimal.
+  The returned string should be freed with g_free() when done using it.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </return-value>
+      <parameters>
+        <parameter name="digest_type" transfer-ownership="none">
+          <doc xml:space="preserve">a #GChecksumType to use for the HMAC</doc>
+          <type name="ChecksumType" c:type="GChecksumType"/>
+        </parameter>
+        <parameter name="key" transfer-ownership="none">
+          <doc xml:space="preserve">the key to use in the HMAC</doc>
+          <type name="Bytes" c:type="GBytes*"/>
+        </parameter>
+        <parameter name="data" transfer-ownership="none">
+          <doc xml:space="preserve">binary blob to compute the HMAC of</doc>
+          <type name="Bytes" c:type="GBytes*"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="compute_hmac_for_data"
               c:identifier="g_compute_hmac_for_data"
               version="2.30">
@@ -35584,7 +35864,9 @@ The hexadecimal string returned will be in lower case.</doc>
         </parameter>
         <parameter name="data" transfer-ownership="none">
           <doc xml:space="preserve">binary blob to compute the HMAC of</doc>
-          <type name="guint8" c:type="const guchar*"/>
+          <array length="4" zero-terminated="0" c:type="guchar*">
+            <type name="guint8" c:type="guchar"/>
+          </array>
         </parameter>
         <parameter name="length" transfer-ownership="none">
           <doc xml:space="preserve">length of @data</doc>
@@ -35850,8 +36132,9 @@ See your C library manual for more details about creat().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">as in creat()</doc>
@@ -37142,14 +37425,14 @@ name encoding.</doc>
 readlink() function.  The returned string is in the encoding used
 for filenames. Use g_filename_to_utf8() to convert it to UTF-8.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">A newly-allocated string with the contents of the symbolic link,
-         or %NULL if an error occurred.</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <doc xml:space="preserve">A newly-allocated string with the contents of
+    the symbolic link, or %NULL if an error occurred.</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
           <doc xml:space="preserve">the symbolic link</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -37252,8 +37535,9 @@ extensions and those listed in the `PATHEXT` environment variable.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a filename to test in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a filename to test in the
+    GLib file name encoding</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="test" transfer-ownership="none">
           <doc xml:space="preserve">bitfield of #GFileTest flags</doc>
@@ -37300,8 +37584,9 @@ whole path, as it allows translation.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">an absolute pathname in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">an absolute pathname in the
+    GLib file name encoding</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -37330,8 +37615,9 @@ translation of filenames.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname hopefully in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname hopefully in the
+    GLib file name encoding</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -37463,10 +37749,10 @@ component following Section 3.3. of RFC 2396.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">an absolute filename specified in the GLib file name encoding,
-           which is the on-disk file name bytes on Unix, and UTF-8 on
-           Windows</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">an absolute filename specified in the GLib file
+    name encoding, which is the on-disk file name bytes on Unix, and UTF-8
+    on Windows</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="hostname"
                    transfer-ownership="none"
@@ -37506,7 +37792,7 @@ the [current locale][setlocale].</doc>
       <parameters>
         <parameter name="opsysstring" transfer-ownership="none">
           <doc xml:space="preserve">a string in the encoding for filenames</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="len" transfer-ownership="none">
           <doc xml:space="preserve">the length of the string, or -1 if the string is
@@ -37584,13 +37870,14 @@ finally in the directories in the `PATH` environment variable. If
 the program is found, the return value contains the full name
 including the type suffix.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a newly-allocated string with the absolute path, or %NULL</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <doc xml:space="preserve">a newly-allocated string with the absolute path,
+    or %NULL</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="program" transfer-ownership="none">
           <doc xml:space="preserve">a program name in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -37613,8 +37900,9 @@ See your C library manual for more details about fopen().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">a string describing the mode in which the file should be opened</doc>
@@ -37753,8 +38041,9 @@ See your C library manual for more details about freopen().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">a string describing the mode in which the file should be  opened</doc>
@@ -37839,7 +38128,7 @@ the current directory.  This can make a difference in the case that
 the current directory is the target of a symbolic link.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">the current directory</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_current_dir_utf8"
@@ -37895,7 +38184,7 @@ On Windows, the character set used in the GLib API is always UTF-8
 and said environment variables have no effect.
 `G_FILENAME_ENCODING` may be set to a comma-separated list of
-character set names. The special token "&amp;commat;locale" is taken
+character set names. The special token "\@locale" is taken
 to  mean the character set for the [current locale][setlocale].
 If `G_FILENAME_ENCODING` is not set, but `G_BROKEN_FILENAMES` is,
 the character set of the current locale is taken as the filename
@@ -37942,7 +38231,7 @@ should either directly check the `HOME` environment variable yourself
 or unset it before calling any functions in GLib.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the current user's home directory</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_host_name"
@@ -38066,7 +38355,7 @@ real user name cannot be determined, the string "Unknown" is
 returned.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the user's real name.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_real_time"
@@ -38104,10 +38393,11 @@ For example, an application can store a spell-check dictionary, a database
 of clip art, or a log file in the CSIDL_COMMON_APPDATA folder.
 This information will not roam and is available to anyone using the computer.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">a %NULL-terminated array of strings owned by GLib that must
-              not be modified or freed.</doc>
+        <doc xml:space="preserve">
+    a %NULL-terminated array of strings owned by GLib that must not be
+    modified or freed.</doc>
         <array c:type="gchar**">
-          <type name="utf8"/>
+          <type name="filename"/>
         </array>
       </return-value>
     </function>
@@ -38144,10 +38434,11 @@ itself.
 Note that on Windows the returned list can vary depending on where
 this function is called.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">a %NULL-terminated array of strings owned by GLib that must
-              not be modified or freed.</doc>
+        <doc xml:space="preserve">
+    a %NULL-terminated array of strings owned by GLib that must not be
+    modified or freed.</doc>
         <array c:type="gchar**">
-          <type name="utf8"/>
+          <type name="filename"/>
         </array>
       </return-value>
     </function>
@@ -38168,7 +38459,7 @@ it is always UTF-8. The return value is never %NULL or the empty
 string.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the directory to use for temporary files.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_user_cache_dir"
@@ -38189,7 +38480,7 @@ See documentation for CSIDL_INTERNET_CACHE.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">a string owned by GLib that must not be modified
               or freed.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_user_config_dir"
@@ -38210,7 +38501,7 @@ what g_get_user_data_dir() returns.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">a string owned by GLib that must not be modified
               or freed.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_user_data_dir"
@@ -38231,7 +38522,7 @@ what g_get_user_config_dir() returns.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">a string owned by GLib that must not be modified
               or freed.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_user_name" c:identifier="g_get_user_name">
@@ -38241,7 +38532,7 @@ encoding, or something else, and there is no guarantee that it is even
 consistent on a machine. On Windows, it is always UTF-8.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the user name of the current user.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_user_runtime_dir"
@@ -38263,8 +38554,9 @@ roaming) application data. See documentation for
 CSIDL_LOCAL_APPDATA.  Note that on Windows it thus is the same as
 what g_get_user_config_dir() returns.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">a string owned by GLib that must not be modified or freed.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <doc xml:space="preserve">a string owned by GLib that must not be
+    modified or freed.</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
     </function>
     <function name="get_user_special_dir"
@@ -38281,10 +38573,10 @@ Depending on the platform, the user might be able to change the path
 of the special directory without requiring the session to restart; GLib
 will not reflect any change once the special directories are loaded.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the path to the specified special directory, or %NULL
-  if the logical id was not found. The returned string is owned by
+        <doc xml:space="preserve">the path to the specified special directory, or
+  %NULL if the logical id was not found. The returned string is owned by
   GLib and should not be modified or freed.</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="directory" transfer-ownership="none">
@@ -39471,7 +39763,10 @@ function is called to terminate the program.
 If g_log_default_handler() is used as the log handler function, a new-line
 character will automatically be appended to @..., and need not be entered
-manually.</doc>
+manually.
+If [structured logging is enabled][using-structured-logging] this will
+output via the structured log writer function (see g_log_set_writer_func()).</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -39521,7 +39816,10 @@ environment variables:
 stderr is used for levels %G_LOG_LEVEL_ERROR, %G_LOG_LEVEL_CRITICAL,
 %G_LOG_LEVEL_WARNING and %G_LOG_LEVEL_MESSAGE. stdout is used for
-the rest.</doc>
+the rest.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -39555,7 +39853,10 @@ default "" application domain</doc>
       </parameters>
     </function>
     <function name="log_remove_handler" c:identifier="g_log_remove_handler">
-      <doc xml:space="preserve">Removes the log handler.</doc>
+      <doc xml:space="preserve">Removes the log handler.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -39580,7 +39881,15 @@ You can only set the levels defined by GLib to be fatal.
 You can also make some message levels fatal at runtime by setting
 the `G_DEBUG` environment variable (see
-[Running GLib Applications](glib-running.html)).</doc>
+[Running GLib Applications](glib-running.html)).
+Libraries should not call this function, as it affects all messages logged
+by a process, including those from other libraries.
+Structured log messages (using g_log_structured() and
+g_log_structured_array()) are fatal only if the default log writer is used;
+otherwise it is up to the writer function to determine which log messages
+are fatal. See [Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the old fatal mask</doc>
         <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
@@ -39600,7 +39909,10 @@ the `G_DEBUG` environment variable (see
       <doc xml:space="preserve">Installs a default log handler which is used if no
 log handler has been set for the particular log domain
 and log level combination. By default, GLib uses
-g_log_default_handler() as default log handler.</doc>
+g_log_default_handler() as default log handler.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value>
         <doc xml:space="preserve">the previous default log handler</doc>
         <type name="LogFunc" c:type="GLogFunc"/>
@@ -39621,7 +39933,13 @@ g_log_default_handler() as default log handler.</doc>
     </function>
     <function name="log_set_fatal_mask" c:identifier="g_log_set_fatal_mask">
       <doc xml:space="preserve">Sets the log levels which are fatal in the given domain.
-%G_LOG_LEVEL_ERROR is always fatal.</doc>
+%G_LOG_LEVEL_ERROR is always fatal.
+This has no effect on structured log messages (using g_log_structured() or
+g_log_structured_array()). To change the fatal behaviour for specific log
+messages, programs must install a custom log writer function using
+g_log_set_writer_func(). See
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the old fatal mask for the log domain</doc>
         <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
@@ -39650,6 +39968,9 @@ Note that since the #G_LOG_LEVEL_ERROR log level is always fatal, if
 you want to set a handler for this log level you must combine it with
 #G_LOG_FLAG_FATAL.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].
 Here is an example for adding a log handler for all warning messages
 in the default domain:
 |[&lt;!-- language="C" --&gt;
@@ -39705,7 +40026,10 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
               c:identifier="g_log_set_handler_full"
               shadows="log_set_handler"
               version="2.46">
-      <doc xml:space="preserve">Like g_log_sets_handler(), but takes a destroy notify for the @user_data.</doc>
+      <doc xml:space="preserve">Like g_log_sets_handler(), but takes a destroy notify for the @user_data.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the id of the new handler</doc>
         <type name="guint" c:type="guint"/>
@@ -39747,6 +40071,432 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
         </parameter>
       </parameters>
     </function>
+    <function name="log_set_writer_func"
+              c:identifier="g_log_set_writer_func"
+              version="2.50">
+      <doc xml:space="preserve">Set a writer function which will be called to format and write out each log
+message. Each program should set a writer function, or the default writer
+(g_log_writer_default()) will be used.
+Libraries **must not** call this function — only programs are allowed to
+install a writer function, as there must be a single, central point where
+log messages are formatted and outputted.
+There can only be one writer function. It is an error to set more than one.</doc>
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+      <parameters>
+        <parameter name="func"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   scope="notified"
+                   closure="1"
+                   destroy="2">
+          <doc xml:space="preserve">log writer function, which must not be %NULL</doc>
+          <type name="LogWriterFunc" c:type="GLogWriterFunc"/>
+        </parameter>
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="0">
+          <doc xml:space="preserve">user data to pass to @func</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+        <parameter name="user_data_free"
+                   transfer-ownership="none"
+                   scope="async"
+                   destroy="0">
+          <doc xml:space="preserve">function to free @user_data once it’s
+   finished with, if non-%NULL</doc>
+          <type name="DestroyNotify" c:type="GDestroyNotify"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_structured"
+              c:identifier="g_log_structured"
+              version="2.50"
+              introspectable="0">
+      <doc xml:space="preserve">Log a message with structured data. The message will be passed through to
+the log writer set by the application using g_log_set_writer_func(). If the
+message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will
+be aborted at the end of this function.
+The structured data is provided as key–value pairs, where keys are UTF-8
+strings, and values are arbitrary pointers — typically pointing to UTF-8
+strings, but that is not a requirement. To pass binary (non-nul-terminated)
+structured data, use g_log_structured_array(). The keys for structured data
+should follow the [systemd journal
+fields](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html)
+specification. It is suggested that custom keys are namespaced according to
+the code which sets them. For example, custom keys from GLib all have a
+`GLIB_` prefix.
+The @log_domain will be converted into a `GLIB_DOMAIN` field. @log_level will
+be converted into a
+[`PRIORITY`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#PRIORITY=)
+field. The format string will have its placeholders substituted for the provided
+values and be converted into a
+[`MESSAGE`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#MESSAGE=)
+field.
+Other fields you may commonly want to pass into this function:
+ * [`MESSAGE_ID`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#MESSAGE_ID=)
+ * [`CODE_FILE`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#CODE_FILE=)
+ * [`CODE_LINE`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#CODE_LINE=)
+ * [`CODE_FUNC`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#CODE_FUNC=)
+ * [`ERRNO`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#ERRNO=)
+Note that `CODE_FILE`, `CODE_LINE` and `CODE_FUNC` are automatically set by
+the logging macros, G_DEBUG_HERE(), g_message(), g_warning(), g_critical(),
+g_error(), etc, if the symbols `G_LOG_USE_STRUCTURED` is defined before including
+glib.h.
+For example:
+|[&lt;!-- language="C" --&gt;
+g_log_structured (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,
+                  "MESSAGE_ID", "06d4df59e6c24647bfe69d2c27ef0b4e",
+                  "MY_APPLICATION_CUSTOM_FIELD", "some debug string",
+                  "MESSAGE", "This is a debug message about pointer %p and integer %u.",
+                  some_pointer, some_integer);
+]|
+Note that each `MESSAGE_ID` must be [uniquely and randomly
+generated](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#MESSAGE_ID=).
+If adding a `MESSAGE_ID`, consider shipping a [message
+catalog](https://www.freedesktop.org/wiki/Software/systemd/catalog/) with
+your software.
+To pass a user data pointer to the log writer function which is specific to
+this logging call, you must use g_log_structured_array() and pass the pointer
+as a field with #GLogField.length set to zero, otherwise it will be
+interpreted as a string.
+For example:
+|[&lt;!-- language="C" --&gt;
+const GLogField fields[] = {
+  { "MESSAGE", "This is a debug message.", -1 },
+  { "MESSAGE_ID", "fcfb2e1e65c3494386b74878f1abf893", -1 },
+  { "MY_APPLICATION_CUSTOM_FIELD", "some debug string", -1 },
+  { "MY_APPLICATION_STATE", state_object, 0 },
+};
+g_log_structured_array (G_LOG_LEVEL_DEBUG, fields, G_N_ELEMENTS (fields));
+]|
+Note also that, even if no other structured fields are specified, there
+must always be a "MESSAGE" key before the format string. The "MESSAGE"-format
+pair has to be the last of the key-value pairs, and "MESSAGE" is the only
+field for which printf()-style formatting is supported.
+The default writer function for `stdout` and `stderr` will automatically
+append a new-line character after the message, so you should not add one
+manually to the format string.</doc>
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_domain" transfer-ownership="none">
+          <doc xml:space="preserve">log domain, usually %G_LOG_DOMAIN</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="..." transfer-ownership="none">
+          <doc xml:space="preserve">key-value pairs of structured data to add to the log entry, followed
+   by the key "MESSAGE", followed by a printf()-style message format,
+   followed by parameters to insert in the format string</doc>
+          <varargs/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_structured_array"
+              c:identifier="g_log_structured_array"
+              version="2.50">
+      <doc xml:space="preserve">Log a message with structured data. The message will be passed through to the
+log writer set by the application using g_log_set_writer_func(). If the
+message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will
+be aborted at the end of this function.
+See g_log_structured() for more documentation.
+This assumes that @log_level is already present in @fields (typically as the
+`PRIORITY` field).</doc>
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">key–value pairs of structured data to add
+   to the log message</doc>
+          <array length="2" zero-terminated="0" c:type="GLogField*">
+            <type name="LogField" c:type="GLogField"/>
+          </array>
+        </parameter>
+        <parameter name="n_fields" transfer-ownership="none">
+          <doc xml:space="preserve">number of elements in the @fields array</doc>
+          <type name="gsize" c:type="gsize"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_variant" c:identifier="g_log_variant" version="2.50">
+      <doc xml:space="preserve">Log a message with structured data, accepting the data within a #GVariant. This
+version is especially useful for use in other languages, via introspection.
+The only mandatory item in the @fields dictionary is the "MESSAGE" which must
+contain the text shown to the user.
+The values in the @fields dictionary are likely to be of type String
+(#G_VARIANT_TYPE_STRING). Array of bytes (#G_VARIANT_TYPE_BYTESTRING) is also
+supported. In this case the message is handled as binary and will be forwarded
+to the log writer as such. The size of the array should not be higher than
+%G_MAXSSIZE. Otherwise it will be truncated to this size. For other types
+g_variant_print() will be used to convert the value into a string.
+For more details on its usage and about the parameters, see g_log_structured().</doc>
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_domain"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">log domain, usually %G_LOG_DOMAIN</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">a dictionary (#GVariant of the type %G_VARIANT_TYPE_VARDICT)
+containing the key-value pairs of message data.</doc>
+          <type name="Variant" c:type="GVariant*"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_writer_default"
+              c:identifier="g_log_writer_default"
+              version="2.50">
+      <doc xml:space="preserve">Format a structured log message and output it to the default log destination
+for the platform. On Linux, this is typically the systemd journal, falling
+back to `stdout` or `stderr` if running from the terminal or if output is
+being redirected to a file.
+Support for other platform-specific logging mechanisms may be added in
+future. Distributors of GLib may modify this function to impose their own
+(documented) platform-specific log writing policies.
+This is suitable for use as a #GLogWriterFunc, and is the default writer used
+if no other is set using g_log_set_writer_func().
+As with g_log_default_handler(), this function drops debug and informational
+messages unless their log domain (or `all`) is listed in the space-separated
+`G_MESSAGES_DEBUG` environment variable.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise</doc>
+        <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">key–value pairs of structured data forming
+   the log message</doc>
+          <array length="2" zero-terminated="0" c:type="GLogField*">
+            <type name="LogField" c:type="GLogField"/>
+          </array>
+        </parameter>
+        <parameter name="n_fields" transfer-ownership="none">
+          <doc xml:space="preserve">number of elements in the @fields array</doc>
+          <type name="gsize" c:type="gsize"/>
+        </parameter>
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">user data passed to g_log_set_writer_func()</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_writer_format_fields"
+              c:identifier="g_log_writer_format_fields"
+              version="2.50">
+      <doc xml:space="preserve">Format a structured log message as a string suitable for outputting to the
+terminal (or elsewhere). This will include the values of all fields it knows
+how to interpret, which includes `MESSAGE` and `GLIB_DOMAIN` (see the
+documentation for g_log_structured()). It does not include values from
+unknown fields.
+The returned string does **not** have a trailing new-line character. It is
+encoded in the character set of the current locale, which is not necessarily
+UTF-8.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">string containing the formatted log message, in
+   the character set of the current locale</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">key–value pairs of structured data forming
+   the log message</doc>
+          <array length="2" zero-terminated="0" c:type="GLogField*">
+            <type name="LogField" c:type="GLogField"/>
+          </array>
+        </parameter>
+        <parameter name="n_fields" transfer-ownership="none">
+          <doc xml:space="preserve">number of elements in the @fields array</doc>
+          <type name="gsize" c:type="gsize"/>
+        </parameter>
+        <parameter name="use_color" transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE to use ANSI color escape sequences when formatting the
+   message, %FALSE to not</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_writer_is_journald"
+              c:identifier="g_log_writer_is_journald"
+              version="2.50">
+      <doc xml:space="preserve">Check whether the given @output_fd file descriptor is a connection to the
+systemd journal, or something else (like a log file or `stdout` or
+`stderr`).</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if @output_fd points to the journal, %FALSE otherwise</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="output_fd" transfer-ownership="none">
+          <doc xml:space="preserve">output file descriptor to check</doc>
+          <type name="gint" c:type="gint"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_writer_journald"
+              c:identifier="g_log_writer_journald"
+              version="2.50">
+      <doc xml:space="preserve">Format a structured log message and send it to the systemd journal as a set
+of key–value pairs. All fields are sent to the journal, but if a field has
+length zero (indicating program-specific data) then only its key will be
+sent.
+This is suitable for use as a #GLogWriterFunc.
+If GLib has been compiled without systemd support, this function is still
+defined, but will always return %G_LOG_WRITER_UNHANDLED.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise</doc>
+        <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">key–value pairs of structured data forming
+   the log message</doc>
+          <array length="2" zero-terminated="0" c:type="GLogField*">
+            <type name="LogField" c:type="GLogField"/>
+          </array>
+        </parameter>
+        <parameter name="n_fields" transfer-ownership="none">
+          <doc xml:space="preserve">number of elements in the @fields array</doc>
+          <type name="gsize" c:type="gsize"/>
+        </parameter>
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">user data passed to g_log_set_writer_func()</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_writer_standard_streams"
+              c:identifier="g_log_writer_standard_streams"
+              version="2.50">
+      <doc xml:space="preserve">Format a structured log message and print it to either `stdout` or `stderr`,
+depending on its log level. %G_LOG_LEVEL_INFO and %G_LOG_LEVEL_DEBUG messages
+are sent to `stdout`; all other log levels are sent to `stderr`. Only fields
+which are understood by this function are included in the formatted string
+which is printed.
+If the output stream supports ANSI color escape sequences, they will be used
+in the output.
+A trailing new-line character is added to the log message when it is printed.
+This is suitable for use as a #GLogWriterFunc.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise</doc>
+        <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
+      </return-value>
+      <parameters>
+        <parameter name="log_level" transfer-ownership="none">
+          <doc xml:space="preserve">log level, either from #GLogLevelFlags, or a user-defined
+   level</doc>
+          <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
+        </parameter>
+        <parameter name="fields" transfer-ownership="none">
+          <doc xml:space="preserve">key–value pairs of structured data forming
+   the log message</doc>
+          <array length="2" zero-terminated="0" c:type="GLogField*">
+            <type name="LogField" c:type="GLogField"/>
+          </array>
+        </parameter>
+        <parameter name="n_fields" transfer-ownership="none">
+          <doc xml:space="preserve">number of elements in the @fields array</doc>
+          <type name="gsize" c:type="gsize"/>
+        </parameter>
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">user data passed to g_log_set_writer_func()</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="log_writer_supports_color"
+              c:identifier="g_log_writer_supports_color"
+              version="2.50">
+      <doc xml:space="preserve">Check whether the given @output_fd file descriptor supports ANSI color
+escape sequences. If so, they can safely be used when formatting log
+messages.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if ANSI color escapes are supported, %FALSE otherwise</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="output_fd" transfer-ownership="none">
+          <doc xml:space="preserve">output file descriptor to check</doc>
+          <type name="gint" c:type="gint"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="logv" c:identifier="g_logv" introspectable="0">
       <doc xml:space="preserve">Logs an error or debugging message.
@@ -39755,7 +40505,10 @@ function is called to terminate the program.
 If g_log_default_handler() is used as the log handler function, a new-line
 character will automatically be appended to @..., and need not be entered
-manually.</doc>
+manually.
+If [structured logging is enabled][using-structured-logging] this will
+output via the structured log writer function (see g_log_set_writer_func()).</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -39797,8 +40550,9 @@ See your C library manual for more details about lstat().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="buf" transfer-ownership="none">
           <doc xml:space="preserve">a pointer to a stat struct, which will be filled with the file
@@ -40287,8 +41041,9 @@ See your C library manual for more details about mkdir().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">permissions to use for the newly created directory</doc>
@@ -40309,7 +41064,7 @@ created. Returns -1 if an error occurred, with errno set.</doc>
       <parameters>
         <parameter name="pathname" transfer-ownership="none">
           <doc xml:space="preserve">a pathname in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="mode" transfer-ownership="none">
           <doc xml:space="preserve">permissions to use for newly created directories</doc>
@@ -40329,11 +41084,11 @@ and you can pass a @mode and additional @flags. The X string will
 be modified to form the name of a directory that didn't exist.
 The string should be in the GLib file name encoding. Most importantly,
 on Windows it should be in UTF-8.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">A pointer to @tmpl, which has been modified
-    to hold the directory name.  In case of errors, %NULL is
+      <return-value transfer-ownership="full" nullable="1">
+        <doc xml:space="preserve">A pointer to @tmpl, which has been
+    modified to hold the directory name.  In case of errors, %NULL is
     returned and %errno will be set.</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="tmpl" transfer-ownership="none">
@@ -40354,11 +41109,11 @@ and you can pass a @mode. The X string will be modified to form
 the name of a directory that didn't exist. The string should be
 in the GLib file name encoding. Most importantly, on Windows it
 should be in UTF-8.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">A pointer to @tmpl, which has been modified
-    to hold the directory name. In case of errors, %NULL is
+      <return-value transfer-ownership="full" nullable="1">
+        <doc xml:space="preserve">A pointer to @tmpl, which has been
+    modified to hold the directory name. In case of errors, %NULL is
     returned, and %errno will be set.</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="tmpl" transfer-ownership="none">
@@ -40620,8 +41375,9 @@ See your C library manual for more details about open().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="flags" transfer-ownership="none">
           <doc xml:space="preserve">as in open()</doc>
@@ -40687,12 +41443,12 @@ separator is returned. If @file_name is empty, it gets ".".</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">a newly allocated string containing the last
    component of the filename</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="file_name" transfer-ownership="none">
           <doc xml:space="preserve">the name of the file</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -40703,12 +41459,12 @@ If the file name has no directory components "." is returned.
 The returned string should be freed when no longer needed.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">the directory components of the file</doc>
-        <type name="utf8" c:type="gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="file_name" transfer-ownership="none">
           <doc xml:space="preserve">the name of the file</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -40744,7 +41500,7 @@ Windows-specific code.</doc>
       <parameters>
         <parameter name="file_name" transfer-ownership="none">
           <doc xml:space="preserve">a file name</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -40753,13 +41509,14 @@ Windows-specific code.</doc>
 i.e. after the "/" in UNIX or "C:\" under Windows. If @file_name
 is not an absolute path it returns %NULL.</doc>
       <return-value transfer-ownership="none" nullable="1">
-        <doc xml:space="preserve">a pointer into @file_name after the root component</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <doc xml:space="preserve">a pointer into @file_name after the
+    root component</doc>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="file_name" transfer-ownership="none">
           <doc xml:space="preserve">a file name</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -40998,8 +41755,8 @@ its own new-line character.
 g_print() should not be used from within libraries for debugging
 messages, since it may be redirected by applications to special
 purpose message windows or even files. Instead, libraries should
-use g_log(), or the convenience functions g_message(), g_warning()
-and g_error().</doc>
+use g_log(), g_log_structured(), or the convenience macros g_message(),
+g_warning() and g_error().</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -41021,8 +41778,8 @@ a trailing new-line character. Typically, @format should end with its own
 new-line character.
 g_printerr() should not be used from within libraries.
-Instead g_log() should be used, or the convenience functions
-g_message(), g_warning() and g_error().</doc>
+Instead g_log() or g_log_structured() should be used, or the convenience
+macros g_message(), g_warning() and g_error().</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -41597,8 +42354,9 @@ set by rmdir().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -41615,12 +42373,13 @@ a file that is open to some process.</doc>
       </return-value>
       <parameters>
         <parameter name="oldfilename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="newfilename" transfer-ownership="none">
           <doc xml:space="preserve">a pathname in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -41661,8 +42420,9 @@ on your system.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -42492,7 +43252,7 @@ are different concepts on Windows.</doc>
                    nullable="1"
                    allow-none="1">
           <doc xml:space="preserve">child's current working directory, or %NULL to inherit parent's</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="argv" transfer-ownership="none">
           <doc xml:space="preserve">child's argument vector</doc>
@@ -42736,7 +43496,7 @@ the spawned program opens its windows on the right screen.</doc>
                    nullable="1"
                    allow-none="1">
           <doc xml:space="preserve">child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="argv" transfer-ownership="none">
           <doc xml:space="preserve">child's argument vector, in the GLib file name encoding</doc>
@@ -43084,7 +43844,7 @@ how these functions work on Windows.</doc>
                    nullable="1"
                    allow-none="1">
           <doc xml:space="preserve">child's current working directory, or %NULL to inherit parent's</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="argv" transfer-ownership="none">
           <doc xml:space="preserve">child's argument vector</doc>
@@ -43255,8 +44015,9 @@ See your C library manual for more details about stat().</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="buf" transfer-ownership="none">
           <doc xml:space="preserve">a pointer to a stat struct, which will be filled with the file
@@ -43840,7 +44601,7 @@ The value of %errno will not be changed by this function.</doc>
     </function>
     <function name="strescape" c:identifier="g_strescape">
       <doc xml:space="preserve">Escapes the special characters '\b', '\f', '\n', '\r', '\t', '\v', '\'
-and '&amp;quot;' in the string @source by inserting a '\' before
+and '"' in the string @source by inserting a '\' before
 them. Additionally all characters in the range 0x01-0x1F (everything
 below SPACE) and in the range 0x7F-0xFF (all non-ASCII chars) are
 replaced with a '\' followed by their octal representation.
@@ -43989,7 +44750,11 @@ should be freed with g_free().</doc>
     <function name="strjoinv" c:identifier="g_strjoinv">
       <doc xml:space="preserve">Joins a number of strings together to form one long string, with the
 optional @separator inserted between each of them. The returned string
-should be freed with g_free().</doc>
+should be freed with g_free().
+If @str_array has no items, the return value will be an
+empty string. If @str_array contains a single item, @separator will not
+appear in the resulting string.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">a newly-allocated string containing all of the strings joined
     together, with @separator between them</doc>
@@ -44753,6 +45518,10 @@ with text matching @pattern, is expected to be logged. When this
 message is logged, it will not be printed, and the test case will
 not abort.
+This API may only be used with the old logging API (g_log() without
+%G_LOG_USE_STRUCTURED defined). It will not work with the structured logging
+API. See [Testing for Messages][testing-for-messages].
 Use g_test_assert_expected_messages() to assert that all
 previously-expected messages have been seen and suppressed.
@@ -44841,7 +45610,7 @@ This is approximately the same as calling g_test_build_filename("."),
 but you don't need to free the return value.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the path of the directory, owned by GLib</doc>
-        <type name="utf8" c:type="const gchar*"/>
+        <type name="filename" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="file_type" transfer-ownership="none">
@@ -44948,7 +45717,7 @@ So far, the following arguments are understood:
   `quick`: Quick tests, should run really quickly and give good coverage.
   `undefined`: Tests for undefined behaviour, may provoke programming errors
-  under g_test_trap_subprocess() or g_test_expect_messages() to check
+  under g_test_trap_subprocess() or g_test_expect_message() to check
   that appropriate assertions or warnings are given
   `no-undefined`: Avoid tests for undefined behaviour
@@ -44994,7 +45763,13 @@ Note that the handler is reset at the beginning of
 any test case, so you have to set it inside each test
 function which needs the special behavior.
-This handler has no effect on g_error messages.</doc>
+This handler has no effect on g_error messages.
+This handler also has no effect on structured log messages (using
+g_log_structured() or g_log_structured_array()). To change the fatal
+behaviour for specific log messages, programs must install a custom log
+writer function using g_log_set_writer_func().See
+[Using Structured Logging][using-structured-logging].</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -47012,8 +47787,9 @@ are open to some process, or mapped into memory.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
       </parameters>
     </function>
@@ -48009,8 +48785,9 @@ on your system.</doc>
       </return-value>
       <parameters>
         <parameter name="filename" transfer-ownership="none">
-          <doc xml:space="preserve">a pathname in the GLib file name encoding (UTF-8 on Windows)</doc>
-          <type name="utf8" c:type="const gchar*"/>
+          <doc xml:space="preserve">a pathname in the GLib file name encoding
+    (UTF-8 on Windows)</doc>
+          <type name="filename" c:type="gchar*"/>
         </parameter>
         <parameter name="utb"
                    transfer-ownership="none"