--- 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">
+
+ 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.
+
+ 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.
+
+
+
+
+
+ If the weakly referenced object still exists, return a new reference to
+it. Otherwise, return %NULL.
+
+ a new reference, or %NULL
+
+
+
+
+ Return the additional data that was passed to tp_weak_ref_new().
+
+%NULL
+
+ the additional data supplied in tp_weak_ref_new(), which may be
+
+
+
+
+ Return a new weak reference wrapper for @object.
+
+
+Free-function: tp_weak_ref_destroy()
+
+ a new weak-reference wrapper
+
+
+
+
+ an object to which to take a weak reference
+
+
+
+ optional additional data to store alongside the weak ref
+
+
+
+ destructor for @user_data, called when the weak ref is freed
+
+
+
+
+
@@ -31846,6 +31920,37 @@
+
+ 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" -> _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
+
+ the escaped string, which must be freed by
+
+
+
+
+ The string to be escaped
+
+
+
+
+
+ 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.
+
+
+
+
+
+ The hash table to be updated
+
+
+
+
+
+
+ The hash table to update it with (read-only)
+
+
+
+
+
+
+ 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
+
+
+
+ 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
+
+
+
+
+
+ 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.
+
+ the value associated with the key as a signed 64-bit integer, or
+
+
+
+
+ a non-%NULL #GKeyFile
+
+
+
+ a non-%NULL group name
+
+
+
+ a non-%NULL key
+
+
+
+
+
+ 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.
+
+ the value associated with the key as an unsigned 64-bit integer,
+
+
+
+
+ a non-%NULL #GKeyFile
+
+
+
+ a non-%NULL group name
+
+
+
+ a non-%NULL key
+
+
+
+
+
+ <!--no further documentation needed-->
+
+ %TRUE if @needle is one of the elements of @haystack
+
+
+
+
+ The pointer array to be searched
+
+
+
+
+
+ The pointer to look for
+
+
+
+
+
+ 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.
+
+
+
+
+
+ a #GPtrArray to copy items to
+
+
+
+
+
+ a #GPtrArray to copy items from
+
+
+
+
+
+
+
+ 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.
+
+ the handler id
+
+
+
+
+ the instance to connect to.
+
+
+
+ a string of the form "signal-name::detail".
+
+
+
+ the #GCallback to connect.
+
+
+
+ the object to pass as data to @c_handler.
+
+
+
+ a combination of #GConnectFlags. Only %G_CONNECT_AFTER and %G_CONNECT_SWAPPED are supported by this function.
+
+
+
+
+
+ <!-- 'Returns' says it all -->
+
+tp_g_value_slice_free() or g_slice_free().
+
+ a newly allocated copy of @value, to be freed with
+
+
+
+
+ A GValue
+
+
+
+
+
+ Unset and free a slice-allocated GValue.
+
+<literal>(GDestroyNotify) tp_g_value_slice_free</literal> can be used
+as a destructor for values in a #GHashTable, for example.
+
+
+
+
+
+ A GValue which was allocated with the g_slice API
+
+
+
+
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 @@
+
+ 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.
+
+ the offset of the mixin class
+
+
+
+
+ A pointer to a GObjectClass-derived class structure
+
+
+
+ A quark that was used to store the offset with g_type_set_qdata()
+
+
+
+
+
+ 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.
+
+ the offset of the mixin
+
+
+
+
+ A pointer to a GObject-derived instance structure
+
+
+
+ A quark that was used to store the offset with g_type_set_qdata()
+
+
+
+
+
+ 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.
+
+ a pointer @offset bytes beyond @instance
+
+
+
+
+ A pointer to a structure
+
+
+
+ The offset of a structure member in bytes, which must not be 0
+
+
+
+
+
+ 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().
+
+
+
+
+
+ the source object
+
+
+
+ the callback
+
+
+
+ user data for @callback
+
+
+
+ the source tag for the #GSimpleAsyncResult
+
+
+
+
+
+ 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
+
+ %FALSE if @left and @right are both %NULL, or if
+
+
+
+
+ The first string to compare (may be NULL)
+
+
+
+ The second string to compare (may be NULL)
+
+
+
+
+
+ <!-- -->
+
+ TRUE if @str is an element of @strv, according to strcmp().
+
+
+
+
+ a NULL-terminated array of strings, or %NULL (which is treated as an empty strv)
+
+
+
+ a non-NULL string
+
+
+
+
+
+ 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
+
+ a nonzero Telepathy user action time, or
+
+
+
+
+ an X11 timestamp, or 0 to indicate the current time
+
+
+
+
+
+ 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.
+
+ %TRUE if it would be appropriate to present a window
+
+
+
+
+ the Telepathy user action time
+
+
+
+ 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
+
+
+
+
+
+ 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<!-- -->() function, and will be deprecated as
+soon as the glib one becomes public.
+
+ a new valid UTF8 string
+
+
+
+
+ string to coerce into UTF8
+
+
+
+
+
+ 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.
+
+<example>
+<title> using tp_value_array_build</title>
+<programlisting>
+GValueArray *array = tp_value_array_build (2,
+G_TYPE_STRING, host,
+G_TYPE_UINT, port,
+G_TYPE_INVALID);
+</programlisting>
+</example>
+
+ a newly created #GValueArray, free with g_value_array_free.
+
+
+
+
+ The number of elements that should be in the array
+
+
+
+ The type of the first argument.
+
+
+
+
+
+
+
+
+
+ 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.
+
+<example>
+<title>using tp_value_array_unpack</title>
+<programlisting>
+const gchar *host;
+guint port;
+
+tp_value_array_unpack (array, 2,
+&host,
+&port);
+</programlisting>
+</example>
+
+
+
+
+
+ the array to unpack
+
+
+
+ The number of elements that should be in the array
+
+
+
+
+
+
+
+
+
+ Return a new weak reference wrapper for @object.
+
+
+Free-function: tp_weak_ref_destroy()
+
+ a new weak-reference wrapper
+
+
+
+
+ an object to which to take a weak reference
+
+
+
+ optional additional data to store alongside the weak ref
+
+
+
+ destructor for @user_data, called when the weak ref is freed
+
+
+
+