Commit upstream/0.7.37 - telepathy-glib

Imported Upstream version 0.7.37 Simon McVittie 14 years ago

69 changed file(s) with 2580 addition(s) and 873 deletion(s). Raw diff Collapse all Expand all

+74

-0

ChangeLog less more

	0	commit ce29153497e4cb1c6039b9e3bb58af163302ede4
	1	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	2	Date: 2009-09-14 15:32:47 +0100
	3
	4	NEWS for spec 0.17.28
	5
	6	commit 9d012f3f26bbb8c13100ad0322ae1a3f880d0665
	7	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	8	Date: 2009-09-14 15:21:57 +0100
	9
	10	Enable ContactCapabilities code generation and document the result
	11
	12	commit e4b7fab2049a2d22db0bbd086a2d1aa823606edc
	13	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	14	Date: 2009-09-14 13:37:56 +0100
	15
	16	Update spec to 0.17.28
	17
	18	* ContactCapabilities undrafted (identical to draft 2)
	19	* In_Progress call state
	20	* InitialAudio, InitialVideo, ImmutableStreams properties on streamed
	21	media calls
	22
	23	commit a40095761920c9c6fd8505d5eb16b686df23b0bb
	24	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	25	Date: 2009-09-10 18:18:33 +0100
	26
	27	NEWS for debug improvements
	28
	29	commit 2b61c4a7907c3815aead4e4f3f539f7dc93c0261
	30	Merge: fbf0e83 ca23208
	31	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	32	Date: 2009-09-10 18:15:46 +0100
	33
	34	Merge branch 'debug-sender'
	35
	36	Reviewed-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
	37
	38	commit ca2320888a87157518f35ea1ac5141910acd47d5
	39	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	40	Date: 2009-09-10 17:56:37 +0100
	41
	42	tp_debug_sender_log_handler: explain why @exclude is useful
	43
	44	commit a4206720755969ab923f6bea1148a79cbd8a1823
	45	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	46	Date: 2009-09-10 17:55:49 +0100
	47
	48	fd.o#23843: tp_debug_sender_log_handler: correct logic for exclude=NULL to exclude nothing
	49
	50	Also elide an unnecessary variable.
	51
	52	commit fbf0e837f7d94667744783d26afe8e2661dd3c92
	53	Author: Jonny Lamb <jonny.lamb@collabora.co.uk>
	54	Date: 2009-09-04 15:05:35 +0100
	55
	56	tests: add a test for debug domains being set correctly
	57
	58	Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
	59
	60	commit e442e00127d031b9f64c4b9ca203966bc8ec757a
	61	Author: Jonny Lamb <jonny.lamb@collabora.co.uk>
	62	Date: 2009-04-20 17:20:54 +0100
	63
	64	debug: set the log domain to tp-glib/$category
	65
	66	Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
	67
	68	commit 6af5cb11e18f94a02274b48749aca1c13a57229f
	69	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	70	Date: 2009-09-03 20:54:55 +0100
	71
	72	Nano version
	73
0	74	commit 6739a4296e5eb609b4bbf3ed52ff342a16f2a076
1	75	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2	76	Date: 2009-09-03 20:15:10 +0100

+21

-0

NEWS less more

	0	telepathy-glib 0.7.37 (2009-09-14)
	1	==================================
	2
	3	The "Lego Batman" release.
	4
	5	Enhancements:
	6
	7	* Update to telepathy-spec 0.17.28
	8	* add ContactCapabilities interface
	9	* add InitialVideo, InitialAudio, ImmutableStreams properties to
	10	StreamedMedia
	11	* add TP_CHANNEL_CALL_STATE_FLAG_IN_PROGRESS
	12
	13	* Set the debug domain for telepathy-glib to tp-glib/$category, e.g.
	14	tp-glib/connection for TpConnection and TpBaseConnection (jonny)
	15
	16	Fixes:
	17
	18	* fd.o #23843: make tp_debug_sender_log_handler with exclude=NULL include
	19	everything, rather than nothing (smcv)
	20
0	21	telepathy-glib 0.7.36 (2009-09-03)
1	22	==================================
2	23

+12

-12

configure less more

0	0	#! /bin/sh
1	1	# Guess values for system-dependent variables and create Makefiles.
2		# Generated by GNU Autoconf 2.64 for Telepathy-GLib 0.7.36.
	2	# Generated by GNU Autoconf 2.64 for Telepathy-GLib 0.7.37.
3	3	#
4	4	# Report bugs to <https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy>.
5	5	#

698	698	# Identity of this package.
699	699	PACKAGE_NAME='Telepathy-GLib'
700	700	PACKAGE_TARNAME='telepathy-glib'
701		PACKAGE_VERSION='0.7.36'
702		PACKAGE_STRING='Telepathy-GLib 0.7.36'
	701	PACKAGE_VERSION='0.7.37'
	702	PACKAGE_STRING='Telepathy-GLib 0.7.37'
703	703	PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy'
704	704	PACKAGE_URL=''
705	705

1472	1472	# Omit some internal or obsolete options to make the list less imposing.
1473	1473	# This message is too long to be a string in the A/UX 3.1 sh.
1474	1474	cat <<_ACEOF
1475		\`configure' configures Telepathy-GLib 0.7.36 to adapt to many kinds of systems.
	1475	\`configure' configures Telepathy-GLib 0.7.37 to adapt to many kinds of systems.
1476	1476
1477	1477	Usage: $0 [OPTION]... [VAR=VALUE]...
1478	1478

1542	1542
1543	1543	if test -n "$ac_init_help"; then
1544	1544	case $ac_init_help in
1545		short \| recursive ) echo "Configuration of Telepathy-GLib 0.7.36:";;
	1545	short \| recursive ) echo "Configuration of Telepathy-GLib 0.7.37:";;
1546	1546	esac
1547	1547	cat <<\_ACEOF
1548	1548

1669	1669	test -n "$ac_init_help" && exit $ac_status
1670	1670	if $ac_init_version; then
1671	1671	cat <<\_ACEOF
1672		Telepathy-GLib configure 0.7.36
	1672	Telepathy-GLib configure 0.7.37
1673	1673	generated by GNU Autoconf 2.64
1674	1674
1675	1675	Copyright (C) 2009 Free Software Foundation, Inc.

2040	2040	This file contains any messages produced by compilers while
2041	2041	running configure, to aid debugging if configure makes a mistake.
2042	2042
2043		It was created by Telepathy-GLib $as_me 0.7.36, which was
	2043	It was created by Telepathy-GLib $as_me 0.7.37, which was
2044	2044	generated by GNU Autoconf 2.64. Invocation command line was
2045	2045
2046	2046	$ $0 $@

2702	2702
2703	2703	# Define the identity of the package.
2704	2704	PACKAGE='telepathy-glib'
2705		VERSION='0.7.36'
	2705	VERSION='0.7.37'
2706	2706
2707	2707
2708	2708	cat >>confdefs.h <<_ACEOF

10967	10967
10968	10968
10969	10969
10970		LT_CURRENT=29
	10970	LT_CURRENT=30
10971	10971	LT_REVISION=0
10972		LT_AGE=29
	10972	LT_AGE=30
10973	10973
10974	10974
10975	10975

12584	12584	# report actual input values of CONFIG_FILES etc. instead of their
12585	12585	# values after options handling.
12586	12586	ac_log="
12587		This file was extended by Telepathy-GLib $as_me 0.7.36, which was
	12587	This file was extended by Telepathy-GLib $as_me 0.7.37, which was
12588	12588	generated by GNU Autoconf 2.64. Invocation command line was
12589	12589
12590	12590	CONFIG_FILES = $CONFIG_FILES

12648	12648	_ACEOF
12649	12649	cat >>$CONFIG_STATUS <<_ACEOF \|\| ac_write_fail=1
12650	12650	ac_cs_version="\\
12651		Telepathy-GLib config.status 0.7.36
	12651	Telepathy-GLib config.status 0.7.37
12652	12652	configured by $0, generated by GNU Autoconf 2.64,
12653	12653	with options \\"`$as_echo "$ac_configure_args" \| sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`\\"
12654	12654

-3

configure.ac less more

10	10
11	11	m4_define([tp_glib_major_version], [0])
12	12	m4_define([tp_glib_minor_version], [7])
13		m4_define([tp_glib_micro_version], [36])
	13	m4_define([tp_glib_micro_version], [37])
14	14	m4_define([tp_glib_nano_version], [0])
15	15
16	16	# If library source has changed since last release, increment revision

25	25	# (we don't guarantee that we won't add ABI then remove it again, if it was
26	26	# never seen in a release).
27	27
28		m4_define([tp_glib_lt_current], [29])
	28	m4_define([tp_glib_lt_current], [30])
29	29	m4_define([tp_glib_lt_revision], [0])
30		m4_define([tp_glib_lt_age], [29])
	30	m4_define([tp_glib_lt_age], [30])
31	31
32	32	# Some magic
33	33	m4_define([tp_glib_base_version],

-1

docs/reference/html/ch-client.html less more

48	48	<span class="refentrytitle"><a href="telepathy-glib-connection-contacts.html">Connection Contacts interface</a></span><span class="refpurpose"> — client-side wrappers for the Contacts interface</span>
49	49	</dt>
50	50	<dt>
51		<span class="refentrytitle"><a href="telepathy-glib-connection-caps.html">Connection Capabilities interface</a></span><span class="refpurpose"> — client-side wrappers for the Capabilities interface</span>
	51	<span class="refentrytitle"><a href="telepathy-glib-connection-caps.html">Connection ContactCapabilities and Capabilities interfaces</a></span><span class="refpurpose"> — client-side wrappers for the capabilities interfaces</span>
52	52	</dt>
53	53	<dt>
54	54	<span class="refentrytitle"><a href="telepathy-glib-connection-requests.html">Connection Requests interface</a></span><span class="refpurpose"> — client-side wrappers for the Requests interface</span>

-1

docs/reference/html/index.html less more

98	98	<span class="refentrytitle"><a href="telepathy-glib-connection-contacts.html">Connection Contacts interface</a></span><span class="refpurpose"> — client-side wrappers for the Contacts interface</span>
99	99	</dt>
100	100	<dt>
101		<span class="refentrytitle"><a href="telepathy-glib-connection-caps.html">Connection Capabilities interface</a></span><span class="refpurpose"> — client-side wrappers for the Capabilities interface</span>
	101	<span class="refentrytitle"><a href="telepathy-glib-connection-caps.html">Connection ContactCapabilities and Capabilities interfaces</a></span><span class="refpurpose"> — client-side wrappers for the capabilities interfaces</span>
102	102	</dt>
103	103	<dt>
104	104	<span class="refentrytitle"><a href="telepathy-glib-connection-requests.html">Connection Requests interface</a></span><span class="refpurpose"> — client-side wrappers for the Requests interface</span>

+21

-2

docs/reference/html/index.sgml less more

271	271	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS">
272	272	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS">
273	273	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS">
	274	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS">
	275	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS">
274	276	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS">
275	277	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS">
276	278	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS">

491	493	<ANCHOR id="TP-STRUCT-TYPE-ALIAS-PAIR--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ALIAS-PAIR--CAPS">
492	494	<ANCHOR id="TP-ARRAY-TYPE-ALIAS-PAIR-LIST--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ALIAS-PAIR-LIST--CAPS">
493	495	<ANCHOR id="TP-HASH-TYPE-AVATAR-TOKEN-MAP--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-HASH-TYPE-AVATAR-TOKEN-MAP--CAPS">
	496	<ANCHOR id="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS">
	497	<ANCHOR id="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS">
	498	<ANCHOR id="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS">
	499	<ANCHOR id="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS">
494	500	<ANCHOR id="TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS">
495	501	<ANCHOR id="TP-ARRAY-TYPE-CAPABILITY-CHANGE-LIST--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CAPABILITY-CHANGE-LIST--CAPS">
496	502	<ANCHOR id="TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS">

807	813	<ANCHOR id="telepathy-glib-connection-caps.synopsis" href="telepathy-glib/telepathy-glib-connection-caps.html#telepathy-glib-connection-caps.synopsis">
808	814	<ANCHOR id="telepathy-glib-connection-caps.description" href="telepathy-glib/telepathy-glib-connection-caps.html#telepathy-glib-connection-caps.description">
809	815	<ANCHOR id="telepathy-glib-connection-caps.details" href="telepathy-glib/telepathy-glib-connection-caps.html#telepathy-glib-connection-caps.details">
810		<ANCHOR id="tp-cli-connection-interface-capabilities-run-advertise-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-advertise-capabilities">
811		<ANCHOR id="tp-cli-connection-interface-capabilities-run-get-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-get-capabilities">
	816	<ANCHOR id="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities">
	817	<ANCHOR id="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities">
	818	<ANCHOR id="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities">
	819	<ANCHOR id="tp-cli-connection-interface-contact-capabilities-call-update-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-update-capabilities">
	820	<ANCHOR id="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed">
	821	<ANCHOR id="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed">
812	822	<ANCHOR id="tp-cli-connection-interface-capabilities-call-advertise-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-advertise-capabilities">
813	823	<ANCHOR id="tp-cli-connection-interface-capabilities-call-get-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-get-capabilities">
814	824	<ANCHOR id="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" href="telepathy-glib/telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities">

1953	1963	<ANCHOR id="tp-svc-connection-interface-capabilities-implement-get-capabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-implement-get-capabilities">
1954	1964	<ANCHOR id="tp-svc-connection-interface-capabilities-return-from-get-capabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-return-from-get-capabilities">
1955	1965	<ANCHOR id="tp-svc-connection-interface-capabilities-emit-capabilities-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-emit-capabilities-changed">
	1966	<ANCHOR id="TpSvcConnectionInterfaceContactCapabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities">
	1967	<ANCHOR id="TpSvcConnectionInterfaceContactCapabilitiesClass" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass">
	1968	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed">
	1969	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl">
	1970	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities">
	1971	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities">
	1972	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-update-capabilities-impl">
	1973	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities">
	1974	<ANCHOR id="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-update-capabilities">
1956	1975	<ANCHOR id="TpSvcConnectionInterfaceLocation" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation">
1957	1976	<ANCHOR id="TpSvcConnectionInterfaceLocationClass" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocationClass">
1958	1977	<ANCHOR id="tp-svc-connection-interface-location-emit-location-updated" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-location-emit-location-updated">

-1

docs/reference/html/telepathy-glib-asv.html less more

456	456	<p>
457	457	</p>
458	458	<div class="example">
459		<a name="id3032309"></a><p class="title"><b>Example 1. Using <a class="link" href="telepathy-glib-asv.html#tp-asv-new" title="tp_asv_new ()"><code class="function">tp_asv_new()</code></a></b></p>
	459	<a name="id2774856"></a><p class="title"><b>Example 1. Using <a class="link" href="telepathy-glib-asv.html#tp-asv-new" title="tp_asv_new ()"><code class="function">tp_asv_new()</code></a></b></p>
460	460	<div class="example-contents"><pre class="programlisting">
461	461	GHashTable *parameters = tp_asv_new (
462	462	"answer", G_TYPE_INT, 42,

-1

docs/reference/html/telepathy-glib-channel-roomlist.html less more

930	930	Connect a handler to the signal GotRooms.
931	931	</p>
932	932	<p>
933		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when information about rooms on the server becomes available. The array contains the room handle (as can be passed to the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">RequestChannel</tp:dbus-ref> method with HANDLE_TYPE_ROOM), the channel type, and a dictionary containing further information about the room as available. The following well-known keys and types are recommended for use where appropriate:</p> <dl> <dt>handle-name (s)</dt> <dd>The string name of the room handle (as would be returned by <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>)</dd> <dt>name (s)</dt> <dd>The human-readable name of the room if different from the handle</dd> <dt>description (s)</dt> <dd>A description of the room's overall purpose</dd> <dt>subject (s)</dt> <dd>The current subject of conversation in the room</dd> <dt>members (u)</dt> <dd>The number of members in the room</dd> <dt>password (b)</dt> <dd>True if the room requires a password to enter</dd> <dt>invite-only (b)</dt> <dd>True if you cannot join the room, but must be invited</dd> </dl></p>
	933	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when information about rooms on the server becomes available. The array contains the room handle (as can be passed to the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">RequestChannel</tp:dbus-ref> method with HANDLE_TYPE_ROOM), the channel type, and a dictionary containing further information about the room as available. The following well-known keys and types are recommended for use where appropriate:</p> <dl> <dt>handle-name (s)</dt> <dd>The identifier of the room (as would be returned by <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>)</dd> <dt>name (s)</dt> <dd>The human-readable name of the room if different from the handle</dd> <dt>description (s)</dt> <dd>A description of the room's overall purpose</dd> <dt>subject (s)</dt> <dd>The current subject of conversation in the room</dd> <dt>members (u)</dt> <dd>The number of members in the room</dd> <dt>password (b)</dt> <dd>True if the room requires a password to enter</dd> <dt>invite-only (b)</dt> <dd>True if you cannot join the room, but must be invited</dd> </dl></p>
934	934	<p>
935	935	</p>
936	936	<div class="variablelist"><table border="0">

-2

docs/reference/html/telepathy-glib-connection-aliasing.html less more

485	485	state.
486	486	</p>
487	487	<p>
488		Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the handle name if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</p>
	488	Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the contact identifier (i.e. the string corresponding to the handle) if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</p>
489	489	<p>
490	490	</p>
491	491	<div class="variablelist"><table border="0">

856	856	Start a GetAliases method call.
857	857	</p>
858	858	<p>
859		Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the handle name if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</p>
	859	Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the contact identifier (i.e. the string corresponding to the handle) if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</p>
860	860	<p>
861	861	</p>
862	862	<div class="variablelist"><table border="0">

+564

-263

docs/reference/html/telepathy-glib-connection-caps.html less more

1	1	<html>
2	2	<head>
3	3	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4		<title>Connection Capabilities interface</title>
	4	<title>Connection ContactCapabilities and Capabilities interfaces</title>
5	5	<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6	6	<link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7	7	<link rel="up" href="ch-client.html" title="Client-side proxies">

32	32	<a href="#telepathy-glib-connection-caps.description" class="shortcut">Description</a>
33	33	</td></tr>
34	34	</table>
35		<div class="refentry" title="Connection Capabilities interface">
	35	<div class="refentry" title="Connection ContactCapabilities and Capabilities interfaces">
36	36	<a name="telepathy-glib-connection-caps"></a><div class="titlepage"></div>
37	37	<div class="refnamediv"><table width="100%"><tr>
38	38	<td valign="top">
39		<h2><span class="refentrytitle"><a name="telepathy-glib-connection-caps.top_of_page"></a>Connection Capabilities interface</span></h2>
40		<p>Connection Capabilities interface — client-side wrappers for the Capabilities interface</p>
	39	<h2><span class="refentrytitle"><a name="telepathy-glib-connection-caps.top_of_page"></a>Connection ContactCapabilities and Capabilities interfaces</span></h2>
	40	<p>Connection ContactCapabilities and Capabilities interfaces — client-side wrappers for the capabilities interfaces</p>
41	41	</td>
42	42	<td valign="top" align="right"></td>
43	43	</tr></table></div>

47	47
48	48	#include <telepathy-glib/connection.h>
49	49
50		<a
51		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
52		>gboolean</a> <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-advertise-capabilities" title="tp_cli_connection_interface_capabilities_run_advertise_capabilities ()">tp_cli_connection_interface_capabilities_run_advertise_capabilities</a>
	50	void (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()">*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</a>)
	51	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	52	<a
	53	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	54	>GHashTable</a> *out_Contact_Capabilities,
	55	const <a
	56	href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
	57	>GError</a> *error,
	58	<a
	59	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	60	>gpointer</a> user_data,
	61	<a
	62	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	63	>GObject</a> *weak_object);
	64	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()">tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities</a>
53	65	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
54	66	<a
55	67	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
56	68	>gint</a> timeout_ms,
57	69	const <a
58		href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
59		>GPtrArray</a> *in_Add,
60		const <a
61		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
62		>gchar</a> **in_Remove,
63		<a
64		href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
65		>GPtrArray</a> **out_Self_Capabilities,
66		<a
	70	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
	71	>GArray</a> *in_handles,
	72	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</a> callback,
	73	<a
	74	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	75	>gpointer</a> user_data,
	76	<a
	77	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	78	>GDestroyNotify</a> destroy,
	79	<a
	80	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	81	>GObject</a> *weak_object);
	82	void (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()">*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</a>)
	83	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	84	const <a
67	85	href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
68		>GError</a> **error,
69		<a
70		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
71		>GMainLoop</a> **loop);
72		<a
73		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
74		>gboolean</a> <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-get-capabilities" title="tp_cli_connection_interface_capabilities_run_get_capabilities ()">tp_cli_connection_interface_capabilities_run_get_capabilities</a>
	86	>GError</a> *error,
	87	<a
	88	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	89	>gpointer</a> user_data,
	90	<a
	91	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	92	>GObject</a> *weak_object);
	93	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()">tp_cli_connection_interface_contact_capabilities_call_update_capabilities</a>
75	94	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
76	95	<a
77	96	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
78	97	>gint</a> timeout_ms,
79	98	const <a
80		href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
81		>GArray</a> *in_Handles,
82		<a
83	99	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
84		>GPtrArray</a> **out_Contact_Capabilities,
	100	>GPtrArray</a> *in_Handler_Capabilities,
	101	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</a> callback,
	102	<a
	103	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	104	>gpointer</a> user_data,
	105	<a
	106	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	107	>GDestroyNotify</a> destroy,
	108	<a
	109	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	110	>GObject</a> *weak_object);
	111	void (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()">*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</a>)
	112	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	113	<a
	114	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	115	>GHashTable</a> *arg_caps,
	116	<a
	117	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	118	>gpointer</a> user_data,
	119	<a
	120	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	121	>GObject</a> *weak_object);
	122	<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed</a>
	123	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	124	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</a> callback,
	125	<a
	126	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	127	>gpointer</a> user_data,
	128	<a
	129	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	130	>GDestroyNotify</a> destroy,
	131	<a
	132	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	133	>GObject</a> *weak_object,
85	134	<a
86	135	href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
87		>GError</a> **error,
88		<a
89		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
90		>GMainLoop</a> **loop);
	136	>GError</a> **error);
	137
	138
91	139	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-advertise-capabilities" title="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()">tp_cli_connection_interface_capabilities_call_advertise_capabilities</a>
92	140	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
93	141	<a

187	235	<a name="telepathy-glib-connection-caps.description"></a><h2>Description</h2>
188	236	<p>
189	237	Some instant messaging protocols allow discovery of the capabilities of
190		a user's client. In Telepathy, this is represented by the Capabilities
191		interface, which lets applications advertise extra capabilities for the
192		local user, and query the interfaces supported by their contacts.
	238	a user's client. In Telepathy, this is represented by the
	239	ContactCapabilities interface, which lets applications advertise extra
	240	capabilities for the local user, and query the interfaces supported by
	241	their contacts.
	242	</p>
	243	<p>
	244	The Capabilities interface is an older API with similar functionality.
193	245	</p>
194	246	<p>
195	247	This section documents the auto-generated C wrappers for the
196		Capabilities interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.</p>
	248	ContactCapabilities and Capabilities interfaces, used with
	249	<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.</p>
197	250	<p>
198	251	</p>
199	252	</div>
200	253	<div class="refsect1" title="Details">
201	254	<a name="telepathy-glib-connection-caps.details"></a><h2>Details</h2>
202		<div class="refsect2" title="tp_cli_connection_interface_capabilities_run_advertise_capabilities ()">
203		<a name="tp-cli-connection-interface-capabilities-run-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_run_advertise_capabilities ()</h3>
204		<pre class="programlisting"><a
205		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
206		>gboolean</a> tp_cli_connection_interface_capabilities_run_advertise_capabilities
207		(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
208		<a
209		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
210		>gint</a> timeout_ms,
211		const <a
212		href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
213		>GPtrArray</a> *in_Add,
214		const <a
215		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
216		>gchar</a> **in_Remove,
217		<a
218		href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
219		>GPtrArray</a> **out_Self_Capabilities,
220		<a
	255	<div class="refsect2" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()">
	256	<a name="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()</h3>
	257	<pre class="programlisting">void (*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities)
	258	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	259	<a
	260	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	261	>GHashTable</a> *out_Contact_Capabilities,
	262	const <a
221	263	href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
222		>GError</a> **error,
223		<a
224		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
225		>GMainLoop</a> **loop);</pre>
226		<p>
227		Call the method AdvertiseCapabilities and run the main loop
228		until it returns. Before calling this method, you must
229		add a reference to any borrowed objects you need to keep,
230		and generally ensure that everything is in a consistent
231		state.
232		</p>
233		<p>
234		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></p>
	264	>GError</a> *error,
	265	<a
	266	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	267	>gpointer</a> user_data,
	268	<a
	269	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	270	>GObject</a> *weak_object);</pre>
	271	<p>
	272	Signature of the callback called when a GetContactCapabilities method call
	273	succeeds or fails.</p>
235	274	<p>
236	275	</p>
237	276	<div class="variablelist"><table border="0">

239	278	<tbody>
240	279	<tr>
241	280	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
242		<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
243		</td>
244		</tr>
245		<tr>
246		<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
247		<td> Timeout in milliseconds, or -1 for default
248		</td>
249		</tr>
250		<tr>
251		<td><p><span class="term"><em class="parameter"><code>in_Add</code></em> :</span></p></td>
252		<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
253		</td>
254		</tr>
255		<tr>
256		<td><p><span class="term"><em class="parameter"><code>in_Remove</code></em> :</span></p></td>
257		<td> Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove
258		</td>
259		</tr>
260		<tr>
261		<td><p><span class="term"><em class="parameter"><code>out_Self_Capabilities</code></em> :</span></p></td>
262		<td> Used to return an 'out' argument if <a
263		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
264		><code class="literal">TRUE</code></a> is returned: An array of structures describing the current capabilities containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
	281	<td> the proxy on which the call was made
	282	</td>
	283	</tr>
	284	<tr>
	285	<td><p><span class="term"><em class="parameter"><code>out_Contact_Capabilities</code></em> :</span></p></td>
	286	<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
	287	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	288	><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a dictionary mapping the channel properties to their values.</li> <li>an array of additional allowed properties</li> </ul>
265	289	</td>
266	290	</tr>
267	291	<tr>
268	292	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
269		<td> If not <a
270		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
271		><code class="literal">NULL</code></a>, used to return errors if <a
272		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
273		><code class="literal">FALSE</code></a>
274		is returned
275		</td>
276		</tr>
277		<tr>
278		<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
279		<td> If not <a
280		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
281		><code class="literal">NULL</code></a>, set before re-entering
282		the main loop, to point to a <a
283		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
284		><span class="type">GMainLoop</span></a>
285		which can be used to cancel this call with
286		<a
287		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
288		><code class="function">g_main_loop_quit()</code></a>, causing a return of
289		<a
290		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
291		><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
292		</td>
293		</tr>
294		<tr>
295		<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
296		<td> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error
	293	<td> <a
	294	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	295	><code class="literal">NULL</code></a> on success, or an error on failure
	296	</td>
	297	</tr>
	298	<tr>
	299	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	300	<td> user-supplied data
	301	</td>
	302	</tr>
	303	<tr>
	304	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	305	<td> user-supplied object
297	306	</td>
298	307	</tr>
299	308	</tbody>
300	309	</table></div>
301	310	</div>
302	311	<hr>
303		<div class="refsect2" title="tp_cli_connection_interface_capabilities_run_get_capabilities ()">
304		<a name="tp-cli-connection-interface-capabilities-run-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_run_get_capabilities ()</h3>
305		<pre class="programlisting"><a
306		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
307		>gboolean</a> tp_cli_connection_interface_capabilities_run_get_capabilities
	312	<div class="refsect2" title="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()">
	313	<a name="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()</h3>
	314	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities
308	315	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
309	316	<a
310	317	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
311	318	>gint</a> timeout_ms,
312	319	const <a
313	320	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
314		>GArray</a> *in_Handles,
315		<a
316		href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
317		>GPtrArray</a> **out_Contact_Capabilities,
318		<a
319		href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
320		>GError</a> **error,
321		<a
322		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
323		>GMainLoop</a> **loop);</pre>
324		<p>
325		Call the method GetCapabilities and run the main loop
326		until it returns. Before calling this method, you must
327		add a reference to any borrowed objects you need to keep,
328		and generally ensure that everything is in a consistent
329		state.
330		</p>
331		<p>
332		Returns an array of capabilities for the given contact handles.</p>
	321	>GArray</a> *in_handles,
	322	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</a> callback,
	323	<a
	324	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	325	>gpointer</a> user_data,
	326	<a
	327	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	328	>GDestroyNotify</a> destroy,
	329	<a
	330	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	331	>GObject</a> *weak_object);</pre>
	332	<p>
	333	Start a GetContactCapabilities method call.
	334	</p>
	335	<p>
	336	Returns an array of enhanced capabilities for the given contact handles.</p>
333	337	<p>
334	338	</p>
335	339	<div class="variablelist"><table border="0">

337	341	<tbody>
338	342	<tr>
339	343	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
340		<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
341		</td>
342		</tr>
343		<tr>
344		<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
345		<td> Timeout in milliseconds, or -1 for default
346		</td>
347		</tr>
348		<tr>
349		<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
350		<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p>
351		</td>
352		</tr>
353		<tr>
354		<td><p><span class="term"><em class="parameter"><code>out_Contact_Capabilities</code></em> :</span></p></td>
355		<td> Used to return an 'out' argument if <a
356		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
357		><code class="literal">TRUE</code></a> is returned: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of generic capability flags for the type</li> <li>a bitwise OR of type specific capability flags for the type</li> </ul>
358		</td>
359		</tr>
360		<tr>
361		<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
362		<td> If not <a
363		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
364		><code class="literal">NULL</code></a>, used to return errors if <a
365		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
366		><code class="literal">FALSE</code></a>
367		is returned
368		</td>
369		</tr>
370		<tr>
371		<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
372		<td> If not <a
373		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
374		><code class="literal">NULL</code></a>, set before re-entering
375		the main loop, to point to a <a
376		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
377		><span class="type">GMainLoop</span></a>
378		which can be used to cancel this call with
379		<a
380		href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
381		><code class="function">g_main_loop_quit()</code></a>, causing a return of
382		<a
383		href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
384		><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
385		</td>
386		</tr>
387		<tr>
388		<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
389		<td> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error
390		</td>
391		</tr>
392		</tbody>
393		</table></div>
394		</div>
395		<hr>
396		<div class="refsect2" title="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()">
397		<a name="tp-cli-connection-interface-capabilities-call-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_advertise_capabilities ()</h3>
398		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_capabilities_call_advertise_capabilities
399		(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
400		<a
401		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
402		>gint</a> timeout_ms,
403		const <a
404		href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
405		>GPtrArray</a> *in_Add,
406		const <a
407		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
408		>gchar</a> **in_Remove,
409		<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</a> callback,
410		<a
411		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
412		>gpointer</a> user_data,
413		<a
414		href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
415		>GDestroyNotify</a> destroy,
416		<a
417		href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
418		>GObject</a> *weak_object);</pre>
419		<p>
420		Start a AdvertiseCapabilities method call.
421		</p>
422		<p>
423		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></p>
424		<p>
425		</p>
426		<div class="variablelist"><table border="0">
427		<col align="left" valign="top">
428		<tbody>
429		<tr>
430		<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
431	344	<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
432	345	</td>
433	346	</tr>

438	351	</td>
439	352	</tr>
440	353	<tr>
441		<td><p><span class="term"><em class="parameter"><code>in_Add</code></em> :</span></p></td>
442		<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
443		</td>
444		</tr>
445		<tr>
446		<td><p><span class="term"><em class="parameter"><code>in_Remove</code></em> :</span></p></td>
447		<td> Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove
	354	<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
	355	<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>The handle zero MUST NOT be included in the request.</p>
448	356	</td>
449	357	</tr>
450	358	<tr>

505	413	</table></div>
506	414	</div>
507	415	<hr>
508		<div class="refsect2" title="tp_cli_connection_interface_capabilities_call_get_capabilities ()">
509		<a name="tp-cli-connection-interface-capabilities-call-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_get_capabilities ()</h3>
510		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_capabilities_call_get_capabilities
511		(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
512		<a
513		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
514		>gint</a> timeout_ms,
515		const <a
516		href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
517		>GArray</a> *in_Handles,
518		<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</a> callback,
519		<a
520		href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
521		>gpointer</a> user_data,
522		<a
523		href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
524		>GDestroyNotify</a> destroy,
	416	<div class="refsect2" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()">
	417	<a name="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()</h3>
	418	<pre class="programlisting">void (*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities)
	419	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	420	const <a
	421	href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
	422	>GError</a> *error,
	423	<a
	424	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	425	>gpointer</a> user_data,
525	426	<a
526	427	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
527	428	>GObject</a> *weak_object);</pre>
528	429	<p>
529		Start a GetCapabilities method call.
530		</p>
531		<p>
532		Returns an array of capabilities for the given contact handles.</p>
	430	Signature of the callback called when a UpdateCapabilities method call
	431	succeeds or fails.</p>
533	432	<p>
534	433	</p>
535	434	<div class="variablelist"><table border="0">

537	436	<tbody>
538	437	<tr>
539	438	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	439	<td> the proxy on which the call was made
	440	</td>
	441	</tr>
	442	<tr>
	443	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	444	<td> <a
	445	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	446	><code class="literal">NULL</code></a> on success, or an error on failure
	447	</td>
	448	</tr>
	449	<tr>
	450	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	451	<td> user-supplied data
	452	</td>
	453	</tr>
	454	<tr>
	455	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	456	<td> user-supplied object
	457	</td>
	458	</tr>
	459	</tbody>
	460	</table></div>
	461	</div>
	462	<hr>
	463	<div class="refsect2" title="tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()">
	464	<a name="tp-cli-connection-interface-contact-capabilities-call-update-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()</h3>
	465	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_contact_capabilities_call_update_capabilities
	466	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	467	<a
	468	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
	469	>gint</a> timeout_ms,
	470	const <a
	471	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
	472	>GPtrArray</a> *in_Handler_Capabilities,
	473	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</a> callback,
	474	<a
	475	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	476	>gpointer</a> user_data,
	477	<a
	478	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	479	>GDestroyNotify</a> destroy,
	480	<a
	481	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	482	>GObject</a> *weak_object);</pre>
	483	<p>
	484	Start a UpdateCapabilities method call.
	485	</p>
	486	<p>
	487	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Alter the connection's advertised capabilities to include the intersection of the given clients' capabilities with what the connection manager is able to implement.</p> <p>On connections managed by the ChannelDispatcher, processes other than the ChannelDispatcher SHOULD NOT call this method, and the ChannelDispatcher SHOULD use this method to advertise the capabilities of all the registered <tp:dbus-ref namespace="org.freedesktop.Telepathy">Client.Handler</tp:dbus-ref> implementations.On connections not managed by the ChannelDispatcher, clients MAY use this method directly, to indicate the channels they will handle and the extra capabilities they have.</p> <p>Upon a successful invocation of this method, the connection manager will only emit the <tp:member-ref>ContactCapabilitiesChanged</tp:member-ref> signal for the user's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">SelfHandle</tp:dbus-ref> if, in the underlying protocol, the new capabilities are distinct from the previous state.</p> <tp:rationale> <p>The connection manager will essentially intersect the provided capabilities and the channel classes it implements. Therefore, certain properties which are never fixed for a channel class (such as the target handle, or the Parameters property of a tube channel) will almost certainly not be advertised.</p> </tp:rationale> <p>This method MAY be called on a newly-created connection while it is still in the DISCONNECTED state, to request that when the connection connects, it will do so with the appropriate capabilities. Doing so MUST NOT fail.</p></p>
	488	<p>
	489	</p>
	490	<div class="variablelist"><table border="0">
	491	<col align="left" valign="top">
	492	<tbody>
	493	<tr>
	494	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
540	495	<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
541	496	</td>
542	497	</tr>

547	502	</td>
548	503	</tr>
549	504	<tr>
550		<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
551		<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p>
	505	<td><p><span class="term"><em class="parameter"><code>in_Handler_Capabilities</code></em> :</span></p></td>
	506	<td> Used to pass an 'in' argument: <p>The capabilities of one or more clients.</p> <p>For each client in the given list, any capabilities previously advertised for the same client name are discarded, then replaced by the capabilities indicated.</p> <p>As a result, if a client becomes unavailable, this method SHOULD be called with a <tp:type>Handler_Capabilities</tp:type> structure containing its name, an empty list of channel classes, and an empty list of capabilities. When this is done, the connection manager SHOULD free all memory associated with that client name.</p> <tp:rationale> <p>This method takes a list of clients so that when the channel dispatcher first calls it (with a list of all the Handlers that are initially available), the changes can be made atomically, with only one transmission of updated capabilities to the network. Afterwards, the channel dispatcher will call this method with a single-element list every time a Handler becomes available or unavailable.</p> </tp:rationale> <p>The connection manager MUST ignore any channel classes and client capabilities for which there is no representation in the protocol or no support in the connection manager.</p>
552	507	</td>
553	508	</tr>
554	509	<tr>

609	564	</table></div>
610	565	</div>
611	566	<hr>
	567	<div class="refsect2" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()">
	568	<a name="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"></a><h3>tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()</h3>
	569	<pre class="programlisting">void (*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed)
	570	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	571	<a
	572	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	573	>GHashTable</a> *arg_caps,
	574	<a
	575	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	576	>gpointer</a> user_data,
	577	<a
	578	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	579	>GObject</a> *weak_object);</pre>
	580	<p>
	581	Represents the signature of a callback for the signal ContactCapabilitiesChanged.</p>
	582	<p>
	583	</p>
	584	<div class="variablelist"><table border="0">
	585	<col align="left" valign="top">
	586	<tbody>
	587	<tr>
	588	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	589	<td> The proxy on which <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()"><code class="function">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed()</code></a>
	590	was called
	591	</td>
	592	</tr>
	593	<tr>
	594	<td><p><span class="term"><em class="parameter"><code>arg_caps</code></em> :</span></p></td>
	595	<td> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> All the capabilities of the contacts
	596	</td>
	597	</tr>
	598	<tr>
	599	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	600	<td> User-supplied data
	601	</td>
	602	</tr>
	603	<tr>
	604	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	605	<td> User-supplied weakly referenced object
	606	</td>
	607	</tr>
	608	</tbody>
	609	</table></div>
	610	</div>
	611	<hr>
	612	<div class="refsect2" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()">
	613	<a name="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"></a><h3>tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()</h3>
	614	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed
	615	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	616	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</a> callback,
	617	<a
	618	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	619	>gpointer</a> user_data,
	620	<a
	621	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	622	>GDestroyNotify</a> destroy,
	623	<a
	624	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	625	>GObject</a> *weak_object,
	626	<a
	627	href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
	628	>GError</a> **error);</pre>
	629	<p>
	630	Connect a handler to the signal ContactCapabilitiesChanged.
	631	</p>
	632	<p>
	633	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handles. A single signal can be emitted for several contacts.</p> <tp:rationale> <p>The underlying protocol can get several contacts' capabilities at the same time.</p> </tp:rationale></p>
	634	<p>
	635	</p>
	636	<div class="variablelist"><table border="0">
	637	<col align="left" valign="top">
	638	<tbody>
	639	<tr>
	640	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	641	<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
	642	</td>
	643	</tr>
	644	<tr>
	645	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	646	<td> Callback to be called when the signal is
	647	received
	648	</td>
	649	</tr>
	650	<tr>
	651	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	652	<td> User-supplied data for the callback
	653	</td>
	654	</tr>
	655	<tr>
	656	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	657	<td> Destructor for the user-supplied data, which
	658	will be called when this signal is disconnected, or
	659	before this function returns <a
	660	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	661	><code class="literal">NULL</code></a>
	662	</td>
	663	</tr>
	664	<tr>
	665	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	666	<td> A <a
	667	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	668	><span class="type">GObject</span></a> which will be weakly referenced;
	669	if it is destroyed, this callback will automatically be
	670	disconnected
	671	</td>
	672	</tr>
	673	<tr>
	674	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	675	<td> If not <a
	676	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	677	><code class="literal">NULL</code></a>, used to raise an error if <a
	678	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	679	><code class="literal">NULL</code></a> is
	680	returned
	681	</td>
	682	</tr>
	683	<tr>
	684	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	685	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
	686	above, which can be used to disconnect the signal; or
	687	<a
	688	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	689	><code class="literal">NULL</code></a> if the proxy does not have the desired interface
	690	or has become invalid.
	691	</td>
	692	</tr>
	693	</tbody>
	694	</table></div>
	695	</div>
	696	<hr>
	697	<div class="refsect2" title="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()">
	698	<a name="tp-cli-connection-interface-capabilities-call-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_advertise_capabilities ()</h3>
	699	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_capabilities_call_advertise_capabilities
	700	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	701	<a
	702	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
	703	>gint</a> timeout_ms,
	704	const <a
	705	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
	706	>GPtrArray</a> *in_Add,
	707	const <a
	708	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
	709	>gchar</a> **in_Remove,
	710	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</a> callback,
	711	<a
	712	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	713	>gpointer</a> user_data,
	714	<a
	715	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	716	>GDestroyNotify</a> destroy,
	717	<a
	718	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	719	>GObject</a> *weak_object);</pre>
	720	<p>
	721	Start a AdvertiseCapabilities method call.
	722	</p>
	723	<p>
	724	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></p>
	725	<p>
	726	</p>
	727	<div class="variablelist"><table border="0">
	728	<col align="left" valign="top">
	729	<tbody>
	730	<tr>
	731	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	732	<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
	733	</td>
	734	</tr>
	735	<tr>
	736	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	737	<td> the timeout in milliseconds, or -1 to use the
	738	default
	739	</td>
	740	</tr>
	741	<tr>
	742	<td><p><span class="term"><em class="parameter"><code>in_Add</code></em> :</span></p></td>
	743	<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
	744	</td>
	745	</tr>
	746	<tr>
	747	<td><p><span class="term"><em class="parameter"><code>in_Remove</code></em> :</span></p></td>
	748	<td> Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove
	749	</td>
	750	</tr>
	751	<tr>
	752	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	753	<td> called when the method call succeeds or fails;
	754	may be <a
	755	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	756	><code class="literal">NULL</code></a> to make a "fire and forget" call with no
	757	reply tracking
	758	</td>
	759	</tr>
	760	<tr>
	761	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	762	<td> user-supplied data passed to the callback;
	763	must be <a
	764	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	765	><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
	766	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	767	><code class="literal">NULL</code></a>
	768	</td>
	769	</tr>
	770	<tr>
	771	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	772	<td> called with the user_data as argument, after the
	773	call has succeeded, failed or been cancelled;
	774	must be <a
	775	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	776	><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
	777	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	778	><code class="literal">NULL</code></a>
	779	</td>
	780	</tr>
	781	<tr>
	782	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	783	<td> If not <a
	784	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	785	><code class="literal">NULL</code></a>, a <a
	786	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	787	><span class="type">GObject</span></a> which will be
	788	weakly referenced; if it is destroyed, this call
	789	will automatically be cancelled. Must be <a
	790	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	791	><code class="literal">NULL</code></a> if
	792	<em class="parameter"><code>callback</code></em> is <a
	793	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	794	><code class="literal">NULL</code></a>
	795	</td>
	796	</tr>
	797	<tr>
	798	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	799	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
	800	progress. It is borrowed from the object, and will become
	801	invalid when the callback is called, the call is
	802	cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
	803	</td>
	804	</tr>
	805	</tbody>
	806	</table></div>
	807	</div>
	808	<hr>
	809	<div class="refsect2" title="tp_cli_connection_interface_capabilities_call_get_capabilities ()">
	810	<a name="tp-cli-connection-interface-capabilities-call-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_get_capabilities ()</h3>
	811	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_capabilities_call_get_capabilities
	812	(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
	813	<a
	814	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
	815	>gint</a> timeout_ms,
	816	const <a
	817	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
	818	>GArray</a> *in_Handles,
	819	<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</a> callback,
	820	<a
	821	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	822	>gpointer</a> user_data,
	823	<a
	824	href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
	825	>GDestroyNotify</a> destroy,
	826	<a
	827	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	828	>GObject</a> *weak_object);</pre>
	829	<p>
	830	Start a GetCapabilities method call.
	831	</p>
	832	<p>
	833	Returns an array of capabilities for the given contact handles.</p>
	834	<p>
	835	</p>
	836	<div class="variablelist"><table border="0">
	837	<col align="left" valign="top">
	838	<tbody>
	839	<tr>
	840	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	841	<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
	842	</td>
	843	</tr>
	844	<tr>
	845	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	846	<td> the timeout in milliseconds, or -1 to use the
	847	default
	848	</td>
	849	</tr>
	850	<tr>
	851	<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
	852	<td> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p>
	853	</td>
	854	</tr>
	855	<tr>
	856	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	857	<td> called when the method call succeeds or fails;
	858	may be <a
	859	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	860	><code class="literal">NULL</code></a> to make a "fire and forget" call with no
	861	reply tracking
	862	</td>
	863	</tr>
	864	<tr>
	865	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	866	<td> user-supplied data passed to the callback;
	867	must be <a
	868	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	869	><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
	870	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	871	><code class="literal">NULL</code></a>
	872	</td>
	873	</tr>
	874	<tr>
	875	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	876	<td> called with the user_data as argument, after the
	877	call has succeeded, failed or been cancelled;
	878	must be <a
	879	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	880	><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
	881	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	882	><code class="literal">NULL</code></a>
	883	</td>
	884	</tr>
	885	<tr>
	886	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	887	<td> If not <a
	888	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	889	><code class="literal">NULL</code></a>, a <a
	890	href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
	891	><span class="type">GObject</span></a> which will be
	892	weakly referenced; if it is destroyed, this call
	893	will automatically be cancelled. Must be <a
	894	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	895	><code class="literal">NULL</code></a> if
	896	<em class="parameter"><code>callback</code></em> is <a
	897	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
	898	><code class="literal">NULL</code></a>
	899	</td>
	900	</tr>
	901	<tr>
	902	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	903	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
	904	progress. It is borrowed from the object, and will become
	905	invalid when the callback is called, the call is
	906	cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
	907	</td>
	908	</tr>
	909	</tbody>
	910	</table></div>
	911	</div>
	912	<hr>
612	913	<div class="refsect2" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()">
613	914	<a name="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()</h3>
614	915	<pre class="programlisting">void (*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities)

-1

docs/reference/html/telepathy-glib-connection-contacts.html less more

6	6	<link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7	7	<link rel="up" href="ch-client.html" title="Client-side proxies">
8	8	<link rel="prev" href="telepathy-glib-connection-avatars.html" title="Connection Avatars interface">
9		<link rel="next" href="telepathy-glib-connection-caps.html" title="Connection Capabilities interface">
	9	<link rel="next" href="telepathy-glib-connection-caps.html" title="Connection ContactCapabilities and Capabilities interfaces">
10	10	<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11	11	<link rel="stylesheet" href="style.css" type="text/css">
12	12	<link rel="chapter" href="ch-dbus.html" title="General D-Bus support">

-1

docs/reference/html/telepathy-glib-connection-requests.html less more

5	5	<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6	6	<link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7	7	<link rel="up" href="ch-client.html" title="Client-side proxies">
8		<link rel="prev" href="telepathy-glib-connection-caps.html" title="Connection Capabilities interface">
	8	<link rel="prev" href="telepathy-glib-connection-caps.html" title="Connection ContactCapabilities and Capabilities interfaces">
9	9	<link rel="next" href="telepathy-glib-connection-simple-presence.html" title="Connection SimplePresence interface">
10	10	<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11	11	<link rel="stylesheet" href="style.css" type="text/css">

+14

-14

docs/reference/html/telepathy-glib-connection.html less more

791	791	>guint</a> in_Handle_Type,
792	792	const <a
793	793	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
794		>gchar</a> **in_Names,
	794	>gchar</a> **in_Identifiers,
795	795	<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()">tp_cli_connection_callback_for_request_handles</a> callback,
796	796	<a
797	797	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"

814	814	>guint</a> in_Handle_Type,
815	815	const <a
816	816	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
817		>gchar</a> **in_Names,
	817	>gchar</a> **in_Identifiers,
818	818	<a
819	819	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
820	820	>GArray</a> **out_Handles,

3867	3867	<td><p><span class="term"><em class="parameter"><code>out_Identifiers</code></em> :</span></p></td>
3868	3868	<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
3869	3869	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3870		><code class="literal">NULL</code></a>: An array of handle names in the same order as the given numbers
	3870	><code class="literal">NULL</code></a>: An array of identifiers corresponding to the given handles, in the same order.
3871	3871	</td>
3872	3872	</tr>
3873	3873	<tr>

4065	4065	<td><p><span class="term"><em class="parameter"><code>out_Identifiers</code></em> :</span></p></td>
4066	4066	<td> Used to return an 'out' argument if <a
4067	4067	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
4068		><code class="literal">TRUE</code></a> is returned: An array of handle names in the same order as the given numbers
	4068	><code class="literal">TRUE</code></a> is returned: An array of identifiers corresponding to the given handles, in the same order.
4069	4069	</td>
4070	4070	</tr>
4071	4071	<tr>

4926	4926	<td><p><span class="term"><em class="parameter"><code>out_Handles</code></em> :</span></p></td>
4927	4927	<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
4928	4928	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4929		><code class="literal">NULL</code></a>: An array of integer handle numbers in the same order as the given strings
	4929	><code class="literal">NULL</code></a>: An array of integer handle numbers in the same order as the given identifiers.
4930	4930	</td>
4931	4931	</tr>
4932	4932	<tr>

4962	4962	>guint</a> in_Handle_Type,
4963	4963	const <a
4964	4964	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4965		>gchar</a> **in_Names,
	4965	>gchar</a> **in_Identifiers,
4966	4966	<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()">tp_cli_connection_callback_for_request_handles</a> callback,
4967	4967	<a
4968	4968	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"

4977	4977	Start a RequestHandles method call.
4978	4978	</p>
4979	4979	<p>
4980		Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
	4980	Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the identifier refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
4981	4981	<p>
4982	4982	</p>
4983	4983	<div class="variablelist"><table border="0">

5000	5000	</td>
5001	5001	</tr>
5002	5002	<tr>
5003		<td><p><span class="term"><em class="parameter"><code>in_Names</code></em> :</span></p></td>
5004		<td> Used to pass an 'in' argument: An array of names of entities to request handles for
	5003	<td><p><span class="term"><em class="parameter"><code>in_Identifiers</code></em> :</span></p></td>
	5004	<td> Used to pass an 'in' argument: An array of identifiers of entities to request handles for
5005	5005	</td>
5006	5006	</tr>
5007	5007	<tr>

5076	5076	>guint</a> in_Handle_Type,
5077	5077	const <a
5078	5078	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
5079		>gchar</a> **in_Names,
	5079	>gchar</a> **in_Identifiers,
5080	5080	<a
5081	5081	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
5082	5082	>GArray</a> **out_Handles,

5094	5094	state.
5095	5095	</p>
5096	5096	<p>
5097		Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
	5097	Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the identifier refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
5098	5098	<p>
5099	5099	</p>
5100	5100	<div class="variablelist"><table border="0">

5116	5116	</td>
5117	5117	</tr>
5118	5118	<tr>
5119		<td><p><span class="term"><em class="parameter"><code>in_Names</code></em> :</span></p></td>
5120		<td> Used to pass an 'in' argument: An array of names of entities to request handles for
	5119	<td><p><span class="term"><em class="parameter"><code>in_Identifiers</code></em> :</span></p></td>
	5120	<td> Used to pass an 'in' argument: An array of identifiers of entities to request handles for
5121	5121	</td>
5122	5122	</tr>
5123	5123	<tr>
5124	5124	<td><p><span class="term"><em class="parameter"><code>out_Handles</code></em> :</span></p></td>
5125	5125	<td> Used to return an 'out' argument if <a
5126	5126	href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
5127		><code class="literal">TRUE</code></a> is returned: An array of integer handle numbers in the same order as the given strings
	5127	><code class="literal">TRUE</code></a> is returned: An array of integer handle numbers in the same order as the given identifiers.
5128	5128	</td>
5129	5129	</tr>
5130	5130	<tr>

-3

docs/reference/html/telepathy-glib-debug-sender.html less more

248	248	<a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>.
249	249	</p>
250	250	<p>
251		The <em class="parameter"><code>exclude</code></em> parameter is designed to allow filtering of domains, instead of
252		sending every message to the <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender"><span class="type">TpDebugSender</span></a>. Note that every message,
253		regardless of domain, is given to <a
	251	The <em class="parameter"><code>exclude</code></em> parameter is designed to allow filtering one domain, instead of
	252	sending every message to the <span class="type">""</span> typical usage is for a
	253	process to filter out messages from its own <a
	254	href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#G-LOG-DOMAIN--CAPS"
	255	><code class="literal">G_LOG_DOMAIN</code></a>, so that it can
	256	append a category to its own messages and pass them directly to
	257	tp_debug_sender_add_message. Note that every message, regardless of
	258	domain, is given to <a
254	259	href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-default-handler"
255	260	><code class="function">g_log_default_handler()</code></a>.
256	261	</p>

-2

docs/reference/html/telepathy-glib-enums.html less more

816	816	} TpChannelMediaCapabilities;
817	817	</pre>
818	818	<p>
819		The channel-type-specific capability flags used for Channel.Type.StreamedMedia in the Connection.Interface.Capabilities interface. See the FUTURE.InitialAudio property for details of the mechanisms that will replace this.
	819	The channel-type-specific capability flags used for Channel.Type.StreamedMedia in the Connection.Interface.Capabilities interface. See the InitialAudio property for details of the mechanisms that will replace this.
820	820	</p>
821	821	<p>
822	822	Bitfield/set of flags generated from the Telepathy specification.</p>

852	852	</tr>
853	853	<tr>
854	854	<td><p><a name="TP-CHANNEL-MEDIA-CAPABILITY-IMMUTABLE-STREAMS--CAPS"></a><span class="term"><code class="literal">TP_CHANNEL_MEDIA_CAPABILITY_IMMUTABLE_STREAMS</code></span></p></td>
855		<td> Once streams have been requested for a channel to this handle (either by calling RequestStreams on a channel with no streams, or by specifying InitialAudio or InitialAudio = True in the channel request), then they cannot be changed; subsequent calls to RequestStreams or RemoveStreams will fail. For example, once an audio-only Google Talk call has started, it is not possible to add a video stream; both audio and video must be requested at the start of the call if video is desired. User interfaces may use this pseudo-capability as a hint to display separate "Audio call" and "Video call" buttons, rather than a single "Call" button with the option to add and remove video once the call has started for contacts without this flag.
	855	<td> Channels whose target handle is this contact will have ImmutableStreams = True.
856	856	</td>
857	857	</tr>
858	858	</tbody>

1799	1799	TP_CHANNEL_CALL_STATE_QUEUED = 2,
1800	1800	TP_CHANNEL_CALL_STATE_HELD = 4,
1801	1801	TP_CHANNEL_CALL_STATE_FORWARDED = 8,
	1802	TP_CHANNEL_CALL_STATE_IN_PROGRESS = 16,
1802	1803	} TpChannelCallStateFlags;
1803	1804	</pre>
1804	1805	<p>

1829	1830	<tr>
1830	1831	<td><p><a name="TP-CHANNEL-CALL-STATE-FORWARDED--CAPS"></a><span class="term"><code class="literal">TP_CHANNEL_CALL_STATE_FORWARDED</code></span></p></td>
1831	1832	<td> The initiator of the call originally called a contact other than the current recipient of the call, but the call was then forwarded or diverted.
	1833	</td>
	1834	</tr>
	1835	<tr>
	1836	<td><p><a name="TP-CHANNEL-CALL-STATE-IN-PROGRESS--CAPS"></a><span class="term"><code class="literal">TP_CHANNEL_CALL_STATE_IN_PROGRESS</code></span></p></td>
	1837	<td> Progress has been made in placing the outgoing call, but the destination contact may not have been made aware of the call yet (so the Ringing state is not appropriate). This corresponds to SIP's status code 183 Session Progress, and could be used when the outgoing call has reached a gateway, for instance.
1832	1838	</td>
1833	1839	</tr>
1834	1840	</tbody>

-1

docs/reference/html/telepathy-glib-errors.html less more

661	661	The D-Bus error name org.freedesktop.Telepathy.Error.InvalidHandle
662	662	</p>
663	663	<p>
664		The contact name specified is unknown on this channel or connection.</p>
	664	The handle specified is unknown on this channel or connection.</p>
665	665	<p>
666	666	</p>
667	667	</div>

+105

-0

docs/reference/html/telepathy-glib-gtypes.html less more

78	78	#define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ALIAS-PAIR-LIST--CAPS" title="TP_ARRAY_TYPE_ALIAS_PAIR_LIST">TP_ARRAY_TYPE_ALIAS_PAIR_LIST</a>
79	79
80	80	#define <a class="link" href="telepathy-glib-gtypes.html#TP-HASH-TYPE-AVATAR-TOKEN-MAP--CAPS" title="TP_HASH_TYPE_AVATAR_TOKEN_MAP">TP_HASH_TYPE_AVATAR_TOKEN_MAP</a>
	81
	82	#define <a class="link" href="telepathy-glib-gtypes.html#TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS" title="TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP">TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</a>
	83	#define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS" title="TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST">TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</a>
	84	#define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS" title="TP_STRUCT_TYPE_HANDLER_CAPABILITIES">TP_STRUCT_TYPE_HANDLER_CAPABILITIES</a>
	85	#define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS" title="TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST">TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</a>
81	86
82	87	#define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS" title="TP_STRUCT_TYPE_CAPABILITY_CHANGE">TP_STRUCT_TYPE_CAPABILITY_CHANGE</a>
83	88	#define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CAPABILITY-CHANGE-LIST--CAPS" title="TP_ARRAY_TYPE_CAPABILITY_CHANGE_LIST">TP_ARRAY_TYPE_CAPABILITY_CHANGE_LIST</a>

748	753	</p>
749	754	</div>
750	755	<hr>
	756	<div class="refsect2" title="TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP">
	757	<a name="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS"></a><h3>TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</h3>
	758	<pre class="programlisting">#define TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</pre>
	759	<p>
	760	A mapping from contact handle to their capabilities.
	761	</p>
	762	<p>
	763	This macro expands to a call to a function
	764	that returns the <a
	765	href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
	766	><span class="type">GType</span></a> of a <a
	767	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	768	><span class="type">GHashTable</span></a>
	769	appropriate for representing a D-Bus
	770	dictionary of signature
	771	<code class="literal">a{ua(a{sv}as)}</code>.
	772	</p>
	773	<p>
	774	Keys (D-Bus type <code class="literal">u</code>,
	775	type <code class="literal">Contact_Handle</code>,
	776	named <code class="literal">Key</code>):
	777	A contact handle.
	778	</p>
	779	<p>
	780	Values (D-Bus type <code class="literal">a(a{sv}as)</code>,
	781	type <code class="literal">Requestable_Channel_Class[]</code>,
	782	named <code class="literal">Value</code>):
	783	The contact capabilities.</p>
	784	<p>
	785	</p>
	786	</div>
	787	<hr>
	788	<div class="refsect2" title="TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST">
	789	<a name="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS"></a><h3>TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</h3>
	790	<pre class="programlisting">#define TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</pre>
	791	<p>
	792	Expands to a call to a function
	793	that returns the <a
	794	href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
	795	><span class="type">GType</span></a> of a <a
	796	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
	797	><span class="type">GPtrArray</span></a>
	798	of <a class="link" href="telepathy-glib-gtypes.html#TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS" title="TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP"><span class="type">TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</span></a>.</p>
	799	<p>
	800	</p>
	801	</div>
	802	<hr>
	803	<div class="refsect2" title="TP_STRUCT_TYPE_HANDLER_CAPABILITIES">
	804	<a name="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS"></a><h3>TP_STRUCT_TYPE_HANDLER_CAPABILITIES</h3>
	805	<pre class="programlisting">#define TP_STRUCT_TYPE_HANDLER_CAPABILITIES</pre>
	806	<p>
	807	A structure representing the capabilities of a single client.
	808
	809	</p>
	810	<p>
	811	This macro expands to a call to a function
	812	that returns the <a
	813	href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
	814	><span class="type">GType</span></a> of a <a
	815	href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"
	816	><span class="type">GValueArray</span></a>
	817	appropriate for representing a D-Bus struct
	818	with signature <code class="literal">(saa{sv}as)</code>.
	819	</p>
	820	<p>
	821	Member 0 (D-Bus type <code class="literal">s</code>,
	822	type <code class="literal">DBus_Well_Known_Name</code>,
	823	named <code class="literal">Well_Known_Name</code>):
	824	For implementations of the <tp:dbus-ref namespace="org.freedesktop.Telepathy">Client</tp:dbus-ref> interface, the well-known bus name name of the client; for any other process, any other reversed domain name that uniquely identifies it.
	825	</p>
	826	<p>
	827	Member 1 (D-Bus type <code class="literal">aa{sv}</code>,
	828	type <code class="literal">String_Variant_Map[]</code>,
	829	named <code class="literal">Channel_Classes</code>):
	830	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of channel classes that can be handled by this client. This will usually be a copy of the client's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler">HandlerChannelFilter</tp:dbus-ref> property.
	831	</p>
	832	<p>
	833	Member 2 (D-Bus type <code class="literal">as</code>,
	834	type <code class="literal">Handler_Capability_Token[]</code>,
	835	named <code class="literal">Capabilities</code>):
	836	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of client capabilities supported by this client, to be used by the connection manager to determine what capabilities to advertise. This will usually be a copy of the client's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler">Capabilities</tp:dbus-ref> property.</p>
	837	<p>
	838	</p>
	839	</div>
	840	<hr>
	841	<div class="refsect2" title="TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST">
	842	<a name="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS"></a><h3>TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</h3>
	843	<pre class="programlisting">#define TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</pre>
	844	<p>
	845	Expands to a call to a function
	846	that returns the <a
	847	href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
	848	><span class="type">GType</span></a> of a <a
	849	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
	850	><span class="type">GPtrArray</span></a>
	851	of <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS" title="TP_STRUCT_TYPE_HANDLER_CAPABILITIES"><span class="type">TP_STRUCT_TYPE_HANDLER_CAPABILITIES</span></a>.</p>
	852	<p>
	853	</p>
	854	</div>
	855	<hr>
751	856	<div class="refsect2" title="TP_STRUCT_TYPE_CAPABILITY_CHANGE">
752	857	<a name="TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS"></a><h3>TP_STRUCT_TYPE_CAPABILITY_CHANGE</h3>
753	858	<pre class="programlisting">#define TP_STRUCT_TYPE_CAPABILITY_CHANGE</pre>

+20

-0

docs/reference/html/telepathy-glib-interfaces.html less more

73	73	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS">TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS</a>
74	74	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES">TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES</a>
75	75	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES">TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES</a>
	76	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</a>
	77	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</a>
76	78	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CONTACTS">TP_IFACE_CONNECTION_INTERFACE_CONTACTS</a>
77	79	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS</a>
78	80	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS" title="TP_IFACE_CONNECTION_INTERFACE_REQUESTS">TP_IFACE_CONNECTION_INTERFACE_REQUESTS</a>

397	399	</p>
398	400	</div>
399	401	<hr>
	402	<div class="refsect2" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">
	403	<a name="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"></a><h3>TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</h3>
	404	<pre class="programlisting">#define TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</pre>
	405	<p>
	406	The interface name "org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities"</p>
	407	<p>
	408	</p>
	409	</div>
	410	<hr>
	411	<div class="refsect2" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">
	412	<a name="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"></a><h3>TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</h3>
	413	<pre class="programlisting">#define TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</pre>
	414	<p>
	415	Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities"</p>
	416	<p>
	417	</p>
	418	</div>
	419	<hr>
400	420	<div class="refsect2" title="TP_IFACE_CONNECTION_INTERFACE_CONTACTS">
401	421	<a name="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS"></a><h3>TP_IFACE_CONNECTION_INTERFACE_CONTACTS</h3>
402	422	<pre class="programlisting">#define TP_IFACE_CONNECTION_INTERFACE_CONTACTS</pre>

+305

-3

docs/reference/html/telepathy-glib-svc-connection.html less more

243	243	>guint</a> in_Handle_Type,
244	244	const <a
245	245	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
246		>gchar</a> **in_Names,
	246	>gchar</a> **in_Identifiers,
247	247	<a
248	248	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
249	249	>DBusGMethodInvocation</a> *context);

866	866	const <a
867	867	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
868	868	>GPtrArray</a> *arg_Caps);
	869
	870
	871	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities" title="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</a>;
	872	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass" title="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</a>;
	873	void <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed" title="tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ()">tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed</a>
	874	(<a
	875	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	876	>gpointer</a> instance,
	877	<a
	878	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	879	>GHashTable</a> *arg_caps);
	880	void (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl" title="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()">*tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</a>)
	881	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities" title="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</a> *self,
	882	const <a
	883	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
	884	>GArray</a> *in_handles,
	885	<a
	886	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	887	>DBusGMethodInvocation</a> *context);
	888	void <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities" title="tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ()">tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities</a>
	889	(<a
	890	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	891	>DBusGMethodInvocation</a> *context,
	892	<a
	893	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	894	>GHashTable</a> *out_Contact_Capabilities);
	895	void <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities" title="tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ()">tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities</a>
	896	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass" title="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</a> *klass,
	897	<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl" title="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()">tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</a> impl);
	898	void (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-update-capabilities-impl" title="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()">*tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</a>)
	899	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities" title="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</a> *self,
	900	const <a
	901	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
	902	>GPtrArray</a> *in_Handler_Capabilities,
	903	<a
	904	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	905	>DBusGMethodInvocation</a> *context);
	906	void <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities" title="tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ()">tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities</a>
	907	(<a
	908	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	909	>DBusGMethodInvocation</a> *context);
	910	void <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-update-capabilities" title="tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ()">tp_svc_connection_interface_contact_capabilities_implement_update_capabilities</a>
	911	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass" title="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</a> *klass,
	912	<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-update-capabilities-impl" title="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()">tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</a> impl);
869	913
870	914
871	915	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation" title="TpSvcConnectionInterfaceLocation">TpSvcConnectionInterfaceLocation</a>;

2094	2138	>guint</a> in_Handle_Type,
2095	2139	const <a
2096	2140	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
2097		>gchar</a> **in_Names,
	2141	>gchar</a> **in_Identifiers,
2098	2142	<a
2099	2143	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
2100	2144	>DBusGMethodInvocation</a> *context);</pre>

2117	2161	</td>
2118	2162	</tr>
2119	2163	<tr>
2120		<td><p><span class="term"><em class="parameter"><code>in_Names</code></em> :</span></p></td>
	2164	<td><p><span class="term"><em class="parameter"><code>in_Identifiers</code></em> :</span></p></td>
2121	2165	<td> const gchar ** (FIXME, generate documentation)
2122	2166	</td>
2123	2167	</tr>

5463	5507	<tr>
5464	5508	<td><p><span class="term"><em class="parameter"><code>arg_Caps</code></em> :</span></p></td>
5465	5509	<td> const GPtrArray * (FIXME, generate documentation)
	5510	</td>
	5511	</tr>
	5512	</tbody>
	5513	</table></div>
	5514	</div>
	5515	<hr>
	5516	<div class="refsect2" title="TpSvcConnectionInterfaceContactCapabilities">
	5517	<a name="TpSvcConnectionInterfaceContactCapabilities"></a><h3>TpSvcConnectionInterfaceContactCapabilities</h3>
	5518	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceContactCapabilities TpSvcConnectionInterfaceContactCapabilities;</pre>
	5519	<p>
	5520	Dummy typedef representing any implementation of this interface.</p>
	5521	<p>
	5522	</p>
	5523	</div>
	5524	<hr>
	5525	<div class="refsect2" title="TpSvcConnectionInterfaceContactCapabilitiesClass">
	5526	<a name="TpSvcConnectionInterfaceContactCapabilitiesClass"></a><h3>TpSvcConnectionInterfaceContactCapabilitiesClass</h3>
	5527	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceContactCapabilitiesClass TpSvcConnectionInterfaceContactCapabilitiesClass;</pre>
	5528	<p>
	5529	The class of TpSvcConnectionInterfaceContactCapabilities.
	5530	</p>
	5531	<p>
	5532	In a full implementation of this interface (i.e. all
	5533	methods implemented), the interface initialization
	5534	function used in <a
	5535	href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE--CAPS"
	5536	><code class="function">G_IMPLEMENT_INTERFACE()</code></a> would
	5537	typically look like this:
	5538	</p>
	5539	<p>
	5540	</p>
	5541	<pre class="programlisting">
	5542	static void
	5543	implement_connection_interface_contact_capabilities (gpointer klass,
	5544	gpointer unused G_GNUC_UNUSED)
	5545	{
	5546	#define IMPLEMENT(x) tp_svc_connection_interface_contact_capabilities_implement_##x (\
	5547	klass, my_object_##x)
	5548	IMPLEMENT (update_capabilities);
	5549	IMPLEMENT (get_contact_capabilities);
	5550	#undef IMPLEMENT
	5551	}
	5552	</pre>
	5553	<p>
	5554	</p>
	5555	</div>
	5556	<hr>
	5557	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ()">
	5558	<a name="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed"></a><h3>tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ()</h3>
	5559	<pre class="programlisting">void tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed
	5560	(<a
	5561	href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
	5562	>gpointer</a> instance,
	5563	<a
	5564	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	5565	>GHashTable</a> *arg_caps);</pre>
	5566	<p>
	5567	Type-safe wrapper around g_signal_emit to emit the
	5568	ContactCapabilitiesChanged signal on interface org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.</p>
	5569	<p>
	5570	</p>
	5571	<div class="variablelist"><table border="0">
	5572	<col align="left" valign="top">
	5573	<tbody>
	5574	<tr>
	5575	<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
	5576	<td> The object implementing this interface
	5577	</td>
	5578	</tr>
	5579	<tr>
	5580	<td><p><span class="term"><em class="parameter"><code>arg_caps</code></em> :</span></p></td>
	5581	<td> GHashTable * (FIXME, generate documentation)
	5582	</td>
	5583	</tr>
	5584	</tbody>
	5585	</table></div>
	5586	</div>
	5587	<hr>
	5588	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()">
	5589	<a name="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl"></a><h3>tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()</h3>
	5590	<pre class="programlisting">void (*tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl)
	5591	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities" title="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</a> *self,
	5592	const <a
	5593	href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
	5594	>GArray</a> *in_handles,
	5595	<a
	5596	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	5597	>DBusGMethodInvocation</a> *context);</pre>
	5598	<p>
	5599	The signature of an implementation of the D-Bus method
	5600	GetContactCapabilities on interface org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.</p>
	5601	<p>
	5602	</p>
	5603	<div class="variablelist"><table border="0">
	5604	<col align="left" valign="top">
	5605	<tbody>
	5606	<tr>
	5607	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	5608	<td> The object implementing this interface
	5609	</td>
	5610	</tr>
	5611	<tr>
	5612	<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
	5613	<td> const GArray * (FIXME, generate documentation)
	5614	</td>
	5615	</tr>
	5616	<tr>
	5617	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	5618	<td> Used to return values or throw an error
	5619	</td>
	5620	</tr>
	5621	</tbody>
	5622	</table></div>
	5623	</div>
	5624	<hr>
	5625	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ()">
	5626	<a name="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities"></a><h3>tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ()</h3>
	5627	<pre class="programlisting">void tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities
	5628	(<a
	5629	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	5630	>DBusGMethodInvocation</a> *context,
	5631	<a
	5632	href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
	5633	>GHashTable</a> *out_Contact_Capabilities);</pre>
	5634	<p>
	5635	Return successfully by calling <a
	5636	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
	5637	><code class="function">dbus_g_method_return()</code></a>.
	5638	This inline function exists only to provide type-safety.</p>
	5639	<p>
	5640	</p>
	5641	<div class="variablelist"><table border="0">
	5642	<col align="left" valign="top">
	5643	<tbody>
	5644	<tr>
	5645	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	5646	<td> The D-Bus method invocation context
	5647	</td>
	5648	</tr>
	5649	<tr>
	5650	<td><p><span class="term"><em class="parameter"><code>out_Contact_Capabilities</code></em> :</span></p></td>
	5651	<td> GHashTable * (FIXME, generate documentation)
	5652	</td>
	5653	</tr>
	5654	</tbody>
	5655	</table></div>
	5656	</div>
	5657	<hr>
	5658	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ()">
	5659	<a name="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities"></a><h3>tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ()</h3>
	5660	<pre class="programlisting">void tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities
	5661	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass" title="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</a> *klass,
	5662	<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl" title="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()">tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</a> impl);</pre>
	5663	<p>
	5664	Register an implementation for the GetContactCapabilities method in the vtable
	5665	of an implementation of this interface. To be called from
	5666	the interface init function.</p>
	5667	<p>
	5668	</p>
	5669	<div class="variablelist"><table border="0">
	5670	<col align="left" valign="top">
	5671	<tbody>
	5672	<tr>
	5673	<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
	5674	<td> A class whose instances implement this interface
	5675	</td>
	5676	</tr>
	5677	<tr>
	5678	<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
	5679	<td> A callback used to implement the GetContactCapabilities D-Bus method
	5680	</td>
	5681	</tr>
	5682	</tbody>
	5683	</table></div>
	5684	</div>
	5685	<hr>
	5686	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()">
	5687	<a name="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl"></a><h3>tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()</h3>
	5688	<pre class="programlisting">void (*tp_svc_connection_interface_contact_capabilities_update_capabilities_impl)
	5689	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities" title="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</a> *self,
	5690	const <a
	5691	href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
	5692	>GPtrArray</a> *in_Handler_Capabilities,
	5693	<a
	5694	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	5695	>DBusGMethodInvocation</a> *context);</pre>
	5696	<p>
	5697	The signature of an implementation of the D-Bus method
	5698	UpdateCapabilities on interface org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.</p>
	5699	<p>
	5700	</p>
	5701	<div class="variablelist"><table border="0">
	5702	<col align="left" valign="top">
	5703	<tbody>
	5704	<tr>
	5705	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	5706	<td> The object implementing this interface
	5707	</td>
	5708	</tr>
	5709	<tr>
	5710	<td><p><span class="term"><em class="parameter"><code>in_Handler_Capabilities</code></em> :</span></p></td>
	5711	<td> const GPtrArray * (FIXME, generate documentation)
	5712	</td>
	5713	</tr>
	5714	<tr>
	5715	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	5716	<td> Used to return values or throw an error
	5717	</td>
	5718	</tr>
	5719	</tbody>
	5720	</table></div>
	5721	</div>
	5722	<hr>
	5723	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ()">
	5724	<a name="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities"></a><h3>tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ()</h3>
	5725	<pre class="programlisting">void tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities
	5726	(<a
	5727	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
	5728	>DBusGMethodInvocation</a> *context);</pre>
	5729	<p>
	5730	Return successfully by calling <a
	5731	href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
	5732	><code class="function">dbus_g_method_return()</code></a>.
	5733	This inline function exists only to provide type-safety.</p>
	5734	<p>
	5735	</p>
	5736	<div class="variablelist"><table border="0">
	5737	<col align="left" valign="top">
	5738	<tbody><tr>
	5739	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	5740	<td> The D-Bus method invocation context
	5741	</td>
	5742	</tr></tbody>
	5743	</table></div>
	5744	</div>
	5745	<hr>
	5746	<div class="refsect2" title="tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ()">
	5747	<a name="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities"></a><h3>tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ()</h3>
	5748	<pre class="programlisting">void tp_svc_connection_interface_contact_capabilities_implement_update_capabilities
	5749	(<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass" title="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</a> *klass,
	5750	<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-update-capabilities-impl" title="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()">tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</a> impl);</pre>
	5751	<p>
	5752	Register an implementation for the UpdateCapabilities method in the vtable
	5753	of an implementation of this interface. To be called from
	5754	the interface init function.</p>
	5755	<p>
	5756	</p>
	5757	<div class="variablelist"><table border="0">
	5758	<col align="left" valign="top">
	5759	<tbody>
	5760	<tr>
	5761	<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
	5762	<td> A class whose instances implement this interface
	5763	</td>
	5764	</tr>
	5765	<tr>
	5766	<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
	5767	<td> A callback used to implement the UpdateCapabilities D-Bus method
5466	5768	</td>
5467	5769	</tr>
5468	5770	</tbody>

+22

-3

docs/reference/html/telepathy-glib.devhelp less more

25	25	<sub name="Connection Aliasing interface" link="telepathy-glib-connection-aliasing.html"/>
26	26	<sub name="Connection Avatars interface" link="telepathy-glib-connection-avatars.html"/>
27	27	<sub name="Connection Contacts interface" link="telepathy-glib-connection-contacts.html"/>
28		<sub name="Connection Capabilities interface" link="telepathy-glib-connection-caps.html"/>
	28	<sub name="Connection ContactCapabilities and Capabilities interfaces" link="telepathy-glib-connection-caps.html"/>
29	29	<sub name="Connection Requests interface" link="telepathy-glib-connection-requests.html"/>
30	30	<sub name="Connection SimplePresence interface" link="telepathy-glib-connection-simple-presence.html"/>
31	31	<sub name="Connection Presence interface" link="telepathy-glib-connection-presence.html"/>

323	323	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS"/>
324	324	<function name="TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS"/>
325	325	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS"/>
	326	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"/>
	327	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"/>
326	328	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACTS" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS"/>
327	329	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS"/>
328	330	<function name="TP_IFACE_CONNECTION_INTERFACE_REQUESTS" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS"/>

531	533	<function name="TP_STRUCT_TYPE_ALIAS_PAIR" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ALIAS-PAIR--CAPS"/>
532	534	<function name="TP_ARRAY_TYPE_ALIAS_PAIR_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ALIAS-PAIR-LIST--CAPS"/>
533	535	<function name="TP_HASH_TYPE_AVATAR_TOKEN_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-AVATAR-TOKEN-MAP--CAPS"/>
	536	<function name="TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS"/>
	537	<function name="TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS"/>
	538	<function name="TP_STRUCT_TYPE_HANDLER_CAPABILITIES" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS"/>
	539	<function name="TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS"/>
534	540	<function name="TP_STRUCT_TYPE_CAPABILITY_CHANGE" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS"/>
535	541	<function name="TP_ARRAY_TYPE_CAPABILITY_CHANGE_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CAPABILITY-CHANGE-LIST--CAPS"/>
536	542	<function name="TP_STRUCT_TYPE_CAPABILITY_PAIR" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS"/>

790	796	<function name="tp_cli_connection_interface_contacts_call_get_contact_attributes ()" link="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-call-get-contact-attributes"/>
791	797	<function name="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()" link="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes"/>
792	798	<function name="tp_cli_connection_interface_contacts_run_get_contact_attributes ()" link="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-run-get-contact-attributes"/>
793		<function name="tp_cli_connection_interface_capabilities_run_advertise_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-advertise-capabilities"/>
794		<function name="tp_cli_connection_interface_capabilities_run_get_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-get-capabilities"/>
	799	<function name="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"/>
	800	<function name="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"/>
	801	<function name="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"/>
	802	<function name="tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-update-capabilities"/>
	803	<function name="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"/>
	804	<function name="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"/>
795	805	<function name="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-advertise-capabilities"/>
796	806	<function name="tp_cli_connection_interface_capabilities_call_get_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-get-capabilities"/>
797	807	<function name="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"/>

1713	1723	<function name="tp_svc_connection_interface_capabilities_implement_get_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-implement-get-capabilities"/>
1714	1724	<function name="tp_svc_connection_interface_capabilities_return_from_get_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-return-from-get-capabilities"/>
1715	1725	<function name="tp_svc_connection_interface_capabilities_emit_capabilities_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-emit-capabilities-changed"/>
	1726	<function name="TpSvcConnectionInterfaceContactCapabilities" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities"/>
	1727	<function name="TpSvcConnectionInterfaceContactCapabilitiesClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass"/>
	1728	<function name="tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed"/>
	1729	<function name="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl"/>
	1730	<function name="tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities"/>
	1731	<function name="tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities"/>
	1732	<function name="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-update-capabilities-impl"/>
	1733	<function name="tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities"/>
	1734	<function name="tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-update-capabilities"/>
1716	1735	<function name="TpSvcConnectionInterfaceLocation" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation"/>
1717	1736	<function name="TpSvcConnectionInterfaceLocationClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocationClass"/>
1718	1737	<function name="tp_svc_connection_interface_location_emit_location_updated ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-location-emit-location-updated"/>

+23

-3

docs/reference/html/telepathy-glib.devhelp2 less more

25	25	<sub name="Connection Aliasing interface" link="telepathy-glib-connection-aliasing.html"/>
26	26	<sub name="Connection Avatars interface" link="telepathy-glib-connection-avatars.html"/>
27	27	<sub name="Connection Contacts interface" link="telepathy-glib-connection-contacts.html"/>
28		<sub name="Connection Capabilities interface" link="telepathy-glib-connection-caps.html"/>
	28	<sub name="Connection ContactCapabilities and Capabilities interfaces" link="telepathy-glib-connection-caps.html"/>
29	29	<sub name="Connection Requests interface" link="telepathy-glib-connection-requests.html"/>
30	30	<sub name="Connection SimplePresence interface" link="telepathy-glib-connection-simple-presence.html"/>
31	31	<sub name="Connection Presence interface" link="telepathy-glib-connection-presence.html"/>

323	323	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS"/>
324	324	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS"/>
325	325	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS"/>
	326	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"/>
	327	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"/>
326	328	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACTS" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS"/>
327	329	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS"/>
328	330	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_REQUESTS" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS"/>

531	533	<keyword type="macro" name="TP_STRUCT_TYPE_ALIAS_PAIR" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ALIAS-PAIR--CAPS"/>
532	534	<keyword type="macro" name="TP_ARRAY_TYPE_ALIAS_PAIR_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ALIAS-PAIR-LIST--CAPS"/>
533	535	<keyword type="macro" name="TP_HASH_TYPE_AVATAR_TOKEN_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-AVATAR-TOKEN-MAP--CAPS"/>
	536	<keyword type="macro" name="TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS"/>
	537	<keyword type="macro" name="TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS"/>
	538	<keyword type="macro" name="TP_STRUCT_TYPE_HANDLER_CAPABILITIES" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS"/>
	539	<keyword type="macro" name="TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS"/>
534	540	<keyword type="macro" name="TP_STRUCT_TYPE_CAPABILITY_CHANGE" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS"/>
535	541	<keyword type="macro" name="TP_ARRAY_TYPE_CAPABILITY_CHANGE_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CAPABILITY-CHANGE-LIST--CAPS"/>
536	542	<keyword type="macro" name="TP_STRUCT_TYPE_CAPABILITY_PAIR" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS"/>

790	796	<keyword type="function" name="tp_cli_connection_interface_contacts_call_get_contact_attributes ()" link="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-call-get-contact-attributes"/>
791	797	<keyword type="function" name="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()" link="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes"/>
792	798	<keyword type="function" name="tp_cli_connection_interface_contacts_run_get_contact_attributes ()" link="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-run-get-contact-attributes"/>
793		<keyword type="function" name="tp_cli_connection_interface_capabilities_run_advertise_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-advertise-capabilities"/>
794		<keyword type="function" name="tp_cli_connection_interface_capabilities_run_get_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-run-get-capabilities"/>
	799	<keyword type="function" name="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"/>
	800	<keyword type="function" name="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"/>
	801	<keyword type="function" name="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"/>
	802	<keyword type="function" name="tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-update-capabilities"/>
	803	<keyword type="function" name="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"/>
	804	<keyword type="function" name="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"/>
795	805	<keyword type="function" name="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-advertise-capabilities"/>
796	806	<keyword type="function" name="tp_cli_connection_interface_capabilities_call_get_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-get-capabilities"/>
797	807	<keyword type="function" name="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()" link="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"/>

1713	1723	<keyword type="function" name="tp_svc_connection_interface_capabilities_implement_get_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-implement-get-capabilities"/>
1714	1724	<keyword type="function" name="tp_svc_connection_interface_capabilities_return_from_get_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-return-from-get-capabilities"/>
1715	1725	<keyword type="function" name="tp_svc_connection_interface_capabilities_emit_capabilities_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-capabilities-emit-capabilities-changed"/>
	1726	<keyword type="struct" name="TpSvcConnectionInterfaceContactCapabilities" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities"/>
	1727	<keyword type="struct" name="TpSvcConnectionInterfaceContactCapabilitiesClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilitiesClass"/>
	1728	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed"/>
	1729	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl"/>
	1730	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities"/>
	1731	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities"/>
	1732	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-update-capabilities-impl"/>
	1733	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities"/>
	1734	<keyword type="function" name="tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-capabilities-implement-update-capabilities"/>
1716	1735	<keyword type="struct" name="TpSvcConnectionInterfaceLocation" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation"/>
1717	1736	<keyword type="struct" name="TpSvcConnectionInterfaceLocationClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocationClass"/>
1718	1737	<keyword type="function" name="tp_svc_connection_interface_location_emit_location_updated ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-location-emit-location-updated"/>

2475	2494	<keyword type="constant" name="TP_CHANNEL_CALL_STATE_QUEUED" link="telepathy-glib-enums.html#TP-CHANNEL-CALL-STATE-QUEUED--CAPS"/>
2476	2495	<keyword type="constant" name="TP_CHANNEL_CALL_STATE_HELD" link="telepathy-glib-enums.html#TP-CHANNEL-CALL-STATE-HELD--CAPS"/>
2477	2496	<keyword type="constant" name="TP_CHANNEL_CALL_STATE_FORWARDED" link="telepathy-glib-enums.html#TP-CHANNEL-CALL-STATE-FORWARDED--CAPS"/>
	2497	<keyword type="constant" name="TP_CHANNEL_CALL_STATE_IN_PROGRESS" link="telepathy-glib-enums.html#TP-CHANNEL-CALL-STATE-IN-PROGRESS--CAPS"/>
2478	2498	<keyword type="constant" name="TP_LOCAL_HOLD_STATE_UNHELD" link="telepathy-glib-enums.html#TP-LOCAL-HOLD-STATE-UNHELD--CAPS"/>
2479	2499	<keyword type="constant" name="TP_LOCAL_HOLD_STATE_HELD" link="telepathy-glib-enums.html#TP-LOCAL-HOLD-STATE-HELD--CAPS"/>
2480	2500	<keyword type="constant" name="TP_LOCAL_HOLD_STATE_PENDING_HOLD" link="telepathy-glib-enums.html#TP-LOCAL-HOLD-STATE-PENDING-HOLD--CAPS"/>

+39

-0

docs/reference/telepathy-glib-sections.txt less more

914	914	TP_TYPE_SVC_CONNECTION_INTERFACE_CAPABILITIES
915	915	tp_svc_connection_interface_capabilities_get_type
916	916	TP_SVC_CONNECTION_INTERFACE_CAPABILITIES_GET_CLASS
	917	<SUBSECTION>
	918	TpSvcConnectionInterfaceContactCapabilities
	919	TpSvcConnectionInterfaceContactCapabilitiesClass
	920	tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed
	921	tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl
	922	tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities
	923	tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities
	924	tp_svc_connection_interface_contact_capabilities_update_capabilities_impl
	925	tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities
	926	tp_svc_connection_interface_contact_capabilities_implement_update_capabilities
	927	<SUBSECTION Standard>
	928	TP_SVC_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
	929	TP_IS_SVC_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
	930	TP_TYPE_SVC_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
	931	tp_svc_connection_interface_contact_capabilities_get_type
	932	TP_SVC_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_GET_CLASS
917	933	<SUBSECTION>
918	934	TpSvcConnectionInterfaceLocation
919	935	TpSvcConnectionInterfaceLocationClass

1108	1124	# Connection - Avatars
1109	1125	TP_HASH_TYPE_AVATAR_TOKEN_MAP
1110	1126	<SUBSECTION>
	1127	# Connection - ContactCapabilities
	1128	TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP
	1129	TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST
	1130	TP_STRUCT_TYPE_HANDLER_CAPABILITIES
	1131	TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST
	1132	<SUBSECTION>
1111	1133	# Connection - Capabilities
1112	1134	TP_STRUCT_TYPE_CAPABILITY_CHANGE
1113	1135	TP_ARRAY_TYPE_CAPABILITY_CHANGE_LIST

1210	1232	tp_type_dbus_array_oa_7bsv_7d
1211	1233	tp_type_dbus_array_of_a_7bsv_7d
1212	1234	tp_type_dbus_array_of_a_7bss_7d
	1235	tp_type_dbus_array_of_a_7bua_28a_7bsv_7das_29_7d
1213	1236	tp_type_dbus_array_of_o
1214	1237	tp_type_dbus_array_os
1215	1238	tp_type_dbus_array_osuu
1216	1239	tp_type_dbus_array_sa_28usuussduss_29
	1240	tp_type_dbus_array_saa_7bsv_7das
1217	1241	tp_type_dbus_array_sq
1218	1242	tp_type_dbus_array_su
1219	1243	tp_type_dbus_array_susv

1237	1261	tp_type_dbus_hash_sv
1238	1262	tp_type_dbus_hash_u_28ua_7bsa_7bsv_7d_7d_29
1239	1263	tp_type_dbus_hash_u_28uss_29
	1264	tp_type_dbus_hash_ua_28a_7bsv_7das_29
1240	1265	tp_type_dbus_hash_ua_7bsv_7d
1241	1266	tp_type_dbus_hash_uau
1242	1267	tp_type_dbus_hash_us

1249	1274	tp_type_dbus_struct_os
1250	1275	tp_type_dbus_struct_osuu
1251	1276	tp_type_dbus_struct_sa_28usuussduss_29
	1277	tp_type_dbus_struct_saa_7bsv_7das
1252	1278	tp_type_dbus_struct_sq
1253	1279	tp_type_dbus_struct_su
1254	1280	tp_type_dbus_struct_susv

1941	1967	TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS
1942	1968	TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES
1943	1969	TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES
	1970	TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
	1971	TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
1944	1972	TP_IFACE_CONNECTION_INTERFACE_CONTACTS
1945	1973	TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS
1946	1974	TP_IFACE_CONNECTION_INTERFACE_REQUESTS

2052	2080	tp_iface_quark_connection_interface_aliasing
2053	2081	tp_iface_quark_connection_interface_avatars
2054	2082	tp_iface_quark_connection_interface_contacts
	2083	tp_iface_quark_connection_interface_contact_capabilities
2055	2084	tp_iface_quark_connection_interface_capabilities
2056	2085	tp_iface_quark_connection_interface_requests
2057	2086	tp_iface_quark_connection_interface_simple_presence

2632	2661	<FILE>connection-caps</FILE>
2633	2662	<TITLE>connection-caps</TITLE>
2634	2663	<INCLUDE>telepathy-glib/connection.h</INCLUDE>
	2664	tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities
	2665	tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities
	2666	tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities
	2667	tp_cli_connection_interface_contact_capabilities_call_update_capabilities
	2668	tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed
	2669	tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed
	2670	<SUBSECTION Private>
	2671	tp_cli_connection_interface_contact_capabilities_run_get_contact_capabilities
	2672	tp_cli_connection_interface_contact_capabilities_run_update_capabilities
2635	2673	tp_cli_connection_interface_capabilities_run_advertise_capabilities
2636	2674	tp_cli_connection_interface_capabilities_run_get_capabilities
	2675	<SUBSECTION>
2637	2676	tp_cli_connection_interface_capabilities_call_advertise_capabilities
2638	2677	tp_cli_connection_interface_capabilities_call_get_capabilities
2639	2678	tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities

+59

-10

docs/reference/tmpl/connection-caps.sgml less more

16	16	<!-- ##### SECTION Stability_Level ##### -->
17	17
18	18
19		<!-- ##### FUNCTION tp_cli_connection_interface_capabilities_run_advertise_capabilities ##### -->
	19	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ##### -->
	20	<para>
	21
	22	</para>
	23
	24	@proxy:
	25	@out_Contact_Capabilities:
	26	@error:
	27	@user_data:
	28	@weak_object:
	29
	30
	31	<!-- ##### FUNCTION tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ##### -->
20	32	<para>
21	33
22	34	</para>
23	35
24	36	@proxy:
25	37	@timeout_ms:
26		@in_Add:
27		@in_Remove:
28		@out_Self_Capabilities:
29		@error:
30		@loop:
	38	@in_handles:
	39	@callback:
	40	@user_data:
	41	@destroy:
	42	@weak_object:
31	43	@Returns:
32	44
33	45
34		<!-- ##### FUNCTION tp_cli_connection_interface_capabilities_run_get_capabilities ##### -->
	46	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ##### -->
	47	<para>
	48
	49	</para>
	50
	51	@proxy:
	52	@error:
	53	@user_data:
	54	@weak_object:
	55
	56
	57	<!-- ##### FUNCTION tp_cli_connection_interface_contact_capabilities_call_update_capabilities ##### -->
35	58	<para>
36	59
37	60	</para>
38	61
39	62	@proxy:
40	63	@timeout_ms:
41		@in_Handles:
42		@out_Contact_Capabilities:
	64	@in_Handler_Capabilities:
	65	@callback:
	66	@user_data:
	67	@destroy:
	68	@weak_object:
	69	@Returns:
	70
	71
	72	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ##### -->
	73	<para>
	74
	75	</para>
	76
	77	@proxy:
	78	@arg_caps:
	79	@user_data:
	80	@weak_object:
	81
	82
	83	<!-- ##### FUNCTION tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ##### -->
	84	<para>
	85
	86	</para>
	87
	88	@proxy:
	89	@callback:
	90	@user_data:
	91	@destroy:
	92	@weak_object:
43	93	@error:
44		@loop:
45	94	@Returns:
46	95
47	96

-2

docs/reference/tmpl/connection.sgml less more

738	738	@proxy:
739	739	@timeout_ms:
740	740	@in_Handle_Type:
741		@in_Names:
	741	@in_Identifiers:
742	742	@callback:
743	743	@user_data:
744	744	@destroy:

754	754	@proxy:
755	755	@timeout_ms:
756	756	@in_Handle_Type:
757		@in_Names:
	757	@in_Identifiers:
758	758	@out_Handles:
759	759	@error:
760	760	@loop:

-0

docs/reference/tmpl/enums.sgml less more

514	514	@TP_CHANNEL_CALL_STATE_QUEUED:
515	515	@TP_CHANNEL_CALL_STATE_HELD:
516	516	@TP_CHANNEL_CALL_STATE_FORWARDED:
	517	@TP_CHANNEL_CALL_STATE_IN_PROGRESS:
517	518
518	519	<!-- ##### MACRO NUM_TP_LOCAL_HOLD_STATES ##### -->
519	520	<para>

+28

-0

docs/reference/tmpl/gtypes.sgml less more

172	172
173	173
174	174
	175	<!-- ##### MACRO TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP ##### -->
	176	<para>
	177
	178	</para>
	179
	180
	181
	182	<!-- ##### MACRO TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST ##### -->
	183	<para>
	184
	185	</para>
	186
	187
	188
	189	<!-- ##### MACRO TP_STRUCT_TYPE_HANDLER_CAPABILITIES ##### -->
	190	<para>
	191
	192	</para>
	193
	194
	195
	196	<!-- ##### MACRO TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST ##### -->
	197	<para>
	198
	199	</para>
	200
	201
	202
175	203	<!-- ##### MACRO TP_STRUCT_TYPE_CAPABILITY_CHANGE ##### -->
176	204	<para>
177	205

+14

-0

docs/reference/tmpl/interfaces.sgml less more

198	198
199	199
200	200
	201	<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES ##### -->
	202	<para>
	203
	204	</para>
	205
	206
	207
	208	<!-- ##### MACRO TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES ##### -->
	209	<para>
	210
	211	</para>
	212
	213
	214
201	215	<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACTS ##### -->
202	216	<para>
203	217

+77

-1

docs/reference/tmpl/svc-connection.sgml less more

375	375
376	376	@self:
377	377	@in_Handle_Type:
378		@in_Names:
	378	@in_Identifiers:
379	379	@context:
380	380
381	381

1390	1390	@arg_Caps:
1391	1391
1392	1392
	1393	<!-- ##### STRUCT TpSvcConnectionInterfaceContactCapabilities ##### -->
	1394	<para>
	1395
	1396	</para>
	1397
	1398
	1399	<!-- ##### STRUCT TpSvcConnectionInterfaceContactCapabilitiesClass ##### -->
	1400	<para>
	1401
	1402	</para>
	1403
	1404
	1405	<!-- ##### FUNCTION tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ##### -->
	1406	<para>
	1407
	1408	</para>
	1409
	1410	@instance:
	1411	@arg_caps:
	1412
	1413
	1414	<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ##### -->
	1415	<para>
	1416
	1417	</para>
	1418
	1419	@self:
	1420	@in_handles:
	1421	@context:
	1422
	1423
	1424	<!-- ##### FUNCTION tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ##### -->
	1425	<para>
	1426
	1427	</para>
	1428
	1429	@context:
	1430	@out_Contact_Capabilities:
	1431
	1432
	1433	<!-- ##### FUNCTION tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ##### -->
	1434	<para>
	1435
	1436	</para>
	1437
	1438	@klass:
	1439	@impl:
	1440
	1441
	1442	<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ##### -->
	1443	<para>
	1444
	1445	</para>
	1446
	1447	@self:
	1448	@in_Handler_Capabilities:
	1449	@context:
	1450
	1451
	1452	<!-- ##### FUNCTION tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ##### -->
	1453	<para>
	1454
	1455	</para>
	1456
	1457	@context:
	1458
	1459
	1460	<!-- ##### FUNCTION tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ##### -->
	1461	<para>
	1462
	1463	</para>
	1464
	1465	@klass:
	1466	@impl:
	1467
	1468
1393	1469	<!-- ##### STRUCT TpSvcConnectionInterfaceLocation ##### -->
1394	1470	<para>
1395	1471

+27

-0

docs/reference/tmpl/telepathy-glib-unused.sgml less more

44	44
45	45	@proxy:
46	46	@timeout_ms:
	47	@error:
	48	@loop:
	49	@Returns:
	50
	51	<!-- ##### FUNCTION tp_cli_connection_interface_capabilities_run_advertise_capabilities ##### -->
	52	<para>
	53
	54	</para>
	55
	56	@proxy:
	57	@timeout_ms:
	58	@in_Add:
	59	@in_Remove:
	60	@out_Self_Capabilities:
	61	@error:
	62	@loop:
	63	@Returns:
	64
	65	<!-- ##### FUNCTION tp_cli_connection_interface_capabilities_run_get_capabilities ##### -->
	66	<para>
	67
	68	</para>
	69
	70	@proxy:
	71	@timeout_ms:
	72	@in_Handles:
	73	@out_Contact_Capabilities:
47	74	@error:
48	75	@loop:
49	76	@Returns:

+21

-2

docs/reference/xml/api-index-full.xml less more

376	376	<indexentry><primaryie linkends="TpSvcConnectionInterfaceCapabilities-struct"><link linkend="TpSvcConnectionInterfaceCapabilities">TpSvcConnectionInterfaceCapabilities</link></primaryie></indexentry>
377	377	<indexentry><primaryie linkends="TpSvcConnectionInterfaceCapabilities-capabilities-changed"><link linkend="TpSvcConnectionInterfaceCapabilities-capabilities-changed">TpSvcConnectionInterfaceCapabilities::capabilities-changed</link></primaryie></indexentry>
378	378	<indexentry><primaryie linkends="TpSvcConnectionInterfaceCapabilitiesClass"><link linkend="TpSvcConnectionInterfaceCapabilitiesClass">TpSvcConnectionInterfaceCapabilitiesClass</link></primaryie></indexentry>
	379	<indexentry><primaryie linkends="TpSvcConnectionInterfaceContactCapabilities"><link linkend="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</link></primaryie></indexentry>
	380	<indexentry><primaryie linkends="TpSvcConnectionInterfaceContactCapabilitiesClass"><link linkend="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</link></primaryie></indexentry>
379	381	<indexentry><primaryie linkends="TpSvcConnectionInterfaceContacts-struct"><link linkend="TpSvcConnectionInterfaceContacts">TpSvcConnectionInterfaceContacts</link></primaryie></indexentry>
380	382	<indexentry><primaryie linkends="TpSvcConnectionInterfaceContactsClass"><link linkend="TpSvcConnectionInterfaceContactsClass">TpSvcConnectionInterfaceContactsClass</link></primaryie></indexentry>
381	383	<indexentry><primaryie linkends="TpSvcConnectionInterfaceLocation"><link linkend="TpSvcConnectionInterfaceLocation">TpSvcConnectionInterfaceLocation</link></primaryie></indexentry>

457	459	<indexentry><primaryie linkends="TP-ARRAY-TYPE-CHANNEL-CLASS-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CHANNEL-CLASS-LIST--CAPS">TP_ARRAY_TYPE_CHANNEL_CLASS_LIST</link></primaryie></indexentry>
458	460	<indexentry><primaryie linkends="TP-ARRAY-TYPE-CHANNEL-DETAILS-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CHANNEL-DETAILS-LIST--CAPS">TP_ARRAY_TYPE_CHANNEL_DETAILS_LIST</link></primaryie></indexentry>
459	461	<indexentry><primaryie linkends="TP-ARRAY-TYPE-CHANNEL-INFO-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CHANNEL-INFO-LIST--CAPS">TP_ARRAY_TYPE_CHANNEL_INFO_LIST</link></primaryie></indexentry>
	462	<indexentry><primaryie linkends="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS">TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</link></primaryie></indexentry>
460	463	<indexentry><primaryie linkends="TP-ARRAY-TYPE-CONTACT-CAPABILITY-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CONTACT-CAPABILITY-LIST--CAPS">TP_ARRAY_TYPE_CONTACT_CAPABILITY_LIST</link></primaryie></indexentry>
461	464	<indexentry><primaryie linkends="TP-ARRAY-TYPE-DBUS-TUBE-MEMBER-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-DBUS-TUBE-MEMBER-LIST--CAPS">TP_ARRAY_TYPE_DBUS_TUBE_MEMBER_LIST</link></primaryie></indexentry>
462	465	<indexentry><primaryie linkends="TP-ARRAY-TYPE-DEBUG-MESSAGE-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-DEBUG-MESSAGE-LIST--CAPS">TP_ARRAY_TYPE_DEBUG_MESSAGE_LIST</link></primaryie></indexentry>
463	466	<indexentry><primaryie linkends="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS">TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</link></primaryie></indexentry>
	467	<indexentry><primaryie linkends="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS">TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</link></primaryie></indexentry>
464	468	<indexentry><primaryie linkends="TP-ARRAY-TYPE-LOCAL-PENDING-INFO-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-LOCAL-PENDING-INFO-LIST--CAPS">TP_ARRAY_TYPE_LOCAL_PENDING_INFO_LIST</link></primaryie></indexentry>
465	469	<indexentry><primaryie linkends="TP-ARRAY-TYPE-MEDIA-SESSION-HANDLER-INFO-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-MEDIA-SESSION-HANDLER-INFO-LIST--CAPS">TP_ARRAY_TYPE_MEDIA_SESSION_HANDLER_INFO_LIST</link></primaryie></indexentry>
466	470	<indexentry><primaryie linkends="TP-ARRAY-TYPE-MEDIA-STREAM-HANDLER-CANDIDATE-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-MEDIA-STREAM-HANDLER-CANDIDATE-LIST--CAPS">TP_ARRAY_TYPE_MEDIA_STREAM_HANDLER_CANDIDATE_LIST</link></primaryie></indexentry>

944	948	<indexentry><primaryie linkends="tp-cli-connection-interface-capabilities-call-advertise-capabilities"><link linkend="tp-cli-connection-interface-capabilities-call-advertise-capabilities">tp_cli_connection_interface_capabilities_call_advertise_capabilities</link></primaryie></indexentry>
945	949	<indexentry><primaryie linkends="tp-cli-connection-interface-capabilities-call-get-capabilities"><link linkend="tp-cli-connection-interface-capabilities-call-get-capabilities">tp_cli_connection_interface_capabilities_call_get_capabilities</link></primaryie></indexentry>
946	950	<indexentry><primaryie linkends="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed"><link linkend="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed</link></primaryie></indexentry>
947		<indexentry><primaryie linkends="tp-cli-connection-interface-capabilities-run-advertise-capabilities"><link linkend="tp-cli-connection-interface-capabilities-run-advertise-capabilities">tp_cli_connection_interface_capabilities_run_advertise_capabilities</link></primaryie></indexentry>
948		<indexentry><primaryie linkends="tp-cli-connection-interface-capabilities-run-get-capabilities"><link linkend="tp-cli-connection-interface-capabilities-run-get-capabilities">tp_cli_connection_interface_capabilities_run_get_capabilities</link></primaryie></indexentry>
949	951	<indexentry><primaryie linkends="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed"><link linkend="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</link></primaryie></indexentry>
950	952	<indexentry><primaryie linkends="tp-cli-connection-interface-contacts-callback-for-get-contact-attributes"><link linkend="tp-cli-connection-interface-contacts-callback-for-get-contact-attributes">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</link></primaryie></indexentry>
951	953	<indexentry><primaryie linkends="tp-cli-connection-interface-contacts-call-get-contact-attributes"><link linkend="tp-cli-connection-interface-contacts-call-get-contact-attributes">tp_cli_connection_interface_contacts_call_get_contact_attributes</link></primaryie></indexentry>
952	954	<indexentry><primaryie linkends="tp-cli-connection-interface-contacts-run-get-contact-attributes"><link linkend="tp-cli-connection-interface-contacts-run-get-contact-attributes">tp_cli_connection_interface_contacts_run_get_contact_attributes</link></primaryie></indexentry>
	955	<indexentry><primaryie linkends="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"><link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</link></primaryie></indexentry>
	956	<indexentry><primaryie linkends="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"><link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</link></primaryie></indexentry>
	957	<indexentry><primaryie linkends="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"><link linkend="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities">tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities</link></primaryie></indexentry>
	958	<indexentry><primaryie linkends="tp-cli-connection-interface-contact-capabilities-call-update-capabilities"><link linkend="tp-cli-connection-interface-contact-capabilities-call-update-capabilities">tp_cli_connection_interface_contact_capabilities_call_update_capabilities</link></primaryie></indexentry>
	959	<indexentry><primaryie linkends="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"><link linkend="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed</link></primaryie></indexentry>
	960	<indexentry><primaryie linkends="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"><link linkend="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</link></primaryie></indexentry>
953	961	<indexentry><primaryie linkends="tp-cli-connection-interface-location-callback-for-get-locations"><link linkend="tp-cli-connection-interface-location-callback-for-get-locations">tp_cli_connection_interface_location_callback_for_get_locations</link></primaryie></indexentry>
954	962	<indexentry><primaryie linkends="tp-cli-connection-interface-location-callback-for-request-location"><link linkend="tp-cli-connection-interface-location-callback-for-request-location">tp_cli_connection_interface_location_callback_for_request_location</link></primaryie></indexentry>
955	963	<indexentry><primaryie linkends="tp-cli-connection-interface-location-callback-for-set-location"><link linkend="tp-cli-connection-interface-location-callback-for-set-location">tp_cli_connection_interface_location_callback_for_set_location</link></primaryie></indexentry>

1414	1422	<indexentry><primaryie linkends="TP-HASH-TYPE-CHANNEL-CALL-STATE-MAP--CAPS"><link linkend="TP-HASH-TYPE-CHANNEL-CALL-STATE-MAP--CAPS">TP_HASH_TYPE_CHANNEL_CALL_STATE_MAP</link></primaryie></indexentry>
1415	1423	<indexentry><primaryie linkends="TP-HASH-TYPE-CHANNEL-CLASS--CAPS"><link linkend="TP-HASH-TYPE-CHANNEL-CLASS--CAPS">TP_HASH_TYPE_CHANNEL_CLASS</link></primaryie></indexentry>
1416	1424	<indexentry><primaryie linkends="TP-HASH-TYPE-CONTACT-ATTRIBUTES-MAP--CAPS"><link linkend="TP-HASH-TYPE-CONTACT-ATTRIBUTES-MAP--CAPS">TP_HASH_TYPE_CONTACT_ATTRIBUTES_MAP</link></primaryie></indexentry>
	1425	<indexentry><primaryie linkends="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS"><link linkend="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS">TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</link></primaryie></indexentry>
1417	1426	<indexentry><primaryie linkends="TP-HASH-TYPE-CONTACT-LOCATIONS--CAPS"><link linkend="TP-HASH-TYPE-CONTACT-LOCATIONS--CAPS">TP_HASH_TYPE_CONTACT_LOCATIONS</link></primaryie></indexentry>
1418	1427	<indexentry><primaryie linkends="TP-HASH-TYPE-CONTACT-PRESENCES--CAPS"><link linkend="TP-HASH-TYPE-CONTACT-PRESENCES--CAPS">TP_HASH_TYPE_CONTACT_PRESENCES</link></primaryie></indexentry>
1419	1428	<indexentry><primaryie linkends="TP-HASH-TYPE-DBUS-TUBE-PARTICIPANTS--CAPS"><link linkend="TP-HASH-TYPE-DBUS-TUBE-PARTICIPANTS--CAPS">TP_HASH_TYPE_DBUS_TUBE_PARTICIPANTS</link></primaryie></indexentry>

1475	1484	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-AVATARS--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-AVATARS--CAPS">TP_IFACE_CONNECTION_INTERFACE_AVATARS</link></primaryie></indexentry>
1476	1485	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS">TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES</link></primaryie></indexentry>
1477	1486	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS">TP_IFACE_CONNECTION_INTERFACE_CONTACTS</link></primaryie></indexentry>
	1487	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS">TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</link></primaryie></indexentry>
1478	1488	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-LOCATION--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-LOCATION--CAPS">TP_IFACE_CONNECTION_INTERFACE_LOCATION</link></primaryie></indexentry>
1479	1489	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-PRESENCE--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-PRESENCE--CAPS">TP_IFACE_CONNECTION_INTERFACE_PRESENCE</link></primaryie></indexentry>
1480	1490	<indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS">TP_IFACE_CONNECTION_INTERFACE_REQUESTS</link></primaryie></indexentry>

1524	1534	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS</link></primaryie></indexentry>
1525	1535	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES</link></primaryie></indexentry>
1526	1536	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS</link></primaryie></indexentry>
	1537	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</link></primaryie></indexentry>
1527	1538	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-LOCATION--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-LOCATION--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_LOCATION</link></primaryie></indexentry>
1528	1539	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-PRESENCE--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-PRESENCE--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_PRESENCE</link></primaryie></indexentry>
1529	1540	<indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-REQUESTS--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-REQUESTS--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_REQUESTS</link></primaryie></indexentry>

1671	1682	<indexentry><primaryie linkends="TP-STRUCT-TYPE-DBUS-TUBE-MEMBER--CAPS"><link linkend="TP-STRUCT-TYPE-DBUS-TUBE-MEMBER--CAPS">TP_STRUCT_TYPE_DBUS_TUBE_MEMBER</link></primaryie></indexentry>
1672	1683	<indexentry><primaryie linkends="TP-STRUCT-TYPE-DEBUG-MESSAGE--CAPS"><link linkend="TP-STRUCT-TYPE-DEBUG-MESSAGE--CAPS">TP_STRUCT_TYPE_DEBUG_MESSAGE</link></primaryie></indexentry>
1673	1684	<indexentry><primaryie linkends="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"><link linkend="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS">TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</link></primaryie></indexentry>
	1685	<indexentry><primaryie linkends="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS"><link linkend="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS">TP_STRUCT_TYPE_HANDLER_CAPABILITIES</link></primaryie></indexentry>
1674	1686	<indexentry><primaryie linkends="TP-STRUCT-TYPE-LAST-ACTIVITY-AND-STATUSES--CAPS"><link linkend="TP-STRUCT-TYPE-LAST-ACTIVITY-AND-STATUSES--CAPS">TP_STRUCT_TYPE_LAST_ACTIVITY_AND_STATUSES</link></primaryie></indexentry>
1675	1687	<indexentry><primaryie linkends="TP-STRUCT-TYPE-LOCAL-PENDING-INFO--CAPS"><link linkend="TP-STRUCT-TYPE-LOCAL-PENDING-INFO--CAPS">TP_STRUCT_TYPE_LOCAL_PENDING_INFO</link></primaryie></indexentry>
1676	1688	<indexentry><primaryie linkends="TP-STRUCT-TYPE-MEDIA-SESSION-HANDLER-INFO--CAPS"><link linkend="TP-STRUCT-TYPE-MEDIA-SESSION-HANDLER-INFO--CAPS">TP_STRUCT_TYPE_MEDIA_SESSION_HANDLER_INFO</link></primaryie></indexentry>

2025	2037	<indexentry><primaryie linkends="tp-svc-connection-interface-contacts-get-contact-attributes-impl"><link linkend="tp-svc-connection-interface-contacts-get-contact-attributes-impl">tp_svc_connection_interface_contacts_get_contact_attributes_impl</link></primaryie></indexentry>
2026	2038	<indexentry><primaryie linkends="tp-svc-connection-interface-contacts-implement-get-contact-attributes"><link linkend="tp-svc-connection-interface-contacts-implement-get-contact-attributes">tp_svc_connection_interface_contacts_implement_get_contact_attributes</link></primaryie></indexentry>
2027	2039	<indexentry><primaryie linkends="tp-svc-connection-interface-contacts-return-from-get-contact-attributes"><link linkend="tp-svc-connection-interface-contacts-return-from-get-contact-attributes">tp_svc_connection_interface_contacts_return_from_get_contact_attributes</link></primaryie></indexentry>
	2040	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed"><link linkend="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed">tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed</link></primaryie></indexentry>
	2041	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl"><link linkend="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl">tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</link></primaryie></indexentry>
	2042	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities"><link linkend="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities">tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities</link></primaryie></indexentry>
	2043	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities"><link linkend="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities">tp_svc_connection_interface_contact_capabilities_implement_update_capabilities</link></primaryie></indexentry>
	2044	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities"><link linkend="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities">tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities</link></primaryie></indexentry>
	2045	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities"><link linkend="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities">tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities</link></primaryie></indexentry>
	2046	<indexentry><primaryie linkends="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl"><link linkend="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl">tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</link></primaryie></indexentry>
2028	2047	<indexentry><primaryie linkends="tp-svc-connection-interface-location-emit-location-updated"><link linkend="tp-svc-connection-interface-location-emit-location-updated">tp_svc_connection_interface_location_emit_location_updated</link></primaryie></indexentry>
2029	2048	<indexentry><primaryie linkends="tp-svc-connection-interface-location-get-locations-impl"><link linkend="tp-svc-connection-interface-location-get-locations-impl">tp_svc_connection_interface_location_get_locations_impl</link></primaryie></indexentry>
2030	2049	<indexentry><primaryie linkends="tp-svc-connection-interface-location-implement-get-locations"><link linkend="tp-svc-connection-interface-location-implement-get-locations">tp_svc_connection_interface_location_implement_get_locations</link></primaryie></indexentry>

-1

docs/reference/xml/channel-roomlist.xml less more

476	476	Connect a handler to the signal GotRooms.
477	477	</para>
478	478	<para>
479		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when information about rooms on the server becomes available. The array contains the room handle (as can be passed to the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">RequestChannel</tp:dbus-ref> method with HANDLE_TYPE_ROOM), the channel type, and a dictionary containing further information about the room as available. The following well-known keys and types are recommended for use where appropriate:</p> <dl> <dt>handle-name (s)</dt> <dd>The string name of the room handle (as would be returned by <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>)</dd> <dt>name (s)</dt> <dd>The human-readable name of the room if different from the handle</dd> <dt>description (s)</dt> <dd>A description of the room's overall purpose</dd> <dt>subject (s)</dt> <dd>The current subject of conversation in the room</dd> <dt>members (u)</dt> <dd>The number of members in the room</dd> <dt>password (b)</dt> <dd>True if the room requires a password to enter</dd> <dt>invite-only (b)</dt> <dd>True if you cannot join the room, but must be invited</dd> </dl></para>
	479	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when information about rooms on the server becomes available. The array contains the room handle (as can be passed to the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">RequestChannel</tp:dbus-ref> method with HANDLE_TYPE_ROOM), the channel type, and a dictionary containing further information about the room as available. The following well-known keys and types are recommended for use where appropriate:</p> <dl> <dt>handle-name (s)</dt> <dd>The identifier of the room (as would be returned by <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>)</dd> <dt>name (s)</dt> <dd>The human-readable name of the room if different from the handle</dd> <dt>description (s)</dt> <dd>A description of the room's overall purpose</dd> <dt>subject (s)</dt> <dd>The current subject of conversation in the room</dd> <dt>members (u)</dt> <dd>The number of members in the room</dd> <dt>password (b)</dt> <dd>True if the room requires a password to enter</dd> <dt>invite-only (b)</dt> <dd>True if you cannot join the room, but must be invited</dd> </dl></para>
480	480	<para>
481	481	</para><variablelist role="params">
482	482	<varlistentry><term><parameter>proxy</parameter> :</term>

-2

docs/reference/xml/connection-aliasing.xml less more

239	239	state.
240	240	</para>
241	241	<para>
242		Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the handle name if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</para>
	242	Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the contact identifier (i.e. the string corresponding to the handle) if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</para>
243	243	<para>
244	244	</para><variablelist role="params">
245	245	<varlistentry><term><parameter>proxy</parameter> :</term>

426	426	Start a GetAliases method call.
427	427	</para>
428	428	<para>
429		Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the handle name if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</para>
	429	Request the value of several contacts' aliases at once. This SHOULD only return cached aliases, falling back on the contact identifier (i.e. the string corresponding to the handle) if none is present. Also if there was no cached alias, a request SHOULD be started of which the result is later signalled by <tp:member-ref>AliasesChanged</tp:member-ref>.</para>
430	430	<para>
431	431	</para><variablelist role="params">
432	432	<varlistentry><term><parameter>proxy</parameter> :</term>

+387

-221

docs/reference/xml/connection-caps.xml less more

2	2	"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3	3	<refentry id="telepathy-glib-connection-caps">
4	4	<refmeta>
5		<refentrytitle role="top_of_page" id="telepathy-glib-connection-caps.top_of_page">Connection Capabilities interface</refentrytitle>
	5	<refentrytitle role="top_of_page" id="telepathy-glib-connection-caps.top_of_page">Connection ContactCapabilities and Capabilities interfaces</refentrytitle>
6	6	<manvolnum>3</manvolnum>
7	7	<refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8	8	</refmeta>
9	9
10	10	<refnamediv>
11		<refname>Connection Capabilities interface</refname>
12		<refpurpose>client-side wrappers for the Capabilities interface</refpurpose>
	11	<refname>Connection ContactCapabilities and Capabilities interfaces</refname>
	12	<refpurpose>client-side wrappers for the capabilities interfaces</refpurpose>
13	13	</refnamediv>
14	14
15	15	<refsynopsisdiv id="telepathy-glib-connection-caps.synopsis" role="synopsis">

19	19
20	20	#include <telepathy-glib/connection.h>
21	21
22		<link linkend="gboolean">gboolean</link> <link linkend="tp-cli-connection-interface-capabilities-run-advertise-capabilities">tp_cli_connection_interface_capabilities_run_advertise_capabilities</link>
23		(<link linkend="TpConnection">TpConnection</link> *proxy,
24		<link linkend="gint">gint</link> timeout_ms,
25		const <link linkend="GPtrArray">GPtrArray</link> *in_Add,
26		const <link linkend="gchar">gchar</link> **in_Remove,
27		<link linkend="GPtrArray">GPtrArray</link> **out_Self_Capabilities,
28		<link linkend="GError">GError</link> **error,
29		<link linkend="GMainLoop">GMainLoop</link> **loop);
30		<link linkend="gboolean">gboolean</link> <link linkend="tp-cli-connection-interface-capabilities-run-get-capabilities">tp_cli_connection_interface_capabilities_run_get_capabilities</link>
31		(<link linkend="TpConnection">TpConnection</link> *proxy,
32		<link linkend="gint">gint</link> timeout_ms,
33		const <link linkend="GArray">GArray</link> *in_Handles,
34		<link linkend="GPtrArray">GPtrArray</link> **out_Contact_Capabilities,
35		<link linkend="GError">GError</link> **error,
36		<link linkend="GMainLoop">GMainLoop</link> **loop);
	22	<link linkend="void">void</link> (<link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities">*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</link>)
	23	(<link linkend="TpConnection">TpConnection</link> *proxy,
	24	<link linkend="GHashTable">GHashTable</link> *out_Contact_Capabilities,
	25	const <link linkend="GError">GError</link> *error,
	26	<link linkend="gpointer">gpointer</link> user_data,
	27	<link linkend="GObject">GObject</link> *weak_object);
	28	<link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities">tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities</link>
	29	(<link linkend="TpConnection">TpConnection</link> *proxy,
	30	<link linkend="gint">gint</link> timeout_ms,
	31	const <link linkend="GArray">GArray</link> *in_handles,
	32	<link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</link> callback,
	33	<link linkend="gpointer">gpointer</link> user_data,
	34	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	35	<link linkend="GObject">GObject</link> *weak_object);
	36	<link linkend="void">void</link> (<link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities">*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</link>)
	37	(<link linkend="TpConnection">TpConnection</link> *proxy,
	38	const <link linkend="GError">GError</link> *error,
	39	<link linkend="gpointer">gpointer</link> user_data,
	40	<link linkend="GObject">GObject</link> *weak_object);
	41	<link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-connection-interface-contact-capabilities-call-update-capabilities">tp_cli_connection_interface_contact_capabilities_call_update_capabilities</link>
	42	(<link linkend="TpConnection">TpConnection</link> *proxy,
	43	<link linkend="gint">gint</link> timeout_ms,
	44	const <link linkend="GPtrArray">GPtrArray</link> *in_Handler_Capabilities,
	45	<link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</link> callback,
	46	<link linkend="gpointer">gpointer</link> user_data,
	47	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	48	<link linkend="GObject">GObject</link> *weak_object);
	49	<link linkend="void">void</link> (<link linkend="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed">*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</link>)
	50	(<link linkend="TpConnection">TpConnection</link> *proxy,
	51	<link linkend="GHashTable">GHashTable</link> *arg_caps,
	52	<link linkend="gpointer">gpointer</link> user_data,
	53	<link linkend="GObject">GObject</link> *weak_object);
	54	<link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed</link>
	55	(<link linkend="TpConnection">TpConnection</link> *proxy,
	56	<link linkend="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</link> callback,
	57	<link linkend="gpointer">gpointer</link> user_data,
	58	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	59	<link linkend="GObject">GObject</link> *weak_object,
	60	<link linkend="GError">GError</link> **error);
	61
	62
37	63	<link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-connection-interface-capabilities-call-advertise-capabilities">tp_cli_connection_interface_capabilities_call_advertise_capabilities</link>
38	64	(<link linkend="TpConnection">TpConnection</link> *proxy,
39	65	<link linkend="gint">gint</link> timeout_ms,

90	116	<title role="desc.title">Description</title>
91	117	<para>
92	118	Some instant messaging protocols allow discovery of the capabilities of
93		a user's client. In Telepathy, this is represented by the Capabilities
94		interface, which lets applications advertise extra capabilities for the
95		local user, and query the interfaces supported by their contacts.
	119	a user's client. In Telepathy, this is represented by the
	120	ContactCapabilities interface, which lets applications advertise extra
	121	capabilities for the local user, and query the interfaces supported by
	122	their contacts.
	123	</para>
	124	<para>
	125	The Capabilities interface is an older API with similar functionality.
96	126	</para>
97	127	<para>
98	128	This section documents the auto-generated C wrappers for the
99		Capabilities interface, used with <link linkend="TpConnection"><type>TpConnection</type></link> objects.</para>
	129	ContactCapabilities and Capabilities interfaces, used with
	130	<link linkend="TpConnection"><type>TpConnection</type></link> objects.</para>
100	131	<para>
101	132	</para>
102	133	</refsect1>
103	134
104	135	<refsect1 id="telepathy-glib-connection-caps.details" role="details">
105	136	<title role="details.title">Details</title>
106		<refsect2 id="tp-cli-connection-interface-capabilities-run-advertise-capabilities" role="function">
107		<title>tp_cli_connection_interface_capabilities_run_advertise_capabilities ()</title>
108		<indexterm zone="tp-cli-connection-interface-capabilities-run-advertise-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_run_advertise_capabilities">tp_cli_connection_interface_capabilities_run_advertise_capabilities</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> tp_cli_connection_interface_capabilities_run_advertise_capabilities
109		(<link linkend="TpConnection">TpConnection</link> *proxy,
110		<link linkend="gint">gint</link> timeout_ms,
111		const <link linkend="GPtrArray">GPtrArray</link> *in_Add,
112		const <link linkend="gchar">gchar</link> **in_Remove,
113		<link linkend="GPtrArray">GPtrArray</link> **out_Self_Capabilities,
114		<link linkend="GError">GError</link> **error,
115		<link linkend="GMainLoop">GMainLoop</link> **loop);</programlisting>
116		<para>
117		Call the method AdvertiseCapabilities and run the main loop
118		until it returns. Before calling this method, you must
119		add a reference to any borrowed objects you need to keep,
120		and generally ensure that everything is in a consistent
121		state.
122		</para>
123		<para>
124		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></para>
125		<para>
126		</para><variablelist role="params">
127		<varlistentry><term><parameter>proxy</parameter> :</term>
128		<listitem><simpara> A <link linkend="TpConnection"><type>TpConnection</type></link> or subclass
129		</simpara></listitem></varlistentry>
130		<varlistentry><term><parameter>timeout_ms</parameter> :</term>
131		<listitem><simpara> Timeout in milliseconds, or -1 for default
132		</simpara></listitem></varlistentry>
133		<varlistentry><term><parameter>in_Add</parameter> :</term>
134		<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
135		</simpara></listitem></varlistentry>
136		<varlistentry><term><parameter>in_Remove</parameter> :</term>
137		<listitem><simpara> Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove
138		</simpara></listitem></varlistentry>
139		<varlistentry><term><parameter>out_Self_Capabilities</parameter> :</term>
140		<listitem><simpara> Used to return an 'out' argument if <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> is returned: An array of structures describing the current capabilities containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
	137	<refsect2 id="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" role="function">
	138	<title>tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()</title>
	139	<indexterm zone="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"><primary sortas="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities)
	140	(<link linkend="TpConnection">TpConnection</link> *proxy,
	141	<link linkend="GHashTable">GHashTable</link> *out_Contact_Capabilities,
	142	const <link linkend="GError">GError</link> *error,
	143	<link linkend="gpointer">gpointer</link> user_data,
	144	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	145	<para>
	146	Signature of the callback called when a GetContactCapabilities method call
	147	succeeds or fails.</para>
	148	<para>
	149	</para><variablelist role="params">
	150	<varlistentry><term><parameter>proxy</parameter> :</term>
	151	<listitem><simpara> the proxy on which the call was made
	152	</simpara></listitem></varlistentry>
	153	<varlistentry><term><parameter>out_Contact_Capabilities</parameter> :</term>
	154	<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a dictionary mapping the channel properties to their values.</li> <li>an array of additional allowed properties</li> </ul>
141	155	</simpara></listitem></varlistentry>
142	156	<varlistentry><term><parameter>error</parameter> :</term>
143		<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to return errors if <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>
144		is returned
145		</simpara></listitem></varlistentry>
146		<varlistentry><term><parameter>loop</parameter> :</term>
147		<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, set before re-entering
148		the main loop, to point to a <link linkend="GMainLoop"><type>GMainLoop</type></link>
149		which can be used to cancel this call with
150		<link linkend="g-main-loop-quit"><function>g_main_loop_quit()</function></link>, causing a return of
151		<link linkend="FALSE--CAPS"><literal>FALSE</literal></link> with <parameter>error</parameter> set to <link linkend="TP-DBUS-ERROR-CANCELLED--CAPS"><literal>TP_DBUS_ERROR_CANCELLED</literal></link>
152		</simpara></listitem></varlistentry>
153		<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE on success, FALSE and sets <parameter>error</parameter> on error
154		</simpara></listitem></varlistentry>
155		</variablelist></refsect2>
156		<refsect2 id="tp-cli-connection-interface-capabilities-run-get-capabilities" role="function">
157		<title>tp_cli_connection_interface_capabilities_run_get_capabilities ()</title>
158		<indexterm zone="tp-cli-connection-interface-capabilities-run-get-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_run_get_capabilities">tp_cli_connection_interface_capabilities_run_get_capabilities</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> tp_cli_connection_interface_capabilities_run_get_capabilities
159		(<link linkend="TpConnection">TpConnection</link> *proxy,
160		<link linkend="gint">gint</link> timeout_ms,
161		const <link linkend="GArray">GArray</link> *in_Handles,
162		<link linkend="GPtrArray">GPtrArray</link> **out_Contact_Capabilities,
163		<link linkend="GError">GError</link> **error,
164		<link linkend="GMainLoop">GMainLoop</link> **loop);</programlisting>
165		<para>
166		Call the method GetCapabilities and run the main loop
167		until it returns. Before calling this method, you must
168		add a reference to any borrowed objects you need to keep,
169		and generally ensure that everything is in a consistent
170		state.
171		</para>
172		<para>
173		Returns an array of capabilities for the given contact handles.</para>
174		<para>
175		</para><variablelist role="params">
176		<varlistentry><term><parameter>proxy</parameter> :</term>
177		<listitem><simpara> A <link linkend="TpConnection"><type>TpConnection</type></link> or subclass
178		</simpara></listitem></varlistentry>
179		<varlistentry><term><parameter>timeout_ms</parameter> :</term>
180		<listitem><simpara> Timeout in milliseconds, or -1 for default
181		</simpara></listitem></varlistentry>
182		<varlistentry><term><parameter>in_Handles</parameter> :</term>
183		<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p>
184		</simpara></listitem></varlistentry>
185		<varlistentry><term><parameter>out_Contact_Capabilities</parameter> :</term>
186		<listitem><simpara> Used to return an 'out' argument if <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> is returned: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of generic capability flags for the type</li> <li>a bitwise OR of type specific capability flags for the type</li> </ul>
187		</simpara></listitem></varlistentry>
188		<varlistentry><term><parameter>error</parameter> :</term>
189		<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to return errors if <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>
190		is returned
191		</simpara></listitem></varlistentry>
192		<varlistentry><term><parameter>loop</parameter> :</term>
193		<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, set before re-entering
194		the main loop, to point to a <link linkend="GMainLoop"><type>GMainLoop</type></link>
195		which can be used to cancel this call with
196		<link linkend="g-main-loop-quit"><function>g_main_loop_quit()</function></link>, causing a return of
197		<link linkend="FALSE--CAPS"><literal>FALSE</literal></link> with <parameter>error</parameter> set to <link linkend="TP-DBUS-ERROR-CANCELLED--CAPS"><literal>TP_DBUS_ERROR_CANCELLED</literal></link>
198		</simpara></listitem></varlistentry>
199		<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE on success, FALSE and sets <parameter>error</parameter> on error
200		</simpara></listitem></varlistentry>
201		</variablelist></refsect2>
202		<refsect2 id="tp-cli-connection-interface-capabilities-call-advertise-capabilities" role="function">
203		<title>tp_cli_connection_interface_capabilities_call_advertise_capabilities ()</title>
204		<indexterm zone="tp-cli-connection-interface-capabilities-call-advertise-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_call_advertise_capabilities">tp_cli_connection_interface_capabilities_call_advertise_capabilities</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_connection_interface_capabilities_call_advertise_capabilities
205		(<link linkend="TpConnection">TpConnection</link> *proxy,
206		<link linkend="gint">gint</link> timeout_ms,
207		const <link linkend="GPtrArray">GPtrArray</link> *in_Add,
208		const <link linkend="gchar">gchar</link> **in_Remove,
209		<link linkend="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</link> callback,
210		<link linkend="gpointer">gpointer</link> user_data,
211		<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
212		<link linkend="GObject">GObject</link> *weak_object);</programlisting>
213		<para>
214		Start a AdvertiseCapabilities method call.
215		</para>
216		<para>
217		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></para>
	157	<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
	158	</simpara></listitem></varlistentry>
	159	<varlistentry><term><parameter>user_data</parameter> :</term>
	160	<listitem><simpara> user-supplied data
	161	</simpara></listitem></varlistentry>
	162	<varlistentry><term><parameter>weak_object</parameter> :</term>
	163	<listitem><simpara> user-supplied object
	164	</simpara></listitem></varlistentry>
	165	</variablelist></refsect2>
	166	<refsect2 id="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities" role="function">
	167	<title>tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()</title>
	168	<indexterm zone="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"><primary sortas="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities">tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities
	169	(<link linkend="TpConnection">TpConnection</link> *proxy,
	170	<link linkend="gint">gint</link> timeout_ms,
	171	const <link linkend="GArray">GArray</link> *in_handles,
	172	<link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</link> callback,
	173	<link linkend="gpointer">gpointer</link> user_data,
	174	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	175	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	176	<para>
	177	Start a GetContactCapabilities method call.
	178	</para>
	179	<para>
	180	Returns an array of enhanced capabilities for the given contact handles.</para>
218	181	<para>
219	182	</para><variablelist role="params">
220	183	<varlistentry><term><parameter>proxy</parameter> :</term>

224	187	<listitem><simpara> the timeout in milliseconds, or -1 to use the
225	188	default
226	189	</simpara></listitem></varlistentry>
227		<varlistentry><term><parameter>in_Add</parameter> :</term>
228		<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
229		</simpara></listitem></varlistentry>
230		<varlistentry><term><parameter>in_Remove</parameter> :</term>
231		<listitem><simpara> Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove
	190	<varlistentry><term><parameter>in_handles</parameter> :</term>
	191	<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>The handle zero MUST NOT be included in the request.</p>
232	192	</simpara></listitem></varlistentry>
233	193	<varlistentry><term><parameter>callback</parameter> :</term>
234	194	<listitem><simpara> called when the method call succeeds or fails;

256	216	cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
257	217	</simpara></listitem></varlistentry>
258	218	</variablelist></refsect2>
259		<refsect2 id="tp-cli-connection-interface-capabilities-call-get-capabilities" role="function">
260		<title>tp_cli_connection_interface_capabilities_call_get_capabilities ()</title>
261		<indexterm zone="tp-cli-connection-interface-capabilities-call-get-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_call_get_capabilities">tp_cli_connection_interface_capabilities_call_get_capabilities</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_connection_interface_capabilities_call_get_capabilities
262		(<link linkend="TpConnection">TpConnection</link> *proxy,
263		<link linkend="gint">gint</link> timeout_ms,
264		const <link linkend="GArray">GArray</link> *in_Handles,
265		<link linkend="tp-cli-connection-interface-capabilities-callback-for-get-capabilities">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</link> callback,
266		<link linkend="gpointer">gpointer</link> user_data,
267		<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
268		<link linkend="GObject">GObject</link> *weak_object);</programlisting>
269		<para>
270		Start a GetCapabilities method call.
271		</para>
272		<para>
273		Returns an array of capabilities for the given contact handles.</para>
	219	<refsect2 id="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" role="function">
	220	<title>tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()</title>
	221	<indexterm zone="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"><primary sortas="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities)
	222	(<link linkend="TpConnection">TpConnection</link> *proxy,
	223	const <link linkend="GError">GError</link> *error,
	224	<link linkend="gpointer">gpointer</link> user_data,
	225	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	226	<para>
	227	Signature of the callback called when a UpdateCapabilities method call
	228	succeeds or fails.</para>
	229	<para>
	230	</para><variablelist role="params">
	231	<varlistentry><term><parameter>proxy</parameter> :</term>
	232	<listitem><simpara> the proxy on which the call was made
	233	</simpara></listitem></varlistentry>
	234	<varlistentry><term><parameter>error</parameter> :</term>
	235	<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
	236	</simpara></listitem></varlistentry>
	237	<varlistentry><term><parameter>user_data</parameter> :</term>
	238	<listitem><simpara> user-supplied data
	239	</simpara></listitem></varlistentry>
	240	<varlistentry><term><parameter>weak_object</parameter> :</term>
	241	<listitem><simpara> user-supplied object
	242	</simpara></listitem></varlistentry>
	243	</variablelist></refsect2>
	244	<refsect2 id="tp-cli-connection-interface-contact-capabilities-call-update-capabilities" role="function">
	245	<title>tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()</title>
	246	<indexterm zone="tp-cli-connection-interface-contact-capabilities-call-update-capabilities"><primary sortas="tp_cli_connection_interface_contact_capabilities_call_update_capabilities">tp_cli_connection_interface_contact_capabilities_call_update_capabilities</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_connection_interface_contact_capabilities_call_update_capabilities
	247	(<link linkend="TpConnection">TpConnection</link> *proxy,
	248	<link linkend="gint">gint</link> timeout_ms,
	249	const <link linkend="GPtrArray">GPtrArray</link> *in_Handler_Capabilities,
	250	<link linkend="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</link> callback,
	251	<link linkend="gpointer">gpointer</link> user_data,
	252	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	253	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	254	<para>
	255	Start a UpdateCapabilities method call.
	256	</para>
	257	<para>
	258	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Alter the connection's advertised capabilities to include the intersection of the given clients' capabilities with what the connection manager is able to implement.</p> <p>On connections managed by the ChannelDispatcher, processes other than the ChannelDispatcher SHOULD NOT call this method, and the ChannelDispatcher SHOULD use this method to advertise the capabilities of all the registered <tp:dbus-ref namespace="org.freedesktop.Telepathy">Client.Handler</tp:dbus-ref> implementations.On connections not managed by the ChannelDispatcher, clients MAY use this method directly, to indicate the channels they will handle and the extra capabilities they have.</p> <p>Upon a successful invocation of this method, the connection manager will only emit the <tp:member-ref>ContactCapabilitiesChanged</tp:member-ref> signal for the user's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">SelfHandle</tp:dbus-ref> if, in the underlying protocol, the new capabilities are distinct from the previous state.</p> <tp:rationale> <p>The connection manager will essentially intersect the provided capabilities and the channel classes it implements. Therefore, certain properties which are never fixed for a channel class (such as the target handle, or the Parameters property of a tube channel) will almost certainly not be advertised.</p> </tp:rationale> <p>This method MAY be called on a newly-created connection while it is still in the DISCONNECTED state, to request that when the connection connects, it will do so with the appropriate capabilities. Doing so MUST NOT fail.</p></para>
274	259	<para>
275	260	</para><variablelist role="params">
276	261	<varlistentry><term><parameter>proxy</parameter> :</term>

280	265	<listitem><simpara> the timeout in milliseconds, or -1 to use the
281	266	default
282	267	</simpara></listitem></varlistentry>
283		<varlistentry><term><parameter>in_Handles</parameter> :</term>
284		<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p>
	268	<varlistentry><term><parameter>in_Handler_Capabilities</parameter> :</term>
	269	<listitem><simpara> Used to pass an 'in' argument: <p>The capabilities of one or more clients.</p> <p>For each client in the given list, any capabilities previously advertised for the same client name are discarded, then replaced by the capabilities indicated.</p> <p>As a result, if a client becomes unavailable, this method SHOULD be called with a <tp:type>Handler_Capabilities</tp:type> structure containing its name, an empty list of channel classes, and an empty list of capabilities. When this is done, the connection manager SHOULD free all memory associated with that client name.</p> <tp:rationale> <p>This method takes a list of clients so that when the channel dispatcher first calls it (with a list of all the Handlers that are initially available), the changes can be made atomically, with only one transmission of updated capabilities to the network. Afterwards, the channel dispatcher will call this method with a single-element list every time a Handler becomes available or unavailable.</p> </tp:rationale> <p>The connection manager MUST ignore any channel classes and client capabilities for which there is no representation in the protocol or no support in the connection manager.</p>
285	270	</simpara></listitem></varlistentry>
286	271	<varlistentry><term><parameter>callback</parameter> :</term>
287	272	<listitem><simpara> called when the method call succeeds or fails;

309	294	cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
310	295	</simpara></listitem></varlistentry>
311	296	</variablelist></refsect2>
312		<refsect2 id="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" role="function">
313		<title>tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()</title>
314		<indexterm zone="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities)
315		(<link linkend="TpConnection">TpConnection</link> *proxy,
316		const <link linkend="GPtrArray">GPtrArray</link> *out_Self_Capabilities,
317		const <link linkend="GError">GError</link> *error,
318		<link linkend="gpointer">gpointer</link> user_data,
319		<link linkend="GObject">GObject</link> *weak_object);</programlisting>
320		<para>
321		Signature of the callback called when a AdvertiseCapabilities method call
322		succeeds or fails.</para>
323		<para>
324		</para><variablelist role="params">
325		<varlistentry><term><parameter>proxy</parameter> :</term>
326		<listitem><simpara> the proxy on which the call was made
327		</simpara></listitem></varlistentry>
328		<varlistentry><term><parameter>out_Self_Capabilities</parameter> :</term>
329		<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: An array of structures describing the current capabilities containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
330		</simpara></listitem></varlistentry>
331		<varlistentry><term><parameter>error</parameter> :</term>
332		<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
333		</simpara></listitem></varlistentry>
334		<varlistentry><term><parameter>user_data</parameter> :</term>
335		<listitem><simpara> user-supplied data
336		</simpara></listitem></varlistentry>
337		<varlistentry><term><parameter>weak_object</parameter> :</term>
338		<listitem><simpara> user-supplied object
339		</simpara></listitem></varlistentry>
340		</variablelist></refsect2>
341		<refsect2 id="tp-cli-connection-interface-capabilities-callback-for-get-capabilities" role="function">
342		<title>tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()</title>
343		<indexterm zone="tp-cli-connection-interface-capabilities-callback-for-get-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_callback_for_get_capabilities">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_capabilities_callback_for_get_capabilities)
344		(<link linkend="TpConnection">TpConnection</link> *proxy,
345		const <link linkend="GPtrArray">GPtrArray</link> *out_Contact_Capabilities,
346		const <link linkend="GError">GError</link> *error,
347		<link linkend="gpointer">gpointer</link> user_data,
348		<link linkend="GObject">GObject</link> *weak_object);</programlisting>
349		<para>
350		Signature of the callback called when a GetCapabilities method call
351		succeeds or fails.</para>
352		<para>
353		</para><variablelist role="params">
354		<varlistentry><term><parameter>proxy</parameter> :</term>
355		<listitem><simpara> the proxy on which the call was made
356		</simpara></listitem></varlistentry>
357		<varlistentry><term><parameter>out_Contact_Capabilities</parameter> :</term>
358		<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of generic capability flags for the type</li> <li>a bitwise OR of type specific capability flags for the type</li> </ul>
359		</simpara></listitem></varlistentry>
360		<varlistentry><term><parameter>error</parameter> :</term>
361		<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
362		</simpara></listitem></varlistentry>
363		<varlistentry><term><parameter>user_data</parameter> :</term>
364		<listitem><simpara> user-supplied data
365		</simpara></listitem></varlistentry>
366		<varlistentry><term><parameter>weak_object</parameter> :</term>
367		<listitem><simpara> user-supplied object
368		</simpara></listitem></varlistentry>
369		</variablelist></refsect2>
370		<refsect2 id="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed" role="function">
371		<title>tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()</title>
372		<indexterm zone="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed"><primary sortas="tp_cli_connection_interface_capabilities_connect_to_capabilities_changed">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_connection_interface_capabilities_connect_to_capabilities_changed
373		(<link linkend="TpConnection">TpConnection</link> *proxy,
374		<link linkend="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</link> callback,
	297	<refsect2 id="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" role="function">
	298	<title>tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()</title>
	299	<indexterm zone="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"><primary sortas="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed)
	300	(<link linkend="TpConnection">TpConnection</link> *proxy,
	301	<link linkend="GHashTable">GHashTable</link> *arg_caps,
	302	<link linkend="gpointer">gpointer</link> user_data,
	303	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	304	<para>
	305	Represents the signature of a callback for the signal ContactCapabilitiesChanged.</para>
	306	<para>
	307	</para><variablelist role="params">
	308	<varlistentry><term><parameter>proxy</parameter> :</term>
	309	<listitem><simpara> The proxy on which <link linkend="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"><function>tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed()</function></link>
	310	was called
	311	</simpara></listitem></varlistentry>
	312	<varlistentry><term><parameter>arg_caps</parameter> :</term>
	313	<listitem><simpara> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> All the capabilities of the contacts
	314	</simpara></listitem></varlistentry>
	315	<varlistentry><term><parameter>user_data</parameter> :</term>
	316	<listitem><simpara> User-supplied data
	317	</simpara></listitem></varlistentry>
	318	<varlistentry><term><parameter>weak_object</parameter> :</term>
	319	<listitem><simpara> User-supplied weakly referenced object
	320	</simpara></listitem></varlistentry>
	321	</variablelist></refsect2>
	322	<refsect2 id="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" role="function">
	323	<title>tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()</title>
	324	<indexterm zone="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"><primary sortas="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed
	325	(<link linkend="TpConnection">TpConnection</link> *proxy,
	326	<link linkend="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</link> callback,
375	327	<link linkend="gpointer">gpointer</link> user_data,
376	328	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
377	329	<link linkend="GObject">GObject</link> *weak_object,
378	330	<link linkend="GError">GError</link> **error);</programlisting>
379	331	<para>
380		Connect a handler to the signal CapabilitiesChanged.
381		</para>
382		<para>
383		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handle.</p> <p>If the handle is zero, the capabilities refer to the connection itself, in some poorly defined way. This usage is deprecated and clients should ignore it.</p></para>
	332	Connect a handler to the signal ContactCapabilitiesChanged.
	333	</para>
	334	<para>
	335	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handles. A single signal can be emitted for several contacts.</p> <tp:rationale> <p>The underlying protocol can get several contacts' capabilities at the same time.</p> </tp:rationale></para>
384	336	<para>
385	337	</para><variablelist role="params">
386	338	<varlistentry><term><parameter>proxy</parameter> :</term>

413	365	or has become invalid.
414	366	</simpara></listitem></varlistentry>
415	367	</variablelist></refsect2>
	368	<refsect2 id="tp-cli-connection-interface-capabilities-call-advertise-capabilities" role="function">
	369	<title>tp_cli_connection_interface_capabilities_call_advertise_capabilities ()</title>
	370	<indexterm zone="tp-cli-connection-interface-capabilities-call-advertise-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_call_advertise_capabilities">tp_cli_connection_interface_capabilities_call_advertise_capabilities</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_connection_interface_capabilities_call_advertise_capabilities
	371	(<link linkend="TpConnection">TpConnection</link> *proxy,
	372	<link linkend="gint">gint</link> timeout_ms,
	373	const <link linkend="GPtrArray">GPtrArray</link> *in_Add,
	374	const <link linkend="gchar">gchar</link> **in_Remove,
	375	<link linkend="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</link> callback,
	376	<link linkend="gpointer">gpointer</link> user_data,
	377	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	378	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	379	<para>
	380	Start a AdvertiseCapabilities method call.
	381	</para>
	382	<para>
	383	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></para>
	384	<para>
	385	</para><variablelist role="params">
	386	<varlistentry><term><parameter>proxy</parameter> :</term>
	387	<listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
	388	</simpara></listitem></varlistentry>
	389	<varlistentry><term><parameter>timeout_ms</parameter> :</term>
	390	<listitem><simpara> the timeout in milliseconds, or -1 to use the
	391	default
	392	</simpara></listitem></varlistentry>
	393	<varlistentry><term><parameter>in_Add</parameter> :</term>
	394	<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
	395	</simpara></listitem></varlistentry>
	396	<varlistentry><term><parameter>in_Remove</parameter> :</term>
	397	<listitem><simpara> Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove
	398	</simpara></listitem></varlistentry>
	399	<varlistentry><term><parameter>callback</parameter> :</term>
	400	<listitem><simpara> called when the method call succeeds or fails;
	401	may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
	402	reply tracking
	403	</simpara></listitem></varlistentry>
	404	<varlistentry><term><parameter>user_data</parameter> :</term>
	405	<listitem><simpara> user-supplied data passed to the callback;
	406	must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	407	</simpara></listitem></varlistentry>
	408	<varlistentry><term><parameter>destroy</parameter> :</term>
	409	<listitem><simpara> called with the user_data as argument, after the
	410	call has succeeded, failed or been cancelled;
	411	must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	412	</simpara></listitem></varlistentry>
	413	<varlistentry><term><parameter>weak_object</parameter> :</term>
	414	<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
	415	weakly referenced; if it is destroyed, this call
	416	will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
	417	<parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	418	</simpara></listitem></varlistentry>
	419	<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
	420	progress. It is borrowed from the object, and will become
	421	invalid when the callback is called, the call is
	422	cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
	423	</simpara></listitem></varlistentry>
	424	</variablelist></refsect2>
	425	<refsect2 id="tp-cli-connection-interface-capabilities-call-get-capabilities" role="function">
	426	<title>tp_cli_connection_interface_capabilities_call_get_capabilities ()</title>
	427	<indexterm zone="tp-cli-connection-interface-capabilities-call-get-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_call_get_capabilities">tp_cli_connection_interface_capabilities_call_get_capabilities</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_connection_interface_capabilities_call_get_capabilities
	428	(<link linkend="TpConnection">TpConnection</link> *proxy,
	429	<link linkend="gint">gint</link> timeout_ms,
	430	const <link linkend="GArray">GArray</link> *in_Handles,
	431	<link linkend="tp-cli-connection-interface-capabilities-callback-for-get-capabilities">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</link> callback,
	432	<link linkend="gpointer">gpointer</link> user_data,
	433	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	434	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	435	<para>
	436	Start a GetCapabilities method call.
	437	</para>
	438	<para>
	439	Returns an array of capabilities for the given contact handles.</para>
	440	<para>
	441	</para><variablelist role="params">
	442	<varlistentry><term><parameter>proxy</parameter> :</term>
	443	<listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
	444	</simpara></listitem></varlistentry>
	445	<varlistentry><term><parameter>timeout_ms</parameter> :</term>
	446	<listitem><simpara> the timeout in milliseconds, or -1 to use the
	447	default
	448	</simpara></listitem></varlistentry>
	449	<varlistentry><term><parameter>in_Handles</parameter> :</term>
	450	<listitem><simpara> Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p>
	451	</simpara></listitem></varlistentry>
	452	<varlistentry><term><parameter>callback</parameter> :</term>
	453	<listitem><simpara> called when the method call succeeds or fails;
	454	may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
	455	reply tracking
	456	</simpara></listitem></varlistentry>
	457	<varlistentry><term><parameter>user_data</parameter> :</term>
	458	<listitem><simpara> user-supplied data passed to the callback;
	459	must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	460	</simpara></listitem></varlistentry>
	461	<varlistentry><term><parameter>destroy</parameter> :</term>
	462	<listitem><simpara> called with the user_data as argument, after the
	463	call has succeeded, failed or been cancelled;
	464	must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	465	</simpara></listitem></varlistentry>
	466	<varlistentry><term><parameter>weak_object</parameter> :</term>
	467	<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
	468	weakly referenced; if it is destroyed, this call
	469	will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
	470	<parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	471	</simpara></listitem></varlistentry>
	472	<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
	473	progress. It is borrowed from the object, and will become
	474	invalid when the callback is called, the call is
	475	cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
	476	</simpara></listitem></varlistentry>
	477	</variablelist></refsect2>
	478	<refsect2 id="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" role="function">
	479	<title>tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()</title>
	480	<indexterm zone="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities)
	481	(<link linkend="TpConnection">TpConnection</link> *proxy,
	482	const <link linkend="GPtrArray">GPtrArray</link> *out_Self_Capabilities,
	483	const <link linkend="GError">GError</link> *error,
	484	<link linkend="gpointer">gpointer</link> user_data,
	485	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	486	<para>
	487	Signature of the callback called when a AdvertiseCapabilities method call
	488	succeeds or fails.</para>
	489	<para>
	490	</para><variablelist role="params">
	491	<varlistentry><term><parameter>proxy</parameter> :</term>
	492	<listitem><simpara> the proxy on which the call was made
	493	</simpara></listitem></varlistentry>
	494	<varlistentry><term><parameter>out_Self_Capabilities</parameter> :</term>
	495	<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: An array of structures describing the current capabilities containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul>
	496	</simpara></listitem></varlistentry>
	497	<varlistentry><term><parameter>error</parameter> :</term>
	498	<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
	499	</simpara></listitem></varlistentry>
	500	<varlistentry><term><parameter>user_data</parameter> :</term>
	501	<listitem><simpara> user-supplied data
	502	</simpara></listitem></varlistentry>
	503	<varlistentry><term><parameter>weak_object</parameter> :</term>
	504	<listitem><simpara> user-supplied object
	505	</simpara></listitem></varlistentry>
	506	</variablelist></refsect2>
	507	<refsect2 id="tp-cli-connection-interface-capabilities-callback-for-get-capabilities" role="function">
	508	<title>tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()</title>
	509	<indexterm zone="tp-cli-connection-interface-capabilities-callback-for-get-capabilities"><primary sortas="tp_cli_connection_interface_capabilities_callback_for_get_capabilities">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_capabilities_callback_for_get_capabilities)
	510	(<link linkend="TpConnection">TpConnection</link> *proxy,
	511	const <link linkend="GPtrArray">GPtrArray</link> *out_Contact_Capabilities,
	512	const <link linkend="GError">GError</link> *error,
	513	<link linkend="gpointer">gpointer</link> user_data,
	514	<link linkend="GObject">GObject</link> *weak_object);</programlisting>
	515	<para>
	516	Signature of the callback called when a GetCapabilities method call
	517	succeeds or fails.</para>
	518	<para>
	519	</para><variablelist role="params">
	520	<varlistentry><term><parameter>proxy</parameter> :</term>
	521	<listitem><simpara> the proxy on which the call was made
	522	</simpara></listitem></varlistentry>
	523	<varlistentry><term><parameter>out_Contact_Capabilities</parameter> :</term>
	524	<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of generic capability flags for the type</li> <li>a bitwise OR of type specific capability flags for the type</li> </ul>
	525	</simpara></listitem></varlistentry>
	526	<varlistentry><term><parameter>error</parameter> :</term>
	527	<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
	528	</simpara></listitem></varlistentry>
	529	<varlistentry><term><parameter>user_data</parameter> :</term>
	530	<listitem><simpara> user-supplied data
	531	</simpara></listitem></varlistentry>
	532	<varlistentry><term><parameter>weak_object</parameter> :</term>
	533	<listitem><simpara> user-supplied object
	534	</simpara></listitem></varlistentry>
	535	</variablelist></refsect2>
	536	<refsect2 id="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed" role="function">
	537	<title>tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()</title>
	538	<indexterm zone="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed"><primary sortas="tp_cli_connection_interface_capabilities_connect_to_capabilities_changed">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_connection_interface_capabilities_connect_to_capabilities_changed
	539	(<link linkend="TpConnection">TpConnection</link> *proxy,
	540	<link linkend="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</link> callback,
	541	<link linkend="gpointer">gpointer</link> user_data,
	542	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
	543	<link linkend="GObject">GObject</link> *weak_object,
	544	<link linkend="GError">GError</link> **error);</programlisting>
	545	<para>
	546	Connect a handler to the signal CapabilitiesChanged.
	547	</para>
	548	<para>
	549	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handle.</p> <p>If the handle is zero, the capabilities refer to the connection itself, in some poorly defined way. This usage is deprecated and clients should ignore it.</p></para>
	550	<para>
	551	</para><variablelist role="params">
	552	<varlistentry><term><parameter>proxy</parameter> :</term>
	553	<listitem><simpara> A <link linkend="TpConnection"><type>TpConnection</type></link> or subclass
	554	</simpara></listitem></varlistentry>
	555	<varlistentry><term><parameter>callback</parameter> :</term>
	556	<listitem><simpara> Callback to be called when the signal is
	557	received
	558	</simpara></listitem></varlistentry>
	559	<varlistentry><term><parameter>user_data</parameter> :</term>
	560	<listitem><simpara> User-supplied data for the callback
	561	</simpara></listitem></varlistentry>
	562	<varlistentry><term><parameter>destroy</parameter> :</term>
	563	<listitem><simpara> Destructor for the user-supplied data, which
	564	will be called when this signal is disconnected, or
	565	before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
	566	</simpara></listitem></varlistentry>
	567	<varlistentry><term><parameter>weak_object</parameter> :</term>
	568	<listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
	569	if it is destroyed, this callback will automatically be
	570	disconnected
	571	</simpara></listitem></varlistentry>
	572	<varlistentry><term><parameter>error</parameter> :</term>
	573	<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
	574	returned
	575	</simpara></listitem></varlistentry>
	576	<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
	577	above, which can be used to disconnect the signal; or
	578	<link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
	579	or has become invalid.
	580	</simpara></listitem></varlistentry>
	581	</variablelist></refsect2>
416	582	<refsect2 id="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed" role="function">
417	583	<title>tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()</title>
418	584	<indexterm zone="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed"><primary sortas="tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed)

+14

-14

docs/reference/xml/connection.xml less more

331	331	(<link linkend="TpConnection">TpConnection</link> *proxy,
332	332	<link linkend="gint">gint</link> timeout_ms,
333	333	<link linkend="guint">guint</link> in_Handle_Type,
334		const <link linkend="gchar">gchar</link> **in_Names,
	334	const <link linkend="gchar">gchar</link> **in_Identifiers,
335	335	<link linkend="tp-cli-connection-callback-for-request-handles">tp_cli_connection_callback_for_request_handles</link> callback,
336	336	<link linkend="gpointer">gpointer</link> user_data,
337	337	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,

340	340	(<link linkend="TpConnection">TpConnection</link> *proxy,
341	341	<link linkend="gint">gint</link> timeout_ms,
342	342	<link linkend="guint">guint</link> in_Handle_Type,
343		const <link linkend="gchar">gchar</link> **in_Names,
	343	const <link linkend="gchar">gchar</link> **in_Identifiers,
344	344	<link linkend="GArray">GArray</link> **out_Handles,
345	345	<link linkend="GError">GError</link> **error,
346	346	<link linkend="GMainLoop">GMainLoop</link> **loop);

1985	1985	<listitem><simpara> the proxy on which the call was made
1986	1986	</simpara></listitem></varlistentry>
1987	1987	<varlistentry><term><parameter>out_Identifiers</parameter> :</term>
1988		<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: An array of handle names in the same order as the given numbers
	1988	<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: An array of identifiers corresponding to the given handles, in the same order.
1989	1989	</simpara></listitem></varlistentry>
1990	1990	<varlistentry><term><parameter>error</parameter> :</term>
1991	1991	<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure

2088	2088	<listitem><simpara> Used to pass an 'in' argument: An array of integer handles of this type
2089	2089	</simpara></listitem></varlistentry>
2090	2090	<varlistentry><term><parameter>out_Identifiers</parameter> :</term>
2091		<listitem><simpara> Used to return an 'out' argument if <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> is returned: An array of handle names in the same order as the given numbers
	2091	<listitem><simpara> Used to return an 'out' argument if <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> is returned: An array of identifiers corresponding to the given handles, in the same order.
2092	2092	</simpara></listitem></varlistentry>
2093	2093	<varlistentry><term><parameter>error</parameter> :</term>
2094	2094	<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to return errors if <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>

2520	2520	<listitem><simpara> the proxy on which the call was made
2521	2521	</simpara></listitem></varlistentry>
2522	2522	<varlistentry><term><parameter>out_Handles</parameter> :</term>
2523		<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: An array of integer handle numbers in the same order as the given strings
	2523	<listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: An array of integer handle numbers in the same order as the given identifiers.
2524	2524	</simpara></listitem></varlistentry>
2525	2525	<varlistentry><term><parameter>error</parameter> :</term>
2526	2526	<listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure

2538	2538	(<link linkend="TpConnection">TpConnection</link> *proxy,
2539	2539	<link linkend="gint">gint</link> timeout_ms,
2540	2540	<link linkend="guint">guint</link> in_Handle_Type,
2541		const <link linkend="gchar">gchar</link> **in_Names,
	2541	const <link linkend="gchar">gchar</link> **in_Identifiers,
2542	2542	<link linkend="tp-cli-connection-callback-for-request-handles">tp_cli_connection_callback_for_request_handles</link> callback,
2543	2543	<link linkend="gpointer">gpointer</link> user_data,
2544	2544	<link linkend="GDestroyNotify">GDestroyNotify</link> destroy,

2547	2547	Start a RequestHandles method call.
2548	2548	</para>
2549	2549	<para>
2550		Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</para>
	2550	Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the identifier refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</para>
2551	2551	<para>
2552	2552	</para><variablelist role="params">
2553	2553	<varlistentry><term><parameter>proxy</parameter> :</term>

2560	2560	<varlistentry><term><parameter>in_Handle_Type</parameter> :</term>
2561	2561	<listitem><simpara> Used to pass an 'in' argument: The type of handle required
2562	2562	</simpara></listitem></varlistentry>
2563		<varlistentry><term><parameter>in_Names</parameter> :</term>
2564		<listitem><simpara> Used to pass an 'in' argument: An array of names of entities to request handles for
	2563	<varlistentry><term><parameter>in_Identifiers</parameter> :</term>
	2564	<listitem><simpara> Used to pass an 'in' argument: An array of identifiers of entities to request handles for
2565	2565	</simpara></listitem></varlistentry>
2566	2566	<varlistentry><term><parameter>callback</parameter> :</term>
2567	2567	<listitem><simpara> called when the method call succeeds or fails;

2595	2595	(<link linkend="TpConnection">TpConnection</link> *proxy,
2596	2596	<link linkend="gint">gint</link> timeout_ms,
2597	2597	<link linkend="guint">guint</link> in_Handle_Type,
2598		const <link linkend="gchar">gchar</link> **in_Names,
	2598	const <link linkend="gchar">gchar</link> **in_Identifiers,
2599	2599	<link linkend="GArray">GArray</link> **out_Handles,
2600	2600	<link linkend="GError">GError</link> **error,
2601	2601	<link linkend="GMainLoop">GMainLoop</link> **loop);</programlisting>

2607	2607	state.
2608	2608	</para>
2609	2609	<para>
2610		Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</para>
	2610	Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the identifier refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</para>
2611	2611	<para>
2612	2612	</para><variablelist role="params">
2613	2613	<varlistentry><term><parameter>proxy</parameter> :</term>

2619	2619	<varlistentry><term><parameter>in_Handle_Type</parameter> :</term>
2620	2620	<listitem><simpara> Used to pass an 'in' argument: The type of handle required
2621	2621	</simpara></listitem></varlistentry>
2622		<varlistentry><term><parameter>in_Names</parameter> :</term>
2623		<listitem><simpara> Used to pass an 'in' argument: An array of names of entities to request handles for
	2622	<varlistentry><term><parameter>in_Identifiers</parameter> :</term>
	2623	<listitem><simpara> Used to pass an 'in' argument: An array of identifiers of entities to request handles for
2624	2624	</simpara></listitem></varlistentry>
2625	2625	<varlistentry><term><parameter>out_Handles</parameter> :</term>
2626		<listitem><simpara> Used to return an 'out' argument if <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> is returned: An array of integer handle numbers in the same order as the given strings
	2626	<listitem><simpara> Used to return an 'out' argument if <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> is returned: An array of integer handle numbers in the same order as the given identifiers.
2627	2627	</simpara></listitem></varlistentry>
2628	2628	<varlistentry><term><parameter>error</parameter> :</term>
2629	2629	<listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to return errors if <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>

-3

docs/reference/xml/debug-sender.xml less more

153	153	<link linkend="TpDebugSender"><type>TpDebugSender</type></link>.
154	154	</para>
155	155	<para>
156		The <parameter>exclude</parameter> parameter is designed to allow filtering of domains, instead of
157		sending every message to the <link linkend="TpDebugSender"><type>TpDebugSender</type></link>. Note that every message,
158		regardless of domain, is given to <link linkend="g-log-default-handler"><function>g_log_default_handler()</function></link>.
	156	The <parameter>exclude</parameter> parameter is designed to allow filtering one domain, instead of
	157	sending every message to the <link linkend="TpDebugSender--"><type>""</type></link> typical usage is for a
	158	process to filter out messages from its own <link linkend="G-LOG-DOMAIN--CAPS"><literal>G_LOG_DOMAIN</literal></link>, so that it can
	159	append a category to its own messages and pass them directly to
	160	tp_debug_sender_add_message. Note that every message, regardless of
	161	domain, is given to <link linkend="g-log-default-handler"><function>g_log_default_handler()</function></link>.
159	162	</para>
160	163	<para>
161	164	Note that a ref to a <link linkend="TpDebugSender"><type>TpDebugSender</type></link> must be kept at all times otherwise

-2

docs/reference/xml/enums.xml less more

712	712	} TpChannelMediaCapabilities;
713	713	</programlisting>
714	714	<para>
715		<![CDATA[ The channel-type-specific capability flags used for Channel.Type.StreamedMedia in the Connection.Interface.Capabilities interface. See the FUTURE.InitialAudio property for details of the mechanisms that will replace this. ]]>
	715	<![CDATA[ The channel-type-specific capability flags used for Channel.Type.StreamedMedia in the Connection.Interface.Capabilities interface. See the InitialAudio property for details of the mechanisms that will replace this. ]]>
716	716	</para>
717	717	<para>
718	718	Bitfield/set of flags generated from the Telepathy specification.</para>

745	745	</varlistentry>
746	746	<varlistentry id="TP-CHANNEL-MEDIA-CAPABILITY-IMMUTABLE-STREAMS--CAPS" role="constant">
747	747	<term><literal>TP_CHANNEL_MEDIA_CAPABILITY_IMMUTABLE_STREAMS</literal></term>
748		<listitem><simpara> <![CDATA[ Once streams have been requested for a channel to this handle (either by calling RequestStreams on a channel with no streams, or by specifying InitialAudio or InitialAudio = True in the channel request), then they cannot be changed; subsequent calls to RequestStreams or RemoveStreams will fail. For example, once an audio-only Google Talk call has started, it is not possible to add a video stream; both audio and video must be requested at the start of the call if video is desired. User interfaces may use this pseudo-capability as a hint to display separate "Audio call" and "Video call" buttons, rather than a single "Call" button with the option to add and remove video once the call has started for contacts without this flag. ]]>
	748	<listitem><simpara> <![CDATA[ Channels whose target handle is this contact will have ImmutableStreams = True. ]]>
749	749	</simpara></listitem>
750	750	</varlistentry>
751	751	</variablelist></refsect2>

1555	1555	TP_CHANNEL_CALL_STATE_QUEUED = 2,
1556	1556	TP_CHANNEL_CALL_STATE_HELD = 4,
1557	1557	TP_CHANNEL_CALL_STATE_FORWARDED = 8,
	1558	TP_CHANNEL_CALL_STATE_IN_PROGRESS = 16,
1558	1559	} TpChannelCallStateFlags;
1559	1560	</programlisting>
1560	1561	<para>

1582	1583	<varlistentry id="TP-CHANNEL-CALL-STATE-FORWARDED--CAPS" role="constant">
1583	1584	<term><literal>TP_CHANNEL_CALL_STATE_FORWARDED</literal></term>
1584	1585	<listitem><simpara> <![CDATA[ The initiator of the call originally called a contact other than the current recipient of the call, but the call was then forwarded or diverted. ]]>
	1586	</simpara></listitem>
	1587	</varlistentry>
	1588	<varlistentry id="TP-CHANNEL-CALL-STATE-IN-PROGRESS--CAPS" role="constant">
	1589	<term><literal>TP_CHANNEL_CALL_STATE_IN_PROGRESS</literal></term>
	1590	<listitem><simpara> <![CDATA[ Progress has been made in placing the outgoing call, but the destination contact may not have been made aware of the call yet (so the Ringing state is not appropriate). This corresponds to SIP's status code 183 Session Progress, and could be used when the outgoing call has reached a gateway, for instance. ]]>
1585	1591	</simpara></listitem>
1586	1592	</varlistentry>
1587	1593	</variablelist></refsect2>

-1

docs/reference/xml/errors.xml less more

560	560	The D-Bus error name org.freedesktop.Telepathy.Error.InvalidHandle
561	561	</para>
562	562	<para>
563		The contact name specified is unknown on this channel or connection.</para>
	563	The handle specified is unknown on this channel or connection.</para>
564	564	<para>
565	565	</para></refsect2>
566	566	<refsect2 id="TP-ERROR-STR-CHANNEL-BANNED--CAPS" role="macro">

+81

-0

docs/reference/xml/gtypes.xml less more

47	47
48	48	#define <link linkend="TP-HASH-TYPE-AVATAR-TOKEN-MAP--CAPS">TP_HASH_TYPE_AVATAR_TOKEN_MAP</link>
49	49
	50	#define <link linkend="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS">TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</link>
	51	#define <link linkend="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS">TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</link>
	52	#define <link linkend="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS">TP_STRUCT_TYPE_HANDLER_CAPABILITIES</link>
	53	#define <link linkend="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS">TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</link>
	54
50	55	#define <link linkend="TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS">TP_STRUCT_TYPE_CAPABILITY_CHANGE</link>
51	56	#define <link linkend="TP-ARRAY-TYPE-CAPABILITY-CHANGE-LIST--CAPS">TP_ARRAY_TYPE_CAPABILITY_CHANGE_LIST</link>
52	57	#define <link linkend="TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS">TP_STRUCT_TYPE_CAPABILITY_PAIR</link>

582	587	type <literal>Avatar_Token</literal>,
583	588	named <literal>Token</literal>):
584	589	(Undocumented)</para>
	590	<para>
	591	</para></refsect2>
	592	<refsect2 id="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS" role="macro">
	593	<title>TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</title>
	594	<indexterm zone="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS"><primary sortas="TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP">TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</primary></indexterm><programlisting>#define TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</programlisting>
	595	<para>
	596	A mapping from contact handle to their capabilities.
	597	</para>
	598	<para>
	599	This macro expands to a call to a function
	600	that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GHashTable"><type>GHashTable</type></link>
	601	appropriate for representing a D-Bus
	602	dictionary of signature
	603	<literal>a{ua(a{sv}as)}</literal>.
	604	</para>
	605	<para>
	606	Keys (D-Bus type <literal>u</literal>,
	607	type <literal>Contact_Handle</literal>,
	608	named <literal>Key</literal>):
	609	A contact handle.
	610	</para>
	611	<para>
	612	Values (D-Bus type <literal>a(a{sv}as)</literal>,
	613	type <literal>Requestable_Channel_Class[]</literal>,
	614	named <literal>Value</literal>):
	615	The contact capabilities.</para>
	616	<para>
	617	</para></refsect2>
	618	<refsect2 id="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS" role="macro">
	619	<title>TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</title>
	620	<indexterm zone="TP-ARRAY-TYPE-CONTACT-CAPABILITIES-MAP-LIST--CAPS"><primary sortas="TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST">TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</primary></indexterm><programlisting>#define TP_ARRAY_TYPE_CONTACT_CAPABILITIES_MAP_LIST</programlisting>
	621	<para>
	622	Expands to a call to a function
	623	that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GPtrArray"><type>GPtrArray</type></link>
	624	of <link linkend="TP-HASH-TYPE-CONTACT-CAPABILITIES-MAP--CAPS"><type>TP_HASH_TYPE_CONTACT_CAPABILITIES_MAP</type></link>.</para>
	625	<para>
	626	</para></refsect2>
	627	<refsect2 id="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS" role="macro">
	628	<title>TP_STRUCT_TYPE_HANDLER_CAPABILITIES</title>
	629	<indexterm zone="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS"><primary sortas="TP_STRUCT_TYPE_HANDLER_CAPABILITIES">TP_STRUCT_TYPE_HANDLER_CAPABILITIES</primary></indexterm><programlisting>#define TP_STRUCT_TYPE_HANDLER_CAPABILITIES</programlisting>
	630	<para>
	631	A structure representing the capabilities of a single client.
	632
	633	</para>
	634	<para>
	635	This macro expands to a call to a function
	636	that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GValueArray"><type>GValueArray</type></link>
	637	appropriate for representing a D-Bus struct
	638	with signature <literal>(saa{sv}as)</literal>.
	639	</para>
	640	<para>
	641	Member 0 (D-Bus type <literal>s</literal>,
	642	type <literal>DBus_Well_Known_Name</literal>,
	643	named <literal>Well_Known_Name</literal>):
	644	For implementations of the <tp:dbus-ref namespace="org.freedesktop.Telepathy">Client</tp:dbus-ref> interface, the well-known bus name name of the client; for any other process, any other reversed domain name that uniquely identifies it.
	645	</para>
	646	<para>
	647	Member 1 (D-Bus type <literal>aa{sv}</literal>,
	648	type <literal>String_Variant_Map[]</literal>,
	649	named <literal>Channel_Classes</literal>):
	650	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of channel classes that can be handled by this client. This will usually be a copy of the client's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler">HandlerChannelFilter</tp:dbus-ref> property.
	651	</para>
	652	<para>
	653	Member 2 (D-Bus type <literal>as</literal>,
	654	type <literal>Handler_Capability_Token[]</literal>,
	655	named <literal>Capabilities</literal>):
	656	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of client capabilities supported by this client, to be used by the connection manager to determine what capabilities to advertise. This will usually be a copy of the client's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler">Capabilities</tp:dbus-ref> property.</para>
	657	<para>
	658	</para></refsect2>
	659	<refsect2 id="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS" role="macro">
	660	<title>TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</title>
	661	<indexterm zone="TP-ARRAY-TYPE-HANDLER-CAPABILITIES-LIST--CAPS"><primary sortas="TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST">TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</primary></indexterm><programlisting>#define TP_ARRAY_TYPE_HANDLER_CAPABILITIES_LIST</programlisting>
	662	<para>
	663	Expands to a call to a function
	664	that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GPtrArray"><type>GPtrArray</type></link>
	665	of <link linkend="TP-STRUCT-TYPE-HANDLER-CAPABILITIES--CAPS"><type>TP_STRUCT_TYPE_HANDLER_CAPABILITIES</type></link>.</para>
585	666	<para>
586	667	</para></refsect2>
587	668	<refsect2 id="TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS" role="macro">

+16

-0

docs/reference/xml/interfaces.xml less more

45	45	#define <link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS</link>
46	46	#define <link linkend="TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES--CAPS">TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES</link>
47	47	#define <link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES</link>
	48	#define <link linkend="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS">TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</link>
	49	#define <link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</link>
48	50	#define <link linkend="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS">TP_IFACE_CONNECTION_INTERFACE_CONTACTS</link>
49	51	#define <link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACTS--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACTS</link>
50	52	#define <link linkend="TP-IFACE-CONNECTION-INTERFACE-REQUESTS--CAPS">TP_IFACE_CONNECTION_INTERFACE_REQUESTS</link>

327	329	Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Connection.Interface.Capabilities"</para>
328	330	<para>
329	331	</para></refsect2>
	332	<refsect2 id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS" role="macro">
	333	<title>TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</title>
	334	<indexterm zone="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"><primary sortas="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</primary></indexterm><programlisting>#define TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</programlisting>
	335	<para>
	336	The interface name "org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities"</para>
	337	<para>
	338	</para></refsect2>
	339	<refsect2 id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS" role="macro">
	340	<title>TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</title>
	341	<indexterm zone="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES--CAPS"><primary sortas="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</programlisting>
	342	<para>
	343	Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities"</para>
	344	<para>
	345	</para></refsect2>
330	346	<refsect2 id="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS" role="macro">
331	347	<title>TP_IFACE_CONNECTION_INTERFACE_CONTACTS</title>
332	348	<indexterm zone="TP-IFACE-CONNECTION-INTERFACE-CONTACTS--CAPS"><primary sortas="TP_IFACE_CONNECTION_INTERFACE_CONTACTS">TP_IFACE_CONNECTION_INTERFACE_CONTACTS</primary></indexterm><programlisting>#define TP_IFACE_CONNECTION_INTERFACE_CONTACTS</programlisting>

+188

-3

docs/reference/xml/svc-connection.xml less more

127	127	<link linkend="void">void</link> (<link linkend="tp-svc-connection-request-handles-impl">*tp_svc_connection_request_handles_impl</link>)
128	128	(<link linkend="TpSvcConnection">TpSvcConnection</link> *self,
129	129	<link linkend="guint">guint</link> in_Handle_Type,
130		const <link linkend="gchar">gchar</link> **in_Names,
	130	const <link linkend="gchar">gchar</link> **in_Identifiers,
131	131	<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
132	132	<link linkend="void">void</link> <link linkend="tp-svc-connection-implement-request-handles">tp_svc_connection_implement_request_handles</link>
133	133	(<link linkend="TpSvcConnectionClass">TpSvcConnectionClass</link> *klass,

468	468	<link linkend="void">void</link> <link linkend="tp-svc-connection-interface-capabilities-emit-capabilities-changed">tp_svc_connection_interface_capabilities_emit_capabilities_changed</link>
469	469	(<link linkend="gpointer">gpointer</link> instance,
470	470	const <link linkend="GPtrArray">GPtrArray</link> *arg_Caps);
	471
	472
	473	<link linkend="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</link>;
	474	<link linkend="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</link>;
	475	<link linkend="void">void</link> <link linkend="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed">tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed</link>
	476	(<link linkend="gpointer">gpointer</link> instance,
	477	<link linkend="GHashTable">GHashTable</link> *arg_caps);
	478	<link linkend="void">void</link> (<link linkend="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl">*tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</link>)
	479	(<link linkend="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</link> *self,
	480	const <link linkend="GArray">GArray</link> *in_handles,
	481	<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
	482	<link linkend="void">void</link> <link linkend="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities">tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities</link>
	483	(<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
	484	<link linkend="GHashTable">GHashTable</link> *out_Contact_Capabilities);
	485	<link linkend="void">void</link> <link linkend="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities">tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities</link>
	486	(<link linkend="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</link> *klass,
	487	<link linkend="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl">tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</link> impl);
	488	<link linkend="void">void</link> (<link linkend="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl">*tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</link>)
	489	(<link linkend="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</link> *self,
	490	const <link linkend="GPtrArray">GPtrArray</link> *in_Handler_Capabilities,
	491	<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
	492	<link linkend="void">void</link> <link linkend="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities">tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities</link>
	493	(<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
	494	<link linkend="void">void</link> <link linkend="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities">tp_svc_connection_interface_contact_capabilities_implement_update_capabilities</link>
	495	(<link linkend="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</link> *klass,
	496	<link linkend="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl">tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</link> impl);
471	497
472	498
473	499	<link linkend="TpSvcConnectionInterfaceLocation">TpSvcConnectionInterfaceLocation</link>;

1233	1259	<indexterm zone="tp-svc-connection-request-handles-impl"><primary sortas="tp_svc_connection_request_handles_impl">tp_svc_connection_request_handles_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_connection_request_handles_impl)
1234	1260	(<link linkend="TpSvcConnection">TpSvcConnection</link> *self,
1235	1261	<link linkend="guint">guint</link> in_Handle_Type,
1236		const <link linkend="gchar">gchar</link> **in_Names,
	1262	const <link linkend="gchar">gchar</link> **in_Identifiers,
1237	1263	<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
1238	1264	<para>
1239	1265	The signature of an implementation of the D-Bus method

1246	1272	<varlistentry><term><parameter>in_Handle_Type</parameter> :</term>
1247	1273	<listitem><simpara> guint (FIXME, generate documentation)
1248	1274	</simpara></listitem></varlistentry>
1249		<varlistentry><term><parameter>in_Names</parameter> :</term>
	1275	<varlistentry><term><parameter>in_Identifiers</parameter> :</term>
1250	1276	<listitem><simpara> const gchar ** (FIXME, generate documentation)
1251	1277	</simpara></listitem></varlistentry>
1252	1278	<varlistentry><term><parameter>context</parameter> :</term>

3237	3263	<listitem><simpara> const GPtrArray * (FIXME, generate documentation)
3238	3264	</simpara></listitem></varlistentry>
3239	3265	</variablelist></refsect2>
	3266	<refsect2 id="TpSvcConnectionInterfaceContactCapabilities" role="struct">
	3267	<title>TpSvcConnectionInterfaceContactCapabilities</title>
	3268	<indexterm zone="TpSvcConnectionInterfaceContactCapabilities"><primary sortas="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</primary></indexterm><programlisting>typedef struct _TpSvcConnectionInterfaceContactCapabilities TpSvcConnectionInterfaceContactCapabilities;</programlisting>
	3269	<para>
	3270	Dummy typedef representing any implementation of this interface.</para>
	3271	<para>
	3272	</para></refsect2>
	3273	<refsect2 id="TpSvcConnectionInterfaceContactCapabilitiesClass" role="struct">
	3274	<title>TpSvcConnectionInterfaceContactCapabilitiesClass</title>
	3275	<indexterm zone="TpSvcConnectionInterfaceContactCapabilitiesClass"><primary sortas="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</primary></indexterm><programlisting>typedef struct _TpSvcConnectionInterfaceContactCapabilitiesClass TpSvcConnectionInterfaceContactCapabilitiesClass;</programlisting>
	3276	<para>
	3277	The class of TpSvcConnectionInterfaceContactCapabilities.
	3278	</para>
	3279	<para>
	3280	In a full implementation of this interface (i.e. all
	3281	methods implemented), the interface initialization
	3282	function used in <link linkend="G-IMPLEMENT-INTERFACE--CAPS"><function>G_IMPLEMENT_INTERFACE()</function></link> would
	3283	typically look like this:
	3284	</para>
	3285	<para>
	3286	<programlisting>
	3287	static void
	3288	implement_connection_interface_contact_capabilities (gpointer klass,
	3289	gpointer unused G_GNUC_UNUSED)
	3290	{
	3291	#define IMPLEMENT(x) tp_svc_connection_interface_contact_capabilities_implement_##<link linkend="x">x</link> (\
	3292	klass, my_object_##<link linkend="x">x</link>)
	3293	IMPLEMENT (update_capabilities);
	3294	IMPLEMENT (get_contact_capabilities);
	3295	#undef IMPLEMENT
	3296	}
	3297	</programlisting></para>
	3298	<para>
	3299	</para></refsect2>
	3300	<refsect2 id="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed" role="function">
	3301	<title>tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed ()</title>
	3302	<indexterm zone="tp-svc-connection-interface-contact-capabilities-emit-contact-capabilities-changed"><primary sortas="tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed">tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed
	3303	(<link linkend="gpointer">gpointer</link> instance,
	3304	<link linkend="GHashTable">GHashTable</link> *arg_caps);</programlisting>
	3305	<para>
	3306	Type-safe wrapper around g_signal_emit to emit the
	3307	ContactCapabilitiesChanged signal on interface org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.</para>
	3308	<para>
	3309	</para><variablelist role="params">
	3310	<varlistentry><term><parameter>instance</parameter> :</term>
	3311	<listitem><simpara> The object implementing this interface
	3312	</simpara></listitem></varlistentry>
	3313	<varlistentry><term><parameter>arg_caps</parameter> :</term>
	3314	<listitem><simpara> GHashTable * (FIXME, generate documentation)
	3315	</simpara></listitem></varlistentry>
	3316	</variablelist></refsect2>
	3317	<refsect2 id="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl" role="function">
	3318	<title>tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl ()</title>
	3319	<indexterm zone="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl"><primary sortas="tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl">tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl)
	3320	(<link linkend="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</link> *self,
	3321	const <link linkend="GArray">GArray</link> *in_handles,
	3322	<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
	3323	<para>
	3324	The signature of an implementation of the D-Bus method
	3325	GetContactCapabilities on interface org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.</para>
	3326	<para>
	3327	</para><variablelist role="params">
	3328	<varlistentry><term><parameter>self</parameter> :</term>
	3329	<listitem><simpara> The object implementing this interface
	3330	</simpara></listitem></varlistentry>
	3331	<varlistentry><term><parameter>in_handles</parameter> :</term>
	3332	<listitem><simpara> const GArray * (FIXME, generate documentation)
	3333	</simpara></listitem></varlistentry>
	3334	<varlistentry><term><parameter>context</parameter> :</term>
	3335	<listitem><simpara> Used to return values or throw an error
	3336	</simpara></listitem></varlistentry>
	3337	</variablelist></refsect2>
	3338	<refsect2 id="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities" role="function">
	3339	<title>tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities ()</title>
	3340	<indexterm zone="tp-svc-connection-interface-contact-capabilities-return-from-get-contact-capabilities"><primary sortas="tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities">tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_connection_interface_contact_capabilities_return_from_get_contact_capabilities
	3341	(<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
	3342	<link linkend="GHashTable">GHashTable</link> *out_Contact_Capabilities);</programlisting>
	3343	<para>
	3344	Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
	3345	This inline function exists only to provide type-safety.</para>
	3346	<para>
	3347	</para><variablelist role="params">
	3348	<varlistentry><term><parameter>context</parameter> :</term>
	3349	<listitem><simpara> The D-Bus method invocation context
	3350	</simpara></listitem></varlistentry>
	3351	<varlistentry><term><parameter>out_Contact_Capabilities</parameter> :</term>
	3352	<listitem><simpara> GHashTable * (FIXME, generate documentation)
	3353	</simpara></listitem></varlistentry>
	3354	</variablelist></refsect2>
	3355	<refsect2 id="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities" role="function">
	3356	<title>tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities ()</title>
	3357	<indexterm zone="tp-svc-connection-interface-contact-capabilities-implement-get-contact-capabilities"><primary sortas="tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities">tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities
	3358	(<link linkend="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</link> *klass,
	3359	<link linkend="tp-svc-connection-interface-contact-capabilities-get-contact-capabilities-impl">tp_svc_connection_interface_contact_capabilities_get_contact_capabilities_impl</link> impl);</programlisting>
	3360	<para>
	3361	Register an implementation for the GetContactCapabilities method in the vtable
	3362	of an implementation of this interface. To be called from
	3363	the interface init function.</para>
	3364	<para>
	3365	</para><variablelist role="params">
	3366	<varlistentry><term><parameter>klass</parameter> :</term>
	3367	<listitem><simpara> A class whose instances implement this interface
	3368	</simpara></listitem></varlistentry>
	3369	<varlistentry><term><parameter>impl</parameter> :</term>
	3370	<listitem><simpara> A callback used to implement the GetContactCapabilities D-Bus method
	3371	</simpara></listitem></varlistentry>
	3372	</variablelist></refsect2>
	3373	<refsect2 id="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl" role="function">
	3374	<title>tp_svc_connection_interface_contact_capabilities_update_capabilities_impl ()</title>
	3375	<indexterm zone="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl"><primary sortas="tp_svc_connection_interface_contact_capabilities_update_capabilities_impl">tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_connection_interface_contact_capabilities_update_capabilities_impl)
	3376	(<link linkend="TpSvcConnectionInterfaceContactCapabilities">TpSvcConnectionInterfaceContactCapabilities</link> *self,
	3377	const <link linkend="GPtrArray">GPtrArray</link> *in_Handler_Capabilities,
	3378	<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
	3379	<para>
	3380	The signature of an implementation of the D-Bus method
	3381	UpdateCapabilities on interface org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.</para>
	3382	<para>
	3383	</para><variablelist role="params">
	3384	<varlistentry><term><parameter>self</parameter> :</term>
	3385	<listitem><simpara> The object implementing this interface
	3386	</simpara></listitem></varlistentry>
	3387	<varlistentry><term><parameter>in_Handler_Capabilities</parameter> :</term>
	3388	<listitem><simpara> const GPtrArray * (FIXME, generate documentation)
	3389	</simpara></listitem></varlistentry>
	3390	<varlistentry><term><parameter>context</parameter> :</term>
	3391	<listitem><simpara> Used to return values or throw an error
	3392	</simpara></listitem></varlistentry>
	3393	</variablelist></refsect2>
	3394	<refsect2 id="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities" role="function">
	3395	<title>tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities ()</title>
	3396	<indexterm zone="tp-svc-connection-interface-contact-capabilities-return-from-update-capabilities"><primary sortas="tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities">tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_connection_interface_contact_capabilities_return_from_update_capabilities
	3397	(<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
	3398	<para>
	3399	Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
	3400	This inline function exists only to provide type-safety.</para>
	3401	<para>
	3402	</para><variablelist role="params">
	3403	<varlistentry><term><parameter>context</parameter> :</term>
	3404	<listitem><simpara> The D-Bus method invocation context
	3405	</simpara></listitem></varlistentry>
	3406	</variablelist></refsect2>
	3407	<refsect2 id="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities" role="function">
	3408	<title>tp_svc_connection_interface_contact_capabilities_implement_update_capabilities ()</title>
	3409	<indexterm zone="tp-svc-connection-interface-contact-capabilities-implement-update-capabilities"><primary sortas="tp_svc_connection_interface_contact_capabilities_implement_update_capabilities">tp_svc_connection_interface_contact_capabilities_implement_update_capabilities</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_connection_interface_contact_capabilities_implement_update_capabilities
	3410	(<link linkend="TpSvcConnectionInterfaceContactCapabilitiesClass">TpSvcConnectionInterfaceContactCapabilitiesClass</link> *klass,
	3411	<link linkend="tp-svc-connection-interface-contact-capabilities-update-capabilities-impl">tp_svc_connection_interface_contact_capabilities_update_capabilities_impl</link> impl);</programlisting>
	3412	<para>
	3413	Register an implementation for the UpdateCapabilities method in the vtable
	3414	of an implementation of this interface. To be called from
	3415	the interface init function.</para>
	3416	<para>
	3417	</para><variablelist role="params">
	3418	<varlistentry><term><parameter>klass</parameter> :</term>
	3419	<listitem><simpara> A class whose instances implement this interface
	3420	</simpara></listitem></varlistentry>
	3421	<varlistentry><term><parameter>impl</parameter> :</term>
	3422	<listitem><simpara> A callback used to implement the UpdateCapabilities D-Bus method
	3423	</simpara></listitem></varlistentry>
	3424	</variablelist></refsect2>
3240	3425	<refsect2 id="TpSvcConnectionInterfaceLocation" role="struct">
3241	3426	<title>TpSvcConnectionInterfaceLocation</title>
3242	3427	<indexterm zone="TpSvcConnectionInterfaceLocation"><primary sortas="TpSvcConnectionInterfaceLocation">TpSvcConnectionInterfaceLocation</primary></indexterm><programlisting>typedef struct _TpSvcConnectionInterfaceLocation TpSvcConnectionInterfaceLocation;</programlisting>

-4

spec/Channel.xml less more

361	361	handle).</p>
362	362
363	363	<tp:rationale>
364		<p>The careful wording about the self-handle is because the Renaming
365		interface can cause the return from Connection.GetSelfHandle to
366		change. It's something of a specification bug that we don't signal
367		this in the Connection interface yet.</p>
	364	<p>On some protocols, the SelfHandle may change (as signalled by
	365	<tp:dbus-ref
	366	namespace="org.freedesktop.Telepathy">Connection.SelfHandleChanged</tp:dbus-ref>),
	367	but this property is immutable. Hence, locally-requested channels'
	368	InitiatorHandle and InitiatorID may not match the current
	369	SelfHandle; <tp:member-ref>Requested</tp:member-ref> can be used to
	370	determine whether the channel was created locally.</p>
368	371	</tp:rationale>
369	372
370	373	<p>For channels requested by a remote user, this MUST be their handle.

+10

-0

spec/Channel_Interface_Call_State.xml less more

115	115	diverted.
116	116	</tp:docstring>
117	117	</tp:flag>
	118
	119	<tp:flag suffix="In_Progress" value="16">
	120	<tp:docstring>
	121	Progress has been made in placing the outgoing call, but the
	122	destination contact may not have been made aware of the call yet
	123	(so the Ringing state is not appropriate). This corresponds to SIP's
	124	status code 183 Session Progress, and could be used when the
	125	outgoing call has reached a gateway, for instance.
	126	</tp:docstring>
	127	</tp:flag>
118	128	</tp:flags>
119	129
120	130	</interface>

-1

spec/Channel_Interface_Tube.xml less more

43	43	<tp:dbus-ref namespace="org.freedesktop.Telepathy">Channel.Type.StreamTube</tp:dbus-ref>)
44	44	even if no client has indicated via
45	45	<tp:dbus-ref
46		namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT2">UpdateCapabilities</tp:dbus-ref>
	46	namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities">UpdateCapabilities</tp:dbus-ref>
47	47	that such a tube is supported. They SHOULD also allow clients to offer tubes with any
48	48	<tp:dbus-ref
49	49	namespace="org.freedesktop.Telepathy.Channel.Type.StreamTube">Service</tp:dbus-ref> or

-1

spec/Channel_Type_File_Transfer.xml less more

79	79	<p>Connection managers SHOULD NOT advertise support for file transfer to
80	80	other contacts unless it has been indicated by a call to
81	81	<tp:dbus-ref
82		namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT2">UpdateCapabilities</tp:dbus-ref>.
	82	namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities">UpdateCapabilities</tp:dbus-ref>.
83	83	</p>
84	84	<tp:rationale>
85	85	<p>People would send us files, and it would always fail. That would be silly.</p>

-1

spec/Channel_Type_Room_List.xml less more

73	73
74	74	<dl>
75	75	<dt>handle-name (s)</dt>
76		<dd>The string name of the room handle (as would be returned by
	76	<dd>The identifier of the room (as would be returned by
77	77	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>)</dd>
78	78
79	79	<dt>name (s)</dt>

+153

-21

spec/Channel_Type_Streamed_Media.xml less more

440	440	</tp:docstring>
441	441	</signal>
442	442
	443	<property name="InitialAudio" tp:name-for-bindings="Initial_Audio"
	444	type="b" access="read">
	445	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	446	<p>If set to true in a channel request that will create a new channel,
	447	the connection manager should immediately attempt to establish an
	448	audio stream to the remote contact, making it unnecessary for the
	449	client to call <tp:dbus-ref
	450	namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">RequestStreams</tp:dbus-ref>.</p>
	451
	452	<p>If this property, or InitialVideo, is passed to EnsureChannel
	453	(as opposed to CreateChannel), the connection manager SHOULD ignore
	454	these properties when checking whether it can return an existing
	455	channel as suitable; these properties only become significant when
	456	the connection manager has decided to create a new channel.</p>
	457
	458	<p>If true on a requested channel, this indicates that the audio
	459	stream has already been requested and the client does not need to
	460	call RequestStreams, although it MAY still do so.</p>
	461
	462	<p>If true on an unrequested (incoming) channel, this indicates that
	463	the remote contact initially requested an audio stream; this does
	464	not imply that that audio stream is still active (as indicated by
	465	<tp:dbus-ref
	466	namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">ListStreams</tp:dbus-ref>).</p>
	467
	468	<p>This property is immutable (cannot change), and therefore SHOULD
	469	appear wherever immutable properties are reported, e.g. <tp:dbus-ref
	470	namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">NewChannels</tp:dbus-ref>
	471	signals.</p>
	472
	473	<tp:rationale><p>This reduces D-Bus round trips.</p></tp:rationale>
	474
	475	<p>Connection managers capable of signalling audio calls to contacts
	476	SHOULD include a channel class in <tp:dbus-ref
	477	namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">RequestableChannelClasses</tp:dbus-ref>
	478	with <tp:dbus-ref
	479	namespace="org.freedesktop.Telepathy.Channel">ChannelType</tp:dbus-ref>
	480	= <tp:dbus-ref
	481	namespace="org.freedesktop.Telepathy.Channel.Type">StreamedMedia</tp:dbus-ref>
	482	and <tp:dbus-ref
	483	namespace="org.freedesktop.Telepathy.Channel">TargetHandleType</tp:dbus-ref>
	484	= Contact in the fixed properties dictionary, and InitialAudio
	485	(and also InitialVideo, if applicable) in the allowed properties
	486	list. Clients wishing to discover whether a connection manager
	487	can signal audio and/or video calls SHOULD use this information.</p>
	488
	489	<tp:rationale>
	490	<p>Not all protocols support signalling video calls, and it would be
	491	possible (although unlikely) to have a protocol where only video,
	492	and not audio, could be signalled.</p>
	493	</tp:rationale>
	494
	495	<p>Connection managers that support the <tp:dbus-ref
	496	namespace="org.freedesktop.Telepathy.Connection.Interface">ContactCapabilities</tp:dbus-ref>
	497	interface SHOULD represent the capabilities of receiving audio
	498	and/or video calls by including a channel class in
	499	a contact's capabilities with ChannelType = StreamedMedia
	500	in the fixed properties dictionary, and InitialAudio and/or
	501	InitialVideo in the allowed properties list. Clients wishing to
	502	discover whether a particular contact is likely to be able to
	503	receive audio and/or video calls SHOULD use this information.</p>
	504
	505	<tp:rationale>
	506	<p>Not all clients support video calls, and it would also be
	507	possible (although unlikely) to have a client which could only
	508	stream video, not audio.</p>
	509	</tp:rationale>
	510
	511	<p>Clients that are willing to receive audio and/or video calls
	512	SHOULD include the following among their channel classes if
	513	calling <tp:dbus-ref
	514	namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities">UpdateCapabilities</tp:dbus-ref>
	515	(clients of a <tp:dbus-ref
	516	namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>
	517	SHOULD instead arrange for the ChannelDispatcher to do this,
	518	by including the filters in their <tp:dbus-ref
	519	namespace="org.freedesktop.Telepathy.Client.Handler">HandlerChannelFilter</tp:dbus-ref>
	520	properties):</p>
	521
	522	<ul>
	523	<li>{ ChannelType = StreamedMedia }</li>
	524	<li>{ ChannelType = StreamedMedia, InitialAudio = true }
	525	if receiving calls with audio is supported</li>
	526	<li>{ ChannelType = StreamedMedia, InitialVideo = true }
	527	if receiving calls with video is supported</li>
	528	</ul>
	529
	530	<tp:rationale>
	531	<p>Connection managers for protocols with capability discovery,
	532	like XMPP, need this information to advertise the appropriate
	533	capabilities for their protocol.</p>
	534	</tp:rationale>
	535	</tp:docstring>
	536	</property>
	537
	538	<property name="InitialVideo" tp:name-for-bindings="Initial_Video"
	539	type="b" access="read">
	540	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	541	<p>The same as <tp:member-ref>InitialAudio</tp:member-ref>, but for
	542	a video stream. This property is immutable (cannot change).</p>
	543
	544	<p>In particular, note that if this property is false, this does not
	545	imply that an active video stream has not been added, only that no
	546	video stream was active at the time the channel appeared.</p>
	547
	548	<p>This property is the correct way to discover whether connection
	549	managers, contacts etc. support video calls; it appears in
	550	capabilities structures in the same way as InitialAudio.</p>
	551	</tp:docstring>
	552	</property>
	553
	554	<property name="ImmutableStreams" tp:name-for-bindings="Immutable_Streams"
	555	type="b" access="read">
	556	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	557	<p>If <tt>True</tt>, once streams have been requested for this channel
	558	(either by setting <tp:member-ref>InitialAudio</tp:member-ref> or
	559	<tp:member-ref>InitialVideo</tp:member-ref> when the channel is
	560	requested, or by calling
	561	<tp:member-ref>RequestStreams</tp:member-ref> on a channel with no
	562	streams), a stream of a different content type cannot be added;
	563	subsequent calls to <tp:member-ref>RequestStreams</tp:member-ref>
	564	that attempt to do so will fail.</p>
	565
	566	<p>If this property is missing, clients SHOULD assume that it is false,
	567	and thus that the channel's streams can be changed once the call has
	568	started.</p>
	569
	570	<p>If this property is present in the "allowed" set in all of the
	571	StreamedMedia entries in a contact's capabilities, then user
	572	interfaces MAY choose to show a separate "call" option for each
	573	class of call.</p>
	574
	575	<tp:rationale>
	576	<p>For example, once an audio-only Google Talk call has started,
	577	it is not possible to add a video stream; both audio and video
	578	must be requested at the start of the call if video is desired.
	579	User interfaces may use this pseudo-capability as a hint to
	580	display separate "Audio call" and "Video call" buttons, rather
	581	than a single "Call" button with the option to add and remove
	582	video once the call has started for contacts without this flag.
	583	</p>
	584	</tp:rationale>
	585
	586	<p>This property is immutable, and therefore SHOULD be announced
	587	in <tp:dbus-ref
	588	namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">NewChannels</tp:dbus-ref>,
	589	etc.</p>
	590	</tp:docstring>
	591	</property>
	592
443	593	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
444	594	<p>A channel that can send and receive streamed media such as audio or video.
445	595	Provides a number of methods for listing and requesting new streams, and

516	666	The channel-type-specific capability flags used for
517	667	Channel.Type.StreamedMedia in the <tp:dbus-ref
518	668	namespace="org.freedesktop.Telepathy">Connection.Interface.Capabilities</tp:dbus-ref>
519		interface. See the <tp:dbus-ref
520		namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">FUTURE.InitialAudio</tp:dbus-ref>
	669	interface. See the <tp:member-ref>InitialAudio</tp:member-ref>
521	670	property for details of the mechanisms that will replace this.
522	671	</tp:docstring>
523	672	<tp:flag suffix="Audio" value="1">

551	700
552	701	<tp:flag suffix="Immutable_Streams" value="32">
553	702	<tp:docstring>
554		Once streams have been requested for a channel to this handle (either
555		by calling <tp:member-ref>RequestStreams</tp:member-ref> on a channel
556		with no streams, or by specifying <tp:dbus-ref
557		namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia.FUTURE">InitialAudio</tp:dbus-ref>
558		or <tp:dbus-ref
559		namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia.FUTURE">InitialAudio</tp:dbus-ref>
560		= <tt>True</tt> in the channel request), then they cannot be changed;
561		subsequent calls to <tp:member-ref>RequestStreams</tp:member-ref> or
562		<tp:member-ref>RemoveStreams</tp:member-ref> will fail.
563
564		<tp:rationale>
565		For example, once an audio-only Google Talk call has started, it is
566		not possible to add a video stream; both audio and video must be
567		requested at the start of the call if video is desired. User
568		interfaces may use this pseudo-capability as a hint to display
569		separate "Audio call" and "Video call" buttons, rather than a
570		single "Call" button with the option to add and remove video once
571		the call has started for contacts without this flag.
572		</tp:rationale>
	703	Channels whose target handle is this contact will have
	704	<tp:member-ref>ImmutableStreams</tp:member-ref> = <tt>True</tt>.
573	705	</tp:docstring>
574	706	</tp:flag>
575	707

-210

~~spec/Channel_Type_Streamed_Media_Future.xml~~ less more

0		<?xml version="1.0" ?>
1		<node name="/Channel_Type_Streamed_Media_Future"
2		xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3		<tp:copyright> Copyright © 2009 Collabora Limited </tp:copyright>
4		<tp:copyright> Copyright © 2009 Nokia Corporation </tp:copyright>
5		<tp:license xmlns="http://www.w3.org/1999/xhtml">
6		<p>This library is free software; you can redistribute it and/or
7		modify it under the terms of the GNU Lesser General Public
8		License as published by the Free Software Foundation; either
9		version 2.1 of the License, or (at your option) any later version.</p>
10
11		<p>This library is distributed in the hope that it will be useful,
12		but WITHOUT ANY WARRANTY; without even the implied warranty of
13		MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14		Lesser General Public License for more details.</p>
15
16		<p>You should have received a copy of the GNU Lesser General Public
17		License along with this library; if not, write to the Free Software
18		Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
19		USA.</p>
20		</tp:license>
21		<interface name="org.freedesktop.Telepathy.Channel.Type.StreamedMedia.FUTURE">
22		<tp:requires interface="org.freedesktop.Telepathy.Channel"/>
23		<tp:requires interface="org.freedesktop.Telepathy.Channel.Type.StreamedMedia"/>
24
25		<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
26		<p>This interface contains functionality which we intend to incorporate
27		into the <tp:dbus-ref
28		namespace="org.freedesktop.Telepathy">Channel.Type.StreamedMedia</tp:dbus-ref>
29		interface in future. It should be considered to be conceptually part
30		of the core StreamedMedia interface, but without API or ABI
31		guarantees.</p>
32
33		<tp:rationale>
34		<p>The rationale is the same as for <tp:dbus-ref
35		namespace="org.freedesktop.Telepathy">Channel.FUTURE</tp:dbus-ref>.</p>
36		</tp:rationale>
37		</tp:docstring>
38
39		<property name="InitialAudio" tp:name-for-bindings="Initial_Audio"
40		type="b" access="read">
41		<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
42		<p>If set to true in a channel request that will create a new channel,
43		the connection manager should immediately attempt to establish an
44		audio stream to the remote contact, making it unnecessary for the
45		client to call <tp:dbus-ref
46		namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">RequestStreams</tp:dbus-ref>.</p>
47
48		<p>If this property, or InitialVideo, is passed to EnsureChannel
49		(as opposed to CreateChannel), the connection manager SHOULD ignore
50		these properties when checking whether it can return an existing
51		channel as suitable; these properties only become significant when
52		the connection manager has decided to create a new channel.</p>
53
54		<p>If true on a requested channel, this indicates that the audio
55		stream has already been requested and the client does not need to
56		call RequestStreams, although it MAY still do so.</p>
57
58		<p>If true on an unrequested (incoming) channel, this indicates that
59		the remote contact initially requested an audio stream; this does
60		not imply that that audio stream is still active (as indicated by
61		<tp:dbus-ref
62		namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">ListStreams</tp:dbus-ref>).</p>
63
64		<p>This property is immutable (cannot change), and therefore SHOULD
65		appear wherever immutable properties are reported, e.g. <tp:dbus-ref
66		namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">NewChannels</tp:dbus-ref>
67		signals.</p>
68
69		<tp:rationale><p>This reduces D-Bus round trips.</p></tp:rationale>
70
71		<p>Connection managers capable of signalling audio calls to contacts
72		SHOULD include a channel class in <tp:dbus-ref
73		namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">RequestableChannelClasses</tp:dbus-ref>
74		with <tp:dbus-ref
75		namespace="org.freedesktop.Telepathy.Channel">ChannelType</tp:dbus-ref>
76		= <tp:dbus-ref
77		namespace="org.freedesktop.Telepathy.Channel.Type">StreamedMedia</tp:dbus-ref>
78		and <tp:dbus-ref
79		namespace="org.freedesktop.Telepathy.Channel">TargetHandleType</tp:dbus-ref>
80		= Contact in the fixed properties dictionary, and InitialAudio
81		(and also InitialVideo, if applicable) in the allowed properties
82		list. Clients wishing to discover whether a connection manager
83		can signal audio and/or video calls SHOULD use this information.</p>
84
85		<tp:rationale>
86		<p>Not all protocols support signalling video calls, and it would be
87		possible (although unlikely) to have a protocol where only video,
88		and not audio, could be signalled.</p>
89		</tp:rationale>
90
91		<p>Connection managers that support the <tp:dbus-ref
92		namespace="org.freedesktop.Telepathy.Connection.Interface">ContactCapabilities.DRAFT2</tp:dbus-ref>
93		interface SHOULD represent the capabilities of receiving audio
94		and/or video calls by including a channel class in
95		a contact's capabilities with ChannelType = StreamedMedia
96		in the fixed properties dictionary, and InitialAudio and/or
97		InitialVideo in the allowed properties list. Clients wishing to
98		discover whether a particular contact is likely to be able to
99		receive audio and/or video calls SHOULD use this information.</p>
100
101		<tp:rationale>
102		<p>Not all clients support video calls, and it would also be
103		possible (although unlikely) to have a client which could only
104		stream video, not audio.</p>
105		</tp:rationale>
106
107		<p>Clients that are willing to receive audio and/or video calls
108		SHOULD include the following among their channel classes if
109		calling <tp:dbus-ref
110		namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT2">UpdateCapabilities</tp:dbus-ref>
111		(clients of a <tp:dbus-ref
112		namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>
113		SHOULD instead arrange for the ChannelDispatcher to do this,
114		by including the filters in their <tp:dbus-ref
115		namespace="org.freedesktop.Telepathy.Client.Handler">HandlerChannelFilter</tp:dbus-ref>
116		properties):</p>
117
118		<ul>
119		<li>{ ChannelType = StreamedMedia }</li>
120		<li>{ ChannelType = StreamedMedia, InitialAudio = true }
121		if receiving calls with audio is supported</li>
122		<li>{ ChannelType = StreamedMedia, InitialVideo = true }
123		if receiving calls with video is supported</li>
124		</ul>
125
126		<tp:rationale>
127		<p>Connection managers for protocols with capability discovery,
128		like XMPP, need this information to advertise the appropriate
129		capabilities for their protocol.</p>
130		</tp:rationale>
131		</tp:docstring>
132		</property>
133
134		<property name="InitialVideo" tp:name-for-bindings="Initial_Video"
135		type="b" access="read">
136		<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
137		<p>The same as <tp:member-ref>InitialAudio</tp:member-ref>, but for
138		a video stream. This property is immutable (cannot change).</p>
139
140		<p>In particular, note that if this property is false, this does not
141		imply that an active video stream has not been added, only that no
142		video stream was active at the time the channel appeared.</p>
143
144		<p>This property is the correct way to discover whether connection
145		managers, contacts etc. support video calls; it appears in
146		capabilities structures in the same way as InitialAudio.</p>
147		</tp:docstring>
148		</property>
149
150		<property name="ImmutableStreams" tp:name-for-bindings="Immutable_Streams"
151		type="b" access="read">
152		<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
153		<p>If <tt>True</tt>, once streams have been requested for this channel
154		(either by setting <tp:member-ref>InitialAudio</tp:member-ref> or
155		<tp:member-ref>InitialVideo</tp:member-ref> when the channel is
156		requested, or by calling <tp:dbus-ref
157		namespace='org.freedesktop.Telepathy.Channel.Type.StreamedMedia'>RequestStreams</tp:dbus-ref>
158		on a channel with no streams), the channel's streams cannot be changed;
159		subsequent calls to <tp:dbus-ref
160		namespace='org.freedesktop.Telepathy.Channel.Type.StreamedMedia'>RequestStreams</tp:dbus-ref>
161		or <tp:dbus-ref
162		namespace='org.freedesktop.Telepathy.Channel.Type.StreamedMedia'>RemoveStreams</tp:dbus-ref>
163		will fail.</p>
164
165		<p>If this property is missing, clients SHOULD assume that it is false,
166		and thus that the channel's streams can be changed once the call has
167		started.</p>
168
169		<p>If this property is present in all of the <tp:dbus-ref
170		namespace='org.freedesktop.Telepathy.Channel.Type'>StreamedMedia</tp:dbus-ref>
171		entries in a contact's capabilities, then user interfaces MAY choose
172		to show a separate "call" option for each class of call.</p>
173
174		<tp:rationale>
175		<p>On protocols like XMPP Jingle, it is possible to start an
176		audio-only call and then add a video stream, so the user interface
177		could be a single "call" button, which places an audio call, and an
178		"enable video" button in the call interface. However, on protocols
179		like Google Talk it is not possible to upgrade a call once it has
180		started; the user interface will thus need to adapt in order to
181		allow the user to place video calls.</p>
182		</tp:rationale>
183
184		<p>For incoming channels, this property MUST be included in the channel's immutable properties
185		(as announced in <tp:dbus-ref
186		namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">NewChannels</tp:dbus-ref>,
187		etc.). For outgoing calls, this property MAY be omitted from the
188		channel's immutable properties for calls without
189		<tp:member-ref>InitialAudio</tp:member-ref> or
190		<tp:member-ref>InitialVideo</tp:member-ref>, in which case its value
191		is undefined until <tp:dbus-ref
192		namespace='org.freedesktop.Telepathy.Channel.Type.StreamedMedia'>RequestStreams</tp:dbus-ref>
193		has been called at least once.</p>
194
195		<tp:rationale>
196		<p>The protocol mechanism used for the call might only be selected
197		when the CM knows what kind of call is desired. For example, if an
198		XMPP contact is signed in with Google Mail (with video support) and
199		Another client which supports modern Jingle (which supports
200		modifying the streams in a call) but only for audio calls, the
201		call's streams will be immutable if the UI requests Audio+Video,
202		but mutable if the UI just requests audio (a second audio stream
203		could be added, for instance).</p>
204		</tp:rationale>
205		</tp:docstring>
206		</property>
207
208		</interface>
209		</node>

-2

spec/Channel_Type_Text.xml less more

418	418	</tp:property>
419	419	<tp:property name="name" type="s">
420	420	<tp:docstring>
421		A human-visible name for the channel, if it differs from the string
422		version of the channel's handle.
	421	A human-visible name for the channel, if it differs from the channel's
	422	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel">TargetID</tp:dbus-ref>.
423	423	</tp:docstring>
424	424	</tp:property>
425	425	<tp:property name="description" type="s">

+13

-11

spec/Connection.xml less more

250	250
251	251	<arg direction="out" type="as" name="Identifiers">
252	252	<tp:docstring>
253		An array of handle names in the same order as the given numbers
	253	An array of identifiers corresponding to the given handles, in the same order.
254	254	</tp:docstring>
255	255	</arg>
256	256

590	590	</tp:docstring>
591	591	</arg>
592	592
593		<arg direction="in" name="Names" type="as">
594		<tp:docstring>
595		An array of names of entities to request handles for
	593	<arg direction="in" name="Identifiers" type="as">
	594	<tp:docstring>
	595	An array of identifiers of entities to request handles for
596	596	</tp:docstring>
597	597	</arg>
598	598
599	599	<arg direction="out" type="au" tp:type="Handle[]"
600	600	name="Handles">
601	601	<tp:docstring>
602		An array of integer handle numbers in the same order as the given strings
	602	An array of integer handle numbers in the same order as the given identifiers.
603	603	</tp:docstring>
604	604	</arg>
605	605

610	610	client who invokes this method, and must not deallocate the handles
611	611	until the client disconnects from the bus or calls the
612	612	<tp:member-ref>ReleaseHandles</tp:member-ref>
613		method. Where the name refers to an entity that already has a handle
614		in this connection manager, this handle should be returned instead.
615		The handle number 0 must not be returned by the connection manager.
	613	method. Where the identifier refers to an entity that already has a
	614	handle in this connection manager, this handle should be returned
	615	instead. The handle number 0 must not be returned by the connection
	616	manager.
616	617	</tp:docstring>
617	618
618	619	<tp:possible-errors>
619	620	<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
620	621	<tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle">
621	622	<tp:docstring>
622		The given name does not identify a valid entity of the given type.
	623	The given identifier does not identify a valid entity of the given
	624	type.
623	625
624	626	<tp:rationale>
625	627	For instance, an XMPP connection would raise this error for

1039	1041	ambiguous. Connection manager implementations should reference count these
1040	1042	handles to determine if they are in use either by any active clients or any
1041	1043	open channels, and may deallocate them when this ceases to be true. Clients
1042		may request handles of a given type and name with the
	1044	may request handles of a given type and identifier with the
1043	1045	<tp:member-ref>RequestHandles</tp:member-ref> method, inspect the entity
1044		name of handles with the <tp:member-ref>InspectHandles</tp:member-ref>
	1046	identifier with the <tp:member-ref>InspectHandles</tp:member-ref>
1045	1047	method, keep handles from being released with
1046	1048	<tp:member-ref>HoldHandles</tp:member-ref>, and notify that they are no
1047	1049	longer storing handles with

-3

spec/Connection_Interface_Aliasing.xml less more

118	118	</arg>
119	119	<tp:docstring>
120	120	Request the value of several contacts' aliases at once. This SHOULD
121		only return cached aliases, falling back on the handle name if none is
122		present. Also if there was no cached alias, a request SHOULD be started
123		of which the result is later signalled by
	121	only return cached aliases, falling back on the contact identifier
	122	(i.e. the string corresponding to the handle) if none is present. Also
	123	if there was no cached alias, a request SHOULD be started of which the
	124	result is later signalled by
124	125	<tp:member-ref>AliasesChanged</tp:member-ref>.
125	126	</tp:docstring>
126	127	<tp:possible-errors>

-4

spec/Connection_Interface_Contact_Capabilities.xml less more

17	17	License along with this library; if not, write to the Free Software
18	18	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
19	19	</tp:license>
20		<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT2"
21		tp:causes-havoc="experimental">
	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities">
22	21	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
23		<tp:added version="0.17.16">(as a draft)</tp:added>
24		<tp:changed version="0.17.27">(draft 2)</tp:changed>
	22	<tp:added version="0.17.28">(as stable API)</tp:added>
25	23
26	24	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
27	25	<p>Contact capabilities describe the channel classes which may be

-1

spec/Connection_Interface_Renaming.xml less more

64	64	</tp:docstring>
65	65	</signal>
66	66	<method name="RequestRename" tp:name-for-bindings="Request_Rename">
67		<arg direction="in" name="Name" type="s">
	67	<arg direction="in" name="Identifier" type="s">
68	68	<tp:docstring>
69	69	The desired identifier
70	70	</tp:docstring>

-0

spec/Connection_Interface_Requests.xml less more

251	251	<tp:error name="org.freedesktop.Telepathy.Error.Channel.Banned"/>
252	252	<tp:error name="org.freedesktop.Telepathy.Error.Channel.Full"/>
253	253	<tp:error name="org.freedesktop.Telepathy.Error.Channel.InviteOnly"/>
	254	<tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied"/>
254	255	</tp:possible-errors>
255	256	</method>
256	257

382	383	<tp:error name="org.freedesktop.Telepathy.Error.Channel.Banned"/>
383	384	<tp:error name="org.freedesktop.Telepathy.Error.Channel.Full"/>
384	385	<tp:error name="org.freedesktop.Telepathy.Error.Channel.InviteOnly"/>
	386	<tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied"/>
385	387	</tp:possible-errors>
386	388	</method>
387	389

-1

spec/Makefile.am less more

28	28	Channel_Type_Room_List.xml \
29	29	Channel_Type_Stream_Tube.xml \
30	30	Channel_Type_Streamed_Media.xml \
31		Channel_Type_Streamed_Media_Future.xml \
32	31	Channel_Type_Text.xml \
33	32	Channel_Type_Tubes.xml \
34	33	Channel.xml \

-1

spec/Makefile.in less more

238	238	Channel_Type_Room_List.xml \
239	239	Channel_Type_Stream_Tube.xml \
240	240	Channel_Type_Streamed_Media.xml \
241		Channel_Type_Streamed_Media_Future.xml \
242	241	Channel_Type_Text.xml \
243	242	Channel_Type_Tubes.xml \
244	243	Channel.xml \

-2

spec/all.xml less more

2	2	xmlns:xi="http://www.w3.org/2001/XInclude">
3	3
4	4	<tp:title>Telepathy D-Bus Interface Specification</tp:title>
5		<tp:version>0.17.27</tp:version>
	5	<tp:version>0.17.28</tp:version>
6	6
7	7	<tp:copyright>Copyright © 2005-2009 Collabora Limited</tp:copyright>
8	8	<tp:copyright>Copyright © 2005-2009 Nokia Corporation</tp:copyright>

78	78	</tp:docstring>
79	79	<xi:include href="Channel_Type_Contact_List.xml"/>
80	80	<xi:include href="Channel_Type_Streamed_Media.xml"/>
81		<xi:include href="Channel_Type_Streamed_Media_Future.xml"/>
82	81	<xi:include href="Channel_Type_Room_List.xml"/>
83	82	<xi:include href="Channel_Type_Text.xml"/>
84	83	<xi:include href="Channel_Type_Tubes.xml"/>

-1

spec/errors.xml less more

47	47
48	48	<tp:error name="Invalid Handle">
49	49	<tp:docstring>
50		The contact name specified is unknown on this channel or connection.
	50	The handle specified is unknown on this channel or connection.
51	51	</tp:docstring>
52	52	</tp:error>
53	53

-1

telepathy-glib/Makefile.am less more

38	38	versions/0.7.32.abi \
39	39	versions/0.7.34.abi \
40	40	versions/0.7.35.abi \
41		versions/0.7.36.abi
	41	versions/0.7.36.abi \
	42	versions/0.7.37.abi
42	43
43	44	EXTRA_DIST = \
44	45	$(ABI_LISTS) \

-1

telepathy-glib/Makefile.in less more

318	318	versions/0.7.32.abi \
319	319	versions/0.7.34.abi \
320	320	versions/0.7.35.abi \
321		versions/0.7.36.abi
	321	versions/0.7.36.abi \
	322	versions/0.7.37.abi
322	323
323	324	EXTRA_DIST = \
324	325	$(ABI_LISTS) \

-0

telepathy-glib/connection.xml less more

8	8	<xi:include href="../spec/Connection_Interface_Aliasing.xml"/>
9	9	<xi:include href="../spec/Connection_Interface_Avatars.xml"/>
10	10	<xi:include href="../spec/Connection_Interface_Capabilities.xml"/>
	11	<xi:include href="../spec/Connection_Interface_Contact_Capabilities.xml"/>
11	12	<xi:include href="../spec/Connection_Interface_Simple_Presence.xml"/>
12	13	<xi:include href="../spec/Connection_Interface_Presence.xml"/>
13	14	<xi:include href="../spec/Connection_Interface_Contacts.xml"/>

-2

telepathy-glib/debug-internal.h less more

10	10
11	11	G_BEGIN_DECLS
12	12
13		/* Please keep this enum in sync with #keys, and the section gtkdoc,
14		* in debug.c */
	13	/* Please keep this enum in sync with #keys, the section gtkdoc,
	14	* and #key_to_domain, in debug.c */
15	15	typedef enum
16	16	{
17	17	TP_DEBUG_GROUPS = 1 << 1,

-9

telepathy-glib/debug-sender.c less more

404	404	* g_log_default_handler(), and then sends the message on the bus
405	405	* #TpDebugSender.
406	406	*
407		* The @exclude parameter is designed to allow filtering of domains, instead of
408		* sending every message to the #TpDebugSender. Note that every message,
409		* regardless of domain, is given to g_log_default_handler().
	407	* The @exclude parameter is designed to allow filtering one domain, instead of
	408	* sending every message to the #TpDebugSender: typical usage is for a
	409	* process to filter out messages from its own %G_LOG_DOMAIN, so that it can
	410	* append a category to its own messages and pass them directly to
	411	* tp_debug_sender_add_message. Note that every message, regardless of
	412	* domain, is given to g_log_default_handler().
410	413	*
411	414	* Note that a ref to a #TpDebugSender must be kept at all times otherwise
412	415	* no messages given to the handler will be sent to the Telepathy debug

445	448	const gchar *message,
446	449	gpointer exclude)
447	450	{
448		const gchar *domain_exclude = NULL;
449
450	451	g_log_default_handler (log_domain, log_level, message, NULL);
451	452
452	453	if (debug_sender == NULL)
453	454	return;
454	455
455		if (exclude != NULL)
456		domain_exclude = (gchar *) exclude;
457
458		if (domain_exclude != NULL && tp_strdiff (log_domain, domain_exclude))
	456	if (exclude == NULL \|\| tp_strdiff (log_domain, exclude))
459	457	{
460	458	GTimeVal now;
461	459	g_get_current_time (&now);

+54

-1

telepathy-glib/debug.c less more

112	112	{ 0, }
113	113	};
114	114
	115	typedef struct {
	116	guint key;
	117	const gchar *domain;
	118	} DebugKeyToDomain;
	119
	120	/* This is an array of debug key flags to log domains. The point of this is so
	121	* that once getting the index of the bit set, _tp_debug() can simply index
	122	* this array. Aditionally, having the domain already in $domain/$category
	123	* format means we don't have to call g_strdup_printf() to get the desired
	124	* domain for each debug message logged, and then g_free() to free the newly
	125	* created string... */
	126	static DebugKeyToDomain key_to_domain[] = {
	127	/* There is no 1 << 0 */
	128	{ 0, G_LOG_DOMAIN "/misc" },
	129	{ TP_DEBUG_GROUPS, G_LOG_DOMAIN "/groups" },
	130	{ TP_DEBUG_PROPERTIES, G_LOG_DOMAIN "/properties" },
	131	{ TP_DEBUG_IM, G_LOG_DOMAIN "/im" },
	132	{ TP_DEBUG_CONNECTION, G_LOG_DOMAIN "/connection" },
	133	{ TP_DEBUG_PARAMS, G_LOG_DOMAIN "/params" },
	134	{ TP_DEBUG_PRESENCE, G_LOG_DOMAIN "/presence" },
	135	{ TP_DEBUG_MANAGER, G_LOG_DOMAIN "/manager" },
	136	{ TP_DEBUG_CHANNEL, G_LOG_DOMAIN "/channel" },
	137	{ TP_DEBUG_PROXY, G_LOG_DOMAIN "/proxy" },
	138	{ TP_DEBUG_HANDLES, G_LOG_DOMAIN "/handles" },
	139	{ TP_DEBUG_CONTACTS, G_LOG_DOMAIN "/contacts" },
	140	{ TP_DEBUG_ACCOUNTS, G_LOG_DOMAIN "/accounts" },
	141	{ TP_DEBUG_DISPATCHER, G_LOG_DOMAIN "/dispatcher" },
	142	{ 0, NULL }
	143	};
	144
115	145	static GDebugKey persist_keys[] = {
116	146	{ "persist", 1 },
117	147	{ 0, },

238	268	return (flag & flags) != 0;
239	269	}
240	270
	271	static const gchar *
	272	debug_flag_to_domain (TpDebugFlags flag)
	273	{
	274	gint index, max;
	275
	276	/* First bit set of @flag. This to make sure we only have one bit (in the
	277	* unlikely scenario that multiple debug flags were set). This enables us to
	278	* index the #key_to_domain array, instead of having to iterate it looking
	279	* for the right key. */
	280	index = g_bit_nth_lsf (flag, -1);
	281
	282	/* The maximum valid index of the #key_to_domain array. Decrement it by one
	283	* because there is the blank { 0, NULL } item on the end which we want to
	284	* ignore. */
	285	max = G_N_ELEMENTS (key_to_domain) - 1;
	286
	287	/* If the index we got isn't valid, just return "misc". */
	288	if (index < 0 \|\| index >= max)
	289	return G_LOG_DOMAIN "/misc";
	290	else
	291	return key_to_domain[index].domain;
	292	}
	293
241	294	/*
242	295	* _tp_debug_set_flags:
243	296	* @flag: Flag to test

254	307	{
255	308	va_list args;
256	309	va_start (args, format);
257		g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format, args);
	310	g_logv (debug_flag_to_domain (flag), G_LOG_LEVEL_DEBUG, format, args);
258	311	va_end (args);
259	312	}
260	313	}

+10

-6

telepathy-glib/extra-gtkdoc.h less more

543	543
544	544	/**
545	545	* SECTION:connection-caps
546		* @title: Connection Capabilities interface
547		* @short_description: client-side wrappers for the Capabilities interface
	546	* @title: Connection ContactCapabilities and Capabilities interfaces
	547	* @short_description: client-side wrappers for the capabilities interfaces
548	548	* @see_also: #TpConnection
549	549	*
550	550	* Some instant messaging protocols allow discovery of the capabilities of
551		* a user's client. In Telepathy, this is represented by the Capabilities
552		* interface, which lets applications advertise extra capabilities for the
553		* local user, and query the interfaces supported by their contacts.
	551	* a user's client. In Telepathy, this is represented by the
	552	* ContactCapabilities interface, which lets applications advertise extra
	553	* capabilities for the local user, and query the interfaces supported by
	554	* their contacts.
	555	*
	556	* The Capabilities interface is an older API with similar functionality.
554	557	*
555	558	* This section documents the auto-generated C wrappers for the
556		* Capabilities interface, used with #TpConnection objects.
	559	* ContactCapabilities and Capabilities interfaces, used with
	560	* #TpConnection objects.
557	561	*/
558	562
559	563	/**

+18

-0

telepathy-glib/versions/0.7.37.abi less more

	0	Version: TELEPATHY_GLIB_0.7.37
	1	Extends: TELEPATHY_GLIB_0.7.36
	2	Release: 0.7.37
	3
	4	tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities
	5	tp_cli_connection_interface_contact_capabilities_call_update_capabilities
	6	tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed
	7	tp_cli_connection_interface_contact_capabilities_run_get_contact_capabilities
	8	tp_cli_connection_interface_contact_capabilities_run_update_capabilities
	9	tp_iface_quark_connection_interface_contact_capabilities
	10	tp_svc_connection_interface_contact_capabilities_emit_contact_capabilities_changed
	11	tp_svc_connection_interface_contact_capabilities_get_type
	12	tp_svc_connection_interface_contact_capabilities_implement_get_contact_capabilities
	13	tp_svc_connection_interface_contact_capabilities_implement_update_capabilities
	14	tp_type_dbus_array_of_a_7bua_28a_7bsv_7das_29_7d
	15	tp_type_dbus_array_saa_7bsv_7das
	16	tp_type_dbus_hash_ua_28a_7bsv_7das_29
	17	tp_type_dbus_struct_saa_7bsv_7das

+10

-3

tests/Makefile.am less more

9	9	test-heap \
10	10	test-internal-debug \
11	11	test-intset \
12		test-util
	12	test-util \
	13	test-debug-domain
13	14
14	15	TESTS = $(noinst_PROGRAMS) \
15	16	all-errors-documented.py

53	54	test_availability_cmp_SOURCES = \
54	55	availability-cmp.c
55	56
	57	test_debug_domain_SOURCES = \
	58	debug-domain.c
	59
	60	test_internal_debug_SOURCES = \
	61	internal-debug.c
	62
56	63	# this needs to link against the static convenience library so that
57	64	# _tp_debug is still visible
58		test_internal_debug_SOURCES = \
59		internal-debug.c
	65	test_debug_domain_LDADD = \
	66	$(top_builddir)/telepathy-glib/libtelepathy-glib-internal.la
60	67	test_internal_debug_LDADD = \
61	68	$(top_builddir)/telepathy-glib/libtelepathy-glib-internal.la
62	69

+24

-7

tests/Makefile.in less more

37	37	host_triplet = @host@
38	38	noinst_PROGRAMS = test-asv$(EXEEXT) test-availability-cmp$(EXEEXT) \
39	39	test-heap$(EXEEXT) test-internal-debug$(EXEEXT) \
40		test-intset$(EXEEXT) test-util$(EXEEXT)
	40	test-intset$(EXEEXT) test-util$(EXEEXT) \
	41	test-debug-domain$(EXEEXT)
41	42	DIST_COMMON = README $(srcdir)/Makefile.am $(srcdir)/Makefile.in \
42	43	$(top_srcdir)/tools/check-coding-style.mk
43	44	subdir = tests

66	67	test_availability_cmp_LDADD = $(LDADD)
67	68	test_availability_cmp_DEPENDENCIES = \
68	69	$(top_builddir)/telepathy-glib/libtelepathy-glib.la
	70	am_test_debug_domain_OBJECTS = debug-domain.$(OBJEXT)
	71	test_debug_domain_OBJECTS = $(am_test_debug_domain_OBJECTS)
	72	test_debug_domain_DEPENDENCIES = \
	73	$(top_builddir)/telepathy-glib/libtelepathy-glib-internal.la
69	74	am_test_heap_OBJECTS = heap.$(OBJEXT)
70	75	test_heap_OBJECTS = $(am_test_heap_OBJECTS)
71	76	test_heap_LDADD = $(LDADD)

97	102	LINK = $(LIBTOOL) --tag=CC --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) \
98	103	$(AM_LDFLAGS) $(LDFLAGS) -o $@
99	104	SOURCES = $(test_asv_SOURCES) $(test_availability_cmp_SOURCES) \
100		$(test_heap_SOURCES) $(test_internal_debug_SOURCES) \
101		$(test_intset_SOURCES) $(test_util_SOURCES)
	105	$(test_debug_domain_SOURCES) $(test_heap_SOURCES) \
	106	$(test_internal_debug_SOURCES) $(test_intset_SOURCES) \
	107	$(test_util_SOURCES)
102	108	DIST_SOURCES = $(test_asv_SOURCES) $(test_availability_cmp_SOURCES) \
103		$(test_heap_SOURCES) $(test_internal_debug_SOURCES) \
104		$(test_intset_SOURCES) $(test_util_SOURCES)
	109	$(test_debug_domain_SOURCES) $(test_heap_SOURCES) \
	110	$(test_internal_debug_SOURCES) $(test_intset_SOURCES) \
	111	$(test_util_SOURCES)
105	112	RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
106	113	html-recursive info-recursive install-data-recursive \
107	114	install-exec-recursive install-info-recursive \

309	316	test_availability_cmp_SOURCES = \
310	317	availability-cmp.c
311	318
	319	test_debug_domain_SOURCES = \
	320	debug-domain.c
	321
	322	test_internal_debug_SOURCES = \
	323	internal-debug.c
	324
312	325
313	326	# this needs to link against the static convenience library so that
314	327	# _tp_debug is still visible
315		test_internal_debug_SOURCES = \
316		internal-debug.c
	328	test_debug_domain_LDADD = \
	329	$(top_builddir)/telepathy-glib/libtelepathy-glib-internal.la
317	330
318	331	test_internal_debug_LDADD = \
319	332	$(top_builddir)/telepathy-glib/libtelepathy-glib-internal.la

374	387	test-availability-cmp$(EXEEXT): $(test_availability_cmp_OBJECTS) $(test_availability_cmp_DEPENDENCIES)
375	388	@rm -f test-availability-cmp$(EXEEXT)
376	389	$(LINK) $(test_availability_cmp_LDFLAGS) $(test_availability_cmp_OBJECTS) $(test_availability_cmp_LDADD) $(LIBS)
	390	test-debug-domain$(EXEEXT): $(test_debug_domain_OBJECTS) $(test_debug_domain_DEPENDENCIES)
	391	@rm -f test-debug-domain$(EXEEXT)
	392	$(LINK) $(test_debug_domain_LDFLAGS) $(test_debug_domain_OBJECTS) $(test_debug_domain_LDADD) $(LIBS)
377	393	test-heap$(EXEEXT): $(test_heap_OBJECTS) $(test_heap_DEPENDENCIES)
378	394	@rm -f test-heap$(EXEEXT)
379	395	$(LINK) $(test_heap_LDFLAGS) $(test_heap_OBJECTS) $(test_heap_LDADD) $(LIBS)

395	411
396	412	@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/asv.Po@am__quote@
397	413	@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/availability-cmp.Po@am__quote@
	414	@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/debug-domain.Po@am__quote@
398	415	@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/heap.Po@am__quote@
399	416	@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/internal-debug.Po@am__quote@
400	417	@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/intset.Po@am__quote@

+70

-0

tests/debug-domain.c less more

	0	#include <glib.h>
	1
	2	#include <telepathy-glib/util.h>
	3
	4	#include "telepathy-glib/debug-internal.h"
	5
	6	/* Only run test if ENABLE_DEBUG is defined, otherwise we won't have
	7	* _tp_debug and the TpDebugFlags enum. */
	8	#ifdef ENABLE_DEBUG
	9
	10	typedef struct
	11	{
	12	guint flag;
	13	const gchar *domain;
	14	} TestItem;
	15
	16	static TestItem items[] = {
	17	{ TP_DEBUG_GROUPS, "groups" },
	18	{ TP_DEBUG_GROUPS \| TP_DEBUG_PROPERTIES, "groups" },
	19	{ TP_DEBUG_GROUPS \| TP_DEBUG_DISPATCHER, "groups" },
	20	{ TP_DEBUG_PROXY \| TP_DEBUG_CHANNEL, "channel" },
	21	{ 1 << 31, "misc" },
	22	{ TP_DEBUG_ACCOUNTS, "accounts" },
	23	{ TP_DEBUG_PROXY \| TP_DEBUG_HANDLES \| TP_DEBUG_PRESENCE, "presence" },
	24	{ 0, NULL },
	25	};
	26	static guint item = 0;
	27
	28	static void
	29	handler (const gchar *log_domain,
	30	GLogLevelFlags log_level,
	31	const gchar *message,
	32	gpointer user_data)
	33	{
	34	TestItem i = items[item];
	35	gchar **parts;
	36
	37	parts = g_strsplit (log_domain, "/", -1);
	38
	39	g_assert_cmpuint (g_strv_length (parts), ==, 2);
	40	g_assert (!tp_strdiff (parts[0], "tp-glib"));
	41	g_assert (!tp_strdiff (parts[1], i.domain));
	42	g_assert (!tp_strdiff (message, "foo"));
	43
	44	g_strfreev (parts);
	45	}
	46	#endif
	47
	48	int main (int argc, char **argv)
	49	{
	50	#ifdef ENABLE_DEBUG
	51	TestItem i;
	52
	53	g_type_init ();
	54
	55	tp_debug_set_flags ("all");
	56
	57	g_log_set_default_handler (handler, NULL);
	58
	59	for (; items[item].domain != NULL; item++)
	60	{
	61	i = items[item];
	62	_tp_debug (i.flag, "foo");
	63	}
	64
	65	#else
	66	g_print ("Not running test-debug-domain test as ENABLE_DEBUG is undefined\n");
	67	#endif
	68	return 0;
	69	}