RubyGems - gstreamer - Versions diffs - 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32 - Mend

gstreamer 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32

Files changed (2033) hide show

data/vendor/local/lib/pkgconfig/gstreamer-rtsp-1.0.pc CHANGED Viewed

@@ -10,7 +10,7 @@ typelibdir=${libdir}/girepository-1.0
 Name: GStreamer RTSP Library
 Description: RTSP base classes and helper functions
 Requires: gstreamer-1.0 gstreamer-sdp-1.0 gio-2.0
-Version: 1.5.2
+Version: 1.8.0
 Libs: -L${libdir} -lgstrtsp-1.0
 Cflags: -I${includedir}

data/vendor/local/lib/pkgconfig/gstreamer-sdp-1.0.pc CHANGED Viewed

@@ -11,7 +11,7 @@ Name: GStreamer SDP Library
 Description: SDP helper functions
 Requires: glib-2.0
 Requires.private: gio-2.0
-Version: 1.5.2
+Version: 1.8.0
 Libs: -L${libdir} -lgstsdp-1.0
 Cflags: -I${includedir}

data/vendor/local/lib/pkgconfig/gstreamer-tag-1.0.pc CHANGED Viewed

@@ -10,7 +10,7 @@ typelibdir=${libdir}/girepository-1.0
 Name: GStreamer Tag Library
 Description: Tag base classes and helper functions
 Requires: gstreamer-1.0
-Version: 1.5.2
+Version: 1.8.0
 Libs: -L${libdir} -lgsttag-1.0
 Cflags: -I${includedir}

data/vendor/local/lib/pkgconfig/gstreamer-video-1.0.pc CHANGED Viewed

@@ -10,7 +10,7 @@ typelibdir=${libdir}/girepository-1.0
 Name: GStreamer Video Library
 Description: Video base classes and helper functions
 Requires: gstreamer-1.0 gstreamer-base-1.0
-Version: 1.5.2
+Version: 1.8.0
 Libs: -L${libdir} -lgstvideo-1.0
 Cflags: -I${includedir}

data/vendor/local/lib/pkgconfig/libsoup-2.4.pc CHANGED Viewed

@@ -5,7 +5,7 @@ includedir=${prefix}/include
 Name: libsoup
 Description: a glib-based HTTP library
-Version: 2.50.0
+Version: 2.54.0.1
 Requires: glib-2.0 gobject-2.0 gio-2.0
 Requires.private: libxml-2.0
 Libs: -L${libdir} -lsoup-2.4

data/vendor/local/lib/pkgconfig/opus.pc CHANGED Viewed

@@ -8,7 +8,7 @@ includedir=${prefix}/include
 Name: Opus
 Description: Opus IETF audio codec (floating-point build)
 URL: http://opus-codec.org/
-Version: 1.1
+Version: 1.1.2
 Requires:
 Conflicts:
 Libs: -L${libdir} -lopus

data/vendor/local/lib/pkgconfig/sqlite3.pc CHANGED Viewed

@@ -7,7 +7,7 @@ includedir=${prefix}/include
 Name: SQLite
 Description: SQL database engine
-Version: 3.8.11.1
+Version: 3.12.0
 Libs: -L${libdir} -lsqlite3
 Libs.private: -lpthread
 Cflags: -I${includedir}

data/vendor/local/libexec/gstreamer-1.0/gst-plugin-scanner.exe CHANGED Viewed

Binary file

data/vendor/local/share/bash-completion/helpers/gst-completion-helper-1.0.exe CHANGED Viewed

Binary file

data/vendor/local/share/gir-1.0/Gst-1.0.gir CHANGED Viewed

@@ -292,7 +292,7 @@ use an alignment of 7.</doc>
       <field name="mem_type">
         <type name="utf8" c:type="const gchar*"/>
       </field>
-      <field name="mem_map" introspectable="0">
+      <field name="mem_map">
         <doc xml:space="preserve">the implementation of the GstMemoryMapFunction</doc>
         <type name="MemoryMapFunction" c:type="GstMemoryMapFunction"/>
       </field>
@@ -312,7 +312,7 @@ use an alignment of 7.</doc>
         <doc xml:space="preserve">the implementation of the GstMemoryIsSpanFunction</doc>
         <type name="MemoryIsSpanFunction" c:type="GstMemoryIsSpanFunction"/>
       </field>
-      <field name="mem_map_full" introspectable="0">
+      <field name="mem_map_full">
         <doc xml:space="preserve">the implementation of the GstMemoryMapFullFunction.
      Will be used instead of @mem_map if present. (Since 1.6)</doc>
         <type name="MemoryMapFullFunction" c:type="GstMemoryMapFullFunction"/>
@@ -461,7 +461,7 @@ nearest power of 2 and used as the initial size of the queue.</doc>
       </method>
       <method name="pop" c:identifier="gst_atomic_queue_pop">
         <doc xml:space="preserve">Get the head element of the queue.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the head element of @queue or %NULL when
 the queue is empty.</doc>
           <type name="gpointer" c:type="gpointer"/>
@@ -483,7 +483,10 @@ the queue is empty.</doc>
             <doc xml:space="preserve">a #GstAtomicQueue</doc>
             <type name="AtomicQueue" c:type="GstAtomicQueue*"/>
           </instance-parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -1374,7 +1377,7 @@ Buffers are usually created with gst_buffer_new(). After a buffer has been
 created one will typically allocate memory for it and add it to the buffer.
 The following example creates a buffer that can hold a given video frame
 with a given width, height and bits per plane.
-|[
+|[&lt;!-- language="C" --&gt;
   GstBuffer *buffer;
   GstMemory *memory;
   gint size, width, height, bpp;
@@ -1630,7 +1633,10 @@ The prefix/padding must be filled with 0 if @flags contains
             <doc xml:space="preserve">a #GstMetaInfo</doc>
             <type name="MetaInfo" c:type="const GstMetaInfo*"/>
           </parameter>
-          <parameter name="params" transfer-ownership="none">
+          <parameter name="params"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">params for @info</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -1849,7 +1855,10 @@ MT safe.</doc>
             <doc xml:space="preserve">the offset to extract</doc>
             <type name="gsize" c:type="gsize"/>
           </parameter>
-          <parameter name="dest" transfer-ownership="none">
+          <parameter name="dest"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the destination address</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -1862,8 +1871,8 @@ MT safe.</doc>
       <method name="extract_dup"
               c:identifier="gst_buffer_extract_dup"
               version="1.0.10">
-        <doc xml:space="preserve">Extracts a copy of at most @size bytes the data at @offset into a #GBytes.
-@dest must be freed using g_free() when done.</doc>
+        <doc xml:space="preserve">Extracts a copy of at most @size bytes the data at @offset into
+newly-allocated memory. @dest must be freed using g_free() when done.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -2002,7 +2011,10 @@ in the buffer should be skipped.</doc>
             <type name="BufferForeachMetaFunc"
                   c:type="GstBufferForeachMetaFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -2271,7 +2283,10 @@ when there are no more items.</doc>
             <doc xml:space="preserve">a #GstBuffer</doc>
             <type name="Buffer" c:type="GstBuffer*"/>
           </instance-parameter>
-          <parameter name="state" transfer-ownership="none">
+          <parameter name="state"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">an opaque state pointer</doc>
             <type name="gpointer" c:type="gpointer*"/>
           </parameter>
@@ -2414,7 +2429,7 @@ data.</doc>
       <method name="n_memory" c:identifier="gst_buffer_n_memory">
         <doc xml:space="preserve">Get the amount of memory blocks that this buffer has. This amount is never
 larger than what gst_buffer_get_max_memory() returns.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
           <doc xml:space="preserve">the amount of memory block in this buffer.</doc>
           <type name="guint" c:type="guint"/>
         </return-value>
@@ -2882,7 +2897,11 @@ When @meta is set to %NULL, the item will be removed from the buffer.</doc>
           <doc xml:space="preserve">a pointer to a #GstMeta</doc>
           <type name="Meta" c:type="GstMeta**"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data passed to gst_buffer_foreach_meta()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -2969,7 +2988,10 @@ the list should be skipped.</doc>
             <doc xml:space="preserve">a #GstBufferListFunc to call</doc>
             <type name="BufferListFunc" c:type="GstBufferListFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -3080,7 +3102,11 @@ removing or modifying.</doc>
           <doc xml:space="preserve">the index of @buffer</doc>
           <type name="guint" c:type="guint"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data passed to gst_buffer_list_foreach()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -3169,12 +3195,22 @@ The supported options by @pool can be retrieved with gst_buffer_pool_get_options
             <doc xml:space="preserve">a #GstBufferPool configuration</doc>
             <type name="Structure" c:type="GstStructure*"/>
           </parameter>
-          <parameter name="allocator" transfer-ownership="none">
-            <doc xml:space="preserve">a #GstAllocator</doc>
+          <parameter name="allocator"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GstAllocator, or %NULL</doc>
             <type name="Allocator" c:type="GstAllocator**"/>
           </parameter>
-          <parameter name="params" transfer-ownership="none">
-            <doc xml:space="preserve">#GstAllocationParams</doc>
+          <parameter name="params"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">#GstAllocationParams, or %NULL</doc>
             <type name="AllocationParams" c:type="GstAllocationParams*"/>
           </parameter>
         </parameters>
@@ -4231,6 +4267,8 @@ This function is used to receive asynchronous messages in the main loop.
 There can only be a single bus watch per bus, you must remove it before you
 can set a new one.
+The bus watch will only work if a GLib main loop is being run.
 The watch can be removed using gst_bus_remove_watch() or by returning %FALSE
 from @func. If the watch was added to the default main context it is also
 possible to remove the watch using g_source_remove().</doc>
@@ -4249,7 +4287,10 @@ MT safe.</doc>
             <doc xml:space="preserve">A function to call when a message is received.</doc>
             <type name="BusFunc" c:type="GstBusFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @func.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4268,6 +4309,8 @@ This function is used to receive asynchronous messages in the main loop.
 There can only be a single bus watch per bus, you must remove it before you
 can set a new one.
+The bus watch will only work if a GLib main loop is being run.
 When @func is called, the message belongs to the caller; if you want to
 keep a copy of it, call gst_message_ref() before leaving @func.
@@ -4297,7 +4340,10 @@ MT safe.</doc>
             <doc xml:space="preserve">A function to call when a message is received.</doc>
             <type name="BusFunc" c:type="GstBusFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @func.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4324,7 +4370,10 @@ into signals.</doc>
             <doc xml:space="preserve">the #GstMessage received</doc>
             <type name="Message" c:type="GstMessage*"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4633,7 +4682,10 @@ function, which will clear the existing handler.</doc>
             <doc xml:space="preserve">The handler function to install</doc>
             <type name="BusSyncHandler" c:type="GstBusSyncHandler"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">User data that will be sent to the handler function.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4660,7 +4712,10 @@ messages into signals.</doc>
             <doc xml:space="preserve">the #GstMessage received</doc>
             <type name="Message" c:type="GstMessage*"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4858,7 +4913,11 @@ Note that this function is used as a GSourceFunc which means that returning
           <doc xml:space="preserve">the #GstMessage</doc>
           <type name="Message" c:type="GstMessage*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data that has been given, when registering the handler</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -4886,7 +4945,11 @@ message should not be unreffed by the sync handler.</doc>
           <doc xml:space="preserve">the #GstMessage</doc>
           <type name="Message" c:type="GstMessage*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data that has been given, when registering the handler</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -4947,7 +5010,7 @@ function. This function describes the possible types that the pad can
 handle or produce at runtime.
 A #GstCaps can be constructed with the following code fragment:
-|[
+|[&lt;!-- language="C" --&gt;
   GstCaps *caps = gst_caps_new_simple ("video/x-raw",
      "format", G_TYPE_STRING, "I420",
      "framerate", GST_TYPE_FRACTION, 25, 1,
@@ -5196,7 +5259,10 @@ The caps must be mutable.</doc>
             <doc xml:space="preserve">a function to call for each field</doc>
             <type name="CapsFilterMapFunc" c:type="GstCapsFilterMapFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">private data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -5205,7 +5271,11 @@ The caps must be mutable.</doc>
       <method name="fixate" c:identifier="gst_caps_fixate">
         <doc xml:space="preserve">Modifies the given @caps into a representation with only fixed
 values. First the caps will be truncated and then the first structure will be
-fixated with gst_structure_fixate().</doc>
+fixated with gst_structure_fixate().
+This function takes ownership of @caps and will call gst_caps_make_writable()
+on it so you must not use @caps afterwards unless you keep an additional
+reference to it with gst_caps_ref().</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the fixated caps</doc>
           <type name="Caps" c:type="GstCaps*"/>
@@ -5238,7 +5308,10 @@ Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place().</doc>
             <doc xml:space="preserve">a function to call for each field</doc>
             <type name="CapsForeachFunc" c:type="GstCapsForeachFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">private data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -5562,7 +5635,10 @@ delete the structures and features. The caps must be mutable.</doc>
             <doc xml:space="preserve">a function to call for each field</doc>
             <type name="CapsMapFunc" c:type="GstCapsMapFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">private data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -5636,7 +5712,9 @@ If either caps is ANY, the resulting caps will be ANY.</doc>
 @caps, but contains no lists.  Each list is expanded into separate
 @GstStructures.
-This function takes ownership of @caps.</doc>
+This function takes ownership of @caps and will call gst_caps_make_writable()
+on it so you must not use @caps afterwards unless you keep an additional
+reference to it with gst_caps_ref().</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the normalized #GstCaps</doc>
           <type name="Caps" c:type="GstCaps*"/>
@@ -5764,6 +5842,10 @@ same set of formats, but in a simpler form.  Component structures that are
 identical are merged.  Component structures that have values that can be
 merged are also merged.
+This function takes ownership of @caps and will call gst_caps_make_writable()
+on it if necessary, so you must not use @caps afterwards unless you keep an
+additional reference to it with gst_caps_ref().
 This method does not preserve the original order of @caps.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">The simplified caps.</doc>
@@ -5819,7 +5901,7 @@ are included on one caps and omitted on the other.&lt;/note&gt;</doc>
 can be converted back to a #GstCaps by gst_caps_from_string().
 For debugging purposes its easier to do something like this:
-|[
+|[&lt;!-- language="C" --&gt;
 GST_LOG ("caps are %" GST_PTR_FORMAT, caps);
 ]|
 This prints the caps in human readable form.
@@ -5839,7 +5921,11 @@ when there are nested #GstCaps / #GstStructure deeper than one level.</doc>
       </method>
       <method name="truncate" c:identifier="gst_caps_truncate">
         <doc xml:space="preserve">Discard all but the first structure from @caps. Useful when
-fixating.</doc>
+fixating.
+This function takes ownership of @caps and will call gst_caps_make_writable()
+on it if necessary, so you must not use @caps afterwards unless you keep an
+additional reference to it with gst_caps_ref().</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">truncated caps</doc>
           <type name="Caps" c:type="GstCaps*"/>
@@ -6256,7 +6342,7 @@ the MT Refcounting section of the design documents.</doc>
         <doc xml:space="preserve">Converts @features to a human-readable string representation.
 For debugging purposes its easier to do something like this:
-|[
+|[&lt;!-- language="C" --&gt;
 GST_LOG ("features is %" GST_PTR_FORMAT, features);
 ]|
 This prints the features in human readable form.
@@ -6312,7 +6398,11 @@ removed from the caps if %FALSE is returned.</doc>
           <doc xml:space="preserve">the #GstStructure</doc>
           <type name="Structure" c:type="GstStructure*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -6348,7 +6438,11 @@ the foreach operation should stop with %FALSE.</doc>
           <doc xml:space="preserve">the #GstStructure</doc>
           <type name="Structure" c:type="GstStructure*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -6407,7 +6501,11 @@ the map operation should stop with %FALSE.</doc>
           <doc xml:space="preserve">the #GstStructure</doc>
           <type name="Structure" c:type="GstStructure*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -7041,11 +7139,17 @@ MT safe.</doc>
           <type name="gint" c:type="gint"/>
         </return-value>
         <parameters>
-          <parameter name="id1" transfer-ownership="none">
+          <parameter name="id1"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">A #GstClockID</doc>
             <type name="gpointer" c:type="gconstpointer"/>
           </parameter>
-          <parameter name="id2" transfer-ownership="none">
+          <parameter name="id2"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">A #GstClockID to compare with</doc>
             <type name="gpointer" c:type="gconstpointer"/>
           </parameter>
@@ -7181,7 +7285,10 @@ MT safe.</doc>
             <doc xml:space="preserve">The callback function</doc>
             <type name="ClockCallback" c:type="GstClockCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">User data passed in the callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -7423,13 +7530,18 @@ This function is the reverse of gst_clock_unadjust_unlocked().</doc>
 using the passed calibration parameters. This function performs the
 same calculation as gst_clock_adjust_unlocked() when called using the
 current calibration parameters, but doesn't ensure a monotonically
-increasing result as gst_clock_adjust_unlocked() does.</doc>
+increasing result as gst_clock_adjust_unlocked() does.
+Note: The @clock parameter is unused and can be NULL</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the converted time of the clock.</doc>
           <type name="ClockTime" c:type="GstClockTime"/>
         </return-value>
         <parameters>
-          <instance-parameter name="clock" transfer-ownership="none">
+          <instance-parameter name="clock"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #GstClock to use</doc>
             <type name="Clock" c:type="GstClock*"/>
           </instance-parameter>
@@ -7883,6 +7995,50 @@ This function is the reverse of gst_clock_adjust_unlocked().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="unadjust_with_calibration"
+              c:identifier="gst_clock_unadjust_with_calibration"
+              version="1.8">
+        <doc xml:space="preserve">Converts the given @external_target clock time to the internal time,
+using the passed calibration parameters. This function performs the
+same calculation as gst_clock_unadjust_unlocked() when called using the
+current calibration parameters.
+Note: The @clock parameter is unused and can be NULL</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the converted time of the clock.</doc>
+          <type name="ClockTime" c:type="GstClockTime"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="clock"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">a #GstClock to use</doc>
+            <type name="Clock" c:type="GstClock*"/>
+          </instance-parameter>
+          <parameter name="external_target" transfer-ownership="none">
+            <doc xml:space="preserve">a clock time</doc>
+            <type name="ClockTime" c:type="GstClockTime"/>
+          </parameter>
+          <parameter name="cinternal" transfer-ownership="none">
+            <doc xml:space="preserve">a reference internal time</doc>
+            <type name="ClockTime" c:type="GstClockTime"/>
+          </parameter>
+          <parameter name="cexternal" transfer-ownership="none">
+            <doc xml:space="preserve">a reference external time</doc>
+            <type name="ClockTime" c:type="GstClockTime"/>
+          </parameter>
+          <parameter name="cnum" transfer-ownership="none">
+            <doc xml:space="preserve">the numerator of the rate of the clock relative to its
+       internal time</doc>
+            <type name="ClockTime" c:type="GstClockTime"/>
+          </parameter>
+          <parameter name="cdenom" transfer-ownership="none">
+            <doc xml:space="preserve">the denominator of the rate of the clock</doc>
+            <type name="ClockTime" c:type="GstClockTime"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="wait_for_sync"
               c:identifier="gst_clock_wait_for_sync"
               version="1.6">
@@ -7967,7 +8123,11 @@ the application's main thread.</doc>
           <doc xml:space="preserve">The #GstClockID that expired</doc>
           <type name="ClockID" c:type="GstClockID"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="3">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="3">
           <doc xml:space="preserve">user data passed in the gst_clock_id_wait_async() function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -8309,7 +8469,13 @@ order until one step succeeds:
 Bins will catch GST_MESSAGE_NEED_CONTEXT messages and will set any previously
 known context on the element that asks for it if possible. Otherwise the
-application should provide one if it can.</doc>
+application should provide one if it can.
+#GstContext&lt;!-- --&gt;s can be persistent.
+A persistent #GstContext is kept in elements when they reach
+%GST_STATE_NULL, non-persistent ones will be removed.
+Also, a non-persistent context won't override a previous persistent
+context set to an element.</doc>
       <constructor name="new" c:identifier="gst_context_new" version="1.2">
         <doc xml:space="preserve">Create a new context.</doc>
         <return-value transfer-ownership="full">
@@ -8399,8 +8565,8 @@ free it and that the pointer becomes invalid when you free the context.</doc>
         <doc xml:space="preserve">Get a writable version of the structure.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">The structure of the context. The structure is still
-owned by the event, which means that you should not free it and
-that the pointer becomes invalid when you free the event.
+owned by the context, which means that you should not free it and
+that the pointer becomes invalid when you free the context.
 This function checks if @context is writable.</doc>
           <type name="Structure" c:type="GstStructure*"/>
         </return-value>
@@ -8512,7 +8678,10 @@ more suitable for bindings.</doc>
             <doc xml:space="preserve">the number of values</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
-          <parameter name="values" transfer-ownership="none">
+          <parameter name="values"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">array to put control-values in</doc>
             <array length="2" zero-terminated="0" c:type="gpointer">
               <type name="gpointer" c:type="gpointer"/>
@@ -8823,7 +8992,10 @@ or %NULL if the property isn't controlled.</doc>
               <doc xml:space="preserve">the number of values</doc>
               <type name="guint" c:type="guint"/>
             </parameter>
-            <parameter name="values" transfer-ownership="none">
+            <parameter name="values"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">array to put control-values in</doc>
               <array length="3" zero-terminated="0" c:type="gpointer">
                 <type name="gpointer" c:type="gpointer"/>
@@ -8907,7 +9079,8 @@ For implementing a new #GstControlSource one has to implement
 #GstControlSourceGetValue and #GstControlSourceGetValueArray functions.
 These are then used by gst_control_source_get_value() and
 gst_control_source_get_value_array() to get values for specific timestamps.</doc>
-      <method name="get_value" c:identifier="gst_control_source_get_value">
+      <method name="control_source_get_value"
+              c:identifier="gst_control_source_get_value">
         <doc xml:space="preserve">Gets the value for this #GstControlSource at a given timestamp.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%FALSE if the value couldn't be returned, %TRUE otherwise.</doc>
@@ -8922,13 +9095,16 @@ gst_control_source_get_value_array() to get values for specific timestamps.</doc
             <doc xml:space="preserve">the time for which the value should be returned</doc>
             <type name="ClockTime" c:type="GstClockTime"/>
           </parameter>
-          <parameter name="value" transfer-ownership="none">
+          <parameter name="value"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full">
             <doc xml:space="preserve">the value</doc>
             <type name="gdouble" c:type="gdouble*"/>
           </parameter>
         </parameters>
       </method>
-      <method name="get_value_array"
+      <method name="control_source_get_value_array"
               c:identifier="gst_control_source_get_value_array">
         <doc xml:space="preserve">Gets an array of values for for this #GstControlSource. Values that are
 undefined contain NANs.</doc>
@@ -8969,7 +9145,7 @@ undefined contain NANs.</doc>
         <type name="ControlSourceGetValue" c:type="GstControlSourceGetValue"/>
       </field>
       <field name="get_value_array">
-        <doc xml:space="preserve">Function for returning a #GstValueArray for a given timestamp</doc>
+        <doc xml:space="preserve">Function for returning a values array for a given timestamp</doc>
         <type name="ControlSourceGetValueArray"
               c:type="GstControlSourceGetValueArray"/>
       </field>
@@ -9009,7 +9185,7 @@ undefined contain NANs.</doc>
           <type name="ClockTime" c:type="GstClockTime"/>
         </parameter>
         <parameter name="value" transfer-ownership="none">
-          <doc xml:space="preserve">a #GValue which will be set to the result. It must be initialized to the correct type.</doc>
+          <doc xml:space="preserve">a value which will be set to the result.</doc>
           <type name="gdouble" c:type="gdouble*"/>
         </parameter>
       </parameters>
@@ -9244,7 +9420,13 @@ or %NULL on error</doc>
       <constructor name="new_from_iso8601_string"
                    c:identifier="gst_date_time_new_from_iso8601_string">
         <doc xml:space="preserve">Tries to parse common variants of ISO-8601 datetime strings into a
-#GstDateTime.
+#GstDateTime. Possible input formats are (for example):
+2012-06-30T22:46:43Z, 2012, 2012-06, 2012-06-30, 2012-06-30T22:46:43-0430,
+2012-06-30T22:46Z, 2012-06-30T22:46-0430, 2012-06-30 22:46,
+2012-06-30 22:46:43, 2012-06-00, 2012-00-00, 2012-00-30, 22:46:43Z, 22:46Z,
+22:46:43-0430, 22:46-0430, 22:46:30, 22:46
+If no date is provided, it is assumed to be "today" in the timezone
+provided (if any), otherwise UTC.
 Free-function: gst_date_time_unref</doc>
         <return-value transfer-ownership="full" nullable="1">
@@ -10071,10 +10253,10 @@ message is, the greater the probability that the debugging system outputs it.</d
               c:identifier="GST_LEVEL_LOG"
               glib:nick="log">
         <doc xml:space="preserve">Log messages are messages that are very common but might be
- useful to know. As a rule of thumb a pipeline that is iterating as expected
- should never output anything else but LOG messages. Use this log level to
- log recurring information in chain functions and loop functions, for
- example.</doc>
+ useful to know. As a rule of thumb a pipeline that is running as expected
+ should never output anything else but LOG messages whilst processing data.
+ Use this log level to log recurring information in chain functions and
+ loop functions, for example.</doc>
       </member>
       <member name="trace"
               value="7"
@@ -10261,6 +10443,22 @@ classes of the #GstDeviceProvider that produced this device.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_properties"
+              c:identifier="gst_device_get_properties"
+              version="1.6">
+        <doc xml:space="preserve">Gets the extra properties of a device.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">The extra properties or %NULL when there are none.
+         Free with gst_structure_free() after use.</doc>
+          <type name="Structure" c:type="GstStructure*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="device" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDevice</doc>
+            <type name="Device" c:type="GstDevice*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="has_classes"
               c:identifier="gst_device_has_classes"
               version="1.4">
@@ -10275,7 +10473,7 @@ classes of the #GstDeviceProvider that produced this device.</doc>
             <type name="Device" c:type="GstDevice*"/>
           </instance-parameter>
           <parameter name="classes" transfer-ownership="none">
-            <doc xml:space="preserve">a "/" separate list of device classes to match, only match if
+            <doc xml:space="preserve">a "/"-separated list of device classes to match, only match if
  all classes are matched</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -10295,8 +10493,8 @@ classes of the #GstDeviceProvider that produced this device.</doc>
             <type name="Device" c:type="GstDevice*"/>
           </instance-parameter>
           <parameter name="classes" transfer-ownership="none">
-            <doc xml:space="preserve">a %NULL terminated array of classes to match, only match if all
-  classes are matched</doc>
+            <doc xml:space="preserve">a %NULL terminated array of classes
+  to match, only match if all classes are matched</doc>
             <array c:type="gchar**">
               <type name="utf8" c:type="gchar*"/>
             </array>
@@ -10346,6 +10544,12 @@ device in the PLAYING state.</doc>
                 transfer-ownership="none">
         <type name="utf8" c:type="gchar*"/>
       </property>
+      <property name="properties"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <type name="Structure"/>
+      </property>
       <field name="parent">
         <doc xml:space="preserve">The parent #GstObject strucuture.</doc>
         <type name="Object" c:type="GstObject"/>
@@ -10501,7 +10705,14 @@ The basic use pattern of a device monitor is as follows:
               c:identifier="gst_device_monitor_add_filter"
               version="1.4">
         <doc xml:space="preserve">Adds a filter for which #GstDevice will be monitored, any device that matches
-all classes and the #GstCaps will be returned.
+all these classes and the #GstCaps will be returned.
+If this function is called multiple times to add more filters, each will be
+matched independently. That is, adding more filters will not further restrict
+what devices are matched.
+The #GstCaps supported by the device as returned by gst_device_get_caps() are
+not intersected with caps filters added using this function.
 Filters must be added before the #GstDeviceMonitor is started.</doc>
         <return-value transfer-ownership="none">
@@ -10564,6 +10775,43 @@ probe the hardware if the monitor is not currently started.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_providers"
+              c:identifier="gst_device_monitor_get_providers"
+              version="1.6">
+        <doc xml:space="preserve">Get a list of the currently selected device provider factories.
+This</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">
+    A list of device provider factory names that are currently being
+    monitored by @monitor or %NULL when nothing is being monitored.</doc>
+          <array c:type="gchar**">
+            <type name="utf8"/>
+          </array>
+        </return-value>
+        <parameters>
+          <instance-parameter name="monitor" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDeviceMonitor</doc>
+            <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_show_all_devices"
+              c:identifier="gst_device_monitor_get_show_all_devices"
+              version="1.6">
+        <doc xml:space="preserve">Get if @monitor is curretly showing all devices, even those from hidden
+providers.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE when all devices will be shown.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="monitor" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDeviceMonitor</doc>
+            <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="remove_filter"
               c:identifier="gst_device_monitor_remove_filter"
               version="1.4">
@@ -10584,6 +10832,25 @@ by gst_device_monitor_add_filter().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="set_show_all_devices"
+              c:identifier="gst_device_monitor_set_show_all_devices"
+              version="1.6">
+        <doc xml:space="preserve">Set if all devices should be visible, even those devices from hidden
+providers. Setting @show_all to true might show some devices multiple times.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="monitor" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDeviceMonitor</doc>
+            <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/>
+          </instance-parameter>
+          <parameter name="show_all" transfer-ownership="none">
+            <doc xml:space="preserve">show all devices</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="start"
               c:identifier="gst_device_monitor_start"
               version="1.4">
@@ -10613,6 +10880,9 @@ will be emitted on the bus when the list of devices changes.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <property name="show-all" writable="1" transfer-ownership="none">
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <field name="parent">
         <doc xml:space="preserve">the parent #GstObject structure</doc>
         <type name="Object" c:type="GstObject"/>
@@ -10847,6 +11117,48 @@ probe the hardware if the provider is not currently started.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_hidden_providers"
+              c:identifier="gst_device_provider_get_hidden_providers"
+              version="1.6">
+        <doc xml:space="preserve">Get the provider factory names of the #GstDeviceProvider instances that
+are hidden by @provider.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">
+  a list of hidden providers factory names or %NULL when
+  nothing is hidden by @provider. Free with g_strfreev.</doc>
+          <array c:type="gchar**">
+            <type name="utf8"/>
+          </array>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDeviceProvider</doc>
+            <type name="DeviceProvider" c:type="GstDeviceProvider*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="hide_provider"
+              c:identifier="gst_device_provider_hide_provider"
+              version="1.6">
+        <doc xml:space="preserve">Make @provider hide the devices from the factory with @name.
+This function is used when @provider will also provide the devices reported
+by provider factory @name. A monitor should stop monitoring the
+device provider with @name to avoid duplicate devices.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDeviceProvider</doc>
+            <type name="DeviceProvider" c:type="GstDeviceProvider*"/>
+          </instance-parameter>
+          <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">a provider factory name</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="start"
               c:identifier="gst_device_provider_start"
               version="1.4">
@@ -10885,6 +11197,29 @@ called the same number of times that gst_device_provider_start() was called.</do
           </instance-parameter>
         </parameters>
       </method>
+      <method name="unhide_provider"
+              c:identifier="gst_device_provider_unhide_provider"
+              version="1.6">
+        <doc xml:space="preserve">Make @provider unhide the devices from factory @name.
+This function is used when @provider will no longer provide the devices
+reported by provider factory @name. A monitor should start
+monitoring the devices from provider factory @name in order to see
+all devices again.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstDeviceProvider</doc>
+            <type name="DeviceProvider" c:type="GstDeviceProvider*"/>
+          </instance-parameter>
+          <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">a provider factory name</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
       <field name="parent">
         <doc xml:space="preserve">The parent #GstObject</doc>
         <type name="Object" c:type="GstObject"/>
@@ -10903,6 +11238,26 @@ called the same number of times that gst_device_provider_start() was called.</do
           <type name="gpointer" c:type="gpointer"/>
         </array>
       </field>
+      <glib:signal name="provider-hidden" when="first">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <parameter name="object" transfer-ownership="none">
+            <type name="utf8" c:type="gchar*"/>
+          </parameter>
+        </parameters>
+      </glib:signal>
+      <glib:signal name="provider-unhidden" when="first">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <parameter name="object" transfer-ownership="none">
+            <type name="utf8" c:type="gchar*"/>
+          </parameter>
+        </parameters>
+      </glib:signal>
     </class>
     <record name="DeviceProviderClass"
             c:type="GstDeviceProviderClass"
@@ -12342,6 +12697,65 @@ Pads from compatible templates can be linked together.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_context"
+              c:identifier="gst_element_get_context"
+              version="1.8">
+        <doc xml:space="preserve">Gets the context with @context_type set on the element or NULL.
+MT safe.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A #GstContext or NULL</doc>
+          <type name="Context" c:type="GstContext*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="element" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstElement to get the context of.</doc>
+            <type name="Element" c:type="GstElement*"/>
+          </instance-parameter>
+          <parameter name="context_type" transfer-ownership="none">
+            <doc xml:space="preserve">a name of a context to retrieve</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_context_unlocked"
+              c:identifier="gst_element_get_context_unlocked"
+              version="1.8">
+        <doc xml:space="preserve">Gets the context with @context_type set on the element or NULL.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A #GstContext or NULL</doc>
+          <type name="Context" c:type="GstContext*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="element" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstElement to get the context of.</doc>
+            <type name="Element" c:type="GstElement*"/>
+          </instance-parameter>
+          <parameter name="context_type" transfer-ownership="none">
+            <doc xml:space="preserve">a name of a context to retrieve</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_contexts"
+              c:identifier="gst_element_get_contexts"
+              version="1.8">
+        <doc xml:space="preserve">Gets the contexts set on the element.
+MT safe.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">List of #GstContext</doc>
+          <type name="GLib.List" c:type="GList*">
+            <type name="Context"/>
+          </type>
+        </return-value>
+        <parameters>
+          <instance-parameter name="element" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstElement to set the context of.</doc>
+            <type name="Element" c:type="GstElement*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_factory" c:identifier="gst_element_get_factory">
         <doc xml:space="preserve">Retrieves the factory that was used to create this element.</doc>
         <return-value transfer-ownership="none">
@@ -12951,10 +13365,7 @@ MT safe.</doc>
             <doc xml:space="preserve">a #GstElement to invoke the convert query on.</doc>
             <type name="Element" c:type="GstElement*"/>
           </instance-parameter>
-          <parameter name="src_format"
-                     direction="inout"
-                     caller-allocates="0"
-                     transfer-ownership="full">
+          <parameter name="src_format" transfer-ownership="none">
             <doc xml:space="preserve">a #GstFormat to convert from.</doc>
             <type name="Format" c:type="GstFormat"/>
           </parameter>
@@ -13589,8 +14000,13 @@ state will yield the running_time against the clock.</doc>
         <doc xml:space="preserve">updated whenever the a pad is added or removed</doc>
         <type name="guint32" c:type="guint32"/>
       </field>
+      <field name="contexts">
+        <type name="GLib.List" c:type="GList*">
+          <type name="gpointer" c:type="gpointer"/>
+        </type>
+      </field>
       <field name="_gst_reserved" readable="0" private="1">
-        <array zero-terminated="0" c:type="gpointer" fixed-size="4">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="3">
           <type name="gpointer" c:type="gpointer"/>
         </array>
       </field>
@@ -14062,6 +14478,27 @@ dynamically loaded plugins.)</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="add_static_pad_template"
+              c:identifier="gst_element_class_add_static_pad_template"
+              version="1.8">
+        <doc xml:space="preserve">Adds a pad template to an element class based on the static pad template
+@templ. This is mainly used in the _class_init functions of element
+implementations. If a pad template with the same name already exists,
+the old one is replaced by the new one.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="klass" transfer-ownership="none">
+            <doc xml:space="preserve">the #GstElementClass to add the pad template to.</doc>
+            <type name="ElementClass" c:type="GstElementClass*"/>
+          </instance-parameter>
+          <parameter name="static_templ" transfer-ownership="none">
+            <doc xml:space="preserve">#GstStaticPadTemplate to add as pad template to the element class.</doc>
+            <type name="StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="get_metadata"
               c:identifier="gst_element_class_get_metadata">
         <doc xml:space="preserve">Get metadata with @key in @klass.</doc>
@@ -14670,7 +15107,7 @@ Most of the event API is used inside plugins. Applications usually only
 construct and use seek events.
 To do that gst_event_new_seek() is used to create a seek event. It takes
 the needed parameters to specify seeking time and mode.
-|[
+|[&lt;!-- language="C" --&gt;
   GstEvent *event;
   gboolean result;
   ...
@@ -15235,7 +15672,10 @@ stream. A new stream-id should only be created for a stream if the upstream
 stream is split into (potentially) multiple new streams, e.g. in a demuxer,
 but not for every single element in the pipeline.
 gst_pad_create_stream_id() or gst_pad_create_stream_id_printf() can be
-used to create a stream-id.</doc>
+used to create a stream-id.  There are no particular semantics for the
+stream-id, though it should be deterministic (to support stream matching)
+and it might be used to order streams (besides any information conveyed by
+stream flags).</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the new STREAM_START event.</doc>
           <type name="Event" c:type="GstEvent*"/>
@@ -16857,7 +17297,7 @@ usage.</doc>
         <doc xml:space="preserve">Set the new target of the ghostpad @gpad. Any existing target
 is unlinked and links to the new target are established. if @newtarget is
 %NULL the target will be cleared.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the new target could be set. This function
     can return %FALSE when the internal pads could not be linked.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -16926,7 +17366,7 @@ object will not be increased. Your code is responsible for taking a reference
 if it wants to continue using it later.
 The basic use pattern of an iterator is as follows:
-|[
+|[&lt;!-- language="C" --&gt;
   GstIterator *it = _get_iterator(object);
   GValue item = G_VALUE_INIT;
   done = FALSE;
@@ -17212,7 +17652,10 @@ MT safe.</doc>
             <doc xml:space="preserve">pointer to a #GValue where to store the result</doc>
             <type name="GObject.Value" c:type="GValue*"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the compare function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -17257,7 +17700,10 @@ MT safe.</doc>
             <doc xml:space="preserve">the seed value passed to the fold function</doc>
             <type name="GObject.Value" c:type="GValue*"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the fold function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -17286,7 +17732,10 @@ MT safe.</doc>
             <type name="IteratorForeachFunction"
                   c:type="GstIteratorForeachFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -17421,7 +17870,11 @@ reference counts.</doc>
           <doc xml:space="preserve">a #GValue collecting the result</doc>
           <type name="GObject.Value" c:type="GValue*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">data passed to gst_iterator_fold()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17438,7 +17891,11 @@ reference counts.</doc>
           <doc xml:space="preserve">The item</doc>
           <type name="GObject.Value" c:type="const GValue*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">User data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17711,7 +18168,11 @@ Use G_GNUC_NO_INSTRUMENT on that function.</doc>
           <doc xml:space="preserve">the message</doc>
           <type name="DebugMessage" c:type="GstDebugMessage*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="7">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="7">
           <doc xml:space="preserve">user data for the log function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -18231,7 +18692,7 @@ made when this memory needs to be shared between buffers.</doc>
               value="128"
               c:identifier="GST_MEMORY_FLAG_PHYSICALLY_CONTIGUOUS"
               glib:nick="physically-contiguous">
-        <doc xml:space="preserve">the memory is physically contiguous. (Since 2.2)</doc>
+        <doc xml:space="preserve">the memory is physically contiguous. (Since 1.2)</doc>
       </member>
       <member name="not_mappable"
               value="256"
@@ -18268,13 +18729,11 @@ made when this memory needs to be shared between buffers.</doc>
         </parameter>
       </parameters>
     </callback>
-    <callback name="MemoryMapFullFunction"
-              c:type="GstMemoryMapFullFunction"
-              introspectable="0">
+    <callback name="MemoryMapFullFunction" c:type="GstMemoryMapFullFunction">
       <doc xml:space="preserve">Get the memory of @mem that can be accessed according to the mode specified
 in @info's flags. The function should return a pointer that contains at least
 @maxsize bytes.</doc>
-      <return-value>
+      <return-value transfer-ownership="none" nullable="1">
         <doc xml:space="preserve">a pointer to memory of which at least @maxsize bytes can be
 accessed according to the access pattern in @info's flags.</doc>
         <type name="gpointer" c:type="gpointer"/>
@@ -18294,13 +18753,11 @@ accessed according to the access pattern in @info's flags.</doc>
         </parameter>
       </parameters>
     </callback>
-    <callback name="MemoryMapFunction"
-              c:type="GstMemoryMapFunction"
-              introspectable="0">
+    <callback name="MemoryMapFunction" c:type="GstMemoryMapFunction">
       <doc xml:space="preserve">Get the memory of @mem that can be accessed according to the mode specified
 in @flags. The function should return a pointer that contains at least
 @maxsize bytes.</doc>
-      <return-value>
+      <return-value transfer-ownership="none" nullable="1">
         <doc xml:space="preserve">a pointer to memory of which at least @maxsize bytes can be
 accessed according to the access pattern in @flags.</doc>
         <type name="gpointer" c:type="gpointer"/>
@@ -18386,7 +18843,7 @@ Messages are posted by objects in the pipeline and are passed to the
 application using the #GstBus.
 The basic use pattern of posting a message on a #GstBus is as follows:
-|[
+|[&lt;!-- language="C" --&gt;
   gst_bus_post (bus, gst_message_new_eos());
 ]|
@@ -19680,7 +20137,7 @@ disappearance of monitored devices.</doc>
 in the output arguments are copies; the caller must free them when done.
 Typical usage of this function might be:
-|[
+|[&lt;!-- language="C" --&gt;
   ...
   switch (GST_MESSAGE_TYPE (msg)) {
     case GST_MESSAGE_ERROR: {
@@ -20166,7 +20623,7 @@ MT safe.</doc>
         <doc xml:space="preserve">Extracts the old and new states from the GstMessage.
 Typical usage of this function might be:
-|[
+|[&lt;!-- language="C" --&gt;
   ...
   switch (GST_MESSAGE_TYPE (msg)) {
     case GST_MESSAGE_STATE_CHANGED: {
@@ -20447,7 +20904,7 @@ MT safe.</doc>
 output argument is a copy; the caller must free it when done.
 Typical usage of this function might be:
-|[
+|[&lt;!-- language="C" --&gt;
   ...
   switch (GST_MESSAGE_TYPE (msg)) {
     case GST_MESSAGE_TAG: {
@@ -21228,7 +21685,10 @@ structure.</doc>
           <doc xml:space="preserve">a #GstMeta</doc>
           <type name="Meta" c:type="GstMeta*"/>
         </parameter>
-        <parameter name="params" transfer-ownership="none">
+        <parameter name="params"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">parameters passed to the init function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -21282,7 +21742,10 @@ the metadata on @transbuf.</doc>
           <doc xml:space="preserve">the transform type</doc>
           <type name="GLib.Quark" c:type="GQuark"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">transform specific data.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -21538,7 +22001,10 @@ a call to gst_mini_object_set_qdata() with the same @quark.</doc>
             <doc xml:space="preserve">A #GQuark, naming the user data pointer</doc>
             <type name="GLib.Quark" c:type="GQuark"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">An opaque user data pointer</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -21621,7 +22087,10 @@ to stay alive).</doc>
             <doc xml:space="preserve">callback to invoke before the mini object is freed</doc>
             <type name="MiniObjectNotify" c:type="GstMiniObjectNotify"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">extra data to pass to notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -21643,7 +22112,10 @@ to stay alive).</doc>
             <doc xml:space="preserve">callback to search for</doc>
             <type name="MiniObjectNotify" c:type="GstMiniObjectNotify"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to search for</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -21806,7 +22278,11 @@ last ref and @obj is about to be freed.</doc>
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
-        <parameter name="user_data" transfer-ownership="none" closure="0">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="0">
           <doc xml:space="preserve">data that was provided when the notify was added</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -21968,11 +22444,14 @@ of the floating reference, converting it to a normal reference by clearing
 the floating flag while leaving the reference count unchanged. If the object
 is not floating, then this call adds a new normal reference increasing the
 reference count by one.</doc>
-        <return-value>
+        <return-value transfer-ownership="none" nullable="1">
           <type name="gpointer" c:type="gpointer"/>
         </return-value>
         <parameters>
-          <parameter name="object" transfer-ownership="none">
+          <parameter name="object"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GstObject to sink</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -22270,7 +22749,10 @@ better suites for bindings.</doc>
             <doc xml:space="preserve">the number of values</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
-          <parameter name="values" transfer-ownership="none">
+          <parameter name="values"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">array to put control-values in</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -22954,7 +23436,14 @@ MT safe.</doc>
       </method>
       <method name="add_probe" c:identifier="gst_pad_add_probe">
         <doc xml:space="preserve">Be notified of different states of pads. The provided callback is called for
-every state that matches @mask.</doc>
+every state that matches @mask.
+Probes are called in groups: First GST_PAD_PROBE_TYPE_BLOCK probes are
+called, then others, then finally GST_PAD_PROBE_TYPE_IDLE. The only
+exception here are GST_PAD_PROBE_TYPE_IDLE probes that are called
+immediately if the pad is already idle while calling gst_pad_add_probe().
+In each of the groups, probes are called in the order in which they were
+added.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">an id or 0 if no probe is pending. The id can be used to remove the
 probe with gst_pad_remove_probe(). When using GST_PAD_PROBE_TYPE_IDLE it can
@@ -22982,7 +23471,10 @@ MT safe.</doc>
           the pad state</doc>
             <type name="PadProbeCallback" c:type="GstPadProbeCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -23270,7 +23762,10 @@ When @forward returns %TRUE, no further pads will be processed.</doc>
             <doc xml:space="preserve">a #GstPadForwardFunction</doc>
             <type name="PadForwardFunction" c:type="GstPadForwardFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @forward</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -23301,8 +23796,9 @@ MT safe.</doc>
       <method name="get_current_caps" c:identifier="gst_pad_get_current_caps">
         <doc xml:space="preserve">Gets the capabilities currently configured on @pad with the last
 #GST_EVENT_CAPS event.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the current caps of the pad with incremented ref-count.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the current caps of the pad with
+incremented ref-count or %NULL when pad has no caps. Unref after usage.</doc>
           <type name="Caps" c:type="GstCaps*"/>
         </return-value>
         <parameters>
@@ -23333,7 +23829,7 @@ MT safe.</doc>
               c:identifier="gst_pad_get_element_private">
         <doc xml:space="preserve">Gets the private data of a pad.
 No locking is performed in this function.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">a #gpointer to the private data.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </return-value>
@@ -23810,9 +24306,9 @@ called on sinkpads @filter contains the caps accepted by
 downstream in the preferred order. @filter might be %NULL but
 if it is not %NULL the returned caps will be a subset of @filter.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the caps of the peer pad with incremented ref-count. When there is
-no peer pad, this function returns @filter or, when @filter is %NULL, ANY
-caps.</doc>
+          <doc xml:space="preserve">the caps of the peer pad with incremented
+ref-count. When there is no peer pad, this function returns @filter or,
+when @filter is %NULL, ANY caps.</doc>
           <type name="Caps" c:type="GstCaps*"/>
         </return-value>
         <parameters>
@@ -24376,7 +24872,10 @@ Call this function if your sink pad can start a pull-based task.</doc>
             <doc xml:space="preserve">the #GstPadActivateFunction to set.</doc>
             <type name="PadActivateFunction" c:type="GstPadActivateFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24407,7 +24906,10 @@ prepares the element for data passing.</doc>
             <type name="PadActivateModeFunction"
                   c:type="GstPadActivateModeFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24464,7 +24966,10 @@ process a #GstBuffer input buffer. see #GstPadChainFunction for more details.</d
             <doc xml:space="preserve">the #GstPadChainFunction to set.</doc>
             <type name="PadChainFunction" c:type="GstPadChainFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24496,7 +25001,10 @@ called to process a #GstBufferList input buffer list. See
             <type name="PadChainListFunction"
                   c:type="GstPadChainListFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24519,12 +25027,49 @@ No locking is performed in this function.</doc>
             <doc xml:space="preserve">the #GstPad to set the private data of.</doc>
             <type name="Pad" c:type="GstPad*"/>
           </instance-parameter>
-          <parameter name="priv" transfer-ownership="none">
+          <parameter name="priv"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">The private data to attach to the pad.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
         </parameters>
       </method>
+      <method name="set_event_full_function_full"
+              c:identifier="gst_pad_set_event_full_function_full"
+              version="1.8">
+        <doc xml:space="preserve">Sets the given event handler for the pad.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="pad" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstPad of either direction.</doc>
+            <type name="Pad" c:type="GstPad*"/>
+          </instance-parameter>
+          <parameter name="event"
+                     transfer-ownership="none"
+                     scope="notified"
+                     closure="1"
+                     destroy="2">
+            <doc xml:space="preserve">the #GstPadEventFullFunction to set.</doc>
+            <type name="PadEventFullFunction"
+                  c:type="GstPadEventFullFunction"/>
+          </parameter>
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">user_data passed to @notify</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+          <parameter name="notify" transfer-ownership="none" scope="async">
+            <doc xml:space="preserve">notify called when @event will not be used anymore.</doc>
+            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_event_function_full"
               c:identifier="gst_pad_set_event_function_full">
         <doc xml:space="preserve">Sets the given event handler for the pad.</doc>
@@ -24544,7 +25089,10 @@ No locking is performed in this function.</doc>
             <doc xml:space="preserve">the #GstPadEventFunction to set.</doc>
             <type name="PadEventFunction" c:type="GstPadEventFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24575,7 +25123,10 @@ called to produce a new #GstBuffer to start the processing pipeline. see
             <doc xml:space="preserve">the #GstPadGetRangeFunction to set.</doc>
             <type name="PadGetRangeFunction" c:type="GstPadGetRangeFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24605,7 +25156,10 @@ called to produce a new #GstBuffer to start the processing pipeline. see
             <type name="PadIterIntLinkFunction"
                   c:type="GstPadIterIntLinkFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24644,7 +25198,10 @@ of the peer sink pad, if present.</doc>
             <doc xml:space="preserve">the #GstPadLinkFunction to set.</doc>
             <type name="PadLinkFunction" c:type="GstPadLinkFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24689,7 +25246,10 @@ of the peer sink pad, if present.</doc>
             <doc xml:space="preserve">the #GstPadQueryFunction to set.</doc>
             <type name="PadQueryFunction" c:type="GstPadQueryFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24719,7 +25279,10 @@ when the pad is unlinked.</doc>
             <doc xml:space="preserve">the #GstPadUnlinkFunction to set.</doc>
             <type name="PadUnlinkFunction" c:type="GstPadUnlinkFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user_data passed to @notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24751,7 +25314,10 @@ before @func is called.</doc>
             <doc xml:space="preserve">the task function to call</doc>
             <type name="TaskFunction" c:type="GstTaskFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the task function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -24782,7 +25348,10 @@ event. If @foreach_func returns %FALSE the iteration is immediately stopped.</do
             <type name="PadStickyEventsForeachFunction"
                   c:type="GstPadStickyEventsForeachFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the optional user data.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -25035,6 +25604,10 @@ be renegotiated to something else.</doc>
           <field name="last_flowret" writable="1">
             <type name="FlowReturn" c:type="GstFlowReturn"/>
           </field>
+          <field name="eventfullfunc" writable="1">
+            <type name="PadEventFullFunction"
+                  c:type="GstPadEventFullFunction"/>
+          </field>
         </record>
       </union>
       <glib:signal name="linked" when="last">
@@ -25239,6 +25812,39 @@ post an error on the bus and return an appropriate #GstFlowReturn value.</doc>
         <doc xml:space="preserve">the pad is a sink pad.</doc>
       </member>
     </enumeration>
+    <callback name="PadEventFullFunction"
+              c:type="GstPadEventFullFunction"
+              version="1.8">
+      <doc xml:space="preserve">Function signature to handle an event for the pad.
+This variant is for specific elements that will take into account the
+last downstream flow return (from a pad push), in which case they can
+return it.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%GST_FLOW_OK if the event was handled properly, or any other
+#GstFlowReturn dependent on downstream state.</doc>
+        <type name="FlowReturn" c:type="GstFlowReturn"/>
+      </return-value>
+      <parameters>
+        <parameter name="pad" transfer-ownership="none">
+          <doc xml:space="preserve">the #GstPad to handle the event.</doc>
+          <type name="Pad" c:type="GstPad*"/>
+        </parameter>
+        <parameter name="parent"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">the parent of @pad. If the #GST_PAD_FLAG_NEED_PARENT
+         flag is set, @parent is guaranteed to be not-%NULL and remain valid
+         during the execution of this function.</doc>
+          <type name="Object" c:type="GstObject*"/>
+        </parameter>
+        <parameter name="event" transfer-ownership="full">
+          <doc xml:space="preserve">the #GstEvent to handle.</doc>
+          <type name="Event" c:type="GstEvent*"/>
+        </parameter>
+      </parameters>
+    </callback>
     <callback name="PadEventFunction" c:type="GstPadEventFunction">
       <doc xml:space="preserve">Function signature to handle an event for the pad.</doc>
       <return-value transfer-ownership="none">
@@ -25356,6 +25962,15 @@ post an error on the bus and return an appropriate #GstFlowReturn value.</doc>
                      of checking for a subset. This is interesting for
                      parsers that can accept incompletely specified caps.</doc>
       </member>
+      <member name="accept_template"
+              value="65536"
+              c:identifier="GST_PAD_FLAG_ACCEPT_TEMPLATE"
+              glib:nick="accept-template">
+        <doc xml:space="preserve">the default accept-caps handler will use
+                     the template pad caps instead of query caps to
+                     compare with the accept caps. Use this in combination
+                     with %GST_PAD_FLAG_ACCEPT_INTERSECT. (Since 1.6)</doc>
+      </member>
       <member name="last"
               value="1048576"
               c:identifier="GST_PAD_FLAG_LAST"
@@ -25375,7 +25990,11 @@ gst_pad_forward().</doc>
           <doc xml:space="preserve">the #GstPad that is forwarded.</doc>
           <type name="Pad" c:type="GstPad*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">the gpointer to optional user data.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -25682,7 +26301,11 @@ The callback is allowed to modify the data pointer in @info.</doc>
           <doc xml:space="preserve">#GstPadProbeInfo</doc>
           <type name="PadProbeInfo" c:type="GstPadProbeInfo*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">the gpointer to optional user data.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -25713,11 +26336,18 @@ The callback is allowed to modify the data pointer in @info.</doc>
    #GST_PAD_PROBE_TYPE_PULL</doc>
         <type name="guint" c:type="guint"/>
       </field>
-      <field name="_gst_reserved" readable="0" private="1">
-        <array zero-terminated="0" c:type="gpointer" fixed-size="4">
-          <type name="gpointer" c:type="gpointer"/>
-        </array>
-      </field>
+      <union name="ABI" c:type="ABI">
+        <field name="_gst_reserved" writable="1">
+          <array zero-terminated="0" c:type="gpointer" fixed-size="4">
+            <type name="gpointer" c:type="gpointer"/>
+          </array>
+        </field>
+        <record name="abi" c:type="abi">
+          <field name="flow_ret" writable="1">
+            <type name="FlowReturn" c:type="GstFlowReturn"/>
+          </field>
+        </record>
+      </union>
       <method name="get_buffer" c:identifier="gst_pad_probe_info_get_buffer">
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The #GstBuffer from the probe</doc>
@@ -25732,11 +26362,13 @@ The callback is allowed to modify the data pointer in @info.</doc>
       </method>
       <method name="get_buffer_list"
               c:identifier="gst_pad_probe_info_get_buffer_list">
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">The #GstBufferList from the probe</doc>
           <type name="BufferList" c:type="GstBufferList*"/>
         </return-value>
         <parameters>
           <instance-parameter name="info" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstPadProbeInfo</doc>
             <type name="PadProbeInfo" c:type="GstPadProbeInfo*"/>
           </instance-parameter>
         </parameters>
@@ -25776,28 +26408,45 @@ The callback is allowed to modify the data pointer in @info.</doc>
               c:identifier="GST_PAD_PROBE_DROP"
               glib:nick="drop">
         <doc xml:space="preserve">drop data in data probes. For push mode this means that
-       the data item is not sent downstream. For pull mode, it means that the
-       data item is not passed upstream. In both cases, this result code
-       means that #GST_FLOW_OK or %TRUE is returned to the caller.</doc>
+       the data item is not sent downstream. For pull mode, it means that
+       the data item is not passed upstream. In both cases, no more probes
+       are called and #GST_FLOW_OK or %TRUE is returned to the caller.</doc>
       </member>
       <member name="ok"
               value="1"
               c:identifier="GST_PAD_PROBE_OK"
               glib:nick="ok">
-        <doc xml:space="preserve">normal probe return value</doc>
+        <doc xml:space="preserve">normal probe return value. This leaves the probe in
+       place, and defers decisions about dropping or passing data to other
+       probes, if any. If there are no other probes, the default behaviour
+       for the probe type applies (block for blocking probes, and pass for
+       non-blocking probes).</doc>
       </member>
       <member name="remove"
               value="2"
               c:identifier="GST_PAD_PROBE_REMOVE"
               glib:nick="remove">
-        <doc xml:space="preserve">remove probe</doc>
+        <doc xml:space="preserve">remove this probe.</doc>
       </member>
       <member name="pass"
               value="3"
               c:identifier="GST_PAD_PROBE_PASS"
               glib:nick="pass">
-        <doc xml:space="preserve">pass the data item in the block probe and block on
-                        the next item</doc>
+        <doc xml:space="preserve">pass the data item in the block probe and block on the
+       next item.</doc>
+      </member>
+      <member name="handled"
+              value="4"
+              c:identifier="GST_PAD_PROBE_HANDLED"
+              glib:nick="handled">
+        <doc xml:space="preserve">Data has been handled in the probe and will not be
+       forwarded further. For events and buffers this is the same behaviour as
+       @GST_PAD_PROBE_DROP (except that in this case you need to unref the buffer
+       or event yourself). For queries it will also return %TRUE to the caller.
+       The probe can also modify the #GstFlowReturn value by using the
+       #GST_PAD_PROBE_INFO_FLOW_RETURN() accessor.
+       Note that the resulting query must contain valid entries.
+       Since: 1.6</doc>
       </member>
     </enumeration>
     <bitfield name="PadProbeType"
@@ -25996,7 +26645,11 @@ removing or modifying.</doc>
           <doc xml:space="preserve">a sticky #GstEvent.</doc>
           <type name="Event" c:type="GstEvent**"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">the #gpointer to optional user data.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -26038,7 +26691,7 @@ or gst_pad_new_from_static_template ()) or to add to an element class
 (see gst_element_class_add_pad_template ()).
 The following code example shows the code to create a pad from a padtemplate.
-|[
+|[&lt;!-- language="C" --&gt;
   GstStaticPadTemplate my_template =
   GST_STATIC_PAD_TEMPLATE (
     "sink",          // the name of the pad
@@ -26060,7 +26713,7 @@ The following code example shows the code to create a pad from a padtemplate.
 The following example shows you how to add the padtemplate to an
 element class, this is usually done in the class_init of the class:
-|[
+|[&lt;!-- language="C" --&gt;
   static void
   my_element_class_init (GstMyElementClass *klass)
   {
@@ -26429,6 +27082,12 @@ of %GST_PARSE_ERROR_NO_SUCH_ELEMENT was returned.</doc>
               glib:nick="empty">
         <doc xml:space="preserve">An empty description was specified</doc>
       </member>
+      <member name="delayed_link"
+              value="7"
+              c:identifier="GST_PARSE_ERROR_DELAYED_LINK"
+              glib:nick="delayed-link">
+        <doc xml:space="preserve">A delayed link did not get resolved.</doc>
+      </member>
       <function name="quark" c:identifier="gst_parse_error_quark">
         <doc xml:space="preserve">Get the error quark used by the parsing subsystem.</doc>
         <return-value transfer-ownership="none">
@@ -27059,7 +27718,10 @@ via gst_init_get_option_group()) before calling this function.</doc>
             <doc xml:space="preserve">URL to provider of plugin</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">gpointer to user data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -27409,6 +28071,14 @@ The cache is flushed every time the registry is rebuilt.</doc>
         filename argument as filter suffix and check all matching files in
         the directory</doc>
       </member>
+      <member name="file_name_is_prefix"
+              value="8"
+              c:identifier="GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_PREFIX"
+              glib:nick="file-name-is-prefix">
+        <doc xml:space="preserve">interpret
+        filename argument as filter prefix and check all matching files in
+        the directory. Since 1.8.</doc>
+      </member>
     </bitfield>
     <record name="PluginDesc" c:type="GstPluginDesc">
       <doc xml:space="preserve">A plugin should export a variable of this type called plugin_desc. The plugin
@@ -27574,11 +28244,17 @@ ranks are equal but the name of p2 comes before the name of p1</doc>
           <type name="gint" c:type="gint"/>
         </return-value>
         <parameters>
-          <parameter name="p1" transfer-ownership="none">
+          <parameter name="p1"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GstPluginFeature</doc>
             <type name="gpointer" c:type="gconstpointer"/>
           </parameter>
-          <parameter name="p2" transfer-ownership="none">
+          <parameter name="p2"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GstPluginFeature</doc>
             <type name="gpointer" c:type="gconstpointer"/>
           </parameter>
@@ -27662,7 +28338,7 @@ ranks are equal but the name of p2 comes before the name of p1</doc>
 unaffected; use the return value instead.
 Normally this function is used like this:
-|[
+|[&lt;!-- language="C" --&gt;
 GstPluginFeature *loaded_feature;
 loaded_feature = gst_plugin_feature_load (feature);
@@ -27717,7 +28393,11 @@ to get a list of pluginfeature that match certain criteria.</doc>
           <doc xml:space="preserve">the pluginfeature to check</doc>
           <type name="PluginFeature" c:type="GstPluginFeature*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">the user_data that has been passed on e.g.
  gst_registry_feature_filter()</doc>
           <type name="gpointer" c:type="gpointer"/>
@@ -27736,7 +28416,11 @@ to get a list of plugins that match certain criteria.</doc>
           <doc xml:space="preserve">the plugin to check</doc>
           <type name="Plugin" c:type="GstPlugin*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">the user_data that has been passed on e.g. gst_registry_plugin_filter()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -27775,7 +28459,11 @@ user data to be passed to init function (useful for bindings).</doc>
           <doc xml:space="preserve">The plugin object</doc>
           <type name="Plugin" c:type="GstPlugin*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">extra data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -28221,7 +28909,9 @@ The default implementation supports presets located in a system directory,
 application specific directory and in the users home directory. When getting
 a list of presets individual presets are read and overlaid in 1) system,
 2) application and 3) user order. Whenever an earlier entry is newer, the
-later entries will be updated.</doc>
+later entries will be updated. Since 1.8 you can also provide extra paths
+where to find presets through the GST_PRESET_PATH environment variable.
+Presets found in those paths will be concidered as "app presets".</doc>
       <function name="get_app_dir" c:identifier="gst_preset_get_app_dir">
         <doc xml:space="preserve">Gets the directory for application specific presets if set by the
 application.</doc>
@@ -29039,7 +29729,7 @@ Query values can be set using gst_query_set_*(), and parsed using
 gst_query_parse_*() helpers.
 The following example shows how to query the duration of a pipeline:
-|[
+|[&lt;!-- language="C" --&gt;
   GstQuery *query;
   gboolean res;
   query = gst_query_new_duration (GST_FORMAT_TIME);
@@ -29455,8 +30145,8 @@ start position of the array should be inferior to @start.</doc>
       <method name="find_allocation_meta"
               c:identifier="gst_query_find_allocation_meta">
         <doc xml:space="preserve">Check if @query has metadata @api set. When this function returns %TRUE,
-@index will contain the index where the requested API and the flags can be
-found.</doc>
+@index will contain the index where the requested API and the parameters
+can be found.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE when @api is in the list of metadata.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -30088,7 +30778,7 @@ at @index of the metadata API array.</doc>
                      transfer-ownership="none"
                      optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">API specific flags</doc>
+            <doc xml:space="preserve">API specific parameters</doc>
             <type name="Structure" c:type="const GstStructure**"/>
           </parameter>
         </parameters>
@@ -31538,7 +32228,10 @@ MT safe.</doc>
             <doc xml:space="preserve">only return first match</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the filter function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -31740,7 +32433,10 @@ MT safe.</doc>
             <doc xml:space="preserve">only return first match</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to the filter function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -32188,27 +32884,28 @@ complete scan of the file in those cases.
 When performing a segment seek: after the playback of the segment completes,
 no EOS will be emitted by the element that performed the seek, but a
-#GST_MESSAGE_SEGMENT_DONE message will be posted on the bus by the element.
+%GST_MESSAGE_SEGMENT_DONE message will be posted on the bus by the element.
 When this message is posted, it is possible to send a new seek event to
 continue playback. With this seek method it is possible to perform seamless
 looping or simple linear editing.
 When doing fast forward (rate &gt; 1.0) or fast reverse (rate &lt; -1.0) trickmode
-playback, the @GST_SEEK_FLAG_TRICKMODE flag can be used to instruct decoders
+playback, the %GST_SEEK_FLAG_TRICKMODE flag can be used to instruct decoders
 and demuxers to adjust the playback rate by skipping frames. This can improve
 performance and decrease CPU usage because not all frames need to be decoded.
-Beyond that, the @GST_SEEK_FLAG_TRICKMODE_KEY_UNITS flag can be used to
+Beyond that, the %GST_SEEK_FLAG_TRICKMODE_KEY_UNITS flag can be used to
 request that decoders skip all frames except key units, and
-@GST_SEEK_FLAG_TRICKMODE_NO_AUDIO flags can be used to request that audio
+%GST_SEEK_FLAG_TRICKMODE_NO_AUDIO flags can be used to request that audio
 decoders do no decoding at all, and simple output silence.
-The @GST_SEEK_FLAG_SNAP_BEFORE flag can be used to snap to the previous
-relevant location, and the @GST_SEEK_FLAG_SNAP_AFTER flag can be used to
-select the next relevant location. If KEY_UNIT is specified, the relevant
-location is a keyframe. If both flags are specified, the nearest of these
-locations will be selected. If none are specified, the implementation is
+The %GST_SEEK_FLAG_SNAP_BEFORE flag can be used to snap to the previous
+relevant location, and the %GST_SEEK_FLAG_SNAP_AFTER flag can be used to
+select the next relevant location. If %GST_SEEK_FLAG_KEY_UNIT is specified,
+the relevant location is a keyframe. If both flags are specified, the nearest
+of these locations will be selected. If none are specified, the implementation is
 free to select whichever it wants.
 The before and after here are in running time, so when playing backwards,
 the next location refers to the one that will played in next, and not the
 one that is located after in the actual source stream.
@@ -32261,22 +32958,22 @@ elements that handle them.</doc>
               c:identifier="GST_SEEK_FLAG_SKIP"
               glib:nick="skip">
         <doc xml:space="preserve">Deprecated backward compatibility flag, replaced
-                    by @GST_SEEK_FLAG_TRICKMODE</doc>
+                    by %GST_SEEK_FLAG_TRICKMODE</doc>
       </member>
       <member name="snap_before"
               value="32"
               c:identifier="GST_SEEK_FLAG_SNAP_BEFORE"
               glib:nick="snap-before">
         <doc xml:space="preserve">go to a location before the requested position,
-                    if KEY_UNIT this means the keyframe at or before the
-                    requested position the one at or before the seek target.</doc>
+                    if %GST_SEEK_FLAG_KEY_UNIT this means the keyframe at or before
+                    the requested position the one at or before the seek target.</doc>
       </member>
       <member name="snap_after"
               value="64"
               c:identifier="GST_SEEK_FLAG_SNAP_AFTER"
               glib:nick="snap-after">
         <doc xml:space="preserve">go to a location after the requested position,
-                    if KEY_UNIT this means the keyframe at of after the
+                    if %GST_SEEK_FLAG_KEY_UNIT this means the keyframe at of after the
                     requested position.</doc>
       </member>
       <member name="snap_nearest"
@@ -32284,9 +32981,9 @@ elements that handle them.</doc>
               c:identifier="GST_SEEK_FLAG_SNAP_NEAREST"
               glib:nick="snap-nearest">
         <doc xml:space="preserve">go to a position near the requested position,
-                    if KEY_UNIT this means the keyframe closest to the
-                    requested position, if both keyframes are at an equal
-                    distance, behaves like SNAP_BEFORE.</doc>
+                    if %GST_SEEK_FLAG_KEY_UNIT this means the keyframe closest
+                    to the requested position, if both keyframes are at an equal
+                    distance, behaves like %GST_SEEK_FLAG_SNAP_BEFORE.</doc>
       </member>
       <member name="trickmode_key_units"
               value="128"
@@ -32388,7 +33085,7 @@ info to stream time (which is always between 0 and the duration of the stream).<
         <type name="SegmentFlags" c:type="GstSegmentFlags"/>
       </field>
       <field name="rate" writable="1">
-        <doc xml:space="preserve">the rate of the segment</doc>
+        <doc xml:space="preserve">the playback rate of the segment</doc>
         <type name="gdouble" c:type="gdouble"/>
       </field>
       <field name="applied_rate" writable="1">
@@ -32400,28 +33097,29 @@ info to stream time (which is always between 0 and the duration of the stream).<
         <type name="Format" c:type="GstFormat"/>
       </field>
       <field name="base" writable="1">
-        <doc xml:space="preserve">the base of the segment</doc>
+        <doc xml:space="preserve">the running time (plus elapsed time, see offset) of the segment start</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="offset" writable="1">
-        <doc xml:space="preserve">the offset to apply to @start or @stop</doc>
+        <doc xml:space="preserve">the amount (in buffer timestamps) that has already been elapsed in
+    the segment</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="start" writable="1">
-        <doc xml:space="preserve">the start of the segment</doc>
+        <doc xml:space="preserve">the start of the segment in buffer timestamp time (PTS)</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="stop" writable="1">
-        <doc xml:space="preserve">the stop of the segment</doc>
+        <doc xml:space="preserve">the stop of the segment in buffer timestamp time (PTS)</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="time" writable="1">
-        <doc xml:space="preserve">the stream time of the segment</doc>
+        <doc xml:space="preserve">the stream time of the segment start</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="position" writable="1">
-        <doc xml:space="preserve">the position in the segment (used internally by elements
-    such as sources, demuxers or parsers to track progress)</doc>
+        <doc xml:space="preserve">the buffer timestamp position in the segment (used internally by
+    elements such as sources, demuxers or parsers to track progress)</doc>
         <type name="guint64" c:type="guint64"/>
       </field>
       <field name="duration" writable="1">
@@ -32679,6 +33377,138 @@ returned, @offset is not in @segment.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="position_from_running_time"
+              c:identifier="gst_segment_position_from_running_time"
+              version="1.8">
+        <doc xml:space="preserve">Convert @running_time into a position in the segment so that
+gst_segment_to_running_time() with that position returns @running_time.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the position in the segment for @running_time. This function returns
+-1 when @running_time is -1 or when it is not inside @segment.</doc>
+          <type name="guint64" c:type="guint64"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="segment" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstSegment structure.</doc>
+            <type name="Segment" c:type="const GstSegment*"/>
+          </instance-parameter>
+          <parameter name="format" transfer-ownership="none">
+            <doc xml:space="preserve">the format of the segment.</doc>
+            <type name="Format" c:type="GstFormat"/>
+          </parameter>
+          <parameter name="running_time" transfer-ownership="none">
+            <doc xml:space="preserve">the running_time in the segment</doc>
+            <type name="guint64" c:type="guint64"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="position_from_running_time_full"
+              c:identifier="gst_segment_position_from_running_time_full"
+              version="1.8">
+        <doc xml:space="preserve">Translate @running_time to the segment position using the currently configured
+segment. Compared to gst_segment_position_from_running_time() this function can
+return negative segment position.
+This function is typically used by elements that need to synchronize buffers
+against the clock or each other.
+@running_time can be any value and the result of this function for values
+outside of the segment is extrapolated.
+When 1 is returned, @running_time resulted in a positive position returned
+in @position.
+When this function returns -1, the returned @position should be negated
+to get the real negative segment position.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a 1 or -1 on success, 0 on failure.</doc>
+          <type name="gint" c:type="gint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="segment" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstSegment structure.</doc>
+            <type name="Segment" c:type="const GstSegment*"/>
+          </instance-parameter>
+          <parameter name="format" transfer-ownership="none">
+            <doc xml:space="preserve">the format of the segment.</doc>
+            <type name="Format" c:type="GstFormat"/>
+          </parameter>
+          <parameter name="running_time" transfer-ownership="none">
+            <doc xml:space="preserve">the running-time</doc>
+            <type name="guint64" c:type="guint64"/>
+          </parameter>
+          <parameter name="position" transfer-ownership="none">
+            <doc xml:space="preserve">the resulting position in the segment</doc>
+            <type name="guint64" c:type="guint64*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="position_from_stream_time"
+              c:identifier="gst_segment_position_from_stream_time"
+              version="1.8">
+        <doc xml:space="preserve">Convert @stream_time into a position in the segment so that
+gst_segment_to_stream_time() with that position returns @stream_time.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the position in the segment for @stream_time. This function returns
+-1 when @stream_time is -1 or when it is not inside @segment.</doc>
+          <type name="guint64" c:type="guint64"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="segment" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstSegment structure.</doc>
+            <type name="Segment" c:type="const GstSegment*"/>
+          </instance-parameter>
+          <parameter name="format" transfer-ownership="none">
+            <doc xml:space="preserve">the format of the segment.</doc>
+            <type name="Format" c:type="GstFormat"/>
+          </parameter>
+          <parameter name="stream_time" transfer-ownership="none">
+            <doc xml:space="preserve">the stream_time in the segment</doc>
+            <type name="guint64" c:type="guint64"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="position_from_stream_time_full"
+              c:identifier="gst_segment_position_from_stream_time_full"
+              version="1.8">
+        <doc xml:space="preserve">Translate @stream_time to the segment position using the currently configured
+segment. Compared to gst_segment_position_from_stream_time() this function can
+return negative segment position.
+This function is typically used by elements that need to synchronize buffers
+against the clock or each other.
+@stream_time can be any value and the result of this function for values outside
+of the segment is extrapolated.
+When 1 is returned, @stream_time resulted in a positive position returned
+in @position.
+When this function returns -1, the returned @position should be negated
+to get the real negative segment position.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a 1 or -1 on success, 0 on failure.</doc>
+          <type name="gint" c:type="gint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="segment" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstSegment structure.</doc>
+            <type name="Segment" c:type="const GstSegment*"/>
+          </instance-parameter>
+          <parameter name="format" transfer-ownership="none">
+            <doc xml:space="preserve">the format of the segment.</doc>
+            <type name="Format" c:type="GstFormat"/>
+          </parameter>
+          <parameter name="stream_time" transfer-ownership="none">
+            <doc xml:space="preserve">the stream-time</doc>
+            <type name="guint64" c:type="guint64"/>
+          </parameter>
+          <parameter name="position" transfer-ownership="none">
+            <doc xml:space="preserve">the resulting position in the segment</doc>
+            <type name="guint64" c:type="guint64*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_running_time"
               c:identifier="gst_segment_set_running_time">
         <doc xml:space="preserve">Adjust the start/stop and base values of @segment such that the next valid
@@ -32708,7 +33538,9 @@ returned, @running_time is -1 or not in @segment.</doc>
 gst_segment_to_running_time() with that position returns @running_time.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the position in the segment for @running_time. This function returns
--1 when @running_time is -1 or when it is not inside @segment.</doc>
+-1 when @running_time is -1 or when it is not inside @segment.
+Deprecated. Use gst_segment_position_from_running_time() instead.</doc>
           <type name="guint64" c:type="guint64"/>
         </return-value>
         <parameters>
@@ -32798,7 +33630,9 @@ to get the real negative running time.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="to_stream_time" c:identifier="gst_segment_to_stream_time">
+      <method name="to_stream_time"
+              c:identifier="gst_segment_to_stream_time"
+              version="1.8">
         <doc xml:space="preserve">Translate @position to stream time using the currently configured
 segment. The @position value must be between @segment start and
 stop value.
@@ -32829,6 +33663,47 @@ was given.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="to_stream_time_full"
+              c:identifier="gst_segment_to_stream_time_full"
+              version="1.8">
+        <doc xml:space="preserve">Translate @position to the total stream time using the currently configured
+segment. Compared to gst_segment_to_stream_time() this function can return
+negative stream-time.
+This function is typically used by elements that need to synchronize buffers
+against the clock or eachother.
+@position can be any value and the result of this function for values outside
+of the segment is extrapolated.
+When 1 is returned, @position resulted in a positive stream-time returned
+in @stream_time.
+When this function returns -1, the returned @stream_time should be negated
+to get the real negative stream time.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a 1 or -1 on success, 0 on failure.</doc>
+          <type name="gint" c:type="gint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="segment" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstSegment structure.</doc>
+            <type name="Segment" c:type="const GstSegment*"/>
+          </instance-parameter>
+          <parameter name="format" transfer-ownership="none">
+            <doc xml:space="preserve">the format of the segment.</doc>
+            <type name="Format" c:type="GstFormat"/>
+          </parameter>
+          <parameter name="position" transfer-ownership="none">
+            <doc xml:space="preserve">the position in the segment</doc>
+            <type name="guint64" c:type="guint64"/>
+          </parameter>
+          <parameter name="stream_time" transfer-ownership="none">
+            <doc xml:space="preserve">result stream-time</doc>
+            <type name="guint64" c:type="guint64*"/>
+          </parameter>
+        </parameters>
+      </method>
     </record>
     <bitfield name="SegmentFlags"
               glib:type-name="GstSegmentFlags"
@@ -33648,7 +34523,10 @@ The structure must be mutable.</doc>
             <type name="StructureFilterMapFunc"
                   c:type="GstStructureFilterMapFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">private data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -33826,7 +34704,10 @@ and gst_structure_filter_and_map_in_place().</doc>
             <type name="StructureForeachFunc"
                   c:type="GstStructureForeachFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">private data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -34704,7 +35585,10 @@ fields. The structure must be mutable.</doc>
             <doc xml:space="preserve">a function to call for each field</doc>
             <type name="StructureMapFunc" c:type="GstStructureMapFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">private data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -34948,7 +35832,7 @@ value is replaced and freed. The function will take ownership of @value.</doc>
         <doc xml:space="preserve">Converts @structure to a human-readable string representation.
 For debugging purposes its easier to do something like this:
-|[
+|[&lt;!-- language="C" --&gt;
 GST_LOG ("structure is %" GST_PTR_FORMAT, structure);
 ]|
 This prints the structure in human readable form.
@@ -35035,7 +35919,11 @@ should be removed.</doc>
           <doc xml:space="preserve">the #GValue of the field</doc>
           <type name="GObject.Value" c:type="GValue*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -35058,7 +35946,11 @@ the foreach operation should stop with %FALSE.</doc>
           <doc xml:space="preserve">the #GValue of the field</doc>
           <type name="GObject.Value" c:type="const GValue*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -35081,7 +35973,11 @@ the map operation should stop with %FALSE.</doc>
           <doc xml:space="preserve">the #GValue of the field</doc>
           <type name="GObject.Value" c:type="GValue*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -35289,6 +36185,13 @@ attachment)</doc>
       <doc xml:space="preserve">The composer's name, used for sorting (string)</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
+    <constant name="TAG_CONDUCTOR"
+              value="conductor"
+              c:type="GST_TAG_CONDUCTOR"
+              version="1.8">
+      <doc xml:space="preserve">conductor/performer refinement (string)</doc>
+      <type name="utf8" c:type="gchar*"/>
+    </constant>
     <constant name="TAG_CONTACT" value="contact" c:type="GST_TAG_CONTACT">
       <doc xml:space="preserve">contact information (string)</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -35606,6 +36509,22 @@ different from this target bitrate.</doc>
 (sample) (sample taglist should specify the content type)</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
+    <constant name="TAG_PRIVATE_DATA"
+              value="private-data"
+              c:type="GST_TAG_PRIVATE_DATA"
+              version="1.8">
+      <doc xml:space="preserve">Any private data that may be contained in tags (sample).
+It is represented by #GstSample in which #GstBuffer contains the
+binary data and the sample's info #GstStructure may contain any
+extra information that identifies the origin or meaning of the data.
+Private frames in ID3v2 tags ('PRIV' frames) will be represented
+using this tag, in which case the GstStructure will be named
+"ID3PrivateFrame" and contain a field named "owner" of type string
+which contains the owner-identification string from the tag.</doc>
+      <type name="utf8" c:type="gchar*"/>
+    </constant>
     <constant name="TAG_PUBLISHER"
               value="publisher"
               c:type="GST_TAG_PUBLISHER"
@@ -35717,7 +36636,7 @@ The higher the value, the more the user likes this media
 the matching arguments.
 Example:
-|[
+|[&lt;!-- language="C" --&gt;
 printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts));
 ]|</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -35781,7 +36700,11 @@ not modify the tag list.</doc>
           <doc xml:space="preserve">a name of a tag in @list</doc>
           <type name="utf8" c:type="const gchar*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -36019,7 +36942,10 @@ is no tag, the function won't be called at all.</doc>
             <doc xml:space="preserve">function to be called for each tag</doc>
             <type name="TagForeachFunc" c:type="GstTagForeachFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user specified data</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -36446,7 +37372,8 @@ into one if multiple values are associated with the tag.</doc>
           <parameter name="value"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="none">
+                     transfer-ownership="none"
+                     nullable="1">
             <doc xml:space="preserve">location for the result</doc>
             <type name="gpointer" c:type="gpointer*"/>
           </parameter>
@@ -36477,7 +37404,8 @@ list.</doc>
           <parameter name="value"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="none">
+                     transfer-ownership="none"
+                     nullable="1">
             <doc xml:space="preserve">location for the result</doc>
             <type name="gpointer" c:type="gpointer*"/>
           </parameter>
@@ -37194,7 +38122,7 @@ Elements implementing the #GstTagSetter interface often have to merge
 any tags received from upstream and the tags set by the application via
 the interface. This can be done like this:
-|[
+|[&lt;!-- language="C" --&gt;
 GstTagMergeMode merge_mode;
 const GstTagList *application_tags;
 const GstTagList *event_tags;
@@ -37517,7 +38445,10 @@ MT safe.</doc>
             <doc xml:space="preserve">The #GstTaskFunction to use</doc>
             <type name="TaskFunction" c:type="GstTaskFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">User data to pass to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -37629,7 +38560,10 @@ longer referenced.</doc>
             <doc xml:space="preserve">a #GstTaskThreadFunc</doc>
             <type name="TaskThreadFunc" c:type="GstTaskThreadFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @enter_func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -37660,7 +38594,10 @@ longer referenced.</doc>
             <doc xml:space="preserve">a #GstTaskThreadFunc</doc>
             <type name="TaskThreadFunc" c:type="GstTaskThreadFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data passed to @leave_func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -37832,7 +38769,11 @@ a #GstTask.</doc>
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
-        <parameter name="user_data" transfer-ownership="none" closure="0">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="0">
           <doc xml:space="preserve">user data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -37883,7 +38824,10 @@ gst_task_pool_push().</doc>
             <doc xml:space="preserve">a #GstTaskPool</doc>
             <type name="TaskPool" c:type="GstTaskPool*"/>
           </instance-parameter>
-          <parameter name="id" transfer-ownership="none">
+          <parameter name="id"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the id</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -37923,7 +38867,11 @@ must check @error to detect errors.</doc>
             <doc xml:space="preserve">the function to call</doc>
             <type name="TaskPoolFunction" c:type="GstTaskPoolFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none" closure="1">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     closure="1">
             <doc xml:space="preserve">data to pass to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -37955,7 +38903,10 @@ gst_task_pool_push().</doc>
             <doc xml:space="preserve">a #GstTaskPool</doc>
             <type name="TaskPool" c:type="GstTaskPool*"/>
           </instance-parameter>
-          <parameter name="id" transfer-ownership="none">
+          <parameter name="id"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the id</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -37995,7 +38946,10 @@ must check @error to detect errors.</doc>
             <doc xml:space="preserve">the function to call</doc>
             <type name="TaskPoolFunction" c:type="GstTaskPoolFunction"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to pass to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -38067,7 +39021,11 @@ must check @error to detect errors.</doc>
               <doc xml:space="preserve">the function to call</doc>
               <type name="TaskPoolFunction" c:type="GstTaskPoolFunction"/>
             </parameter>
-            <parameter name="user_data" transfer-ownership="none" closure="2">
+            <parameter name="user_data"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1"
+                       closure="2">
               <doc xml:space="preserve">data to pass to @func</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -38084,7 +39042,10 @@ must check @error to detect errors.</doc>
               <doc xml:space="preserve">a #GstTaskPool</doc>
               <type name="TaskPool" c:type="GstTaskPool*"/>
             </parameter>
-            <parameter name="id" transfer-ownership="none">
+            <parameter name="id"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">the id</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -38103,7 +39064,11 @@ must check @error to detect errors.</doc>
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
-        <parameter name="user_data" transfer-ownership="none" closure="0">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="0">
           <doc xml:space="preserve">user data for the task function</doc>
           <type name="gpointer" c:type="void*"/>
         </parameter>
@@ -38149,7 +39114,11 @@ must check @error to detect errors.</doc>
           <doc xml:space="preserve">The #GThread</doc>
           <type name="GLib.Thread" c:type="GThread*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -38863,6 +39832,161 @@ unreffed before setting a new one.</doc>
         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
       </field>
     </record>
+    <class name="Tracer"
+           c:symbol-prefix="tracer"
+           c:type="GstTracer"
+           parent="Object"
+           abstract="1"
+           glib:type-name="GstTracer"
+           glib:get-type="gst_tracer_get_type"
+           glib:type-struct="TracerClass">
+      <doc xml:space="preserve">Tracing modules will subclass #GstTracer and register through
+gst_tracing_register(). Modules can attach to various hook-types - see
+gst_tracing_register_hook(). When invoked they receive hook specific
+contextual data, which they must not modify.</doc>
+      <property name="params"
+                writable="1"
+                construct="1"
+                transfer-ownership="none">
+        <type name="utf8" c:type="gchar*"/>
+      </property>
+      <field name="parent">
+        <type name="Object" c:type="GstObject"/>
+      </field>
+      <field name="priv" readable="0" private="1">
+        <type name="TracerPrivate" c:type="GstTracerPrivate*"/>
+      </field>
+      <field name="_gst_reserved" readable="0" private="1">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="4">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+    </class>
+    <record name="TracerClass"
+            c:type="GstTracerClass"
+            glib:is-gtype-struct-for="Tracer">
+      <field name="parent_class">
+        <type name="ObjectClass" c:type="GstObjectClass"/>
+      </field>
+      <field name="_gst_reserved" readable="0" private="1">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="4">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+    </record>
+    <class name="TracerFactory"
+           c:symbol-prefix="tracer_factory"
+           c:type="GstTracerFactory"
+           version="1.8"
+           parent="PluginFeature"
+           glib:type-name="GstTracerFactory"
+           glib:get-type="gst_tracer_factory_get_type"
+           glib:type-struct="TracerFactoryClass">
+      <doc xml:space="preserve">Use gst_tracer_factory_get_list() to get a list of tracer factories known to
+GStreamer.</doc>
+      <function name="get_list"
+                c:identifier="gst_tracer_factory_get_list"
+                version="1.8">
+        <doc xml:space="preserve">Gets the list of all registered tracer factories. You must free the
+list using gst_plugin_feature_list_free().
+The returned factories are sorted by factory name.
+Free-function: gst_plugin_feature_list_free</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">the list of all
+    registered #GstTracerFactory.</doc>
+          <type name="GLib.List" c:type="GList*">
+            <type name="TracerFactory"/>
+          </type>
+        </return-value>
+      </function>
+    </class>
+    <record name="TracerFactoryClass"
+            c:type="GstTracerFactoryClass"
+            disguised="1"
+            glib:is-gtype-struct-for="TracerFactory">
+    </record>
+    <record name="TracerPrivate" c:type="GstTracerPrivate" disguised="1">
+    </record>
+    <class name="TracerRecord"
+           c:symbol-prefix="tracer_record"
+           c:type="GstTracerRecord"
+           parent="Object"
+           glib:type-name="GstTracerRecord"
+           glib:get-type="gst_tracer_record_get_type"
+           glib:type-struct="TracerRecordClass">
+      <doc xml:space="preserve">Tracing modules will create instances of this class to announce the data they
+will log and create a log formatter.</doc>
+    </class>
+    <record name="TracerRecordClass"
+            c:type="GstTracerRecordClass"
+            disguised="1"
+            glib:is-gtype-struct-for="TracerRecord">
+    </record>
+    <bitfield name="TracerValueFlags"
+              glib:type-name="GstTracerValueFlags"
+              glib:get-type="gst_tracer_value_flags_get_type"
+              c:type="GstTracerValueFlags">
+      <doc xml:space="preserve">Flag that describe the value. These flags help applications processing the
+logs to understand the values.</doc>
+      <member name="none"
+              value="0"
+              c:identifier="GST_TRACER_VALUE_FLAGS_NONE"
+              glib:nick="none">
+        <doc xml:space="preserve">no flags</doc>
+      </member>
+      <member name="optional"
+              value="1"
+              c:identifier="GST_TRACER_VALUE_FLAGS_OPTIONAL"
+              glib:nick="optional">
+        <doc xml:space="preserve">the value is optional. When using this flag
+  one need to have an additional boolean arg before this value in the
+  var-args list passed to  gst_tracer_record_log().</doc>
+      </member>
+      <member name="aggregated"
+              value="2"
+              c:identifier="GST_TRACER_VALUE_FLAGS_AGGREGATED"
+              glib:nick="aggregated">
+        <doc xml:space="preserve">the value is combined since the start of
+  tracing</doc>
+      </member>
+    </bitfield>
+    <enumeration name="TracerValueScope"
+                 version="1.8"
+                 glib:type-name="GstTracerValueScope"
+                 glib:get-type="gst_tracer_value_scope_get_type"
+                 c:type="GstTracerValueScope">
+      <doc xml:space="preserve">Tracing record will contain fields that contain a meassured value or extra
+meta-data. One such meta data are values that tell where a measurement was
+taken. This enumerating declares to which scope such a meta data field
+relates to. If it is e.g. %GST_TRACER_VALUE_SCOPE_PAD, then each of the log
+events may contain values for different #GstPads.</doc>
+      <member name="process"
+              value="0"
+              c:identifier="GST_TRACER_VALUE_SCOPE_PROCESS"
+              glib:nick="process">
+        <doc xml:space="preserve">the value is related to the process</doc>
+      </member>
+      <member name="thread"
+              value="1"
+              c:identifier="GST_TRACER_VALUE_SCOPE_THREAD"
+              glib:nick="thread">
+        <doc xml:space="preserve">the value is related to a thread</doc>
+      </member>
+      <member name="element"
+              value="2"
+              c:identifier="GST_TRACER_VALUE_SCOPE_ELEMENT"
+              glib:nick="element">
+        <doc xml:space="preserve">the value is related to an #GstElement</doc>
+      </member>
+      <member name="pad"
+              value="3"
+              c:identifier="GST_TRACER_VALUE_SCOPE_PAD"
+              glib:nick="pad">
+        <doc xml:space="preserve">the value is related to a #GstPad</doc>
+      </member>
+    </enumeration>
     <record name="TypeFind" c:type="GstTypeFind">
       <doc xml:space="preserve">The following functions allow you to detect the media type of an unknown
 stream.</doc>
@@ -39082,7 +40206,10 @@ This function is typically called during an element's plugin initialization.</do
                 succeeds</doc>
             <type name="Caps" c:type="GstCaps*"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">Optional user data. This user data must be available until the plugin
        is unloaded.</doc>
             <type name="gpointer" c:type="gpointer"/>
@@ -39112,7 +40239,7 @@ the section &lt;link linkend="gstreamer-Writing-typefind-functions"&gt;
 The following example shows how to write a very simple typefinder that
 identifies the given data. You can get quite a bit more complicated than
 that though.
-|[
+|[&lt;!-- language="C" --&gt;
   typedef struct {
     guint8 *data;
     guint size;
@@ -39252,7 +40379,11 @@ e.g. assume a certain media type based on the file extension.</doc>
           <doc xml:space="preserve">A #GstTypeFind structure</doc>
           <type name="TypeFind" c:type="GstTypeFind*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">optional data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -40622,11 +41753,11 @@ determine a order for the two provided values.</doc>
       <doc xml:space="preserve">The major version of GStreamer at compile time:</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="VERSION_MICRO" value="2" c:type="GST_VERSION_MICRO">
+    <constant name="VERSION_MICRO" value="0" c:type="GST_VERSION_MICRO">
       <doc xml:space="preserve">The micro version of GStreamer at compile time:</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="VERSION_MINOR" value="5" c:type="GST_VERSION_MINOR">
+    <constant name="VERSION_MINOR" value="8" c:type="GST_VERSION_MINOR">
       <doc xml:space="preserve">The minor version of GStreamer at compile time:</doc>
       <type name="gint" c:type="gint"/>
     </constant>
@@ -41015,7 +42146,10 @@ Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed.</doc>
           <doc xml:space="preserve">the function to use</doc>
           <type name="LogFunction" c:type="GstLogFunction"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -41257,7 +42391,10 @@ gst_debug_remove_log_function(gst_debug_log_default);</doc>
           <doc xml:space="preserve">the actual message</doc>
           <type name="DebugMessage" c:type="GstDebugMessage*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">the FILE* to log to</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -41339,7 +42476,10 @@ gstreamer code, which can be printed with this function.</doc>
         <type name="guint" c:type="guint"/>
       </return-value>
       <parameters>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">user data of the log function to remove</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -41723,6 +42863,91 @@ is unknown.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="info_strdup_printf"
+              c:identifier="gst_info_strdup_printf"
+              version="1.8"
+              introspectable="0">
+      <doc xml:space="preserve">Allocates, fills and returns a null terminated string from the printf style
+@format string and corresponding arguments.
+See gst_info_vasprintf() for when this function is required.
+Free with g_free().</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a newly allocated null terminated string or %NULL on any error</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </return-value>
+      <parameters>
+        <parameter name="format" transfer-ownership="none">
+          <doc xml:space="preserve">a printf style format string</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="..." transfer-ownership="none">
+          <doc xml:space="preserve">the printf arguments for @format</doc>
+          <varargs/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="info_strdup_vprintf"
+              c:identifier="gst_info_strdup_vprintf"
+              version="1.8"
+              introspectable="0">
+      <doc xml:space="preserve">Allocates, fills and returns a null terminated string from the printf style
+@format string and @args.
+See gst_info_vasprintf() for when this function is required.
+Free with g_free().</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a newly allocated null terminated string or %NULL on any error</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </return-value>
+      <parameters>
+        <parameter name="format" transfer-ownership="none">
+          <doc xml:space="preserve">a printf style format string</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="args" transfer-ownership="none">
+          <doc xml:space="preserve">the va_list of printf arguments for @format</doc>
+          <type name="va_list" c:type="va_list"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="info_vasprintf"
+              c:identifier="gst_info_vasprintf"
+              version="1.8"
+              introspectable="0">
+      <doc xml:space="preserve">Allocates and fills a string large enough (including the terminating null
+byte) to hold the specified printf style @format and @args.
+This function deals with the GStreamer specific printf specifiers
+#GST_PTR_FORMAT and #GST_SEGMENT_FORMAT.  If you do not have these specifiers
+in your @format string, you do not need to use this function and can use
+alternatives such as g_vasprintf().
+Free @result with g_free().</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">the length of the string allocated into @result or -1 on any error</doc>
+        <type name="gint" c:type="gint"/>
+      </return-value>
+      <parameters>
+        <parameter name="result"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full">
+          <doc xml:space="preserve">the resulting string</doc>
+          <type name="utf8" c:type="gchar**"/>
+        </parameter>
+        <parameter name="format" transfer-ownership="none">
+          <doc xml:space="preserve">a printf style format string</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </parameter>
+        <parameter name="args" transfer-ownership="none">
+          <doc xml:space="preserve">the va_list of printf arguments for @format</doc>
+          <type name="va_list" c:type="va_list"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="init" c:identifier="gst_init">
       <doc xml:space="preserve">Initializes the GStreamer library, setting up internal path lists,
 registering built-in elements, and loading standard plugins.
@@ -41828,7 +43053,10 @@ threading system as one of the very first things in your program
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
-        <parameter name="obj" transfer-ownership="none">
+        <parameter name="obj"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
       </parameters>
@@ -42899,7 +44127,10 @@ This function is typically called during an element's plugin initialization.</do
                 succeeds</doc>
           <type name="Caps" c:type="GstCaps*"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">Optional user data. This user data must be available until the plugin
        is unloaded.</doc>
           <type name="gpointer" c:type="gpointer"/>
@@ -43128,7 +44359,10 @@ element or %NULL if nothing was found</doc>
         <type name="gpointer" c:type="gpointer"/>
       </return-value>
       <parameters>
-        <parameter name="array" transfer-ownership="none">
+        <parameter name="array"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">the sorted input array</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -43151,11 +44385,17 @@ element or %NULL if nothing was found</doc>
           <doc xml:space="preserve">search mode that should be used</doc>
           <type name="SearchMode" c:type="GstSearchMode"/>
         </parameter>
-        <parameter name="search_data" transfer-ownership="none">
+        <parameter name="search_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">element that should be found</doc>
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to @search_func</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -44497,7 +45737,7 @@ and @numerator_end/@denominator_end.</doc>
     </function>
     <function name="value_set_structure"
               c:identifier="gst_value_set_structure">
-      <doc xml:space="preserve">Sets the contents of @value to @structure.  The actual</doc>
+      <doc xml:space="preserve">Sets the contents of @value to @structure.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>