gobject-introspection 2.2.5-x86-mingw32 → 3.0.0-x86-mingw32

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

@@ -13,17 +13,94 @@ and/or use gtk-doc annotations.  -->
              shared-library="libglib-2.0-0.dll,libgobject-2.0-0.dll"
              c:identifier-prefixes="G"
              c:symbol-prefixes="g,glib">
+    <alias name="Array_autoptr" c:type="GArray_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="AsyncQueue_autoptr" c:type="GAsyncQueue_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="BookmarkFile_autoptr" c:type="GBookmarkFile_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="ByteArray_autoptr" c:type="GByteArray_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Bytes_autoptr" c:type="GBytes_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Checksum_autoptr" c:type="GChecksum_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="DateDay" c:type="GDateDay">
       <doc xml:space="preserve">Integer representing a day of the month; between 1 and 31.
 #G_DATE_BAD_DAY represents an invalid day of the month.</doc>
       <type name="guint8" c:type="guint8"/>
     </alias>
+    <alias name="DateTime_autoptr" c:type="GDateTime_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="DateYear" c:type="GDateYear">
       <doc xml:space="preserve">Integer representing a year; #G_DATE_BAD_YEAR is the invalid
 value. The year must be 1 or higher; negative (BC) years are not
 allowed. The year is represented with four digits.</doc>
       <type name="guint16" c:type="guint16"/>
     </alias>
+    <alias name="Dir_autoptr" c:type="GDir_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Error_autoptr" c:type="GError_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="HashTable_autoptr" c:type="GHashTable_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Hmac_autoptr" c:type="GHmac_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="IOChannel_autoptr" c:type="GIOChannel_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="KeyFile_autoptr" c:type="GKeyFile_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="List_autoptr" c:type="GList_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MainContext_autoptr" c:type="GMainContext_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MainLoop_autoptr" c:type="GMainLoop_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MappedFile_autoptr" c:type="GMappedFile_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MarkupParseContext_autoptr"
+           c:type="GMarkupParseContext_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MatchInfo_autoptr" c:type="GMatchInfo_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MutexLocker" c:type="GMutexLocker">
+      <doc xml:space="preserve">Opaque type. See g_mutex_locker_new() for details.</doc>
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="MutexLocker_autoptr" c:type="GMutexLocker_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Node_autoptr" c:type="GNode_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="OptionContext_autoptr" c:type="GOptionContext_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="OptionGroup_autoptr" c:type="GOptionGroup_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="PatternSpec_autoptr" c:type="GPatternSpec_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="Pid" c:type="GPid">
       <doc xml:space="preserve">A type which is used to hold a process identification.
 
@@ -34,15 +111,45 @@ GPid is used in GLib only for descendant processes spawned with
 the g_spawn functions.</doc>
       <type name="gpointer" c:type="gpointer"/>
     </alias>
+    <alias name="PtrArray_autoptr" c:type="GPtrArray_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="Quark" c:type="GQuark">
       <doc xml:space="preserve">A GQuark is a non-zero integer which uniquely identifies a
 particular string. A GQuark value of zero is associated to %NULL.</doc>
       <type name="guint32" c:type="guint32"/>
     </alias>
+    <alias name="Queue_autoptr" c:type="GQueue_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Rand_autoptr" c:type="GRand_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Regex_autoptr" c:type="GRegex_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="SList_autoptr" c:type="GSList_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Scanner_autoptr" c:type="GScanner_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Sequence_autoptr" c:type="GSequence_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Source_autoptr" c:type="GSource_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="StringChunk_autoptr" c:type="GStringChunk_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="Strv" c:type="GStrv">
       <doc xml:space="preserve">A C representable type name for #G_TYPE_STRV.</doc>
       <type name="gpointer" c:type="gpointer"/>
     </alias>
+    <alias name="Thread_autoptr" c:type="GThread_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="Time" c:type="GTime">
       <doc xml:space="preserve">Simply a replacement for time_t. It has been deprecated
 since it is not equivalent to time_t on 64-bit platforms
@@ -68,9 +175,33 @@ gtime = (GTime)ttime;
       <doc xml:space="preserve">A value representing an interval of time, in microseconds.</doc>
       <type name="gint64" c:type="gint64"/>
     </alias>
+    <alias name="TimeZone_autoptr" c:type="GTimeZone_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Timer_autoptr" c:type="GTimer_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Tree_autoptr" c:type="GTree_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <alias name="Type" c:type="GType">
       <type name="gsize" c:type="gsize"/>
     </alias>
+    <alias name="VariantBuilder_autoptr" c:type="GVariantBuilder_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="VariantDict_autoptr" c:type="GVariantDict_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="VariantIter_autoptr" c:type="GVariantIter_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="VariantType_autoptr" c:type="GVariantType_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
+    <alias name="Variant_autoptr" c:type="GVariant_autoptr">
+      <type name="gpointer" c:type="gpointer"/>
+    </alias>
     <constant name="ANALYZER_ANALYZING"
               value="1"
               c:type="G_ANALYZER_ANALYZING">
@@ -5459,7 +5590,7 @@ this may mean that the week-numbering year is one greater than the
 calendar year (so that these days have the same week-numbering year
 as the Thursday occurring early in the next year).
 
-For Friday, Saturaday and Sunday occurring near the start of the year,
+For Friday, Saturday and Sunday occurring near the start of the year,
 this may mean that the week-numbering year is one less than the
 calendar year (so that these days have the same week-numbering year
 as the Thursday occurring late in the previous year).
@@ -6582,7 +6713,7 @@ and printing values of type #gsize. See also #G_GINT16_FORMAT.</doc>
               c:type="G_GSIZE_MODIFIER"
               version="2.6">
       <doc xml:space="preserve">The platform dependent length modifier for conversion specifiers
-for scanning and printing values of type #gsize or #gssize. It
+for scanning and printing values of type #gsize. It
 is a string literal.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
@@ -6594,7 +6725,13 @@ is a string literal.</doc>
 and printing values of type #gssize. See also #G_GINT16_FORMAT.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
-    <constant name="GSSIZE_MODIFIER" value="" c:type="G_GSSIZE_MODIFIER">
+    <constant name="GSSIZE_MODIFIER"
+              value=""
+              c:type="G_GSSIZE_MODIFIER"
+              version="2.6">
+      <doc xml:space="preserve">The platform dependent length modifier for conversion specifiers
+for scanning and printing values of type #gssize. It
+is a string literal.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="GUINT16_FORMAT" value="hu" c:type="G_GUINT16_FORMAT">
@@ -6788,6 +6925,7 @@ the discussion in the section description.</doc>
                 version="2.32">
         <doc xml:space="preserve">Checks if @key is in @hash_table.</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
@@ -6968,7 +7106,11 @@ key/value pairs in the hash table.</doc>
                 version="2.14"
                 introspectable="0">
         <doc xml:space="preserve">Retrieves every key inside @hash_table. The returned data is valid
-until changes to the hash release those keys.</doc>
+until changes to the hash release those keys.
+
+This iterates over every entry in the hash table to build its return value.
+To iterate over the entries in a #GHashTable more efficiently, use a
+#GHashTableIter.</doc>
         <return-value>
           <doc xml:space="preserve">a #GList containing all the keys inside the hash
     table. The content of the list is owned by the hash table and
@@ -6999,7 +7141,11 @@ key.  Use @length to determine the true length if it's possible that
 %NULL was used as the value for a key.
 
 Note: in the common case of a string-keyed #GHashTable, the return
-value of this function can be conveniently cast to (gchar **).
+value of this function can be conveniently cast to (const gchar **).
+
+This iterates over every entry in the hash table to build its return value.
+To iterate over the entries in a #GHashTable more efficiently, use a
+#GHashTableIter.
 
 You should always free the return result with g_free().  In the
 above-mentioned case of a string-keyed hash table, it may be
@@ -7034,7 +7180,11 @@ first to transfer ownership of the keys.</doc>
                 version="2.14"
                 introspectable="0">
         <doc xml:space="preserve">Retrieves every value inside @hash_table. The returned data
-is valid until @hash_table is modified.</doc>
+is valid until @hash_table is modified.
+
+This iterates over every entry in the hash table to build its return value.
+To iterate over the entries in a #GHashTable more efficiently, use a
+#GHashTableIter.</doc>
         <return-value>
           <doc xml:space="preserve">a #GList containing all the values inside the hash
     table. The content of the list is owned by the hash table and
@@ -7191,7 +7341,14 @@ a function call.</doc>
         <doc xml:space="preserve">Creates a new #GHashTable like g_hash_table_new() with a reference
 count of 1 and allows to specify functions to free the memory
 allocated for the key and value that get called when removing the
-entry from the #GHashTable.</doc>
+entry from the #GHashTable.
+
+Since version 2.42 it is permissible for destroy notify functions to
+recursively remove further items from the hash table. This is only
+permissible if the application still holds a reference to the hash table.
+This means that you may need to ensure that the hash table is empty by
+calling g_hash_table_remove_all before releasing the last reference using
+g_hash_table_unref().</doc>
         <return-value>
           <doc xml:space="preserve">a new #GHashTable</doc>
           <type name="GLib.HashTable" c:type="GHashTable*">
@@ -9886,7 +10043,10 @@ details about the meanings of the keys below.</doc>
     </constant>
     <constant name="KEY_FILE_DESKTOP_KEY_ACTIONS"
               value="Actions"
-              c:type="G_KEY_FILE_DESKTOP_KEY_ACTIONS">
+              c:type="G_KEY_FILE_DESKTOP_KEY_ACTIONS"
+              version="2.38">
+      <doc xml:space="preserve">A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string list
+giving the available application actions.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="KEY_FILE_DESKTOP_KEY_CATEGORIES"
@@ -9908,7 +10068,10 @@ string giving the tooltip for the desktop entry.</doc>
     </constant>
     <constant name="KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE"
               value="DBusActivatable"
-              c:type="G_KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE">
+              c:type="G_KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE"
+              version="2.38">
+      <doc xml:space="preserve">A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true
+if the application is D-Bus activatable.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="KEY_FILE_DESKTOP_KEY_EXEC"
@@ -11932,7 +12095,10 @@ either use g_list_free_full() or free them manually first.</doc>
         </parameters>
       </function>
       <function name="free_1" c:identifier="g_list_free_1" introspectable="0">
-        <doc xml:space="preserve">Frees one #GList element.
+        <doc xml:space="preserve">Frees one #GList element, but does not update links from the next and
+previous elements in the list, so you should not call this function on an
+element that is currently part of a list.
+
 It is usually used after g_list_remove_link().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -12146,7 +12312,8 @@ with g_list_sort().</doc>
 
 This function iterates over the whole list to count its elements.
 Use a #GQueue instead of a GList if you regularly need the number
-of items.</doc>
+of items. To check whether the list is non-empty, it is faster to check
+@list against %NULL.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of elements in the #GList</doc>
           <type name="guint" c:type="guint"/>
@@ -12161,7 +12328,11 @@ of items.</doc>
         </parameters>
       </function>
       <function name="nth" c:identifier="g_list_nth" introspectable="0">
-        <doc xml:space="preserve">Gets the element at the given position in a #GList.</doc>
+        <doc xml:space="preserve">Gets the element at the given position in a #GList.
+
+This iterates over the list until it reaches the @n-th position. If you
+intend to iterate over every element, it is better to use a for-loop as
+described in the #GList introduction.</doc>
         <return-value>
           <doc xml:space="preserve">the element, or %NULL if the position is off
     the end of the #GList</doc>
@@ -12185,7 +12356,11 @@ of items.</doc>
       <function name="nth_data"
                 c:identifier="g_list_nth_data"
                 introspectable="0">
-        <doc xml:space="preserve">Gets the data of the element at the given position.</doc>
+        <doc xml:space="preserve">Gets the data of the element at the given position.
+
+This iterates over the list until it reaches the @n-th position. If you
+intend to iterate over every element, it is better to use a for-loop as
+described in the #GList introduction.</doc>
         <return-value>
           <doc xml:space="preserve">the element's data, or %NULL if the position
     is off the end of the #GList</doc>
@@ -12604,7 +12779,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="42" c:type="GLIB_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="44" 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
@@ -15638,8 +15813,8 @@ option: `--name arg` or combined in a single argument: `--name=arg`.</doc>
         <doc xml:space="preserve">The option takes an integer argument.</doc>
       </member>
       <member name="callback" value="3" c:identifier="G_OPTION_ARG_CALLBACK">
-        <doc xml:space="preserve">The option provides a callback to parse the
-    extra argument.</doc>
+        <doc xml:space="preserve">The option provides a callback (of type
+    #GOptionArgFunc) to parse the extra argument.</doc>
       </member>
       <member name="filename" value="4" c:identifier="G_OPTION_ARG_FILENAME">
         <doc xml:space="preserve">The option takes a filename as argument.</doc>
@@ -15702,10 +15877,8 @@ fields and should not be directly accessed.</doc>
               c:identifier="g_option_context_add_group"
               version="2.6">
         <doc xml:space="preserve">Adds a #GOptionGroup to the @context, so that parsing with @context
-will recognize the options in the group. Note that the group will
-be freed together with the context when g_option_context_free() is
-called, so you must not free the group yourself after adding it
-to a context.</doc>
+will recognize the options in the group. Note that this will take
+ownership of the @group and thus the @group should not be freed.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -15714,7 +15887,7 @@ to a context.</doc>
             <doc xml:space="preserve">a #GOptionContext</doc>
             <type name="OptionContext" c:type="GOptionContext*"/>
           </instance-parameter>
-          <parameter name="group" transfer-ownership="none">
+          <parameter name="group" transfer-ownership="full">
             <doc xml:space="preserve">the group to add</doc>
             <type name="OptionGroup" c:type="GOptionGroup*"/>
           </parameter>
@@ -15845,13 +16018,12 @@ g_option_context_set_ignore_unknown_options().</doc>
       </method>
       <method name="get_main_group"
               c:identifier="g_option_context_get_main_group"
-              version="2.6"
-              introspectable="0">
+              version="2.6">
         <doc xml:space="preserve">Returns a pointer to the main group of @context.</doc>
-        <return-value>
-          <doc xml:space="preserve">the main group of @context, or %NULL if @context doesn't
- have a main group. Note that group belongs to @context and should
- not be modified or freed.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the main group of @context, or %NULL if
+ @context doesn't have a main group. Note that group belongs to
+ @context and should not be modified or freed.</doc>
           <type name="OptionGroup" c:type="GOptionGroup*"/>
         </return-value>
         <parameters>
@@ -15861,6 +16033,23 @@ g_option_context_set_ignore_unknown_options().</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_strict_posix"
+              c:identifier="g_option_context_get_strict_posix"
+              version="2.44">
+        <doc xml:space="preserve">Returns whether strict POSIX code is enabled.
+
+See g_option_context_set_strict_posix() for more information.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if strict POSIX is enabled, %FALSE otherwise.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GoptionContext</doc>
+            <type name="OptionContext" c:type="GOptionContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_summary"
               c:identifier="g_option_context_get_summary"
               version="2.12">
@@ -16062,12 +16251,53 @@ treated differently when generating `--help` output.</doc>
             <doc xml:space="preserve">a #GOptionContext</doc>
             <type name="OptionContext" c:type="GOptionContext*"/>
           </instance-parameter>
-          <parameter name="group" transfer-ownership="none">
+          <parameter name="group" transfer-ownership="full">
             <doc xml:space="preserve">the group to set as main group</doc>
             <type name="OptionGroup" c:type="GOptionGroup*"/>
           </parameter>
         </parameters>
       </method>
+      <method name="set_strict_posix"
+              c:identifier="g_option_context_set_strict_posix"
+              version="2.44">
+        <doc xml:space="preserve">Sets strict POSIX mode.
+
+By default, this mode is disabled.
+
+In strict POSIX mode, the first non-argument parameter encountered
+(eg: filename) terminates argument processing.  Remaining arguments
+are treated as non-options and are not attempted to be parsed.
+
+If strict POSIX mode is disabled then parsing is done in the GNU way
+where option arguments can be freely mixed with non-options.
+
+As an example, consider "ls foo -l".  With GNU style parsing, this
+will list "foo" in long mode.  In strict POSIX style, this will list
+the files named "foo" and "-l".
+
+It may be useful to force strict POSIX mode when creating "verb
+style" command line tools.  For example, the "gsettings" command line
+tool supports the global option "--schemadir" as well as many
+subcommands ("get", "set", etc.) which each have their own set of
+arguments.  Using strict POSIX mode will allow parsing the global
+options up to the verb name while leaving the remaining options to be
+parsed by the relevant subcommand (which can be determined by
+examining the verb name, which should be present in argv[1] after
+parsing).</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GoptionContext</doc>
+            <type name="OptionContext" c:type="GOptionContext*"/>
+          </instance-parameter>
+          <parameter name="strict_posix" transfer-ownership="none">
+            <doc xml:space="preserve">the new value</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_summary"
               c:identifier="g_option_context_set_summary"
               version="2.12">
@@ -16349,7 +16579,11 @@ or g_option_group_add_entries().</doc>
     your direct control. Since 2.8.</doc>
       </member>
     </bitfield>
-    <record name="OptionGroup" c:type="GOptionGroup" disguised="1">
+    <record name="OptionGroup"
+            c:type="GOptionGroup"
+            glib:type-name="GOptionGroup"
+            glib:get-type="g_option_group_get_type"
+            c:symbol-prefix="option_group">
       <doc xml:space="preserve">A `GOptionGroup` struct defines the options in a single
 group. The struct has only private fields and should not be directly accessed.
 
@@ -16357,6 +16591,49 @@ All options in a group share the same translation function. Libraries which
 need to parse commandline options are expected to provide a function for
 getting a `GOptionGroup` holding their options, which
 the application can then add to its #GOptionContext.</doc>
+      <constructor name="new" c:identifier="g_option_group_new" version="2.6">
+        <doc xml:space="preserve">Creates a new #GOptionGroup.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a newly created option group. It should be added
+  to a #GOptionContext or freed with g_option_group_unref().</doc>
+          <type name="OptionGroup" c:type="GOptionGroup*"/>
+        </return-value>
+        <parameters>
+          <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">the name for the option group, this is used to provide
+  help for the options in this group with `--help-`@name</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="description" transfer-ownership="none">
+            <doc xml:space="preserve">a description for this group to be shown in
+  `--help`. This string is translated using the translation
+  domain or translation function of the group</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="help_description" transfer-ownership="none">
+            <doc xml:space="preserve">a description for the `--help-`@name option.
+  This string is translated using the translation domain or translation function
+  of the group</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">user data that will be passed to the pre- and post-parse hooks,
+  the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+          <parameter name="destroy"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     scope="async">
+            <doc xml:space="preserve">a function that will be called to free @user_data, or %NULL</doc>
+            <type name="DestroyNotify" c:type="GDestroyNotify"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <method name="add_entries"
               c:identifier="g_option_group_add_entries"
               version="2.6">
@@ -16375,9 +16652,14 @@ the application can then add to its #GOptionContext.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="free" c:identifier="g_option_group_free" version="2.6">
+      <method name="free"
+              c:identifier="g_option_group_free"
+              version="2.6"
+              deprecated="1"
+              deprecated-version="2.44">
         <doc xml:space="preserve">Frees a #GOptionGroup. Note that you must not free groups
 which have been added to a #GOptionContext.</doc>
+        <doc-deprecated xml:space="preserve">Use g_option_group_unref() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -16388,6 +16670,19 @@ which have been added to a #GOptionContext.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="ref" c:identifier="g_option_group_ref" version="2.44">
+        <doc xml:space="preserve">Increments the reference count of @group by one.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a #GoptionGroup</doc>
+          <type name="OptionGroup" c:type="GOptionGroup*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="group" transfer-ownership="none">
+            <doc xml:space="preserve">a #GOptionGroup</doc>
+            <type name="OptionGroup" c:type="GOptionGroup*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="set_error_hook"
               c:identifier="g_option_group_set_error_hook"
               version="2.6"
@@ -16509,52 +16804,20 @@ user-visible strings.</doc>
           </parameter>
         </parameters>
       </method>
-      <function name="new"
-                c:identifier="g_option_group_new"
-                version="2.6"
-                introspectable="0">
-        <doc xml:space="preserve">Creates a new #GOptionGroup.</doc>
-        <return-value>
-          <doc xml:space="preserve">a newly created option group. It should be added
-  to a #GOptionContext or freed with g_option_group_free().</doc>
-          <type name="OptionGroup" c:type="GOptionGroup*"/>
+      <method name="unref" c:identifier="g_option_group_unref" version="2.44">
+        <doc xml:space="preserve">Decrements the reference count of @group by one.
+If the reference count drops to 0, the @group will be freed.
+and all memory allocated by the @group is released.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <parameter name="name" transfer-ownership="none">
-            <doc xml:space="preserve">the name for the option group, this is used to provide
-  help for the options in this group with `--help-`@name</doc>
-            <type name="utf8" c:type="const gchar*"/>
-          </parameter>
-          <parameter name="description" transfer-ownership="none">
-            <doc xml:space="preserve">a description for this group to be shown in
-  `--help`. This string is translated using the translation
-  domain or translation function of the group</doc>
-            <type name="utf8" c:type="const gchar*"/>
-          </parameter>
-          <parameter name="help_description" transfer-ownership="none">
-            <doc xml:space="preserve">a description for the `--help-`@name option.
-  This string is translated using the translation domain or translation function
-  of the group</doc>
-            <type name="utf8" c:type="const gchar*"/>
-          </parameter>
-          <parameter name="user_data"
-                     transfer-ownership="none"
-                     nullable="1"
-                     allow-none="1">
-            <doc xml:space="preserve">user data that will be passed to the pre- and post-parse hooks,
-  the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL</doc>
-            <type name="gpointer" c:type="gpointer"/>
-          </parameter>
-          <parameter name="destroy"
-                     transfer-ownership="none"
-                     nullable="1"
-                     allow-none="1"
-                     scope="async">
-            <doc xml:space="preserve">a function that will be called to free @user_data, or %NULL</doc>
-            <type name="DestroyNotify" c:type="GDestroyNotify"/>
-          </parameter>
+          <instance-parameter name="group" transfer-ownership="none">
+            <doc xml:space="preserve">a #GOptionGroup</doc>
+            <type name="OptionGroup" c:type="GOptionGroup*"/>
+          </instance-parameter>
         </parameters>
-      </function>
+      </method>
     </record>
     <callback name="OptionParseFunc" c:type="GOptionParseFunc" throws="1">
       <doc xml:space="preserve">The type of function that can be called before and after parsing.</doc>
@@ -17564,9 +17827,10 @@ g_queue_new().</doc>
               c:identifier="g_queue_insert_after"
               version="2.4"
               introspectable="0">
-        <doc xml:space="preserve">Inserts @data into @queue after @sibling
+        <doc xml:space="preserve">Inserts @data into @queue after @sibling.
 
-@sibling must be part of @queue</doc>
+@sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the
+data at the head of the queue.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17575,8 +17839,12 @@ g_queue_new().</doc>
             <doc xml:space="preserve">a #GQueue</doc>
             <type name="Queue" c:type="GQueue*"/>
           </instance-parameter>
-          <parameter name="sibling" transfer-ownership="none">
-            <doc xml:space="preserve">a #GList link that must be part of @queue</doc>
+          <parameter name="sibling"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GList link that must be part of @queue, or %NULL to
+  push at the head of the queue.</doc>
             <type name="GLib.List" c:type="GList*">
               <type name="gpointer" c:type="gpointer"/>
             </type>
@@ -17593,7 +17861,8 @@ g_queue_new().</doc>
               introspectable="0">
         <doc xml:space="preserve">Inserts @data into @queue before @sibling.
 
-@sibling must be part of @queue.</doc>
+@sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the
+data at the tail of the queue.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17602,8 +17871,12 @@ g_queue_new().</doc>
             <doc xml:space="preserve">a #GQueue</doc>
             <type name="Queue" c:type="GQueue*"/>
           </instance-parameter>
-          <parameter name="sibling" transfer-ownership="none">
-            <doc xml:space="preserve">a #GList link that must be part of @queue</doc>
+          <parameter name="sibling"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GList link that must be part of @queue, or %NULL to
+  push at the tail of the queue.</doc>
             <type name="GLib.List" c:type="GList*">
               <type name="gpointer" c:type="gpointer"/>
             </type>
@@ -20812,7 +21085,8 @@ This function iterates over the whole list.</doc>
         <doc xml:space="preserve">Gets the number of elements in a #GSList.
 
 This function iterates over the whole list to
-count its elements.</doc>
+count its elements. To check whether the list is non-empty, it is faster to
+check @list against %NULL.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of elements in the #GSList</doc>
           <type name="guint" c:type="guint"/>
@@ -24188,7 +24462,7 @@ The rest of the #GString is shifted down to fill the gap.</doc>
 If @free_segment is %TRUE it also frees the character data.  If
 it's %FALSE, the caller gains ownership of the buffer and must
 free it after use with g_free().</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the character data of @string
          (i.e. %NULL if @free_segment is %TRUE)</doc>
           <type name="utf8" c:type="gchar*"/>
@@ -25264,7 +25538,7 @@ or or from within a #GThreadPool.</doc>
         </parameters>
       </function>
       <function name="self" c:identifier="g_thread_self">
-        <doc xml:space="preserve">This functions returns the #GThread corresponding to the
+        <doc xml:space="preserve">This function returns the #GThread corresponding to the
 current thread. Note that this function does not increase
 the reference count of the returned struct.
 
@@ -25569,7 +25843,7 @@ global pool.
 @error can be %NULL to ignore errors, or non-%NULL to report
 errors. An error can only occur when @exclusive is set to %TRUE
 and not all @max_threads threads could be created.
-See #GThreadError for possible errors that may occurr.
+See #GThreadError for possible errors that may occur.
 Note, even in case of error a valid #GThreadPool is returned.</doc>
         <return-value>
           <doc xml:space="preserve">the new #GThreadPool</doc>
@@ -27110,7 +27384,7 @@ url="http://www.unicode.org/reports/tr24/"&gt;Unicode Standard Annex
               value="1"
               c:identifier="G_UNICODE_SCRIPT_INHERITED">
         <doc xml:space="preserve">a mark glyph that takes its script from the
-i                             base glyph to which it is attached</doc>
+                              base glyph to which it is attached</doc>
       </member>
       <member name="arabic" value="2" c:identifier="G_UNICODE_SCRIPT_ARABIC">
         <doc xml:space="preserve">Arabic</doc>
@@ -27639,12 +27913,12 @@ i                             base glyph to which it is attached</doc>
       <member name="tirhuta"
               value="124"
               c:identifier="G_UNICODE_SCRIPT_TIRHUTA">
-        <doc xml:space="preserve">Tirhuta. Since: 2.42
-@G_UNICODE_SCRIPT_WARANG_CITI           Warang Citi. Since: 2.42</doc>
+        <doc xml:space="preserve">Tirhuta. Since: 2.42</doc>
       </member>
       <member name="warang_citi"
               value="125"
               c:identifier="G_UNICODE_SCRIPT_WARANG_CITI">
+        <doc xml:space="preserve">Warang Citi. Since: 2.42</doc>
       </member>
     </enumeration>
     <enumeration name="UnicodeType" c:type="GUnicodeType">
@@ -28216,7 +28490,7 @@ new instance takes ownership of them as if via g_variant_ref_sink().</doc>
                    version="2.26">
         <doc xml:space="preserve">Creates an array-of-bytes #GVariant with the contents of @string.
 This function is just like g_variant_new_string() except that the
-string need not be valid utf8.
+string need not be valid UTF-8.
 
 The nul terminator character at the end of the string is stored in
 the array.</doc>
@@ -28701,14 +28975,14 @@ g_variant_is_signature() if you're not sure.</doc>
                    version="2.24">
         <doc xml:space="preserve">Creates a string #GVariant with the contents of @string.
 
-@string must be valid utf8.</doc>
+@string must be valid UTF-8.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a floating reference to a new string #GVariant instance</doc>
           <type name="Variant" c:type="GVariant*"/>
         </return-value>
         <parameters>
           <parameter name="string" transfer-ownership="none">
-            <doc xml:space="preserve">a normal utf8 nul-terminated string</doc>
+            <doc xml:space="preserve">a normal UTF-8 nul-terminated string</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
         </parameters>
@@ -28743,7 +29017,7 @@ If @length is -1 then @strv is %NULL-terminated.</doc>
                    introspectable="0">
         <doc xml:space="preserve">Creates a string #GVariant with the contents of @string.
 
-@string must be valid utf8.
+@string must be valid UTF-8.
 
 This function consumes @string.  g_free() will be called on @string
 when it is no longer required.
@@ -28758,7 +29032,7 @@ freed.</doc>
         </return-value>
         <parameters>
           <parameter name="string" transfer-ownership="none">
-            <doc xml:space="preserve">a normal utf8 nul-terminated string</doc>
+            <doc xml:space="preserve">a normal UTF-8 nul-terminated string</doc>
             <type name="utf8" c:type="gchar*"/>
           </parameter>
         </parameters>
@@ -29132,11 +29406,11 @@ For an empty array, @length will be set to 0 and a pointer to a
         <doc xml:space="preserve">Similar to g_variant_get_string() except that instead of returning
 a constant string, the string is duplicated.
 
-The string will always be utf8 encoded.
+The string will always be UTF-8 encoded.
 
 The return value must be freed using g_free().</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a newly allocated string, utf8 encoded</doc>
+          <doc xml:space="preserve">a newly allocated string, UTF-8 encoded</doc>
           <type name="utf8" c:type="gchar*"/>
         </return-value>
         <parameters>
@@ -29723,7 +29997,7 @@ involved.</doc>
 type.  This includes the types %G_VARIANT_TYPE_STRING,
 %G_VARIANT_TYPE_OBJECT_PATH and %G_VARIANT_TYPE_SIGNATURE.
 
-The string will always be utf8 encoded.
+The string will always be UTF-8 encoded.
 
 If @length is non-%NULL then the length of the string (in bytes) is
 returned there.  For trusted values, this information is already
@@ -29734,7 +30008,7 @@ other than those three.
 
 The return value remains valid as long as @value exists.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the constant string, utf8 encoded</doc>
+          <doc xml:space="preserve">the constant string, UTF-8 encoded</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
         <parameters>
@@ -32525,6 +32799,23 @@ function passed to g_atexit().</doc>
               c:type="G_WIN32_MSG_HANDLE">
       <type name="gint" c:type="gint"/>
     </constant>
+    <enumeration name="Win32OSType" c:type="GWin32OSType">
+      <doc xml:space="preserve">Type of Windows edition to check for at run-time.</doc>
+      <member name="any" value="0" c:identifier="G_WIN32_OS_ANY">
+        <doc xml:space="preserve">The running system can be a workstation or a server edition of
+ Windows.  The type of the running system is therefore not checked.</doc>
+      </member>
+      <member name="workstation"
+              value="1"
+              c:identifier="G_WIN32_OS_WORKSTATION">
+        <doc xml:space="preserve">The running system is a workstation edition of Windows,
+ such as Windows 7 Professional.</doc>
+      </member>
+      <member name="server" value="2" c:identifier="G_WIN32_OS_SERVER">
+        <doc xml:space="preserve">The running system is a server edition of Windows, such as
+ Windows Server 2008 R2.</doc>
+      </member>
+    </enumeration>
     <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
@@ -32579,7 +32870,8 @@ This function generates enough precision that converting
 the string back using g_ascii_strtod() gives the same machine-number
 (on machines with IEEE compatible 64bit doubles). It is
 guaranteed that the size of the resulting string will never
-be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes.</doc>
+be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes, including the terminating
+nul character, which is always added.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">The pointer to the buffer with the converted string.</doc>
         <type name="utf8" c:type="gchar*"/>
@@ -32605,6 +32897,8 @@ decimal point. To format the number you pass in
 a printf()-style format string. Allowed conversion
 specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.
 
+The returned buffer is guaranteed to be nul-terminated.
+
 If you just want to want to serialize the value into a
 string, use g_ascii_dtostr().</doc>
       <return-value transfer-ownership="full">
@@ -34448,6 +34742,7 @@ function over the call provided by the system; on Unix, it will
 attempt to correctly handle %EINTR, which has platform-specific
 semantics.</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE on success, %FALSE if there was an error.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -36698,7 +36993,9 @@ positional parameters, as specified in the Single Unix Specification.</doc>
     </function>
     <function name="free" c:identifier="g_free">
       <doc xml:space="preserve">Frees the memory pointed to by @mem.
-If @mem is %NULL it simply returns.</doc>
+
+If @mem is %NULL it simply returns, so there is no need to check @mem
+against %NULL before calling this function.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -36780,8 +37077,14 @@ freed.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
-        <parameter name="charset" transfer-ownership="none">
-          <doc xml:space="preserve">return location for character set name</doc>
+        <parameter name="charset"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="none"
+                   optional="1"
+                   allow-none="1">
+          <doc xml:space="preserve">return location for character set
+  name, or %NULL.</doc>
           <type name="utf8" c:type="const char**"/>
         </parameter>
       </parameters>
@@ -37329,6 +37632,7 @@ the discussion in the section description.</doc>
               version="2.32">
       <doc xml:space="preserve">Checks if @key is in @hash_table.</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -37866,8 +38170,10 @@ returns %FALSE it is automatically removed from the list of event
 sources and will not be called again.
 
 This internally creates a main loop source using g_idle_source_new()
-and attaches it to the main loop context using g_source_attach().
-You can do these steps manually if you need greater control.</doc>
+and attaches it to the global #GMainContext using g_source_attach(), so
+the callback will be invoked in whichever thread is running that main
+context. You can do these steps manually if you need greater control or to
+use a custom main context.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
         <type name="guint" c:type="guint"/>
@@ -37891,8 +38197,10 @@ events pending.  If the function returns %FALSE it is automatically
 removed from the list of event sources and will not be called again.
 
 This internally creates a main loop source using g_idle_source_new()
-and attaches it to the main loop context using g_source_attach().
-You can do these steps manually if you need greater control.</doc>
+and attaches it to the global #GMainContext using g_source_attach(), so
+the callback will be invoked in whichever thread is running that main
+context. You can do these steps manually if you need greater control or to
+use a custom main context.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
         <type name="guint" c:type="guint"/>
@@ -39544,7 +39852,7 @@ Windows-specific code.</doc>
       <doc xml:space="preserve">Returns a pointer into @file_name after the root component,
 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">
+      <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*"/>
       </return-value>
@@ -39875,7 +40183,11 @@ of the sprintf() function.</doc>
     </function>
     <function name="propagate_error" c:identifier="g_propagate_error">
       <doc xml:space="preserve">If @dest is %NULL, free @src; otherwise, moves @src into *@dest.
-The error variable @dest points to must be %NULL.</doc>
+The error variable @dest points to must be %NULL.
+
+Note that @src is no longer valid after this call. If you want
+to keep using the same GError*, you need to set it to %NULL
+after calling this function on it.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -42571,8 +42883,10 @@ g_strcompress() does the reverse conversion.</doc>
       </parameters>
     </function>
     <function name="strfreev" c:identifier="g_strfreev">
-      <doc xml:space="preserve">Frees a %NULL-terminated array of strings, and the array itself.
-If called on a %NULL value, g_strfreev() simply returns.</doc>
+      <doc xml:space="preserve">Frees a %NULL-terminated array of strings, as well as each
+string it contains.
+
+If @str_array is %NULL, this function simply returns.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -43104,6 +43418,25 @@ point in some locales, causing unexpected results.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="strv_contains"
+              c:identifier="g_strv_contains"
+              version="2.44">
+      <doc xml:space="preserve">Checks if @strv contains @str. @strv must not be %NULL.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if @str is an element of @strv, according to g_str_equal().</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="strv" transfer-ownership="none">
+          <doc xml:space="preserve">a %NULL-terminated array of strings</doc>
+          <type name="utf8" c:type="const gchar* const*"/>
+        </parameter>
+        <parameter name="str" transfer-ownership="none">
+          <doc xml:space="preserve">a string</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="strv_get_type" c:identifier="g_strv_get_type">
       <return-value transfer-ownership="none">
         <type name="GType" c:type="GType"/>
@@ -43125,8 +43458,7 @@ string array @str_array.</doc>
     </function>
     <function name="test_add_data_func"
               c:identifier="g_test_add_data_func"
-              version="2.16"
-              introspectable="0">
+              version="2.16">
       <doc xml:space="preserve">Create a new test case, similar to g_test_create_case(). However
 the test is assumed to use no fixture, and test suites are automatically
 created on the fly and added to the root fixture, based on the
@@ -43148,7 +43480,7 @@ required via the `-p` command-line option or g_test_trap_subprocess().</doc>
           <doc xml:space="preserve">Test data argument for the test function.</doc>
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
-        <parameter name="test_func" transfer-ownership="none">
+        <parameter name="test_func" transfer-ownership="none" scope="async">
           <doc xml:space="preserve">The test function to invoke for this test.</doc>
           <type name="TestDataFunc" c:type="GTestDataFunc"/>
         </parameter>
@@ -43188,8 +43520,7 @@ required via the `-p` command-line option or g_test_trap_subprocess().</doc>
     </function>
     <function name="test_add_func"
               c:identifier="g_test_add_func"
-              version="2.16"
-              introspectable="0">
+              version="2.16">
       <doc xml:space="preserve">Create a new test case, similar to g_test_create_case(). However
 the test is assumed to use no fixture, and test suites are automatically
 created on the fly and added to the root fixture, based on the
@@ -43206,7 +43537,7 @@ required via the `-p` command-line option or g_test_trap_subprocess().</doc>
           <doc xml:space="preserve">/-separated test case path name for the test.</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
-        <parameter name="test_func" transfer-ownership="none">
+        <parameter name="test_func" transfer-ownership="none" scope="async">
           <doc xml:space="preserve">The test function to invoke for this test.</doc>
           <type name="TestFunc" c:type="GTestFunc"/>
         </parameter>
@@ -43350,14 +43681,14 @@ same relative path as the test binary.</doc>
       <doc xml:space="preserve">Create a new #GTestCase, named @test_name, this API is fairly
 low level, calling g_test_add() or g_test_add_func() is preferable.
 When this test is executed, a fixture structure of size @data_size
-will be allocated and filled with 0s. Then @data_setup is called
-to initialize the fixture. After fixture setup, the actual test
-function @data_test is called. Once the test run completed, the
-fixture structure is torn down  by calling @data_teardown and
-after that the memory is released.
+will be automatically allocated and filled with zeros. Then @data_setup is
+called to initialize the fixture. After fixture setup, the actual test
+function @data_test is called. Once the test run completes, the
+fixture structure is torn down by calling @data_teardown and
+after that the memory is automatically released by the test framework.
 
 Splitting up a test run into fixture setup, test function and
-fixture teardown is most usful if the same fixture is used for
+fixture teardown is most useful if the same fixture is used for
 multiple tests. In this cases, g_test_create_case() will be
 called with the same fixture, but varying @test_name and
 @data_test arguments.</doc>
@@ -43378,15 +43709,17 @@ called with the same fixture, but varying @test_name and
           <doc xml:space="preserve">test data argument for the test functions</doc>
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
-        <parameter name="data_setup" transfer-ownership="none">
+        <parameter name="data_setup" transfer-ownership="none" scope="async">
           <doc xml:space="preserve">the function to set up the fixture data</doc>
           <type name="TestFixtureFunc" c:type="GTestFixtureFunc"/>
         </parameter>
-        <parameter name="data_test" transfer-ownership="none">
+        <parameter name="data_test" transfer-ownership="none" scope="async">
           <doc xml:space="preserve">the actual test function</doc>
           <type name="TestFixtureFunc" c:type="GTestFixtureFunc"/>
         </parameter>
-        <parameter name="data_teardown" transfer-ownership="none">
+        <parameter name="data_teardown"
+                   transfer-ownership="none"
+                   scope="async">
           <doc xml:space="preserve">the function to teardown the fixture data</doc>
           <type name="TestFixtureFunc" c:type="GTestFixtureFunc"/>
         </parameter>
@@ -44302,7 +44635,7 @@ regularly stop all unused threads e.g. from g_timeout_add().</doc>
     <function name="thread_self"
               c:identifier="g_thread_self"
               moved-to="Thread.self">
-      <doc xml:space="preserve">This functions returns the #GThread corresponding to the
+      <doc xml:space="preserve">This function returns the #GThread corresponding to the
 current thread. Note that this function does not increase
 the reference count of the returned struct.
 
@@ -44378,8 +44711,10 @@ g_timeout_add_seconds() function; this function allows for more
 optimizations and more efficient system power usage.
 
 This internally creates a main loop source using g_timeout_source_new()
-and attaches it to the main loop context using g_source_attach(). You can
-do these steps manually if you need greater control.
+and attaches it to the global #GMainContext using g_source_attach(), so
+the callback will be invoked in whichever thread is running that main
+context. You can do these steps manually if you need greater control or to
+use a custom main context.
 
 The interval given is in terms of monotonic time, not wall clock
 time.  See g_get_monotonic_time().</doc>
@@ -44420,8 +44755,10 @@ timeout is recalculated based on the current time and the given interval
 (it does not try to 'catch up' time lost in delays).
 
 This internally creates a main loop source using g_timeout_source_new()
-and attaches it to the main loop context using g_source_attach(). You can
-do these steps manually if you need greater control.
+and attaches it to the global #GMainContext using g_source_attach(), so
+the callback will be invoked in whichever thread is running that main
+context. You can do these steps manually if you need greater control or to
+use a custom main context.
 
 The interval given in terms of monotonic time, not wall clock time.
 See g_get_monotonic_time().</doc>
@@ -44734,7 +45071,9 @@ but care is taken to detect possible overflow during multiplication.</doc>
               introspectable="0">
       <doc xml:space="preserve">Attempts to realloc @mem to a new size, @n_bytes, and returns %NULL
 on failure. Contrast with g_realloc(), which aborts the program
-on failure. If @mem is %NULL, behaves the same as g_try_malloc().</doc>
+on failure.
+
+If @mem is %NULL, behaves the same as g_try_malloc().</doc>
       <return-value>
         <doc xml:space="preserve">the allocated memory, or %NULL.</doc>
         <type name="gpointer" c:type="gpointer"/>
@@ -46994,6 +47333,45 @@ positional parameters, as specified in the Single Unix Specification.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="win32_check_windows_version"
+              c:identifier="g_win32_check_windows_version"
+              version="2.44">
+      <doc xml:space="preserve">Returns whether the version of the Windows operating system the
+code is running on is at least the specified major, minor and
+service pack versions.  See MSDN documentation for the Operating
+System Version.  Software that needs even more detailed version and
+feature information should use the Win32 API VerifyVersionInfo()
+directly.
+
+Successive calls of this function can be used for enabling or
+disabling features at run-time for a range of Windows versions,
+as per the VerifyVersionInfo() API documentation.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if the Windows Version is the same or greater than
+         the specified major, minor and service pack versions, and
+         whether the running Windows is a workstation or server edition
+         of Windows, if specifically specified.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="major" transfer-ownership="none">
+          <doc xml:space="preserve">major version of Windows</doc>
+          <type name="gint" c:type="const gint"/>
+        </parameter>
+        <parameter name="minor" transfer-ownership="none">
+          <doc xml:space="preserve">minor version of Windows</doc>
+          <type name="gint" c:type="const gint"/>
+        </parameter>
+        <parameter name="spver" transfer-ownership="none">
+          <doc xml:space="preserve">Windows Service Pack Level, 0 if none</doc>
+          <type name="gint" c:type="const gint"/>
+        </parameter>
+        <parameter name="os_type" transfer-ownership="none">
+          <doc xml:space="preserve">Type of Windows OS</doc>
+          <type name="Win32OSType" c:type="const GWin32OSType"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="win32_error_message" c:identifier="g_win32_error_message">
       <doc xml:space="preserve">Translate a Win32 error code (as returned by GetLastError() or
 WSAGetLastError()) into the corresponding message. The message is
@@ -47273,8 +47651,12 @@ freed with g_free() when no longer needed. If something goes wrong,
     </function>
     <function name="win32_get_windows_version"
               c:identifier="g_win32_get_windows_version"
-              version="2.6">
-      <doc xml:space="preserve">Returns version information for the Windows operating system the
+              deprecated="1"
+              deprecated-version="2.44">
+      <doc xml:space="preserve">This function is deprecated. Use
+g_win32_check_windows_version() instead.
+
+Returns version information for the Windows operating system the
 code is running on. See MSDN documentation for the GetVersion()
 function. To summarize, the most significant bit is one on Win9x,
 and zero on NT-based systems. Since version 2.14, GLib works only
@@ -47283,6 +47665,11 @@ in your own software is moot. The least significant byte is 4 on
 Windows NT 4, and 5 on Windows XP. Software that needs really
 detailed version and feature information should use Win32 API like
 GetVersionEx() and VerifyVersionInfo().</doc>
+      <doc-deprecated xml:space="preserve">Be aware that for Windows 8.1 and Windows Server
+2012 R2 and later, this will return 62 unless the application is
+manifested for Windows 8.1/Windows Server 2012 R2, for example.
+MSDN stated that GetVersion(), which is used here, is subject to
+further change or removal after Windows 8.1.</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">The version information.</doc>
         <type name="guint" c:type="guint"/>