gobject-introspection 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32

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

@@ -86,66 +86,87 @@ and/or use gtk-doc annotations.  -->
     <union name="Argument" c:type="GIArgument">
       <doc xml:space="preserve">Stores an argument of varying type</doc>
       <field name="v_boolean" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gboolean" c:type="gboolean"/>
       </field>
       <field name="v_int8" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gint8" c:type="gint8"/>
       </field>
       <field name="v_uint8" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="guint8" c:type="guint8"/>
       </field>
       <field name="v_int16" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gint16" c:type="gint16"/>
       </field>
       <field name="v_uint16" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="guint16" c:type="guint16"/>
       </field>
       <field name="v_int32" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gint32" c:type="gint32"/>
       </field>
       <field name="v_uint32" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="guint32" c:type="guint32"/>
       </field>
       <field name="v_int64" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gint64" c:type="gint64"/>
       </field>
       <field name="v_uint64" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="v_float" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gfloat" c:type="gfloat"/>
       </field>
       <field name="v_double" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gdouble" c:type="gdouble"/>
       </field>
       <field name="v_short" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gshort" c:type="gshort"/>
       </field>
       <field name="v_ushort" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gushort" c:type="gushort"/>
       </field>
       <field name="v_int" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="v_uint" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="guint" c:type="guint"/>
       </field>
       <field name="v_long" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="glong" c:type="glong"/>
       </field>
       <field name="v_ulong" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gulong" c:type="gulong"/>
       </field>
       <field name="v_ssize" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gssize" c:type="gssize"/>
       </field>
       <field name="v_size" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gsize" c:type="gsize"/>
       </field>
       <field name="v_string" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="utf8" c:type="gchar*"/>
       </field>
       <field name="v_pointer" writable="1">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gpointer" c:type="gpointer"/>
       </field>
     </union>
@@ -226,6 +247,32 @@ g_irepository_find_by_name(), g_irepository_find_by_gtype() or g_irepository_get
    +----&lt;link linkend="gi-GITypeInfo"&gt;GITypeInfo&lt;/link&gt;
 &lt;/synopsis&gt;
 &lt;/refsect1&gt;</doc>
+      <field name="dummy1" readable="0" private="1">
+        <type name="gint32" c:type="gint32"/>
+      </field>
+      <field name="dummy2" readable="0" private="1">
+        <type name="gint32" c:type="gint32"/>
+      </field>
+      <field name="dummy3" readable="0" private="1">
+        <type name="gpointer" c:type="gpointer"/>
+      </field>
+      <field name="dummy4" readable="0" private="1">
+        <type name="gpointer" c:type="gpointer"/>
+      </field>
+      <field name="dummy5" readable="0" private="1">
+        <type name="gpointer" c:type="gpointer"/>
+      </field>
+      <field name="dummy6" readable="0" private="1">
+        <type name="guint32" c:type="guint32"/>
+      </field>
+      <field name="dummy7" readable="0" private="1">
+        <type name="guint32" c:type="guint32"/>
+      </field>
+      <field name="padding" readable="0" private="1">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="4">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
       <method name="equal" c:identifier="g_base_info_equal">
         <doc xml:space="preserve">Compare two #GIBaseInfo.
 
@@ -351,7 +398,10 @@ deprecated or not.</doc>
               c:identifier="g_base_info_iterate_attributes">
         <doc xml:space="preserve">Iterate over all attributes associated with this node.  The iterator
 structure is typically stack allocated, and must have its first
-member initialized to %NULL.
+member initialized to %NULL.  Attributes are arbitrary namespaced key–value
+pairs which can be attached to almost any item.  They are intended for use
+by software higher in the toolchain than bindings, and are distinct from
+normal GIR annotations.
 
 Both the @name and @value should be treated as constants
 and must not be freed.
@@ -509,6 +559,7 @@ drops to 0, the info is freed.</doc>
       <member name="invalid_0"
               value="10"
               c:identifier="GI_INFO_TYPE_INVALID_0">
+        <doc xml:space="preserve">deleted, used to be GI_INFO_TYPE_ERROR_DOMAIN.</doc>
       </member>
       <member name="union" value="11" c:identifier="GI_INFO_TYPE_UNION">
         <doc xml:space="preserve">union, see #GIUnionInfo</doc>
@@ -537,7 +588,8 @@ drops to 0, the info is freed.</doc>
       <member name="unresolved"
               value="19"
               c:identifier="GI_INFO_TYPE_UNRESOLVED">
-        <doc xml:space="preserve">unresolved type, a type which is not present in the typelib, or any of its dependencies.</doc>
+        <doc xml:space="preserve">unresolved type, a type which is not present in
+  the typelib, or any of its dependencies.</doc>
       </member>
     </enumeration>
     <callback name="ObjectInfoGetValueFunction"
@@ -609,6 +661,8 @@ drops to 0, the info is freed.</doc>
            glib:type-name="GIRepository"
            glib:get-type="g_irepository_get_type"
            glib:type-struct="RepositoryClass">
+      <doc xml:space="preserve">#GIRepository is used to manage repositories of namespaces. Namespaces
+are represented on disk by type libraries (.typelib files).</doc>
       <function name="dump" c:identifier="g_irepository_dump" throws="1">
         <return-value transfer-ownership="none">
           <type name="gboolean" c:type="gboolean"/>
@@ -625,7 +679,7 @@ drops to 0, the info is freed.</doc>
         </return-value>
       </function>
       <function name="get_default" c:identifier="g_irepository_get_default">
-        <doc xml:space="preserve">Returns the singleton process-global default #GIRepository.  It is
+        <doc xml:space="preserve">Returns the singleton process-global default #GIRepository. It is
 not currently supported to have multiple repositories in a
 particular process, but this function is provided in the unlikely
 eventuality that it would become possible, and as a convenience for
@@ -653,11 +707,11 @@ introspection information</doc>
       </function>
       <function name="get_search_path"
                 c:identifier="g_irepository_get_search_path">
-        <doc xml:space="preserve">Returns the search path the GIRepository will use when looking for typelibs.
-The string is internal to GIRespository and should not be freed, nor should
-the elements.</doc>
+        <doc xml:space="preserve">Returns the current search path #GIRepository will use when loading
+typelib files. The list is internal to #GIRespository and should not
+be freed, nor should its string elements.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">list of strings</doc>
+          <doc xml:space="preserve">#GSList of strings</doc>
           <type name="GLib.SList" c:type="GSList*">
             <type name="filename"/>
           </type>
@@ -676,12 +730,16 @@ the elements.</doc>
       </function>
       <function name="prepend_search_path"
                 c:identifier="g_irepository_prepend_search_path">
+        <doc xml:space="preserve">Prepends @directory to the typelib search path.
+See g_irepository_get_search_path().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <parameter name="directory" transfer-ownership="none">
-            <type name="utf8" c:type="const char*"/>
+            <doc xml:space="preserve">directory name to prepend to the typelib
+  search path</doc>
+            <type name="filename" c:type="char*"/>
           </parameter>
         </parameters>
       </function>
@@ -698,8 +756,10 @@ available) for @namespace_ in this @repository.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">the repository</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -716,14 +776,17 @@ domain. Before calling this function for a particular namespace,
 you must call g_irepository_require() once to load the namespace, or
 otherwise ensure the namespace has already been loaded.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">#GIEnumInfo representing metadata about @domain's enum type, or %NULL</doc>
+          <doc xml:space="preserve">#GIEnumInfo representing metadata about @domain's
+enum type, or %NULL</doc>
           <type name="EnumInfo" c:type="GIEnumInfo*"/>
         </return-value>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="domain" transfer-ownership="none">
@@ -746,8 +809,10 @@ when you know the GType to originate from be from a loaded namespace.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="gtype" transfer-ownership="none">
@@ -768,8 +833,10 @@ ensure the namespace has already been loaded.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -796,8 +863,10 @@ such as g_irepository_require() before calling this function.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -808,14 +877,15 @@ such as g_irepository_require() before calling this function.</doc>
       </method>
       <method name="get_dependencies"
               c:identifier="g_irepository_get_dependencies">
-        <doc xml:space="preserve">Return an array of all (transitive) dependencies for namespace
-@namespace_, including version.  The returned strings are of the
-form &lt;code&gt;namespace-version&lt;/code&gt;.
+        <doc xml:space="preserve">Return an array of all (transitive) versioned dependencies for
+@namespace_. Returned strings are of the form
+&lt;code&gt;namespace-version&lt;/code&gt;.
 
-Note: The namespace must have already been loaded using a function
+Note: @namespace_ must have already been loaded using a function
 such as g_irepository_require() before calling this function.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">Zero-terminated string array of versioned dependencies</doc>
+          <doc xml:space="preserve">Zero-terminated string array of versioned
+  dependencies</doc>
           <array c:type="gchar**">
             <type name="utf8"/>
           </array>
@@ -823,8 +893,10 @@ such as g_irepository_require() before calling this function.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -846,8 +918,10 @@ entries.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -872,8 +946,10 @@ entries.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
         </parameters>
@@ -889,8 +965,10 @@ already been loaded before calling this function.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -915,8 +993,10 @@ such as g_irepository_require() before calling this function.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -930,7 +1010,7 @@ such as g_irepository_require() before calling this function.</doc>
         <doc xml:space="preserve">If namespace @namespace_ is loaded, return the full path to the
 .typelib file it was loaded from.  If the typelib for
 namespace @namespace_ was included in a shared library, return
-the special string "$lt;builtin$gt;".</doc>
+the special string "&amp;lt;builtin&amp;gt;".</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">Filesystem path (or $lt;builtin$gt;) if successful, %NULL if namespace is not loaded</doc>
           <type name="utf8" c:type="const gchar*"/>
@@ -938,8 +1018,10 @@ the special string "$lt;builtin$gt;".</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">Repository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -961,8 +1043,10 @@ such as g_irepository_require() before calling this function.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
@@ -985,15 +1069,20 @@ quickly as this function will if it has already been loaded.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">A #GIRepository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
             <doc xml:space="preserve">Namespace of interest</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="version" transfer-ownership="none" allow-none="1">
+          <parameter name="version"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">Required version, may be %NULL for latest</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -1002,17 +1091,25 @@ quickly as this function will if it has already been loaded.</doc>
       <method name="load_typelib"
               c:identifier="g_irepository_load_typelib"
               throws="1">
+        <doc xml:space="preserve">TODO</doc>
         <return-value transfer-ownership="none">
           <type name="utf8" c:type="const char*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="repository" transfer-ownership="none">
+          <instance-parameter name="repository"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="typelib" transfer-ownership="none">
+            <doc xml:space="preserve">TODO</doc>
             <type name="Typelib" c:type="GITypelib*"/>
           </parameter>
           <parameter name="flags" transfer-ownership="none">
+            <doc xml:space="preserve">TODO</doc>
             <type name="RepositoryLoadFlags" c:type="GIRepositoryLoadFlags"/>
           </parameter>
         </parameters>
@@ -1030,15 +1127,20 @@ not specified, the latest will be used.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">Repository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="namespace_" transfer-ownership="none">
             <doc xml:space="preserve">GI namespace to use, e.g. "Gtk"</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="version" transfer-ownership="none" allow-none="1">
+          <parameter name="version"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">Version of namespace, may be %NULL for latest</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -1063,8 +1165,10 @@ not specified, the latest will be used.</doc>
         <parameters>
           <instance-parameter name="repository"
                               transfer-ownership="none"
+                              nullable="1"
                               allow-none="1">
-            <doc xml:space="preserve">Repository, may be %NULL for the default</doc>
+            <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
+  process-global default #GIRepository</doc>
             <type name="Repository" c:type="GIRepository*"/>
           </instance-parameter>
           <parameter name="typelib_dir" transfer-ownership="none">
@@ -1075,7 +1179,10 @@ not specified, the latest will be used.</doc>
             <doc xml:space="preserve">GI namespace to use, e.g. "Gtk"</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="version" transfer-ownership="none" allow-none="1">
+          <parameter name="version"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">Version of namespace, may be %NULL for latest</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -1085,7 +1192,7 @@ not specified, the latest will be used.</doc>
           </parameter>
         </parameters>
       </method>
-      <field name="parent">
+      <field name="parent" readable="0" private="1">
         <type name="GObject.Object" c:type="GObject"/>
       </field>
       <field name="priv" readable="0" private="1">
@@ -1095,11 +1202,13 @@ not specified, the latest will be used.</doc>
     <record name="RepositoryClass"
             c:type="GIRepositoryClass"
             glib:is-gtype-struct-for="Repository">
-      <field name="parent">
+      <field name="parent" readable="0" private="1">
         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
       </field>
     </record>
     <enumeration name="RepositoryError" c:type="GIRepositoryError">
+      <doc xml:space="preserve">An error code used with #G_IREPOSITORY_ERROR in a #GError returned
+from a #GIRepository routine.</doc>
       <member name="typelib_not_found"
               value="0"
               c:identifier="G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND">
@@ -1108,26 +1217,28 @@ not specified, the latest will be used.</doc>
       <member name="namespace_mismatch"
               value="1"
               c:identifier="G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH">
-        <doc xml:space="preserve">the namespace does not match the requested namespace.</doc>
+        <doc xml:space="preserve">the namespace does not match the
+  requested namespace.</doc>
       </member>
       <member name="namespace_version_conflict"
               value="2"
               c:identifier="G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT">
-        <doc xml:space="preserve">the version of the typelib does not match the requested version.</doc>
+        <doc xml:space="preserve">the version of the
+  typelib does not match the requested version.</doc>
       </member>
       <member name="library_not_found"
               value="3"
               c:identifier="G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND">
-        <doc xml:space="preserve">the library used by the typelib could not be found.</doc>
+        <doc xml:space="preserve">the library used by the typelib
+  could not be found.</doc>
       </member>
     </enumeration>
     <bitfield name="RepositoryLoadFlags" c:type="GIRepositoryLoadFlags">
-      <doc xml:space="preserve">Flags that controlls how a typelib is loaded by
-GIRepositry, used by g_irepository_load_typelib().</doc>
+      <doc xml:space="preserve">Flags that control how a typelib is loaded.</doc>
       <member name="irepository_load_flag_lazy"
               value="1"
               c:identifier="G_IREPOSITORY_LOAD_FLAG_LAZY">
-        <doc xml:space="preserve">Load the types lazily.</doc>
+        <doc xml:space="preserve">Lazily load the typelib.</doc>
       </member>
     </bitfield>
     <record name="RepositoryPrivate"
@@ -1142,13 +1253,17 @@ can be freed.</doc>
         <doc xml:space="preserve">The argument is not of callback type.</doc>
       </member>
       <member name="call" value="1" c:identifier="GI_SCOPE_TYPE_CALL">
-        <doc xml:space="preserve">The callback and associated user_data is only used during the call to this function.</doc>
+        <doc xml:space="preserve">The callback and associated user_data is only
+used during the call to this function.</doc>
       </member>
       <member name="async" value="2" c:identifier="GI_SCOPE_TYPE_ASYNC">
-        <doc xml:space="preserve">The callback and associated user_data is only used until the callback is invoked, and the callback. is invoked always exactly once.</doc>
+        <doc xml:space="preserve">The callback and associated user_data is
+only used until the callback is invoked, and the callback.
+is invoked always exactly once.</doc>
       </member>
       <member name="notified" value="3" c:identifier="GI_SCOPE_TYPE_NOTIFIED">
-        <doc xml:space="preserve">The callback and and associated user_data is used until the caller is notfied via the destroy_notify.</doc>
+        <doc xml:space="preserve">The callback and and associated
+user_data is used until the caller is notfied via the destroy_notify.</doc>
       </member>
     </enumeration>
     <enumeration name="Transfer" c:type="GITransfer">
@@ -1163,15 +1278,24 @@ the items within the container itself. Each container is freed differently,
 check the documentation for the types themselves for information on how to
 free them.</doc>
       <member name="nothing" value="0" c:identifier="GI_TRANSFER_NOTHING">
-        <doc xml:space="preserve">transfer nothing from the callee (function or the type instance the property belongs to) to the caller. The callee retains the ownership of the transfer and the caller doesn't need to do anything to free up the resources of this transfer.</doc>
+        <doc xml:space="preserve">transfer nothing from the callee (function or the type
+instance the property belongs to) to the caller. The callee retains the
+ownership of the transfer and the caller doesn't need to do anything to free
+up the resources of this transfer.</doc>
       </member>
       <member name="container" value="1" c:identifier="GI_TRANSFER_CONTAINER">
-        <doc xml:space="preserve">transfer the container (list, array, hash table) from the callee to the caller. The callee retains the ownership of the individual items in the container and the caller has to free up the container resources (g_list_free()/g_hash_table_destroy() etc) of this transfer.</doc>
+        <doc xml:space="preserve">transfer the container (list, array, hash table) from
+the callee to the caller. The callee retains the ownership of the individual
+items in the container and the caller has to free up the container resources
+(g_list_free()/g_hash_table_destroy() etc) of this transfer.</doc>
       </member>
       <member name="everything"
               value="2"
               c:identifier="GI_TRANSFER_EVERYTHING">
-        <doc xml:space="preserve">transfer everything, eg the container and its contents from the callee to the caller. This is the case when the callee creates a copy of all the data it returns. The caller is responsible for cleaning up the container and item resources of this transfer.</doc>
+        <doc xml:space="preserve">transfer everything, eg the container and its
+contents from the callee to the caller. This is the case when the callee
+creates a copy of all the data it returns. The caller is responsible for
+cleaning up the container and item resources of this transfer.</doc>
       </member>
     </enumeration>
     <enumeration name="TypeTag" c:type="GITypeTag">
@@ -1219,7 +1343,8 @@ free them.</doc>
         <doc xml:space="preserve">a UTF-8 encoded string</doc>
       </member>
       <member name="filename" value="14" c:identifier="GI_TYPE_TAG_FILENAME">
-        <doc xml:space="preserve">a filename, encoded in the same encoding as the native filesystem is using.</doc>
+        <doc xml:space="preserve">a filename, encoded in the same encoding
+  as the native filesystem is using.</doc>
       </member>
       <member name="array" value="15" c:identifier="GI_TYPE_TAG_ARRAY">
         <doc xml:space="preserve">an array</doc>
@@ -1244,6 +1369,7 @@ free them.</doc>
       </member>
     </enumeration>
     <record name="Typelib" c:type="GITypelib" disguised="1">
+      <doc xml:space="preserve">TODO</doc>
       <method name="free" c:identifier="g_typelib_free">
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -1350,34 +1476,6 @@ free them.</doc>
         <doc xml:space="preserve">Includes a #GError</doc>
       </member>
     </bitfield>
-    <record name="_BaseInfoStub" c:type="_GIBaseInfoStub">
-      <field name="dummy1" readable="0" private="1">
-        <type name="gint32" c:type="gint32"/>
-      </field>
-      <field name="dummy2" readable="0" private="1">
-        <type name="gint32" c:type="gint32"/>
-      </field>
-      <field name="dummy3" readable="0" private="1">
-        <type name="gpointer" c:type="gpointer"/>
-      </field>
-      <field name="dummy4" readable="0" private="1">
-        <type name="gpointer" c:type="gpointer"/>
-      </field>
-      <field name="dummy5" readable="0" private="1">
-        <type name="gpointer" c:type="gpointer"/>
-      </field>
-      <field name="dummy6" readable="0" private="1">
-        <type name="guint32" c:type="guint32"/>
-      </field>
-      <field name="dummy7" readable="0" private="1">
-        <type name="guint32" c:type="guint32"/>
-      </field>
-      <field name="padding" readable="0" private="1">
-        <array zero-terminated="0" c:type="gpointer" fixed-size="4">
-          <type name="gpointer" c:type="gpointer"/>
-        </array>
-      </field>
-    </record>
     <function name="arg_info_get_closure"
               c:identifier="g_arg_info_get_closure">
       <doc xml:space="preserve">Obtain the index of the user data argument. This is only valid
@@ -1457,7 +1555,9 @@ the resources required to invoke it can be freed.
     <function name="arg_info_get_type" c:identifier="g_arg_info_get_type">
       <doc xml:space="preserve">Obtain the type information for @info.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIArgInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GITypeInfo holding the type
+  information for @info, free it with g_base_info_unref()
+  when done.</doc>
         <type name="TypeInfo" c:type="GITypeInfo*"/>
       </return-value>
       <parameters>
@@ -1486,7 +1586,8 @@ callee allocates; if this is %TRUE, then the caller must allocate.</doc>
     </function>
     <function name="arg_info_is_optional"
               c:identifier="g_arg_info_is_optional">
-      <doc xml:space="preserve">Obtain if the argument is optional.</doc>
+      <doc xml:space="preserve">Obtain if the argument is optional.  For 'out' arguments this means
+that you can pass %NULL in order to ignore the result.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE if it is an optional argument</doc>
         <type name="gboolean" c:type="gboolean"/>
@@ -1553,9 +1654,13 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
     </function>
     <function name="arg_info_may_be_null"
               c:identifier="g_arg_info_may_be_null">
-      <doc xml:space="preserve">Obtain if the argument accepts %NULL.</doc>
+      <doc xml:space="preserve">Obtain if the type of the argument includes the possibility of %NULL.
+For 'in' values this means that %NULL is a valid value.  For 'out'
+values, this means that %NULL may be returned.
+
+See also g_arg_info_is_optional().</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%TRUE if it accepts %NULL</doc>
+        <doc xml:space="preserve">%TRUE if the value may be %NULL</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -1568,6 +1673,7 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
     <function name="callable_info_can_throw_gerror"
               c:identifier="g_callable_info_can_throw_gerror"
               version="1.34">
+      <doc xml:space="preserve">TODO</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE if this #GICallableInfo can throw a #GError</doc>
         <type name="gboolean" c:type="gboolean"/>
@@ -1583,7 +1689,8 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
               c:identifier="g_callable_info_get_arg">
       <doc xml:space="preserve">Obtain information about a particular argument of this callable.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIArgInfo. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIArgInfo. Free it with
+g_base_info_unref() when done.</doc>
         <type name="ArgInfo" c:type="GIArgInfo*"/>
       </return-value>
       <parameters>
@@ -1612,6 +1719,21 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="callable_info_get_instance_ownership_transfer"
+              c:identifier="g_callable_info_get_instance_ownership_transfer">
+      <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>
+        <type name="Transfer" c:type="GITransfer"/>
+      </return-value>
+      <parameters>
+        <parameter name="info" transfer-ownership="none">
+          <doc xml:space="preserve">a #GICallableInfo</doc>
+          <type name="CallableInfo" c:type="GICallableInfo*"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="callable_info_get_n_args"
               c:identifier="g_callable_info_get_n_args">
       <doc xml:space="preserve">Obtain the number of arguments (both IN and OUT) for this callable.</doc>
@@ -1648,7 +1770,8 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
               c:identifier="g_callable_info_get_return_type">
       <doc xml:space="preserve">Obtain the return type of a callable item as a #GITypeInfo.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GITypeInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GITypeInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="TypeInfo" c:type="GITypeInfo*"/>
       </return-value>
       <parameters>
@@ -1661,35 +1784,45 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
     <function name="callable_info_invoke"
               c:identifier="g_callable_info_invoke"
               throws="1">
+      <doc xml:space="preserve">TODO</doc>
       <return-value transfer-ownership="none">
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
         <parameter name="info" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="CallableInfo" c:type="GICallableInfo*"/>
         </parameter>
         <parameter name="function" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
         <parameter name="in_args" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="Argument" c:type="const GIArgument*"/>
         </parameter>
         <parameter name="n_in_args" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="gint" c:type="int"/>
         </parameter>
         <parameter name="out_args" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="Argument" c:type="const GIArgument*"/>
         </parameter>
         <parameter name="n_out_args" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="gint" c:type="int"/>
         </parameter>
         <parameter name="return_value" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="Argument" c:type="GIArgument*"/>
         </parameter>
         <parameter name="is_method" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="gboolean" c:type="gboolean"/>
         </parameter>
         <parameter name="throws" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="gboolean" c:type="gboolean"/>
         </parameter>
       </parameters>
@@ -1707,6 +1840,7 @@ matches the number of arguments in the raw C method. For methods, there
 is one more C argument than is exposed by introspection: the "self"
 or "this" object.</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if @info is a method, %FALSE otherwise</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -1859,7 +1993,8 @@ The initialized @type must not be referenced after @info is deallocated.</doc>
               c:identifier="g_constant_info_get_type">
       <doc xml:space="preserve">Obtain the type of the constant as a #GITypeInfo.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GITypeInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GITypeInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="TypeInfo" c:type="GITypeInfo*"/>
       </return-value>
       <parameters>
@@ -1900,7 +2035,8 @@ Free the value with g_constant_info_free_value().</doc>
       <doc xml:space="preserve">Obtain the string form of the quark for the error domain associated with
 this enum, if any.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the string form of the error domain associated with this enum, or %NULL.</doc>
+        <doc xml:space="preserve">the string form of the error domain associated
+with this enum, or %NULL.</doc>
         <type name="utf8" c:type="const gchar*"/>
       </return-value>
       <parameters>
@@ -1915,7 +2051,8 @@ this enum, if any.</doc>
               version="1.29.17">
       <doc xml:space="preserve">Obtain an enum type method at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -1980,7 +2117,8 @@ may not match the sign of the type used by the C compiler.</doc>
     <function name="enum_info_get_value" c:identifier="g_enum_info_get_value">
       <doc xml:space="preserve">Obtain a value for this enumeration.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the enumeration value or %NULL if type tag is wrong, free the struct with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the enumeration value or %NULL if type tag is wrong,
+free the struct with g_base_info_unref() when done.</doc>
         <type name="ValueInfo" c:type="GIValueInfo*"/>
       </return-value>
       <parameters>
@@ -1997,7 +2135,7 @@ may not match the sign of the type used by the C compiler.</doc>
     <function name="field_info_get_field"
               c:identifier="g_field_info_get_field"
               introspectable="0">
-      <doc xml:space="preserve">Reads a field identified by a #GFieldInfo from a C structure or
+      <doc xml:space="preserve">Reads a field identified by a #GIFieldInfo from a C structure or
 union.  This only handles fields of simple C types. It will fail
 for a field of a composite type like a nested structure or union
 even if that is actually readable.</doc>
@@ -2067,7 +2205,8 @@ much space you need to allocate to store the field.</doc>
     <function name="field_info_get_type" c:identifier="g_field_info_get_type">
       <doc xml:space="preserve">Obtain the type of a field as a #GITypeInfo.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GITypeInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GITypeInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="TypeInfo" c:type="GITypeInfo*"/>
       </return-value>
       <parameters>
@@ -2080,7 +2219,7 @@ much space you need to allocate to store the field.</doc>
     <function name="field_info_set_field"
               c:identifier="g_field_info_set_field"
               introspectable="0">
-      <doc xml:space="preserve">Writes a field identified by a #GFieldInfo to a C structure or
+      <doc xml:space="preserve">Writes a field identified by a #GIFieldInfo to a C structure or
 union.  This only handles fields of simple C types. It will fail
 for a field of a composite type like a nested structure or union
 even if that is actually writable. Note also that that it will refuse
@@ -2126,7 +2265,8 @@ Only #GIFunctionInfo with the flag %GI_FUNCTION_IS_GETTER or
 %GI_FUNCTION_IS_SETTER have a property set. For other cases,
 %NULL will be returned.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the property or %NULL if not set. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the property or %NULL if not set. Free it with
+g_base_info_unref() when done.</doc>
         <type name="PropertyInfo" c:type="GIPropertyInfo*"/>
       </return-value>
       <parameters>
@@ -2158,7 +2298,8 @@ g_module_symbol().</doc>
 Only #GIFunctionInfo with the flag %GI_FUNCTION_WRAPS_VFUNC has
 a virtual function set. For other cases, %NULL will be returned.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the virtual function or %NULL if not set. Free it by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the virtual function or %NULL if not set.
+Free it by calling g_base_info_unref() when done.</doc>
         <type name="VFuncInfo" c:type="GIVFuncInfo*"/>
       </return-value>
       <parameters>
@@ -2179,7 +2320,8 @@ to the function, so the library or shared object containing the
 described function must either be linked to the caller, or must
 have been g_module_symbol()&lt;!-- --&gt;ed before calling this function.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%TRUE if the function has been invoked, %FALSE if an error occurred.</doc>
+        <doc xml:space="preserve">%TRUE if the function has been invoked, %FALSE if an
+  error occurred.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -2188,7 +2330,9 @@ have been g_module_symbol()&lt;!-- --&gt;ed before calling this function.</doc>
           <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
         </parameter>
         <parameter name="in_args" transfer-ownership="none">
-          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each in parameter of @info. If there are no in parameter, @in_args can be %NULL</doc>
+          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each in
+   parameter of @info. If there are no in parameter, @in_args
+   can be %NULL</doc>
           <type name="Argument" c:type="const GIArgument*"/>
         </parameter>
         <parameter name="n_in_args" transfer-ownership="none">
@@ -2196,7 +2340,9 @@ have been g_module_symbol()&lt;!-- --&gt;ed before calling this function.</doc>
           <type name="gint" c:type="int"/>
         </parameter>
         <parameter name="out_args" transfer-ownership="none">
-          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each out parameter of @info. If there are no out parameters, @out_args may be %NULL</doc>
+          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each out
+   parameter of @info. If there are no out parameters, @out_args
+   may be %NULL</doc>
           <type name="Argument" c:type="const GIArgument*"/>
         </parameter>
         <parameter name="n_out_args" transfer-ownership="none">
@@ -2204,26 +2350,34 @@ have been g_module_symbol()&lt;!-- --&gt;ed before calling this function.</doc>
           <type name="gint" c:type="int"/>
         </parameter>
         <parameter name="return_value" transfer-ownership="none">
-          <doc xml:space="preserve">return location for the return value of the function. If the function returns void, @return_value may be %NULL</doc>
+          <doc xml:space="preserve">return location for the return value of the
+   function. If the function returns void, @return_value may be
+   %NULL</doc>
           <type name="Argument" c:type="GIArgument*"/>
         </parameter>
       </parameters>
     </function>
     <function name="info_new" c:identifier="g_info_new">
+      <doc xml:space="preserve">TODO</doc>
       <return-value transfer-ownership="full">
+        <doc xml:space="preserve">TODO</doc>
         <type name="BaseInfo" c:type="GIBaseInfo*"/>
       </return-value>
       <parameters>
         <parameter name="type" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="InfoType" c:type="GIInfoType"/>
         </parameter>
         <parameter name="container" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="BaseInfo" c:type="GIBaseInfo*"/>
         </parameter>
         <parameter name="typelib" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="Typelib" c:type="GITypelib*"/>
         </parameter>
         <parameter name="offset" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="guint32" c:type="guint32"/>
         </parameter>
       </parameters>
@@ -2246,7 +2400,8 @@ have been g_module_symbol()&lt;!-- --&gt;ed before calling this function.</doc>
       <doc xml:space="preserve">Obtain a method of the interface type given a @name. %NULL will be
 returned if there's no method available with that name.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo or %NULL if none found. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo or %NULL if none found.
+Free the struct by calling g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -2263,8 +2418,10 @@ returned if there's no method available with that name.</doc>
     <function name="interface_info_find_signal"
               c:identifier="g_interface_info_find_signal"
               version="1.34">
+      <doc xml:space="preserve">TODO</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">Info for the signal with name @name in @info, or %NULL on failure.</doc>
+        <doc xml:space="preserve">Info for the signal with name @name in @info, or
+%NULL on failure.</doc>
         <type name="SignalInfo" c:type="GISignalInfo*"/>
       </return-value>
       <parameters>
@@ -2283,7 +2440,8 @@ returned if there's no method available with that name.</doc>
       <doc xml:space="preserve">Locate a virtual function slot with name @name. See the documentation
 for g_object_info_find_vfunc() for more information on virtuals.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIVFuncInfo, or %NULL. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIVFuncInfo, or %NULL. Free it with
+g_base_info_unref() when done.</doc>
         <type name="VFuncInfo" c:type="GIVFuncInfo*"/>
       </return-value>
       <parameters>
@@ -2301,7 +2459,8 @@ for g_object_info_find_vfunc() for more information on virtuals.</doc>
               c:identifier="g_interface_info_get_constant">
       <doc xml:space="preserve">Obtain an interface type constant at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIConstantInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIConstantInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="ConstantInfo" c:type="GIConstantInfo*"/>
       </return-value>
       <parameters>
@@ -2319,7 +2478,8 @@ for g_object_info_find_vfunc() for more information on virtuals.</doc>
               c:identifier="g_interface_info_get_iface_struct">
       <doc xml:space="preserve">Returns the layout C structure associated with this #GInterface.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIStructInfo or %NULL. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIStructInfo or %NULL. Free it with
+g_base_info_unref() when done.</doc>
         <type name="StructInfo" c:type="GIStructInfo*"/>
       </return-value>
       <parameters>
@@ -2333,7 +2493,8 @@ for g_object_info_find_vfunc() for more information on virtuals.</doc>
               c:identifier="g_interface_info_get_method">
       <doc xml:space="preserve">Obtain an interface type method at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -2437,7 +2598,8 @@ interface, similar to an base class for GObjects.</doc>
               c:identifier="g_interface_info_get_prerequisite">
       <doc xml:space="preserve">Obtain an interface type prerequisites index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the prerequisites as a #GIBaseInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the prerequisites as a #GIBaseInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="BaseInfo" c:type="GIBaseInfo*"/>
       </return-value>
       <parameters>
@@ -2455,7 +2617,8 @@ interface, similar to an base class for GObjects.</doc>
               c:identifier="g_interface_info_get_property">
       <doc xml:space="preserve">Obtain an interface type property at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIPropertyInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIPropertyInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="PropertyInfo" c:type="GIPropertyInfo*"/>
       </return-value>
       <parameters>
@@ -2473,7 +2636,8 @@ interface, similar to an base class for GObjects.</doc>
               c:identifier="g_interface_info_get_signal">
       <doc xml:space="preserve">Obtain an interface type signal at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GISignalInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GISignalInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="SignalInfo" c:type="GISignalInfo*"/>
       </return-value>
       <parameters>
@@ -2491,7 +2655,8 @@ interface, similar to an base class for GObjects.</doc>
               c:identifier="g_interface_info_get_vfunc">
       <doc xml:space="preserve">Obtain an interface type virtual function at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIVFuncInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIVFuncInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="VFuncInfo" c:type="GIVFuncInfo*"/>
       </return-value>
       <parameters>
@@ -2506,7 +2671,9 @@ interface, similar to an base class for GObjects.</doc>
       </parameters>
     </function>
     <function name="invoke_error_quark" c:identifier="g_invoke_error_quark">
+      <doc xml:space="preserve">TODO</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">TODO</doc>
         <type name="GLib.Quark" c:type="GQuark"/>
       </return-value>
     </function>
@@ -2519,12 +2686,14 @@ g_function_info_invoke().</doc>
       <member name="symbol_not_found"
               value="1"
               c:identifier="G_INVOKE_ERROR_SYMBOL_NOT_FOUND">
-        <doc xml:space="preserve">symbol couldn't be found in any of the libraries associated with the typelib of the function.</doc>
+        <doc xml:space="preserve">symbol couldn't be found in any of the
+libraries associated with the typelib of the function.</doc>
       </member>
       <member name="argument_mismatch"
               value="2"
               c:identifier="G_INVOKE_ERROR_ARGUMENT_MISMATCH">
-        <doc xml:space="preserve">the arguments provided didn't match the expected arguments for the functions type signature.</doc>
+        <doc xml:space="preserve">the arguments provided didn't match
+the expected arguments for the functions type signature.</doc>
       </member>
     </enumeration>
     <function name="object_info_find_method"
@@ -2532,7 +2701,8 @@ g_function_info_invoke().</doc>
       <doc xml:space="preserve">Obtain a method of the object type given a @name. %NULL will be
 returned if there's no method available with that name.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -2555,7 +2725,8 @@ returned if there's no method available with that name.
 Note that this function does *not* search parent classes; you will have
 to chain up if that's desired.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -2577,9 +2748,9 @@ to chain up if that's desired.</doc>
       </parameters>
     </function>
     <function name="object_info_find_signal"
-              c:identifier="g_object_info_find_signal"
-              introspectable="0">
-      <return-value>
+              c:identifier="g_object_info_find_signal">
+      <doc xml:space="preserve">TODO</doc>
+      <return-value transfer-ownership="full">
         <doc xml:space="preserve">Info for the signal with name @name in @info, or %NULL on failure.</doc>
         <type name="SignalInfo" c:type="GISignalInfo*"/>
       </return-value>
@@ -2604,7 +2775,8 @@ returned.
 See the documentation for g_vfunc_info_get_invoker() for more
 information on invoking virtuals.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIVFuncInfo, or %NULL. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIVFuncInfo, or %NULL. Free it with
+g_base_info_unref() when done.</doc>
         <type name="VFuncInfo" c:type="GIVFuncInfo*"/>
       </return-value>
       <parameters>
@@ -2630,7 +2802,8 @@ returned.
 Note that this function does *not* search parent classes; you will have
 to chain up if that's desired.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="VFuncInfo" c:type="GIVFuncInfo*"/>
       </return-value>
       <parameters>
@@ -2671,7 +2844,8 @@ instantiated</doc>
       <doc xml:space="preserve">Every #GObject has two structures; an instance structure and a class
 structure.  This function returns the metadata for the class structure.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIStructInfo or %NULL. Free with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIStructInfo or %NULL. Free with
+g_base_info_unref() when done.</doc>
         <type name="StructInfo" c:type="GIStructInfo*"/>
       </return-value>
       <parameters>
@@ -2685,7 +2859,8 @@ structure.  This function returns the metadata for the class structure.</doc>
               c:identifier="g_object_info_get_constant">
       <doc xml:space="preserve">Obtain an object type constant at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIConstantInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIConstantInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="ConstantInfo" c:type="GIConstantInfo*"/>
       </return-value>
       <parameters>
@@ -2703,7 +2878,8 @@ structure.  This function returns the metadata for the class structure.</doc>
               c:identifier="g_object_info_get_field">
       <doc xml:space="preserve">Obtain an object type field at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFieldInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFieldInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="FieldInfo" c:type="GIFieldInfo*"/>
       </return-value>
       <parameters>
@@ -2773,7 +2949,8 @@ the base classes of this type, starting at the top type.</doc>
               c:identifier="g_object_info_get_interface">
       <doc xml:space="preserve">Obtain an object type interface at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIInterfaceInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIInterfaceInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="InterfaceInfo" c:type="GIInterfaceInfo*"/>
       </return-value>
       <parameters>
@@ -2791,7 +2968,8 @@ the base classes of this type, starting at the top type.</doc>
               c:identifier="g_object_info_get_method">
       <doc xml:space="preserve">Obtain an object type method at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -2907,7 +3085,8 @@ the base classes of this type, starting at the top type.</doc>
               c:identifier="g_object_info_get_parent">
       <doc xml:space="preserve">Obtain the parent of the object type.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIObjectInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIObjectInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="ObjectInfo" c:type="GIObjectInfo*"/>
       </return-value>
       <parameters>
@@ -2921,7 +3100,8 @@ the base classes of this type, starting at the top type.</doc>
               c:identifier="g_object_info_get_property">
       <doc xml:space="preserve">Obtain an object type property at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIPropertyInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIPropertyInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="PropertyInfo" c:type="GIPropertyInfo*"/>
       </return-value>
       <parameters>
@@ -3011,7 +3191,8 @@ the base classes of this type, starting at the top type.</doc>
               c:identifier="g_object_info_get_signal">
       <doc xml:space="preserve">Obtain an object type signal at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GISignalInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GISignalInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="SignalInfo" c:type="GISignalInfo*"/>
       </return-value>
       <parameters>
@@ -3094,7 +3275,8 @@ the base classes of this type, starting at the top type.</doc>
               c:identifier="g_object_info_get_vfunc">
       <doc xml:space="preserve">Obtain an object type virtual function at index @n.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIVFuncInfo. Free the struct by calling g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIVFuncInfo. Free the struct by calling
+g_base_info_unref() when done.</doc>
         <type name="VFuncInfo" c:type="GIVFuncInfo*"/>
       </return-value>
       <parameters>
@@ -3110,7 +3292,7 @@ the base classes of this type, starting at the top type.</doc>
     </function>
     <function name="property_info_get_flags"
               c:identifier="g_property_info_get_flags">
-      <doc xml:space="preserve">Obtain the flags for this property info. See #GParamFags for
+      <doc xml:space="preserve">Obtain the flags for this property info. See #GParamFlags for
 more information about possible flag values.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the flags</doc>
@@ -3142,7 +3324,8 @@ information about transfer values.</doc>
               c:identifier="g_property_info_get_type">
       <doc xml:space="preserve">Obtain the type information for the property @info.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GITypeInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GITypeInfo, free it with
+g_base_info_unref() when done.</doc>
         <type name="TypeInfo" c:type="GITypeInfo*"/>
       </return-value>
       <parameters>
@@ -3176,7 +3359,8 @@ function which will register the GType within the GObject type system.
 Usually this is not called by langauge bindings or applications, use
 g_registered_type_info_get_g_type() directly instead.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the symbol name of the type init function, suitable for passing into g_module_symbol().</doc>
+        <doc xml:space="preserve">the symbol name of the type init function, suitable for
+passing into g_module_symbol().</doc>
         <type name="utf8" c:type="const gchar*"/>
       </return-value>
       <parameters>
@@ -3251,7 +3435,8 @@ stop the emission of the signal.</doc>
               c:identifier="g_struct_info_find_method">
       <doc xml:space="preserve">Obtain the type information for method named @name.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -3283,7 +3468,8 @@ stop the emission of the signal.</doc>
               c:identifier="g_struct_info_get_field">
       <doc xml:space="preserve">Obtain the type information for field with specified index.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFieldInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFieldInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="FieldInfo" c:type="GIFieldInfo*"/>
       </return-value>
       <parameters>
@@ -3301,7 +3487,8 @@ stop the emission of the signal.</doc>
               c:identifier="g_struct_info_get_method">
       <doc xml:space="preserve">Obtain the type information for method with specified index.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -3359,11 +3546,14 @@ stop the emission of the signal.</doc>
     </function>
     <function name="struct_info_is_foreign"
               c:identifier="g_struct_info_is_foreign">
+      <doc xml:space="preserve">TODO</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">TODO</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
         <parameter name="info" transfer-ownership="none">
+          <doc xml:space="preserve">TODO</doc>
           <type name="StructInfo" c:type="GIStructInfo*"/>
         </parameter>
       </parameters>
@@ -3437,7 +3627,8 @@ this function returns full information about the referenced type.  You can then
 inspect the type of the returned #GIBaseInfo to further query whether it is
 a concrete GObject, a GInterface, a structure, etc. using g_base_info_get_type().</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIBaseInfo, or %NULL. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIBaseInfo, or %NULL. Free it with
+g_base_info_unref() when done.</doc>
         <type name="BaseInfo" c:type="GIBaseInfo*"/>
       </return-value>
       <parameters>
@@ -3525,7 +3716,8 @@ of type tags.</doc>
               c:identifier="g_union_info_find_method">
       <doc xml:space="preserve">Obtain the type information for method named @name.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -3559,7 +3751,8 @@ of type tags.</doc>
 union field is the active one if discriminator contains this
 constant.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIConstantInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIConstantInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="ConstantInfo" c:type="GIConstantInfo*"/>
       </return-value>
       <parameters>
@@ -3575,11 +3768,14 @@ constant.</doc>
     </function>
     <function name="union_info_get_discriminator_offset"
               c:identifier="g_union_info_get_discriminator_offset">
-      <return-value transfer-ownership="none">
+      <doc xml:space="preserve">Returns offset of the discriminator field in the structure.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">offset in bytes of the discriminator</doc>
         <type name="gint" c:type="gint"/>
       </return-value>
       <parameters>
         <parameter name="info" transfer-ownership="none">
+          <doc xml:space="preserve">a #GIUnionInfo</doc>
           <type name="UnionInfo" c:type="GIUnionInfo*"/>
         </parameter>
       </parameters>
@@ -3588,7 +3784,8 @@ constant.</doc>
               c:identifier="g_union_info_get_discriminator_type">
       <doc xml:space="preserve">Obtain the type information of the union discriminator.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GITypeInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GITypeInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="TypeInfo" c:type="GITypeInfo*"/>
       </return-value>
       <parameters>
@@ -3602,7 +3799,8 @@ constant.</doc>
               c:identifier="g_union_info_get_field">
       <doc xml:space="preserve">Obtain the type information for field with specified index.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFieldInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFieldInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="FieldInfo" c:type="GIFieldInfo*"/>
       </return-value>
       <parameters>
@@ -3620,7 +3818,8 @@ constant.</doc>
               c:identifier="g_union_info_get_method">
       <doc xml:space="preserve">Obtain the type information for method with specified index.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIFunctionInfo, free it with g_base_info_unref()
+when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -3693,7 +3892,9 @@ constant.</doc>
               c:identifier="g_value_info_get_value">
       <doc xml:space="preserve">Obtain the enumeration value of the #GIValueInfo.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the enumeration value. This will always be representable as a 32-bit signed or unsigned value. The use of gint64 as the return type is to allow both.</doc>
+        <doc xml:space="preserve">the enumeration value. This will always be representable
+  as a 32-bit signed or unsigned value. The use of gint64 as the
+  return type is to allow both.</doc>
         <type name="gint64" c:type="gint64"/>
       </return-value>
       <parameters>
@@ -3746,7 +3947,8 @@ method will return it.  An invoker method is a C entry point.
 
 Not all virtuals will have invokers.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the #GIVFuncInfo or %NULL. Free it with g_base_info_unref() when done.</doc>
+        <doc xml:space="preserve">the #GIVFuncInfo or %NULL. Free it with
+g_base_info_unref() when done.</doc>
         <type name="FunctionInfo" c:type="GIFunctionInfo*"/>
       </return-value>
       <parameters>
@@ -3795,7 +3997,8 @@ this virtual function belongs.</doc>
 arguments. Note that inout parameters must appear in both
 argument lists.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%TRUE if the function has been invoked, %FALSE if an error occurred.</doc>
+        <doc xml:space="preserve">%TRUE if the function has been invoked, %FALSE if an
+  error occurred.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -3808,7 +4011,9 @@ argument lists.</doc>
           <type name="GType" c:type="GType"/>
         </parameter>
         <parameter name="in_args" transfer-ownership="none">
-          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each in parameter of @info. If there are no in parameter, @in_args can be %NULL</doc>
+          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each in
+   parameter of @info. If there are no in parameter, @in_args
+   can be %NULL</doc>
           <type name="Argument" c:type="const GIArgument*"/>
         </parameter>
         <parameter name="n_in_args" transfer-ownership="none">
@@ -3816,7 +4021,9 @@ argument lists.</doc>
           <type name="gint" c:type="int"/>
         </parameter>
         <parameter name="out_args" transfer-ownership="none">
-          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each out parameter of @info. If there are no out parameters, @out_args may be %NULL</doc>
+          <doc xml:space="preserve">an array of #GIArgument&lt;!-- --&gt;s, one for each out
+   parameter of @info. If there are no out parameters, @out_args
+   may be %NULL</doc>
           <type name="Argument" c:type="const GIArgument*"/>
         </parameter>
         <parameter name="n_out_args" transfer-ownership="none">
@@ -3824,7 +4031,9 @@ argument lists.</doc>
           <type name="gint" c:type="int"/>
         </parameter>
         <parameter name="return_value" transfer-ownership="none">
-          <doc xml:space="preserve">return location for the return value of the function. If the function returns void, @return_value may be %NULL</doc>
+          <doc xml:space="preserve">return location for the return value of the
+   function. If the function returns void, @return_value may be
+   %NULL</doc>
           <type name="Argument" c:type="GIArgument*"/>
         </parameter>
       </parameters>