Attachment 66666 Details for Bug 54543 – the resulting changes to the .gir

the resulting changes to the .gir

gir.diff (text/plain), 32.10 KB, created by Simon McVittie on 2012-09-05 10:31:24 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2012-09-05 10:31:24 UTC

Size: 32.10 KB

patch

obsolete

>--- TelepathyGLib-0.12.gir.orig	2012-09-05 11:07:54.101730153 +0100
>+++ TelepathyGLib-0.12.gir	2012-09-05 11:19:58.072191201 +0100
>@@ -29802,6 +29802,80 @@
>               c:type="TP_UNKNOWN_HANDLE_TYPE">
>       <type name="gint" c:type="gint"/>
>     </constant>
>+    <record name="WeakRef" c:type="TpWeakRef" disguised="1" version="0.11.3">
>+      <doc xml:whitespace="preserve">A simple wrapper for a weak reference to a #GObject, suitable for use in
>+asynchronous calls which should only affect the object if it hasn't already
>+been freed.
>+
>+As well as wrapping a weak reference to an object, this structure can
>+contain an extra pointer to arbitrary data. This is useful for asynchronous
>+calls which act on an object and some second piece of data, which are quite
>+common in practice.
>+
>+If more than one piece of auxiliary data is required, the @user_data
>+argument to the constructor can be a struct or a #GValueArray.</doc>
>+      <method name="destroy"
>+              c:identifier="tp_weak_ref_destroy"
>+              version="0.11.3"
>+              introspectable="0">
>+        <doc xml:whitespace="preserve">Free a weak reference wrapper. This drops the weak reference to the
>+object (if it still exists), and frees the user data with the user-supplied
>+destructor function if one was provided.</doc>
>+        <return-value transfer-ownership="none">
>+          <type name="none" c:type="void"/>
>+        </return-value>
>+      </method>
>+      <method name="dup_object"
>+              c:identifier="tp_weak_ref_dup_object"
>+              version="0.11.3"
>+              introspectable="0">
>+        <doc xml:whitespace="preserve">If the weakly referenced object still exists, return a new reference to
>+it. Otherwise, return %NULL.</doc>
>+        <return-value transfer-ownership="full">
>+          <doc xml:whitespace="preserve">a new reference, or %NULL</doc>
>+          <type name="GObject.Object" c:type="gpointer"/>
>+        </return-value>
>+      </method>
>+      <method name="get_user_data"
>+              c:identifier="tp_weak_ref_get_user_data"
>+              version="0.11.3"
>+              introspectable="0">
>+        <doc xml:whitespace="preserve">Return the additional data that was passed to tp_weak_ref_new().
>+
>+%NULL</doc>
>+        <return-value>
>+          <doc xml:whitespace="preserve">the additional data supplied in tp_weak_ref_new(), which may be</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </return-value>
>+      </method>
>+      <function name="new"
>+                c:identifier="tp_weak_ref_new"
>+                version="0.11.3"
>+                introspectable="0">
>+        <doc xml:whitespace="preserve">Return a new weak reference wrapper for @object.
>+
>+
>+Free-function: tp_weak_ref_destroy()</doc>
>+        <return-value transfer-ownership="full">
>+          <doc xml:whitespace="preserve">a new weak-reference wrapper</doc>
>+          <type name="WeakRef" c:type="TpWeakRef*"/>
>+        </return-value>
>+        <parameters>
>+          <parameter name="object" transfer-ownership="none">
>+            <doc xml:whitespace="preserve">an object to which to take a weak reference</doc>
>+            <type name="GObject.Object" c:type="gpointer"/>
>+          </parameter>
>+          <parameter name="user_data" transfer-ownership="none">
>+            <doc xml:whitespace="preserve">optional additional data to store alongside the weak ref</doc>
>+            <type name="gpointer" c:type="gpointer"/>
>+          </parameter>
>+          <parameter name="destroy" transfer-ownership="none" scope="async">
>+            <doc xml:whitespace="preserve">destructor for @user_data, called when the weak ref is freed</doc>
>+            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
>+          </parameter>
>+        </parameters>
>+      </function>
>+    </record>
>     <record name="_DBusPropertiesMixinClass"
>             c:type="_TpDBusPropertiesMixinClass">
>       <field name="interfaces" writable="1">
>@@ -31846,6 +31920,37 @@
>         <type name="GLib.Quark" c:type="GQuark"/>
>       </return-value>
>     </function>
>+    <function name="escape_as_identifier"
>+              c:identifier="tp_escape_as_identifier">
>+      <doc xml:whitespace="preserve">Escape an arbitrary string so it follows the rules for a C identifier,
>+and hence an object path component, interface element component,
>+bus name component or member name in D-Bus.
>+
>+Unlike g_strcanon this is a reversible encoding, so it preserves
>+distinctness.
>+
>+The escaping consists of replacing all non-alphanumerics, and the first
>+character if it's a digit, with an underscore and two lower-case hex
>+digits:
>+
>+"0123abc_xyz\x01\xff" -&gt; _30123abc_5fxyz_01_ff
>+
>+i.e. similar to URI encoding, but with _ taking the role of %, and a
>+smaller allowed set. As a special case, "" is escaped to "_" (just for
>+completeness, really).
>+
>+the caller with #g_free</doc>
>+      <return-value transfer-ownership="full">
>+        <doc xml:whitespace="preserve">the escaped string, which must be freed by</doc>
>+        <type name="utf8" c:type="gchar*"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="name" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The string to be escaped</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>     <function name="external_group_mixin_finalize"
>               c:identifier="tp_external_group_mixin_finalize"
>               version="0.5.13"
>@@ -31959,6 +32064,150 @@
>         </parameter>
>       </parameters>
>     </function>
>+    <function name="g_hash_table_update"
>+              c:identifier="tp_g_hash_table_update"
>+              version="0.7.0"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Add each item in @source to @target, replacing any existing item with the
>+same key. @key_dup and @value_dup are used to duplicate the items; in
>+principle they could also be used to convert between types.</doc>
>+      <return-value transfer-ownership="none">
>+        <type name="none" c:type="void"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="target" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The hash table to be updated</doc>
>+          <type name="GLib.HashTable" c:type="GHashTable*">
>+            <type name="gpointer" c:type="gpointer"/>
>+            <type name="gpointer" c:type="gpointer"/>
>+          </type>
>+        </parameter>
>+        <parameter name="source" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The hash table to update it with (read-only)</doc>
>+          <type name="GLib.HashTable" c:type="GHashTable*">
>+            <type name="gpointer" c:type="gpointer"/>
>+            <type name="gpointer" c:type="gpointer"/>
>+          </type>
>+        </parameter>
>+        <parameter name="key_dup" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">function to duplicate a key from @source so it can be be stored in @target. If NULL, the key is not copied, but is used as-is</doc>
>+          <type name="GObject.BoxedCopyFunc" c:type="GBoxedCopyFunc"/>
>+        </parameter>
>+        <parameter name="value_dup" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">function to duplicate a value from @source so it can be stored in @target. If NULL, the value is not copied, but is used as-is</doc>
>+          <type name="GObject.BoxedCopyFunc" c:type="GBoxedCopyFunc"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="g_key_file_get_int64"
>+              c:identifier="tp_g_key_file_get_int64"
>+              version="0.7.31"
>+              introspectable="0"
>+              throws="1">
>+      <doc xml:whitespace="preserve">Returns the value associated with @key under @group_name as a signed
>+64-bit integer. This is similar to g_key_file_get_integer() but can return
>+64-bit results without truncation.
>+
>+0 if the key was not found or could not be parsed.</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">the value associated with the key as a signed 64-bit integer, or</doc>
>+        <type name="gint64" c:type="gint64"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="key_file" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-%NULL #GKeyFile</doc>
>+          <type name="GLib.KeyFile" c:type="GKeyFile*"/>
>+        </parameter>
>+        <parameter name="group_name" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-%NULL group name</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+        <parameter name="key" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-%NULL key</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="g_key_file_get_uint64"
>+              c:identifier="tp_g_key_file_get_uint64"
>+              version="0.7.31"
>+              introspectable="0"
>+              throws="1">
>+      <doc xml:whitespace="preserve">Returns the value associated with @key under @group_name as an unsigned
>+64-bit integer. This is similar to g_key_file_get_integer() but can return
>+large positive results without truncation.
>+
>+or 0 if the key was not found or could not be parsed.</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">the value associated with the key as an unsigned 64-bit integer,</doc>
>+        <type name="guint64" c:type="guint64"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="key_file" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-%NULL #GKeyFile</doc>
>+          <type name="GLib.KeyFile" c:type="GKeyFile*"/>
>+        </parameter>
>+        <parameter name="group_name" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-%NULL group name</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+        <parameter name="key" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-%NULL key</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="g_ptr_array_contains"
>+              c:identifier="tp_g_ptr_array_contains"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">&lt;!--no further documentation needed--&gt;</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">%TRUE if @needle is one of the elements of @haystack</doc>
>+        <type name="gboolean" c:type="gboolean"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="haystack" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The pointer array to be searched</doc>
>+          <array name="GLib.PtrArray" c:type="GPtrArray*">
>+            <type name="gpointer" c:type="gpointer"/>
>+          </array>
>+        </parameter>
>+        <parameter name="needle" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The pointer to look for</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="g_ptr_array_extend"
>+              c:identifier="tp_g_ptr_array_extend"
>+              version="0.14.3"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Appends all elements of @source to @target. Note that this only copies the
>+pointers from @source; any duplication or reference-incrementing must be
>+performed by the caller.
>+
>+After this function has been called, it is safe to call
>+g_ptr_array_free() on @source and also free the actual pointer array,
>+as long as doing so does not free the data pointed to by the new
>+items in @target.</doc>
>+      <return-value transfer-ownership="none">
>+        <type name="none" c:type="void"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="target" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a #GPtrArray to copy items to</doc>
>+          <array name="GLib.PtrArray" c:type="GPtrArray*">
>+            <type name="gpointer" c:type="gpointer"/>
>+          </array>
>+        </parameter>
>+        <parameter name="source" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a #GPtrArray to copy items from</doc>
>+          <array name="GLib.PtrArray" c:type="GPtrArray*">
>+            <type name="gpointer" c:type="gpointer"/>
>+          </array>
>+        </parameter>
>+      </parameters>
>+    </function>
>     <function name="g_set_error_invalid_handle_type"
>               c:identifier="tp_g_set_error_invalid_handle_type"
>               introspectable="0"
>@@ -31997,6 +32246,89 @@
>         </parameter>
>       </parameters>
>     </function>
>+    <function name="g_signal_connect_object"
>+              c:identifier="tp_g_signal_connect_object"
>+              version="0.9.2"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Connects a #GCallback function to a signal for a particular object, as if
>+with g_signal_connect(). Additionally, arranges for the signal handler to be
>+disconnected if @gobject is destroyed.
>+
>+This is similar to g_signal_connect_data(), but uses a closure which
>+ensures that the @gobject stays alive during the call to @c_handler
>+by temporarily adding a reference count to @gobject.
>+
>+This is similar to g_signal_connect_object(), but doesn't have the
>+documented bug that everyone is too scared to fix. Also, it does not allow
>+you to pass in NULL as @gobject
>+
>+This is intended to be a convenient way for objects to use themselves as
>+user_data for callbacks without having to explicitly disconnect all the
>+handlers in their finalizers.
>+
>+Changed in 0.10.4 and 0.11.3: %G_CONNECT_AFTER is now respected.</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">the handler id</doc>
>+        <type name="gulong" c:type="gulong"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="instance" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">the instance to connect to.</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="detailed_signal" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a string of the form "signal-name::detail".</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+        <parameter name="c_handler" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">the #GCallback to connect.</doc>
>+          <type name="GObject.Callback" c:type="GCallback"/>
>+        </parameter>
>+        <parameter name="gobject" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">the object to pass as data to @c_handler.</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="connect_flags" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a combination of #GConnectFlags. Only %G_CONNECT_AFTER and %G_CONNECT_SWAPPED are supported by this function.</doc>
>+          <type name="GObject.ConnectFlags" c:type="GConnectFlags"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="g_value_slice_dup"
>+              c:identifier="tp_g_value_slice_dup"
>+              version="0.5.14"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">&lt;!-- 'Returns' says it all --&gt;
>+
>+tp_g_value_slice_free() or g_slice_free().</doc>
>+      <return-value transfer-ownership="full">
>+        <doc xml:whitespace="preserve">a newly allocated copy of @value, to be freed with</doc>
>+        <type name="GObject.Value" c:type="GValue*"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="value" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A GValue</doc>
>+          <type name="GObject.Value" c:type="GValue*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="g_value_slice_free"
>+              c:identifier="tp_g_value_slice_free"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Unset and free a slice-allocated GValue.
>+
>+&lt;literal&gt;(GDestroyNotify) tp_g_value_slice_free&lt;/literal&gt; can be used
>+as a destructor for values in a #GHashTable, for example.</doc>
>+      <return-value transfer-ownership="none">
>+        <type name="none" c:type="void"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="value" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A GValue which was allocated with the g_slice API</doc>
>+          <type name="GObject.Value" c:type="GValue*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>     <function name="get_bus" c:identifier="tp_get_bus" introspectable="0">
>       <doc xml:whitespace="preserve">Returns a connection to the D-Bus daemon on which this process was
> activated if it was launched by D-Bus service activation, or the session
>@@ -34022,6 +34354,81 @@
>         </parameter>
>       </parameters>
>     </function>
>+    <function name="mixin_class_get_offset"
>+              c:identifier="tp_mixin_class_get_offset"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">If the type of @klass, or any of its ancestor types, has had an offset
>+attached using qdata with the given @quark, return that offset; if not,
>+return 0.
>+
>+In older telepathy-glib versions, calling this function on an instance that
>+did not have the mixin was considered to be a programming error. Since
>+version 0.13.9, 0 is returned, without error.
>+
>+This is used to implement the telepathy-glib mixin classes.</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">the offset of the mixin class</doc>
>+        <type name="guint" c:type="guint"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="klass" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A pointer to a GObjectClass-derived class structure</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="quark" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A quark that was used to store the offset with g_type_set_qdata()</doc>
>+          <type name="GLib.Quark" c:type="GQuark"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="mixin_instance_get_offset"
>+              c:identifier="tp_mixin_instance_get_offset"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">If the type of @instance, or any of its ancestor types, has had an offset
>+attached using qdata with the given @quark, return that offset. If not,
>+return 0.
>+
>+In older telepathy-glib versions, calling this function on an instance that
>+did not have the mixin was considered to be a programming error. Since
>+version 0.13.9, 0 is returned, without error.
>+
>+This is used to implement the telepathy-glib mixin classes.</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">the offset of the mixin</doc>
>+        <type name="guint" c:type="guint"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="instance" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A pointer to a GObject-derived instance structure</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="quark" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A quark that was used to store the offset with g_type_set_qdata()</doc>
>+          <type name="GLib.Quark" c:type="GQuark"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="mixin_offset_cast"
>+              c:identifier="tp_mixin_offset_cast"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Extend a pointer by an offset, provided the offset is not 0.
>+This is used to cast from an object instance to one of the telepathy-glib
>+mixin classes.</doc>
>+      <return-value>
>+        <doc xml:whitespace="preserve">a pointer @offset bytes beyond @instance</doc>
>+        <type name="gpointer" c:type="gpointer"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="instance" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">A pointer to a structure</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="offset" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The offset of a structure member in bytes, which must not be 0</doc>
>+          <type name="guint" c:type="guint"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>     <function name="presence_mixin_class_get_offset_quark"
>               c:identifier="tp_presence_mixin_class_get_offset_quark"
>               moved-to="PresenceMixinClass.get_offset_quark"
>@@ -34278,6 +34685,85 @@
>         </parameter>
>       </parameters>
>     </function>
>+    <function name="simple_async_report_success_in_idle"
>+              c:identifier="tp_simple_async_report_success_in_idle"
>+              version="0.11.9">
>+      <doc xml:whitespace="preserve">Create a new #GSimpleAsyncResult with no operation result, and call
>+g_simple_async_result_complete_in_idle() on it.
>+
>+This is like a successful version of g_simple_async_report_error_in_idle(),
>+suitable for asynchronous functions that (conceptually) either succeed and
>+return nothing, or raise an error, such as tp_proxy_prepare_async().
>+
>+The corresponding finish function should not call a function that attempts
>+to get a result, such as g_simple_async_result_get_op_res_gpointer().</doc>
>+      <return-value transfer-ownership="none">
>+        <type name="none" c:type="void"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="source" transfer-ownership="none" allow-none="1">
>+          <doc xml:whitespace="preserve">the source object</doc>
>+          <type name="GObject.Object" c:type="GObject*"/>
>+        </parameter>
>+        <parameter name="callback"
>+                   transfer-ownership="none"
>+                   allow-none="1"
>+                   scope="async"
>+                   closure="2">
>+          <doc xml:whitespace="preserve">the callback</doc>
>+          <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
>+        </parameter>
>+        <parameter name="user_data" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">user data for @callback</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="source_tag" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">the source tag for the #GSimpleAsyncResult</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="strdiff" c:identifier="tp_strdiff" introspectable="0">
>+      <doc xml:whitespace="preserve">Return %TRUE if the given strings are different. Unlike #strcmp this
>+function will handle null pointers, treating them as distinct from any
>+string.
>+
>+neither is %NULL and both have the same contents; %TRUE otherwise</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">%FALSE if @left and @right are both %NULL, or if</doc>
>+        <type name="gboolean" c:type="gboolean"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="left" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The first string to compare (may be NULL)</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+        <parameter name="right" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The second string to compare (may be NULL)</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="strv_contains"
>+              c:identifier="tp_strv_contains"
>+              version="0.7.15"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">&lt;!-- --&gt;</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">TRUE if @str is an element of @strv, according to strcmp().</doc>
>+        <type name="gboolean" c:type="gboolean"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="strv" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a NULL-terminated array of strings, or %NULL (which is treated as an empty strv)</doc>
>+          <type name="utf8" c:type="gchar**"/>
>+        </parameter>
>+        <parameter name="str" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">a non-NULL string</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>     <function name="svc_interface_get_dbus_properties_info"
>               c:identifier="tp_svc_interface_get_dbus_properties_info"
>               version="0.15.8"
>@@ -34324,5 +34810,177 @@
>         </parameter>
>       </parameters>
>     </function>
>+    <function name="user_action_time_from_x11"
>+              c:identifier="tp_user_action_time_from_x11"
>+              version="0.11.13">
>+      <doc xml:whitespace="preserve">Convert an X11 timestamp into a user action time as used in Telepathy.
>+
>+This also works for the timestamps used by GDK 2, GDK 3 and Clutter 1.0;
>+it may or may not work with other toolkits or versions.
>+
>+%TP_USER_ACTION_TIME_CURRENT_TIME</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">a nonzero Telepathy user action time, or</doc>
>+        <type name="gint64" c:type="gint64"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="x11_time" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">an X11 timestamp, or 0 to indicate the current time</doc>
>+          <type name="guint32" c:type="guint32"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="user_action_time_should_present"
>+              c:identifier="tp_user_action_time_should_present"
>+              version="0.11.13">
>+      <doc xml:whitespace="preserve">Interpret a Telepathy user action time to decide whether a Handler should
>+attempt to gain focus. If %TRUE is returned, it would be appropriate to
>+call gtk_window_present_with_time() using @x11_time as input, for instance.
>+
>+@x11_time is used to return a timestamp in the right format for X11,
>+GDK 2, GDK 3 and Clutter 1.0; it may or may not work with other
>+toolkits or versions.</doc>
>+      <return-value transfer-ownership="none">
>+        <doc xml:whitespace="preserve">%TRUE if it would be appropriate to present a window</doc>
>+        <type name="gboolean" c:type="gboolean"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="user_action_time" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">the Telepathy user action time</doc>
>+          <type name="gint64" c:type="gint64"/>
>+        </parameter>
>+        <parameter name="x11_time"
>+                   direction="out"
>+                   caller-allocates="0"
>+                   transfer-ownership="full"
>+                   allow-none="1">
>+          <doc xml:whitespace="preserve">a pointer to guint32 used to return an X11 timestamp, or 0 to indicate the current time; if %FALSE is returned, the value placed here is not meaningful</doc>
>+          <type name="guint32" c:type="guint32*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="utf8_make_valid"
>+              c:identifier="tp_utf8_make_valid"
>+              version="0.13.15">
>+      <doc xml:whitespace="preserve">Validate that the provided string is valid UTF8. If not,
>+replace all invalid bytes with unicode replacement
>+character (U+FFFD).
>+
>+This method is a verbatim copy of glib's internal
>+_g_utf8_make_valid&lt;!-- --&gt;() function, and will be deprecated as
>+soon as the glib one becomes public.</doc>
>+      <return-value transfer-ownership="full">
>+        <doc xml:whitespace="preserve">a new valid UTF8 string</doc>
>+        <type name="utf8" c:type="gchar*"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="name" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">string to coerce into UTF8</doc>
>+          <type name="utf8" c:type="gchar*"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="value_array_build"
>+              c:identifier="tp_value_array_build"
>+              version="0.9.2"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Creates a new #GValueArray for use with structs, containing the values
>+passed in as parameters. The values are copied or reffed as appropriate for
>+their type.
>+
>+&lt;example&gt;
>+&lt;title&gt; using tp_value_array_build&lt;/title&gt;
>+&lt;programlisting&gt;
>+GValueArray *array = tp_value_array_build (2,
>+G_TYPE_STRING, host,
>+G_TYPE_UINT, port,
>+G_TYPE_INVALID);
>+&lt;/programlisting&gt;
>+&lt;/example&gt;</doc>
>+      <return-value transfer-ownership="full">
>+        <doc xml:whitespace="preserve">a newly created #GValueArray, free with g_value_array_free.</doc>
>+        <type name="GObject.ValueArray" c:type="GValueArray*"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="length" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The number of elements that should be in the array</doc>
>+          <type name="gsize" c:type="gsize"/>
>+        </parameter>
>+        <parameter name="type" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The type of the first argument.</doc>
>+          <type name="GType" c:type="GType"/>
>+        </parameter>
>+        <parameter transfer-ownership="none">
>+          <varargs>
>+          </varargs>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="value_array_unpack"
>+              c:identifier="tp_value_array_unpack"
>+              version="0.11.0"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Unpacks a #GValueArray into separate variables.
>+
>+The contents of the values aren't copied into the variables, and so become
>+invalid when @array is freed.
>+
>+&lt;example&gt;
>+&lt;title&gt;using tp_value_array_unpack&lt;/title&gt;
>+&lt;programlisting&gt;
>+const gchar *host;
>+guint port;
>+
>+tp_value_array_unpack (array, 2,
>+&amp;host,
>+&amp;port);
>+&lt;/programlisting&gt;
>+&lt;/example&gt;</doc>
>+      <return-value transfer-ownership="none">
>+        <type name="none" c:type="void"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="array" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">the array to unpack</doc>
>+          <type name="GObject.ValueArray" c:type="GValueArray*"/>
>+        </parameter>
>+        <parameter name="len" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">The number of elements that should be in the array</doc>
>+          <type name="gsize" c:type="gsize"/>
>+        </parameter>
>+        <parameter transfer-ownership="none">
>+          <varargs>
>+          </varargs>
>+        </parameter>
>+      </parameters>
>+    </function>
>+    <function name="weak_ref_new"
>+              c:identifier="tp_weak_ref_new"
>+              moved-to="WeakRef.new"
>+              version="0.11.3"
>+              introspectable="0">
>+      <doc xml:whitespace="preserve">Return a new weak reference wrapper for @object.
>+
>+
>+Free-function: tp_weak_ref_destroy()</doc>
>+      <return-value transfer-ownership="full">
>+        <doc xml:whitespace="preserve">a new weak-reference wrapper</doc>
>+        <type name="WeakRef" c:type="TpWeakRef*"/>
>+      </return-value>
>+      <parameters>
>+        <parameter name="object" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">an object to which to take a weak reference</doc>
>+          <type name="GObject.Object" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="user_data" transfer-ownership="none">
>+          <doc xml:whitespace="preserve">optional additional data to store alongside the weak ref</doc>
>+          <type name="gpointer" c:type="gpointer"/>
>+        </parameter>
>+        <parameter name="destroy" transfer-ownership="none" scope="async">
>+          <doc xml:whitespace="preserve">destructor for @user_data, called when the weak ref is freed</doc>
>+          <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
>+        </parameter>
>+      </parameters>
>+    </function>
>   </namespace>
> </repository>

Actions: View

Attachments on bug 54543: 66665 | 66666

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.