Commit c27a531da12805307e27a23db1a176a027739c24 - telepathy-glib

Imported Upstream version 0.11.9 Simon McVittie 13 years ago

83 changed file(s) with 3484 addition(s) and 5271 deletion(s). Raw diff Collapse all Expand all

+248

-0

ChangeLog less more

	0	commit 5d34ae4e1627b9c30780a1b40a50b7a4ee581ea0
	1	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	2	Date: 2010-07-02 16:31:45 +0100
	3
	4	Prepare version 0.11.9
	5
	6	commit 862387cfbd4b17f8a207f98195fcb179616ebc5d
	7	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	8	Date: 2010-07-02 15:11:29 +0100
	9
	10	Actually include Conn.I.Cellular in the API docs
	11
	12	commit 1ac373d985c0a435456f39b675097270aa9459aa
	13	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	14	Date: 2010-07-02 15:01:18 +0100
	15
	16	Update NEWS
	17
	18	commit 5f4a8925687ff4eaa1338d69ca84cbac528a9556
	19	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	20	Date: 2010-07-02 15:47:43 +0200
	21
	22	don't try to remove the handler from the clients hash if it's not an handler
	23
	24	commit 0813337f7f7c7e51feb9008c55126ffae3460338
	25	Merge: 34d2b6b 0e7e6bb
	26	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	27	Date: 2010-07-02 11:40:34 +0100
	28
	29	Merge branch 'spec'
	30
	31	Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
	32
	33	commit 0e7e6bb7176e0fe90fac2bdb00e8391b3ac9e75a
	34	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	35	Date: 2010-07-02 11:32:07 +0100
	36
	37	Generate code for the newly-stable interfaces and add them to the docs
	38
	39	commit d69e5974466566f2e83144d88c080d787f54bae1
	40	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	41	Date: 2010-07-02 11:17:05 +0100
	42
	43	Make code generation more reliable in out-of-tree builds
	44
	45	Previously, the wildcard wouldn't match anything in an out-of-tree build,
	46	so stable-stamp wouldn't be updated, and hence changes to the interface
	47	whitelists (connection.xml etc.) wouldn't trigger a rebuild of
	48	stable-spec.xml.
	49
	50	commit e9c2385c46abbf050562a59a93834fb08df5f64c
	51	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	52	Date: 2010-07-02 10:56:23 +0100
	53
	54	Improve TpAccount:protocol documentation based on TpAccount:service
	55
	56	commit 97704b7d47d1dc683e114a781676ea323dbb7d59
	57	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	58	Date: 2010-07-02 10:56:02 +0100
	59
	60	TpAccount: add tp_account_set_service_async
	61
	62	commit bd1a44f665dff92d731f1b5910aab113a8bccce6
	63	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	64	Date: 2010-07-02 10:55:33 +0100
	65
	66	TpAccount: add read-only support for Service
	67
	68	commit 28173ee563e2a93e25649aa47c48f12212a42d16
	69	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	70	Date: 2010-07-02 10:53:47 +0100
	71
	72	Update to telepathy-spec 0.19.8
	73
	74	- generate code for Account.Service property
	75	- generate code for ConnectionManager.Protocols property and
	76	Protocol_Properties_Map type, although the properties they contain
	77	are still in draft
	78	- Capabilities is deprecated, CMs implementing it must also
	79	implement ContactCapabilities
	80	- Account.I.Storage, Conn.I.Cellular are stable but do not have generated
	81	code yet
	82
	83	commit 34d2b6b53b61ec0b8fe956b9b0d60e18d2cd0a96
	84	Merge: fad9f41 32f7a50
	85	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	86	Date: 2010-07-01 07:44:29 -0700
	87
	88	Merge branch 'gi-fixes'
	89
	90	commit fad9f41b22eef2717dbf2f9e8f5fb81bb14455d7
	91	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	92	Date: 2010-07-01 13:31:02 +0200
	93
	94	telepathy-glib.supp: suppress iface initialization
	95
	96	commit 434a4c8a4d0df687947e8fee2aa2e79e60db5ed0
	97	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	98	Date: 2010-07-01 12:58:05 +0200
	99
	100	tests.supp: test_object_new_static_class has been renamed to tp_tests_object_new_static_class
	101
	102	commit 620837ae16138d83806c8fb0e06648aeefb71b98
	103	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	104	Date: 2010-07-01 12:42:48 +0200
	105
	106	ignore a SELinux leak
	107
	108	commit 32f7a50a1d7bcefe4a6c0bd4c512980a1b54e5c5
	109	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	110	Date: 2010-06-30 15:52:27 -0700
	111
	112	Bump vala requirement to handle (skip) properly.
	113
	114	commit 280eba1914b7dc5e08196ecb5d5367a0fde8e70c
	115	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	116	Date: 2010-06-30 15:10:10 -0700
	117
	118	Correct the capitalization of the C prefix for telepathy-glib.
	119
	120	commit cbd2f2ac5be8aafa44ee7e809fb1b3faff43a206
	121	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	122	Date: 2010-06-30 13:06:17 -0700
	123
	124	Adjust the telepathy-glib.vapi file to point to the proper header
	125
	126	commit 4d4a1f8cbee99e89cf92534f3c0d537845b636d2
	127	Merge: d95c553 6d25edc
	128	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	129	Date: 2010-06-30 10:45:34 +0100
	130
	131	Merge branch 'valgrind'
	132
	133	Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
	134
	135	commit 6d25edceddb2ef98b856e064ffcf53950e4ede9d
	136	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	137	Date: 2010-06-29 19:03:17 +0100
	138
	139	tp_tests_proxy_run_until_prepared_or_failed: don't leak the GAsyncResult
	140
	141	commit d5013c06dc3aed9eb4ef360066f0769d1cbd7e95
	142	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	143	Date: 2010-06-29 19:03:03 +0100
	144
	145	_tp_account_finalize: free priv->error
	146
	147	commit 71746c061bb8251b64192b2b36c9545899aaec90
	148	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	149	Date: 2010-06-29 18:44:34 +0100
	150
	151	contacts, contacts-slow-path tests: don't leak hash tables
	152
	153	commit 08b111e0b8f434b7194238a27bd6036ec01ded7d
	154	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	155	Date: 2010-06-29 18:25:56 +0100
	156
	157	Ignore one-off "leaks" in dbus_g_proxy_class_init
	158
	159	commit 500c58190fb57df437792cfc6205a5e3b660a87d
	160	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	161	Date: 2010-06-29 18:25:47 +0100
	162
	163	Ignore one-off "leaks" in g_inet_address_class_intern_init
	164
	165	commit cc9192e129a0694b5f2e14125fee4a97689206c4
	166	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	167	Date: 2010-06-29 18:25:04 +0100
	168
	169	tests/dbus/account: remove duplicate #include
	170
	171	commit ed19d2c85f99569569b2678d977e6070df64be67
	172	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	173	Date: 2010-06-29 18:20:39 +0100
	174
	175	TpTestsPropsGroupTextChannel: chain up correctly from finalize
	176
	177	commit 9dabad7310b4e43e8d29365f53ede1736f37a368
	178	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	179	Date: 2010-06-29 18:20:24 +0100
	180
	181	TpTestsPropsTextChannel: chain up correctly from finalize
	182
	183	commit 6d65db211035b5cf46b7539b649e922cadd48cc2
	184	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	185	Date: 2010-06-29 17:24:26 +0100
	186
	187	Adjust Valgrind suppressions for glibc
	188
	189	commit 2bb75441f5b84c3b3d05bb6c602d064ef1c34ba3
	190	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	191	Date: 2010-06-29 17:24:09 +0100
	192
	193	Drop valgrind suppression for dbus-glib < 0.76
	194
	195	We already require 0.82.
	196
	197	commit d95c55350c9ae457832df80abb60a6af5bdbe9ae
	198	Merge: d936dd9 ba2691f
	199	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	200	Date: 2010-06-29 11:34:03 +0100
	201
	202	Merge branch 'misc-from-contact-list'
	203
	204	Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	205
	206	commit ba2691f5c72e43bed6ab0d9a427b62cb01c93df5
	207	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	208	Date: 2010-06-18 14:52:22 +0100
	209
	210	util: add tp_simple_async_report_success_in_idle
	211
	212	commit 27b39353fff0b3891b3cd8bcd256b50b5b39c83c
	213	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	214	Date: 2010-06-28 14:35:08 +0100
	215
	216	tp_group_mixin_change_members: be more const-correct
	217
	218	commit d936dd9bbffb1992881f757898fafd972d796b88
	219	Merge: 7e63d00 9d2c909
	220	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	221	Date: 2010-06-23 12:45:11 +0100
	222
	223	Merge branch 'trivia'
	224
	225	Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	226
	227	commit 9d2c9092e5443dfcb44e8a9e4c753133121f6e42
	228	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	229	Date: 2010-06-23 12:01:01 +0100
	230
	231	tp_capabilities_get_channel_classes: spell the skip annotation correctly
	232
	233	commit f79116165362d9b16fdbd77630fb6cb8c0e9ad61
	234	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	235	Date: 2010-06-23 12:00:48 +0100
	236
	237	TpProxyClass: hide the tail of the struct from gtk-doc
	238
	239	The workaround for g-i/vapigen resulted in gtk-doc complaining that
	240	_internal_list_features was undocumented.
	241
	242	commit 7e63d00346361ec9975f5caa01eeb67d7f933764
	243	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	244	Date: 2010-06-22 15:46:03 +0100
	245
	246	Nano version
	247
0	248	commit 3c4334de8ec96e47a6efb0458a6d21cded37c08e
1	249	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2	250	Date: 2010-06-22 11:58:18 +0100

+28

-0

NEWS less more

	0	telepathy-glib 0.11.9 (2010-07-02)
	1	==================================
	2
	3	The “mistakenly displays 2 more bars than it should” release.
	4
	5	Enhancements:
	6
	7	❉ Updated spec to 0.19.8 (smcv):
	8	➠ generate code for some new properties, Conn.I.Cellular and
	9	Account.I.Storage
	10	➠ add convenience methods to TpAccount to access Account.Service
	11
	12	❉ Added tp_simple_async_report_success_in_idle, a convenience function to
	13	return "void" from an async method (smcv)
	14
	15	Fixes:
	16
	17	❉ Fixed libdbus errors when unregistering a TpBaseClient that isn't a
	18	Handler (cassidy)
	19
	20	❉ Made some TpGroupMixin methods more const-correct (smcv)
	21
	22	❉ Fixed some memory leaks in regression tests (smcv)
	23
	24	❉ Suppressed more valgrind false-positives (smcv, cassidy)
	25
	26	❉ Improved generation of experimental Vala bindings (treitter)
	27
0	28	telepathy-glib 0.11.8 (2010-06-22)
1	29	==================================
2	30

+19

-19

configure less more

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

701	701	# Identity of this package.
702	702	PACKAGE_NAME='Telepathy-GLib'
703	703	PACKAGE_TARNAME='telepathy-glib'
704		PACKAGE_VERSION='0.11.8'
705		PACKAGE_STRING='Telepathy-GLib 0.11.8'
	704	PACKAGE_VERSION='0.11.9'
	705	PACKAGE_STRING='Telepathy-GLib 0.11.9'
706	706	PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=tp-glib'
707	707	PACKAGE_URL=''
708	708

1525	1525	# Omit some internal or obsolete options to make the list less imposing.
1526	1526	# This message is too long to be a string in the A/UX 3.1 sh.
1527	1527	cat <<_ACEOF
1528		\`configure' configures Telepathy-GLib 0.11.8 to adapt to many kinds of systems.
	1528	\`configure' configures Telepathy-GLib 0.11.9 to adapt to many kinds of systems.
1529	1529
1530	1530	Usage: $0 [OPTION]... [VAR=VALUE]...
1531	1531

1595	1595
1596	1596	if test -n "$ac_init_help"; then
1597	1597	case $ac_init_help in
1598		short \| recursive ) echo "Configuration of Telepathy-GLib 0.11.8:";;
	1598	short \| recursive ) echo "Configuration of Telepathy-GLib 0.11.9:";;
1599	1599	esac
1600	1600	cat <<\_ACEOF
1601	1601

1742	1742	test -n "$ac_init_help" && exit $ac_status
1743	1743	if $ac_init_version; then
1744	1744	cat <<\_ACEOF
1745		Telepathy-GLib configure 0.11.8
	1745	Telepathy-GLib configure 0.11.9
1746	1746	generated by GNU Autoconf 2.65
1747	1747
1748	1748	Copyright (C) 2009 Free Software Foundation, Inc.

2234	2234	This file contains any messages produced by compilers while
2235	2235	running configure, to aid debugging if configure makes a mistake.
2236	2236
2237		It was created by Telepathy-GLib $as_me 0.11.8, which was
	2237	It was created by Telepathy-GLib $as_me 0.11.9, which was
2238	2238	generated by GNU Autoconf 2.65. Invocation command line was
2239	2239
2240	2240	$ $0 $@

3045	3045
3046	3046	# Define the identity of the package.
3047	3047	PACKAGE='telepathy-glib'
3048		VERSION='0.11.8'
	3048	VERSION='0.11.9'
3049	3049
3050	3050
3051	3051	cat >>confdefs.h <<_ACEOF

12189	12189	pkg_cv_VALA_CFLAGS="$VALA_CFLAGS"
12190	12190	elif test -n "$PKG_CONFIG"; then
12191	12191	if test -n "$PKG_CONFIG" && \
12192		{ { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"vala-1.0 >= 0.8.0.58-d033\""; } >&5
12193		($PKG_CONFIG --exists --print-errors "vala-1.0 >= 0.8.0.58-d033") 2>&5
	12192	{ { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"vala-1.0 >= 0.9.2.74-236cd\""; } >&5
	12193	($PKG_CONFIG --exists --print-errors "vala-1.0 >= 0.9.2.74-236cd") 2>&5
12194	12194	ac_status=$?
12195	12195	$as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
12196	12196	test $ac_status = 0; }; then
12197		pkg_cv_VALA_CFLAGS=`$PKG_CONFIG --cflags "vala-1.0 >= 0.8.0.58-d033" 2>/dev/null`
	12197	pkg_cv_VALA_CFLAGS=`$PKG_CONFIG --cflags "vala-1.0 >= 0.9.2.74-236cd" 2>/dev/null`
12198	12198	else
12199	12199	pkg_failed=yes
12200	12200	fi

12205	12205	pkg_cv_VALA_LIBS="$VALA_LIBS"
12206	12206	elif test -n "$PKG_CONFIG"; then
12207	12207	if test -n "$PKG_CONFIG" && \
12208		{ { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"vala-1.0 >= 0.8.0.58-d033\""; } >&5
12209		($PKG_CONFIG --exists --print-errors "vala-1.0 >= 0.8.0.58-d033") 2>&5
	12208	{ { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"vala-1.0 >= 0.9.2.74-236cd\""; } >&5
	12209	($PKG_CONFIG --exists --print-errors "vala-1.0 >= 0.9.2.74-236cd") 2>&5
12210	12210	ac_status=$?
12211	12211	$as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
12212	12212	test $ac_status = 0; }; then
12213		pkg_cv_VALA_LIBS=`$PKG_CONFIG --libs "vala-1.0 >= 0.8.0.58-d033" 2>/dev/null`
	12213	pkg_cv_VALA_LIBS=`$PKG_CONFIG --libs "vala-1.0 >= 0.9.2.74-236cd" 2>/dev/null`
12214	12214	else
12215	12215	pkg_failed=yes
12216	12216	fi

12230	12230	_pkg_short_errors_supported=no
12231	12231	fi
12232	12232	if test $_pkg_short_errors_supported = yes; then
12233		VALA_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors "vala-1.0 >= 0.8.0.58-d033" 2>&1`
	12233	VALA_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors "vala-1.0 >= 0.9.2.74-236cd" 2>&1`
12234	12234	else
12235		VALA_PKG_ERRORS=`$PKG_CONFIG --print-errors "vala-1.0 >= 0.8.0.58-d033" 2>&1`
	12235	VALA_PKG_ERRORS=`$PKG_CONFIG --print-errors "vala-1.0 >= 0.9.2.74-236cd" 2>&1`
12236	12236	fi
12237	12237	# Put the nasty error message in config.log where it belongs
12238	12238	echo "$VALA_PKG_ERRORS" >&5
12239	12239
12240		as_fn_error "Package requirements (vala-1.0 >= 0.8.0.58-d033) were not met:
	12240	as_fn_error "Package requirements (vala-1.0 >= 0.9.2.74-236cd) were not met:
12241	12241
12242	12242	$VALA_PKG_ERRORS
12243	12243

17100	17100	# report actual input values of CONFIG_FILES etc. instead of their
17101	17101	# values after options handling.
17102	17102	ac_log="
17103		This file was extended by Telepathy-GLib $as_me 0.11.8, which was
	17103	This file was extended by Telepathy-GLib $as_me 0.11.9, which was
17104	17104	generated by GNU Autoconf 2.65. Invocation command line was
17105	17105
17106	17106	CONFIG_FILES = $CONFIG_FILES

17166	17166	cat >>$CONFIG_STATUS <<_ACEOF \|\| ac_write_fail=1
17167	17167	ac_cs_config="`$as_echo "$ac_configure_args" \| sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
17168	17168	ac_cs_version="\\
17169		Telepathy-GLib config.status 0.11.8
	17169	Telepathy-GLib config.status 0.11.9
17170	17170	configured by $0, generated by GNU Autoconf 2.65,
17171	17171	with options \\"\$ac_cs_config\\"
17172	17172

-2

configure.ac less more

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

196	196
197	197	if test x$enable_vala_bindings = xyes; then
198	198	PKG_CHECK_MODULES(VALA,
199		[vala-1.0 >= 0.8.0.58-d033])
	199	[vala-1.0 >= 0.9.2.74-236cd])
200	200	have_vala=yes
201	201
202	202	AC_PATH_PROG(VALAC, valac, valac)

-0

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

65	65	<span class="refentrytitle"><a href="telepathy-glib-connection-presence.html">Connection Presence interface</a></span><span class="refpurpose"> — client-side wrappers for the Presence interface</span>
66	66	</dt>
67	67	<dt>
	68	<span class="refentrytitle"><a href="telepathy-glib-connection-cellular.html">Connection Cellular interface</a></span><span class="refpurpose"> — client-side wrappers for the Cellular interface</span>
	69	</dt>
	70	<dt>
68	71	<span class="refentrytitle"><a href="telepathy-glib-channel.html">TpChannel</a></span><span class="refpurpose"> — proxy object for a Telepathy channel</span>
69	72	</dt>
70	73	<dt>

-0

docs/reference/html/index.html less more

112	112	<span class="refentrytitle"><a href="telepathy-glib-connection-presence.html">Connection Presence interface</a></span><span class="refpurpose"> — client-side wrappers for the Presence interface</span>
113	113	</dt>
114	114	<dt>
	115	<span class="refentrytitle"><a href="telepathy-glib-connection-cellular.html">Connection Cellular interface</a></span><span class="refpurpose"> — client-side wrappers for the Cellular interface</span>
	116	</dt>
	117	<dt>
115	118	<span class="refentrytitle"><a href="telepathy-glib-channel.html">TpChannel</a></span><span class="refpurpose"> — proxy object for a Telepathy channel</span>
116	119	</dt>
117	120	<dt>

+40

-0

docs/reference/html/index.sgml less more

274	274	<ANCHOR id="TP-IFACE-QUARK-ACCOUNT:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT:CAPS">
275	275	<ANCHOR id="TP-IFACE-ACCOUNT-INTERFACE-AVATAR:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR:CAPS">
276	276	<ANCHOR id="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR:CAPS">
	277	<ANCHOR id="TP-IFACE-ACCOUNT-INTERFACE-STORAGE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-STORAGE:CAPS">
	278	<ANCHOR id="TP-IFACE-QUARK-ACCOUNT-INTERFACE-STORAGE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-STORAGE:CAPS">
277	279	<ANCHOR id="TP-IFACE-ACCOUNT-MANAGER:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER:CAPS">
278	280	<ANCHOR id="TP-IFACE-QUARK-ACCOUNT-MANAGER:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER:CAPS">
279	281	<ANCHOR id="TP-IFACE-DBUS-DAEMON:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON:CAPS">

300	302	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-BALANCE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-BALANCE:CAPS">
301	303	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES:CAPS">
302	304	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES:CAPS">
	305	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CELLULAR:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CELLULAR:CAPS">
	306	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CELLULAR:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CELLULAR:CAPS">
303	307	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS">
304	308	<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">
305	309	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS">

397	401	<ANCHOR id="TP-PROP-ACCOUNT-ICON:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-ICON:CAPS">
398	402	<ANCHOR id="TP-PROP-ACCOUNT-INTERFACES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACES:CAPS">
399	403	<ANCHOR id="TP-PROP-ACCOUNT-INTERFACE-AVATAR-AVATAR:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-AVATAR-AVATAR:CAPS">
	404	<ANCHOR id="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-IDENTIFIER:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-IDENTIFIER:CAPS">
	405	<ANCHOR id="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-PROVIDER:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-PROVIDER:CAPS">
	406	<ANCHOR id="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-RESTRICTIONS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-RESTRICTIONS:CAPS">
	407	<ANCHOR id="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-SPECIFIC-INFORMATION:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-SPECIFIC-INFORMATION:CAPS">
400	408	<ANCHOR id="TP-PROP-ACCOUNT-MANAGER-INTERFACES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INTERFACES:CAPS">
401	409	<ANCHOR id="TP-PROP-ACCOUNT-MANAGER-INVALID-ACCOUNTS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INVALID-ACCOUNTS:CAPS">
402	410	<ANCHOR id="TP-PROP-ACCOUNT-MANAGER-SUPPORTED-ACCOUNT-PROPERTIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-SUPPORTED-ACCOUNT-PROPERTIES:CAPS">

405	413	<ANCHOR id="TP-PROP-ACCOUNT-NORMALIZED-NAME:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-NORMALIZED-NAME:CAPS">
406	414	<ANCHOR id="TP-PROP-ACCOUNT-PARAMETERS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-PARAMETERS:CAPS">
407	415	<ANCHOR id="TP-PROP-ACCOUNT-REQUESTED-PRESENCE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-REQUESTED-PRESENCE:CAPS">
	416	<ANCHOR id="TP-PROP-ACCOUNT-SERVICE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-SERVICE:CAPS">
408	417	<ANCHOR id="TP-PROP-ACCOUNT-VALID:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-VALID:CAPS">
409	418	<ANCHOR id="TP-PROP-CHANNEL-CHANNEL-TYPE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-CHANNEL-TYPE:CAPS">
410	419	<ANCHOR id="TP-PROP-CHANNEL-DISPATCHER-INTERFACES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-DISPATCHER-INTERFACES:CAPS">

486	495	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-AVATARS-RECOMMENDED-AVATAR-WIDTH:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-RECOMMENDED-AVATAR-WIDTH:CAPS">
487	496	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-AVATARS-SUPPORTED-AVATAR-MIME-TYPES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-SUPPORTED-AVATAR-MIME-TYPES:CAPS">
488	497	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-BALANCE-ACCOUNT-BALANCE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-BALANCE-ACCOUNT-BALANCE:CAPS">
	498	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CELLULAR-IMSI:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-IMSI:CAPS">
	499	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-REDUCED-CHARACTER-SET:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-REDUCED-CHARACTER-SET:CAPS">
	500	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-SERVICE-CENTRE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-SERVICE-CENTRE:CAPS">
	501	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS">
489	502	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS">
490	503	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-CONTACT-INFO-FLAGS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-CONTACT-INFO-FLAGS:CAPS">
491	504	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-SUPPORTED-FIELDS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-SUPPORTED-FIELDS:CAPS">

497	510	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-SERVICE-POINT-KNOWN-SERVICE-POINTS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SERVICE-POINT-KNOWN-SERVICE-POINTS:CAPS">
498	511	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-SIMPLE-PRESENCE-STATUSES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SIMPLE-PRESENCE-STATUSES:CAPS">
499	512	<ANCHOR id="TP-PROP-CONNECTION-MANAGER-INTERFACES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-INTERFACES:CAPS">
	513	<ANCHOR id="TP-PROP-CONNECTION-MANAGER-PROTOCOLS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-PROTOCOLS:CAPS">
500	514	<ANCHOR id="TP-PROP-CONNECTION-INTERFACES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACES:CAPS">
501	515	<ANCHOR id="TP-PROP-CONNECTION-SELF-HANDLE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-SELF-HANDLE:CAPS">
502	516	<ANCHOR id="TP-PROP-CONNECTION-STATUS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-STATUS:CAPS">

805	819	<ANCHOR id="TP-ANONYMITY-MODE-CLIENT-INFO:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-ANONYMITY-MODE-CLIENT-INFO:CAPS">
806	820	<ANCHOR id="TP-ANONYMITY-MODE-SHOW-CLIENT-INFO:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-ANONYMITY-MODE-SHOW-CLIENT-INFO:CAPS">
807	821	<ANCHOR id="TP-ANONYMITY-MODE-NETWORK-INFO:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-ANONYMITY-MODE-NETWORK-INFO:CAPS">
	822	<ANCHOR id="TpStorageRestrictionFlags" href="telepathy-glib/telepathy-glib-enums.html#TpStorageRestrictionFlags">
	823	<ANCHOR id="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PARAMETERS:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PARAMETERS:CAPS">
	824	<ANCHOR id="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-ENABLED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-ENABLED:CAPS">
	825	<ANCHOR id="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PRESENCE:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PRESENCE:CAPS">
	826	<ANCHOR id="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-SERVICE:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-SERVICE:CAPS">
808	827	<ANCHOR id="telepathy-glib-errors" href="telepathy-glib/telepathy-glib-errors.html">
809	828	<ANCHOR id="telepathy-glib-errors.synopsis" href="telepathy-glib/telepathy-glib-errors.html#telepathy-glib-errors.synopsis">
810	829	<ANCHOR id="telepathy-glib-errors.description" href="telepathy-glib/telepathy-glib-errors.html#telepathy-glib-errors.description">

915	934	<ANCHOR id="TP-STRUCT-TYPE-SOCKET-NETMASK-IPV6:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-SOCKET-NETMASK-IPV6:CAPS">
916	935	<ANCHOR id="TP-STRUCT-TYPE-PARAM-SPEC:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-PARAM-SPEC:CAPS">
917	936	<ANCHOR id="TP-ARRAY-TYPE-PARAM-SPEC-LIST:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-PARAM-SPEC-LIST:CAPS">
	937	<ANCHOR id="TP-HASH-TYPE-PROTOCOL-PROPERTIES-MAP:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-HASH-TYPE-PROTOCOL-PROPERTIES-MAP:CAPS">
918	938	<ANCHOR id="TP-STRUCT-TYPE-CHANNEL-INFO:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CHANNEL-INFO:CAPS">
919	939	<ANCHOR id="TP-ARRAY-TYPE-CHANNEL-INFO-LIST:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CHANNEL-INFO-LIST:CAPS">
920	940	<ANCHOR id="TP-HASH-TYPE-ALIAS-MAP:CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-HASH-TYPE-ALIAS-MAP:CAPS">

1443	1463	<ANCHOR id="tp-cli-connection-interface-presence-connect-to-presence-update" href="telepathy-glib/telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-connect-to-presence-update">
1444	1464	<ANCHOR id="tp-cli-connection-interface-presence-signal-callback-presence-update" href="telepathy-glib/telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-signal-callback-presence-update">
1445	1465	<ANCHOR id="telepathy-glib-connection-presence.see-also" href="telepathy-glib/telepathy-glib-connection-presence.html#telepathy-glib-connection-presence.see-also">
	1466	<ANCHOR id="telepathy-glib-connection-cellular" href="telepathy-glib/telepathy-glib-connection-cellular.html">
	1467	<ANCHOR id="telepathy-glib-connection-cellular.synopsis" href="telepathy-glib/telepathy-glib-connection-cellular.html#telepathy-glib-connection-cellular.synopsis">
	1468	<ANCHOR id="telepathy-glib-connection-cellular.description" href="telepathy-glib/telepathy-glib-connection-cellular.html#telepathy-glib-connection-cellular.description">
	1469	<ANCHOR id="telepathy-glib-connection-cellular.details" href="telepathy-glib/telepathy-glib-connection-cellular.html#telepathy-glib-connection-cellular.details">
	1470	<ANCHOR id="tp-cli-connection-interface-cellular-connect-to-imsi-changed" href="telepathy-glib/telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-connect-to-imsi-changed">
	1471	<ANCHOR id="tp-cli-connection-interface-cellular-signal-callback-imsi-changed" href="telepathy-glib/telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-signal-callback-imsi-changed">
	1472	<ANCHOR id="telepathy-glib-connection-cellular.see-also" href="telepathy-glib/telepathy-glib-connection-cellular.html#telepathy-glib-connection-cellular.see-also">
1446	1473	<ANCHOR id="telepathy-glib-channel" href="telepathy-glib/telepathy-glib-channel.html">
1447	1474	<ANCHOR id="telepathy-glib-channel.synopsis" href="telepathy-glib/telepathy-glib-channel.html#telepathy-glib-channel.synopsis">
1448	1475	<ANCHOR id="TpChannel" href="telepathy-glib/telepathy-glib-channel.html#TpChannel">

1927	1954	<ANCHOR id="tp-account-get-connection-manager" href="telepathy-glib/telepathy-glib-account.html#tp-account-get-connection-manager">
1928	1955	<ANCHOR id="tp-account-get-protocol" href="telepathy-glib/telepathy-glib-account.html#tp-account-get-protocol">
1929	1956	<ANCHOR id="tp-account-get-icon-name" href="telepathy-glib/telepathy-glib-account.html#tp-account-get-icon-name">
	1957	<ANCHOR id="tp-account-get-service" href="telepathy-glib/telepathy-glib-account.html#tp-account-get-service">
1930	1958	<ANCHOR id="tp-account-set-enabled-async" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-enabled-async">
1931	1959	<ANCHOR id="tp-account-set-enabled-finish" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-enabled-finish">
1932	1960	<ANCHOR id="tp-account-reconnect-async" href="telepathy-glib/telepathy-glib-account.html#tp-account-reconnect-async">

1941	1969	<ANCHOR id="tp-account-set-display-name-finish" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-display-name-finish">
1942	1970	<ANCHOR id="tp-account-set-icon-name-async" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-icon-name-async">
1943	1971	<ANCHOR id="tp-account-set-icon-name-finish" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-icon-name-finish">
	1972	<ANCHOR id="tp-account-set-service-async" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-service-async">
	1973	<ANCHOR id="tp-account-set-service-finish" href="telepathy-glib/telepathy-glib-account.html#tp-account-set-service-finish">
1944	1974	<ANCHOR id="tp-account-request-presence-async" href="telepathy-glib/telepathy-glib-account.html#tp-account-request-presence-async">
1945	1975	<ANCHOR id="tp-account-request-presence-finish" href="telepathy-glib/telepathy-glib-account.html#tp-account-request-presence-finish">
1946	1976	<ANCHOR id="tp-account-get-connect-automatically" href="telepathy-glib/telepathy-glib-account.html#tp-account-get-connect-automatically">

1997	2027	<ANCHOR id="TpAccount--requested-presence-type" href="telepathy-glib/telepathy-glib-account.html#TpAccount--requested-presence-type">
1998	2028	<ANCHOR id="TpAccount--requested-status" href="telepathy-glib/telepathy-glib-account.html#TpAccount--requested-status">
1999	2029	<ANCHOR id="TpAccount--requested-status-message" href="telepathy-glib/telepathy-glib-account.html#TpAccount--requested-status-message">
	2030	<ANCHOR id="TpAccount--service" href="telepathy-glib/telepathy-glib-account.html#TpAccount--service">
2000	2031	<ANCHOR id="TpAccount--valid" href="telepathy-glib/telepathy-glib-account.html#TpAccount--valid">
2001	2032	<ANCHOR id="telepathy-glib-account.signal-details" href="telepathy-glib/telepathy-glib-account.html#telepathy-glib-account.signal-details">
2002	2033	<ANCHOR id="TpAccount-presence-changed" href="telepathy-glib/telepathy-glib-account.html#TpAccount-presence-changed">

2549	2580	<ANCHOR id="TpSvcConnectionInterfaceContactCapabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities">
2550	2581	<ANCHOR id="TpSvcConnectionInterfaceLocation" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation">
2551	2582	<ANCHOR id="TpSvcConnectionInterfaceContactInfo" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo">
	2583	<ANCHOR id="TpSvcConnectionInterfaceCellular" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular">
2552	2584	<ANCHOR id="telepathy-glib-svc-connection.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-connection.html#telepathy-glib-svc-connection.object-hierarchy">
2553	2585	<ANCHOR id="telepathy-glib-svc-connection.implementations" href="telepathy-glib/telepathy-glib-svc-connection.html#telepathy-glib-svc-connection.implementations">
2554	2586	<ANCHOR id="telepathy-glib-svc-connection.signals" href="telepathy-glib/telepathy-glib-svc-connection.html#telepathy-glib-svc-connection.signals">

2735	2767	<ANCHOR id="tp-svc-connection-interface-contact-info-return-from-request-contact-info" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-return-from-request-contact-info">
2736	2768	<ANCHOR id="tp-svc-connection-interface-contact-info-return-from-set-contact-info" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-return-from-set-contact-info">
2737	2769	<ANCHOR id="tp-svc-connection-interface-contact-info-set-contact-info-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-set-contact-info-impl">
	2770	<ANCHOR id="TpSvcConnectionInterfaceCellular-struct" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-struct">
	2771	<ANCHOR id="TpSvcConnectionInterfaceCellularClass" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellularClass">
	2772	<ANCHOR id="tp-svc-connection-interface-cellular-emit-imsi-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-cellular-emit-imsi-changed">
2738	2773	<ANCHOR id="telepathy-glib-svc-connection.signal-details" href="telepathy-glib/telepathy-glib-svc-connection.html#telepathy-glib-svc-connection.signal-details">
2739	2774	<ANCHOR id="TpSvcConnection-connection-error" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnection-connection-error">
2740	2775	<ANCHOR id="TpSvcConnection-new-channel" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnection-new-channel">

2752	2787	<ANCHOR id="TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed">
2753	2788	<ANCHOR id="TpSvcConnectionInterfaceLocation-location-updated" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated">
2754	2789	<ANCHOR id="TpSvcConnectionInterfaceContactInfo-contact-info-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed">
	2790	<ANCHOR id="TpSvcConnectionInterfaceCellular-i-ms-ichanged" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-i-ms-ichanged">
2755	2791	<ANCHOR id="telepathy-glib-svc-connection.see-also" href="telepathy-glib/telepathy-glib-svc-connection.html#telepathy-glib-svc-connection.see-also">
2756	2792	<ANCHOR id="telepathy-glib-svc-anonymity" href="telepathy-glib/telepathy-glib-svc-anonymity.html">
2757	2793	<ANCHOR id="telepathy-glib-svc-anonymity.synopsis" href="telepathy-glib/telepathy-glib-svc-anonymity.html#telepathy-glib-svc-anonymity.synopsis">

2909	2945	<ANCHOR id="telepathy-glib-svc-account.synopsis" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.synopsis">
2910	2946	<ANCHOR id="TpSvcAccount" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount">
2911	2947	<ANCHOR id="TpSvcAccountInterfaceAvatar" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar">
	2948	<ANCHOR id="TpSvcAccountInterfaceStorage" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorage">
2912	2949	<ANCHOR id="telepathy-glib-svc-account.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.object-hierarchy">
2913	2950	<ANCHOR id="telepathy-glib-svc-account.signals" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.signals">
2914	2951	<ANCHOR id="telepathy-glib-svc-account.description" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.description">

2929	2966	<ANCHOR id="TpSvcAccountInterfaceAvatar-struct" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct">
2930	2967	<ANCHOR id="TpSvcAccountInterfaceAvatarClass" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass">
2931	2968	<ANCHOR id="tp-svc-account-interface-avatar-emit-avatar-changed" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed">
	2969	<ANCHOR id="TpSvcAccountInterfaceStorage-struct" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorage-struct">
	2970	<ANCHOR id="TpSvcAccountInterfaceStorageClass" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorageClass">
2932	2971	<ANCHOR id="telepathy-glib-svc-account.signal-details" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.signal-details">
2933	2972	<ANCHOR id="TpSvcAccount-account-property-changed" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed">
2934	2973	<ANCHOR id="TpSvcAccount-removed" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount-removed">

3656	3695	<ANCHOR id="tp-clear-pointer" href="telepathy-glib/telepathy-glib-util.html#tp-clear-pointer">
3657	3696	<ANCHOR id="tp-clear-object" href="telepathy-glib/telepathy-glib-util.html#tp-clear-object">
3658	3697	<ANCHOR id="tp-clear-boxed" href="telepathy-glib/telepathy-glib-util.html#tp-clear-boxed">
	3698	<ANCHOR id="tp-simple-async-report-success-in-idle" href="telepathy-glib/telepathy-glib-util.html#tp-simple-async-report-success-in-idle">
3659	3699	<ANCHOR id="telepathy-glib-gnio-util" href="telepathy-glib/telepathy-glib-gnio-util.html">
3660	3700	<ANCHOR id="telepathy-glib-gnio-util.synopsis" href="telepathy-glib/telepathy-glib-gnio-util.html#telepathy-glib-gnio-util.synopsis">
3661	3701	<ANCHOR id="telepathy-glib-gnio-util.description" href="telepathy-glib/telepathy-glib-gnio-util.html#telepathy-glib-gnio-util.description">

+16

-16

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

118	118	<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpChannelGroupFlags" title="enum TpChannelGroupFlags"><span class="type">TpChannelGroupFlags</span></a> del</code></em>);
119	119	<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-TpGroupMixin.html#tp-group-mixin-change-members" title="tp_group_mixin_change_members ()">tp_group_mixin_change_members</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
120	120	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
121		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
122		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
123		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
124		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
	121	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
	122	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
	123	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
	124	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
125	125	<em class="parameter"><code><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> actor</code></em>,
126	126	<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpChannelGroupChangeReason" title="enum TpChannelGroupChangeReason"><span class="type">TpChannelGroupChangeReason</span></a> reason</code></em>);
127	127	<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-TpGroupMixin.html#tp-group-mixin-change-members-detailed" title="tp_group_mixin_change_members_detailed ()">tp_group_mixin_change_members_detailed</a>
128	128	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
129		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
130		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
131		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
132		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
	129	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
	130	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
	131	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
	132	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
133	133	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *details</code></em>);
134	134	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpGroupMixin.html#tp-group-mixin-add-handle-owner" title="tp_group_mixin_add_handle_owner ()">tp_group_mixin_add_handle_owner</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
135	135	<em class="parameter"><code><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> local_handle</code></em>,

1112	1112	<a name="tp-group-mixin-change-members"></a><h3>tp_group_mixin_change_members ()</h3>
1113	1113	<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_group_mixin_change_members (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
1114	1114	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
1115		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
1116		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
1117		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
1118		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
	1115	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
	1116	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
	1117	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
	1118	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
1119	1119	<em class="parameter"><code><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> actor</code></em>,
1120	1120	<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpChannelGroupChangeReason" title="enum TpChannelGroupChangeReason"><span class="type">TpChannelGroupChangeReason</span></a> reason</code></em>);</pre>
1121	1121	<p>

1200	1200	<a name="tp-group-mixin-change-members-detailed"></a><h3>tp_group_mixin_change_members_detailed ()</h3>
1201	1201	<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_group_mixin_change_members_detailed
1202	1202	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
1203		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
1204		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
1205		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
1206		<em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
	1203	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add</code></em>,
	1204	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *del</code></em>,
	1205	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_local_pending</code></em>,
	1206	<em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *add_remote_pending</code></em>,
1207	1207	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *details</code></em>);</pre>
1208	1208	<p>
1209	1209	Change the sets of members as given by the arguments, and emit the

+142

-1

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

64	64	const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()">tp_account_get_connection_manager</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
65	65	const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()">tp_account_get_protocol</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
66	66	const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-icon-name" title="tp_account_get_icon_name ()">tp_account_get_icon_name</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
	67	const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-service" title="tp_account_get_service ()">tp_account_get_service</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
67	68	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-async" title="tp_account_set_enabled_async ()">tp_account_set_enabled_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
68	69	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
69	70	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,

106	107	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
107	108	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
108	109	<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-finish" title="tp_account_set_icon_name_finish ()">tp_account_set_icon_name_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
	110	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
	111	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
	112	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()">tp_account_set_service_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
	113	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
	114	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
	115	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
	116	<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-service-finish" title="tp_account_set_service_finish ()">tp_account_set_service_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
109	117	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
110	118	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
111	119	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-request-presence-async" title="tp_account_request_presence_async ()">tp_account_request_presence_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,

284	292	"<a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title='The "requested-presence-type" property'>requested-presence-type</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
285	293	"<a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title='The "requested-status" property'>requested-status</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
286	294	"<a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title='The "requested-status-message" property'>requested-status-message</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
	295	"<a class="link" href="telepathy-glib-account.html#TpAccount--service" title='The "service" property'>service</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
287	296	"<a class="link" href="telepathy-glib-account.html#TpAccount--valid" title='The "valid" property'>valid</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
288	297	</pre>
289	298	</div>

608	617	<p class="since">Since 0.9.0</p>
609	618	</div>
610	619	<hr>
	620	<div class="refsect2" title="tp_account_get_service ()">
	621	<a name="tp-account-get-service"></a><h3>tp_account_get_service ()</h3>
	622	<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_service (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
	623	<p>
	624
	625	</p>
	626	<div class="variablelist"><table border="0">
	627	<col align="left" valign="top">
	628	<tbody>
	629	<tr>
	630	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	631	<td>an account
	632	</td>
	633	</tr>
	634	<tr>
	635	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	636	<td> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--service" title='The "service" property'><span class="type">"service"</span></a> property
	637
	638	</td>
	639	</tr>
	640	</tbody>
	641	</table></div>
	642	<p class="since">Since 0.11.UNRELEASED</p>
	643	</div>
	644	<hr>
611	645	<div class="refsect2" title="tp_account_set_enabled_async ()">
612	646	<a name="tp-account-set-enabled-async"></a><h3>tp_account_set_enabled_async ()</h3>
613	647	<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_enabled_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,

1114	1148	</tbody>
1115	1149	</table></div>
1116	1150	<p class="since">Since 0.9.0</p>
	1151	</div>
	1152	<hr>
	1153	<div class="refsect2" title="tp_account_set_service_async ()">
	1154	<a name="tp-account-set-service-async"></a><h3>tp_account_set_service_async ()</h3>
	1155	<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_service_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
	1156	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
	1157	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
	1158	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
	1159	<p>
	1160	Requests an asynchronous set of the Service property on <em class="parameter"><code>self</code></em>. When
	1161	the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
	1162	<a class="link" href="telepathy-glib-account.html#tp-account-set-service-finish" title="tp_account_set_service_finish ()"><code class="function">tp_account_set_service_finish()</code></a> to get the result of the operation.
	1163	</p>
	1164	<div class="variablelist"><table border="0">
	1165	<col align="left" valign="top">
	1166	<tbody>
	1167	<tr>
	1168	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	1169	<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
	1170	</td>
	1171	</tr>
	1172	<tr>
	1173	<td><p><span class="term"><em class="parameter"><code>service</code></em> :</span></p></td>
	1174	<td>a new service name, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or the empty string to unset the
	1175	service name (which will result in the <a class="link" href="telepathy-glib-account.html#TpAccount--service" title='The "service" property'><span class="type">"service"</span></a> property
	1176	becoming the same as <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title='The "protocol" property'><span class="type">"protocol"</span></a>)
	1177	</td>
	1178	</tr>
	1179	<tr>
	1180	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	1181	<td>a callback to call when the request is satisfied
	1182	</td>
	1183	</tr>
	1184	<tr>
	1185	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	1186	<td>data to pass to <em class="parameter"><code>callback</code></em>
	1187	</td>
	1188	</tr>
	1189	</tbody>
	1190	</table></div>
	1191	<p class="since">Since 0.11.UNRELEASED</p>
	1192	</div>
	1193	<hr>
	1194	<div class="refsect2" title="tp_account_set_service_finish ()">
	1195	<a name="tp-account-set-service-finish"></a><h3>tp_account_set_service_finish ()</h3>
	1196	<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_service_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
	1197	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
	1198	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
	1199	<p>
	1200	Finishes an async set of the Service parameter.
	1201	</p>
	1202	<div class="variablelist"><table border="0">
	1203	<col align="left" valign="top">
	1204	<tbody>
	1205	<tr>
	1206	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	1207	<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
	1208	</td>
	1209	</tr>
	1210	<tr>
	1211	<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
	1212	<td>a <a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
	1213	</td>
	1214	</tr>
	1215	<tr>
	1216	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	1217	<td>a <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill
	1218	</td>
	1219	</tr>
	1220	<tr>
	1221	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	1222	<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
	1223
	1224	</td>
	1225	</tr>
	1226	</tbody>
	1227	</table></div>
	1228	<p class="since">Since 0.11.UNRELEASED</p>
1117	1229	</div>
1118	1230	<hr>
1119	1231	<div class="refsect2" title="tp_account_request_presence_async ()">

2941	3053	<a name="TpAccount--protocol"></a><h3>The <code class="literal">"protocol"</code> property</h3>
2942	3054	<pre class="programlisting"> "protocol" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
2943	3055	<p>
2944		The account's protocol name.
	3056	The account's machine-readable protocol name, such as "jabber", "msn" or
	3057	"local-xmpp". Recommended names for most protocols can be found in the
	3058	Telepathy D-Bus Interface Specification.
2945	3059	</p>
2946	3060	<p>Default value: NULL</p>
2947	3061	<p class="since">Since 0.9.0</p>

2991	3105	</p>
2992	3106	<p>Default value: NULL</p>
2993	3107	<p class="since">Since 0.9.0</p>
	3108	</div>
	3109	<hr>
	3110	<div class="refsect2" title='The "service" property'>
	3111	<a name="TpAccount--service"></a><h3>The <code class="literal">"service"</code> property</h3>
	3112	<pre class="programlisting"> "service" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
	3113	<p>
	3114	A machine-readable name identifying a specific service to which this
	3115	account connects, or a copy of <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title='The "protocol" property'><span class="type">"protocol"</span></a> if there is no more
	3116	specific service.
	3117	</p>
	3118	<p>
	3119	Well-known names for various services can be found in the Telepathy D-Bus
	3120	Interface Specification.
	3121	</p>
	3122	<p>
	3123	For instance, accounts for the "jabber" protocol should have the service
	3124	names "google-talk", "ovi-chat", "facebook" and "lj-talk" for accounts
	3125	that connect to Google Talk, Ovi Chat, Facebook and Livejournal,
	3126	respectively, and this property will be "jabber" for accounts that
	3127	connect to a generic Jabber server.
	3128	</p>
	3129	<p>
	3130	To change this property, use
	3131	<a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()"><code class="function">tp_account_set_service_async()</code></a>.
	3132	</p>
	3133	<p>Default value: NULL</p>
	3134	<p class="since">Since 0.11.UNRELEASED</p>
2994	3135	</div>
2995	3136	<hr>
2996	3137	<div class="refsect2" title='The "valid" property'>

-1

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

234	234	<p>
235	235	</p>
236	236	<div class="example">
237		<a name="id581257"></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>
	237	<a name="id612188"></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>
238	238	<div class="example-contents">
239	239	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
240	240	<tbody>

+19

-16

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

88	88	<a name="tp-capabilities-get-channel-classes"></a><h3>tp_capabilities_get_channel_classes ()</h3>
89	89	<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> * tp_capabilities_get_channel_classes (<em class="parameter"><code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a> *self</code></em>);</pre>
90	90	<p>
91		</p>
92		<div class="variablelist"><table border="0">
93		<col align="left" valign="top">
94		<tbody>
95		<tr>
96		<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
97		<td>
98		</td>
99		</tr>
100		<tr>
101		<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
102		<td>
103		</td>
104		</tr>
105		</tbody>
106		</table></div>
	91
	92	</p>
	93	<div class="variablelist"><table border="0">
	94	<col align="left" valign="top">
	95	<tbody>
	96	<tr>
	97	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	98	<td>a <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a> object
	99	</td>
	100	</tr>
	101	<tr>
	102	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	103	<td> the same <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> as the <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--channel-classes" title='The "channel-classes" property'><span class="type">"channel-classes"</span></a> property
	104
	105	</td>
	106	</tr>
	107	</tbody>
	108	</table></div>
	109	<p class="since">Since 0.11.3</p>
107	110	</div>
108	111	<hr>
109	112	<div class="refsect2" title="tp_capabilities_is_specific_to_contact ()">

-3

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

2032	2032	Connect a handler to the signal MessageReceived.
2033	2033	</p>
2034	2034	<p>
2035		Signals that a message has been received and added to the pending messages queue. This MUST be emitted exactly once per emission of the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">Received</tp:dbus-ref> signal on the Text interface. <tp:rationale> The double signal-emission provides compatibility with older clients. Clients supporting Messages should listen for Messages.MessageReceived only (if the channel has the Messages interface) or Text.Received only (otherwise). </tp:rationale>
	2035	Signals that a message has been received and added to the pending messages queue. This MUST be emitted exactly once per emission of the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">Received</tp:dbus-ref> signal on the Text interface, for backwards-compatibility; clients SHOULD ignore the latter in favour of this signal if this interface is present, as mentioned in the introduction.
2036	2036	</p>
2037	2037	<div class="variablelist"><table border="0">
2038	2038	<col align="left" valign="top">

2108	2108	</tr>
2109	2109	<tr>
2110	2110	<td><p><span class="term"><em class="parameter"><code>arg_Content</code></em> :</span></p></td>
2111		<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The message content (see <tp:type>Message_Part</tp:type> for full details). If the message that was passed to SendMessage has a formatted text part that the connection manager recognises, but no text/plain alternative, the CM MUST use the formatted text part to generate a text/plain alternative which is also included in this signal argument.</p> <p>If the connection manager can predict that the message will be altered during transmission, this argument SHOULD reflect what other contacts will receive, rather than being a copy of the argument to SendMessage (if the message is truncated, formatting or alternatives are dropped, etc., then the edited version SHOULD appear in this signal).</p>
	2111	<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The message content (see <tp:type>Message_Part</tp:type> for full details). If the message that was passed to <tp:member-ref>SendMessage</tp:member-ref> has a formatted text part that the connection manager recognises, but no <tt>text/plain</tt> alternative, the CM MUST use the formatted text part to generate a <tt>text/plain</tt> alternative which is also included in this signal argument.</p> <p>If the connection manager can predict that the message will be altered during transmission, this argument SHOULD reflect what other contacts will receive, rather than being a copy of the argument to SendMessage (if the message is truncated, formatting or alternatives are dropped, etc., then the edited version SHOULD appear in this signal).</p>
2112	2112	</td>
2113	2113	</tr>
2114	2114	<tr>

2148	2148	Connect a handler to the signal MessageSent.
2149	2149	</p>
2150	2150	<p>
2151		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Signals that a message has been submitted for sending. This MUST be emitted exactly once per emission of the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">Sent</tp:dbus-ref> signal on the Text interface. This SHOULD be emitted as soon as the CM determines it's theoretically possible to send the message (e.g. the parameters are supported and correct).</p> <tp:rationale> <p>This signal allows a process that is not the caller of SendMessage to log sent messages. The double signal-emission provides compatibility with older clients. Clients supporting Messages should listen for Messages.MessageSent only (if the channel has the Messages interface) or Text.Sent only (otherwise).</p> </tp:rationale>
	2151	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Signals that a message has been submitted for sending. This MUST be emitted exactly once per emission of the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">Sent</tp:dbus-ref> signal on the Text interface, for backwards-compatibility; clients SHOULD ignore the latter if this interface is present, as mentioned in the introduction.</p> <p>This SHOULD be emitted as soon as the CM determines it's theoretically possible to send the message (e.g. the parameters are supported and correct).</p> <tp:rationale> <p>This signal allows a process that is not the caller of SendMessage to log sent messages.</p> </tp:rationale>
2152	2152	</p>
2153	2153	<div class="variablelist"><table border="0">
2154	2154	<col align="left" valign="top">

-2

docs/reference/html/telepathy-glib-channel.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-presence.html" title="Connection Presence interface">
	8	<link rel="prev" href="telepathy-glib-connection-cellular.html" title="Connection Cellular interface">
9	9	<link rel="next" href="telepathy-glib-channel-group.html" title="Group interface on Channels">
10	10	<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
11	11	<link rel="stylesheet" href="style.css" type="text/css">

13	13	<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14	14	<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
15	15	<tr valign="middle">
16		<td><a accesskey="p" href="telepathy-glib-connection-presence.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
	16	<td><a accesskey="p" href="telepathy-glib-connection-cellular.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17	17	<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
18	18	<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19	19	<th width="100%" align="center">telepathy-glib Reference Manual</th>

+179

-0

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

	0	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
	1	<html>
	2	<head>
	3	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	4	<title>Connection Cellular interface</title>
	5	<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
	6	<link rel="home" href="index.html" title="telepathy-glib Reference Manual">
	7	<link rel="up" href="ch-client.html" title="Client-side proxies">
	8	<link rel="prev" href="telepathy-glib-connection-presence.html" title="Connection Presence interface">
	9	<link rel="next" href="telepathy-glib-channel.html" title="TpChannel">
	10	<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
	11	<link rel="stylesheet" href="style.css" type="text/css">
	12	</head>
	13	<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
	14	<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
	15	<tr valign="middle">
	16	<td><a accesskey="p" href="telepathy-glib-connection-presence.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
	17	<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
	18	<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
	19	<th width="100%" align="center">telepathy-glib Reference Manual</th>
	20	<td><a accesskey="n" href="telepathy-glib-channel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
	21	</tr>
	22	<tr><td colspan="5" class="shortcuts">
	23	<a href="#telepathy-glib-connection-cellular.synopsis" class="shortcut">Top</a>
	24	\|
	25	<a href="#telepathy-glib-connection-cellular.description" class="shortcut">Description</a>
	26	</td></tr>
	27	</table>
	28	<div class="refentry" title="Connection Cellular interface">
	29	<a name="telepathy-glib-connection-cellular"></a><div class="titlepage"></div>
	30	<div class="refnamediv"><table width="100%"><tr>
	31	<td valign="top">
	32	<h2><span class="refentrytitle"><a name="telepathy-glib-connection-cellular.top_of_page"></a>Connection Cellular interface</span></h2>
	33	<p>Connection Cellular interface — client-side wrappers for the Cellular interface</p>
	34	</td>
	35	<td valign="top" align="right"></td>
	36	</tr></table></div>
	37	<div class="refsynopsisdiv" title="Synopsis">
	38	<a name="telepathy-glib-connection-cellular.synopsis"></a><h2>Synopsis</h2>
	39	<pre class="synopsis">
	40	#include <telepathy-glib/connection.h>
	41
	42	<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-connect-to-imsi-changed" title="tp_cli_connection_interface_cellular_connect_to_imsi_changed ()">tp_cli_connection_interface_cellular_connect_to_imsi_changed</a>
	43	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	44	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-signal-callback-imsi-changed" title="tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()"><span class="type">tp_cli_connection_interface_cellular_signal_callback_imsi_changed</span></a> callback</code></em>,
	45	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	46	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	47	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
	48	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
	49	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-signal-callback-imsi-changed" title="tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()">*tp_cli_connection_interface_cellular_signal_callback_imsi_changed</a>)
	50	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	51	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_IMSI</code></em>,
	52	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	53	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	54	</pre>
	55	</div>
	56	<div class="refsect1" title="Description">
	57	<a name="telepathy-glib-connection-cellular.description"></a><h2>Description</h2>
	58	<p>
	59	An interface for connections to cellular telephony (GSM, CDMA etc.), which
	60	provides properties and signals that aren't applicable to other protocols.
	61	</p>
	62	</div>
	63	<div class="refsect1" title="Details">
	64	<a name="telepathy-glib-connection-cellular.details"></a><h2>Details</h2>
	65	<div class="refsect2" title="tp_cli_connection_interface_cellular_connect_to_imsi_changed ()">
	66	<a name="tp-cli-connection-interface-cellular-connect-to-imsi-changed"></a><h3>tp_cli_connection_interface_cellular_connect_to_imsi_changed ()</h3>
	67	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_cellular_connect_to_imsi_changed
	68	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	69	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-signal-callback-imsi-changed" title="tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()"><span class="type">tp_cli_connection_interface_cellular_signal_callback_imsi_changed</span></a> callback</code></em>,
	70	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	71	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	72	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
	73	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
	74	<p>
	75	Connect a handler to the signal IMSIChanged.
	76	</p>
	77	<p>
	78	Emitted when the IMSI for the connection changes. This sort of thing is rare, but could happen on cellular phones that allow hot-swapping of SIM cards. In the case of SIM swapping, this signal would be emitted twice; the first time while the SIM is being ejected (with an empty string), and the second time after a new SIM has been inserted (assuming that the IMSI can be determined from the new SIM).
	79	</p>
	80	<div class="variablelist"><table border="0">
	81	<col align="left" valign="top">
	82	<tbody>
	83	<tr>
	84	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	85	<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
	86	</td>
	87	</tr>
	88	<tr>
	89	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	90	<td>Callback to be called when the signal is
	91	received
	92	</td>
	93	</tr>
	94	<tr>
	95	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	96	<td>User-supplied data for the callback
	97	</td>
	98	</tr>
	99	<tr>
	100	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	101	<td>Destructor for the user-supplied data, which
	102	will be called when this signal is disconnected, or
	103	before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	104	</td>
	105	</tr>
	106	<tr>
	107	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	108	<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
	109	if it is destroyed, this callback will automatically be
	110	disconnected
	111	</td>
	112	</tr>
	113	<tr>
	114	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	115	<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
	116	returned
	117	</td>
	118	</tr>
	119	<tr>
	120	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	121	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
	122	above, which can be used to disconnect the signal; or
	123	<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
	124	or has become invalid.
	125	</td>
	126	</tr>
	127	</tbody>
	128	</table></div>
	129	</div>
	130	<hr>
	131	<div class="refsect2" title="tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()">
	132	<a name="tp-cli-connection-interface-cellular-signal-callback-imsi-changed"></a><h3>tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()</h3>
	133	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_cellular_signal_callback_imsi_changed)
	134	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	135	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_IMSI</code></em>,
	136	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	137	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	138	<p>
	139	Represents the signature of a callback for the signal IMSIChanged.
	140	</p>
	141	<div class="variablelist"><table border="0">
	142	<col align="left" valign="top">
	143	<tbody>
	144	<tr>
	145	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	146	<td>The proxy on which <a class="link" href="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-connect-to-imsi-changed" title="tp_cli_connection_interface_cellular_connect_to_imsi_changed ()"><code class="function">tp_cli_connection_interface_cellular_connect_to_imsi_changed()</code></a>
	147	was called
	148	</td>
	149	</tr>
	150	<tr>
	151	<td><p><span class="term"><em class="parameter"><code>arg_IMSI</code></em> :</span></p></td>
	152	<td>The new IMSI value. This may be an empty string in the case where the IMSI is being reset or removed.
	153	</td>
	154	</tr>
	155	<tr>
	156	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	157	<td>User-supplied data
	158	</td>
	159	</tr>
	160	<tr>
	161	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	162	<td>User-supplied weakly referenced object
	163	</td>
	164	</tr>
	165	</tbody>
	166	</table></div>
	167	</div>
	168	</div>
	169	<div class="refsect1" title="See Also">
	170	<a name="telepathy-glib-connection-cellular.see-also"></a><h2>See Also</h2>
	171	<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
	172	</div>
	173	</div>
	174	<div class="footer">
	175	<hr>
	176	Generated by GTK-Doc V1.15</div>
	177	</body>
	178	</html>⏎

-2

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

1716	1716	</tr>
1717	1717	<tr>
1718	1718	<td><p><span class="term"><em class="parameter"><code>out_Protocols</code></em> :</span></p></td>
1719		<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: A array of string protocol identifiers supported by this manager
	1719	<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The keys of the <tp:member-ref>Protocols</tp:member-ref> map.
1720	1720	</td>
1721	1721	</tr>
1722	1722	<tr>

1845	1845	</tr>
1846	1846	<tr>
1847	1847	<td><p><span class="term"><em class="parameter"><code>out_Protocols</code></em> :</span></p></td>
1848		<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: A array of string protocol identifiers supported by this manager
	1848	<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The keys of the <tp:member-ref>Protocols</tp:member-ref> map.
1849	1849	</td>
1850	1850	</tr>
1851	1851	<tr>

-2

docs/reference/html/telepathy-glib-connection-presence.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-simple-presence.html" title="Connection SimplePresence interface">
9		<link rel="next" href="telepathy-glib-channel.html" title="TpChannel">
	9	<link rel="next" href="telepathy-glib-connection-cellular.html" title="Connection Cellular interface">
10	10	<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
11	11	<link rel="stylesheet" href="style.css" type="text/css">
12	12	</head>

17	17	<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
18	18	<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19	19	<th width="100%" align="center">telepathy-glib Reference Manual</th>
20		<td><a accesskey="n" href="telepathy-glib-channel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
	20	<td><a accesskey="n" href="telepathy-glib-connection-cellular.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
21	21	</tr>
22	22	<tr><td colspan="5" class="shortcuts">
23	23	<a href="#telepathy-glib-connection-presence.synopsis" class="shortcut">Top</a>

+45

-2

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

114	114	enum <a class="link" href="telepathy-glib-enums.html#TpServicePointType" title="enum TpServicePointType">TpServicePointType</a>;
115	115	#define <a class="link" href="telepathy-glib-enums.html#NUM-TP-SERVICE-POINT-TYPES:CAPS" title="NUM_TP_SERVICE_POINT_TYPES">NUM_TP_SERVICE_POINT_TYPES</a>
116	116	enum <a class="link" href="telepathy-glib-enums.html#TpAnonymityModeFlags" title="enum TpAnonymityModeFlags">TpAnonymityModeFlags</a>;
	117	enum <a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags">TpStorageRestrictionFlags</a>;
117	118	</pre>
118	119	</div>
119	120	<div class="refsect1" title="Description">

944	945	</tr>
945	946	<tr>
946	947	<td><p><a name="TP-CHANNEL-TEXT-MESSAGE-TYPE-DELIVERY-REPORT:CAPS"></a><span class="term"><code class="literal">TP_CHANNEL_TEXT_MESSAGE_TYPE_DELIVERY_REPORT</code></span></p></td>
947		<td> This message type MUST NOT appear unless the channel supports the DeliveryReporting interface. The message MUST be as defined by the DeliveryReporting interface.
	948	<td> A delivery report. This message type MUST NOT appear unless the channel supports the Messages interface; see Message_Part for the format that delivery reports must take.
948	949	</td>
949	950	</tr>
950	951	</tbody>

1308	1309	} TpDeliveryStatus;
1309	1310	</pre>
1310	1311	<p>
1311		The status of a message as indicated by a delivery report. If this enum is extended in future specifications, this should only be to add new, non-overlapping conditions (i.e. all failures should still be signalled as either Temporarily_Failed or Permanently_Failed). If additional detail is required (e.g. distinguishing between the various types of permanent failure) this will be done using additional keys in the Message_Part.
	1312	The status of a message as indicated by a delivery report. If this enum is extended in future specifications, this should only be to add new, non-overlapping conditions (i.e. all failures should still be signalled as either Temporarily_Failed or Permanently_Failed). If additional detail is required (e.g. distinguishing between the various types of permanent failure) this will be done using additional Delivery_Report_Header_Keys.
1312	1313	</p>
1313	1314	<p>
1314	1315	Bitfield/set of flags generated from the Telepathy specification.

2382	2383	</tbody>
2383	2384	</table></div>
2384	2385	</div>
	2386	<hr>
	2387	<div class="refsect2" title="enum TpStorageRestrictionFlags">
	2388	<a name="TpStorageRestrictionFlags"></a><h3>enum TpStorageRestrictionFlags</h3>
	2389	<pre class="programlisting">typedef enum {
	2390	TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PARAMETERS = 1,
	2391	TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_ENABLED = 2,
	2392	TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PRESENCE = 4,
	2393	TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_SERVICE = 8,
	2394	} TpStorageRestrictionFlags;
	2395	</pre>
	2396	<p>
	2397	Flags indicating restrictions imposed on an Account by its storage method.
	2398	</p>
	2399	<p>
	2400	Bitfield/set of flags generated from the Telepathy specification.
	2401	</p>
	2402	<div class="variablelist"><table border="0">
	2403	<col align="left" valign="top">
	2404	<tbody>
	2405	<tr>
	2406	<td><p><a name="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PARAMETERS:CAPS"></a><span class="term"><code class="literal">TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PARAMETERS</code></span></p></td>
	2407	<td> The account's Parameters property can't be changed by calling UpdateParameters.
	2408	</td>
	2409	</tr>
	2410	<tr>
	2411	<td><p><a name="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-ENABLED:CAPS"></a><span class="term"><code class="literal">TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_ENABLED</code></span></p></td>
	2412	<td> The account can't be enabled/disabled by setting the Enabled property.
	2413	</td>
	2414	</tr>
	2415	<tr>
	2416	<td><p><a name="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PRESENCE:CAPS"></a><span class="term"><code class="literal">TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PRESENCE</code></span></p></td>
	2417	<td> The account's presence can't be changed by setting the RequestedPresence and AutomaticPresence properties.
	2418	</td>
	2419	</tr>
	2420	<tr>
	2421	<td><p><a name="TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-SERVICE:CAPS"></a><span class="term"><code class="literal">TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_SERVICE</code></span></p></td>
	2422	<td> The account's Service property cannot be changed.
	2423	</td>
	2424	</tr>
	2425	</tbody>
	2426	</table></div>
	2427	</div>
2385	2428	</div>
2386	2429	</div>
2387	2430	<div class="footer">

+33

-4

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

58	58
59	59	#define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-PARAM-SPEC:CAPS" title="TP_STRUCT_TYPE_PARAM_SPEC">TP_STRUCT_TYPE_PARAM_SPEC</a>
60	60	#define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-PARAM-SPEC-LIST:CAPS" title="TP_ARRAY_TYPE_PARAM_SPEC_LIST">TP_ARRAY_TYPE_PARAM_SPEC_LIST</a>
	61	#define <a class="link" href="telepathy-glib-gtypes.html#TP-HASH-TYPE-PROTOCOL-PROPERTIES-MAP:CAPS" title="TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP">TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP</a>
61	62
62	63	#define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CHANNEL-INFO:CAPS" title="TP_STRUCT_TYPE_CHANNEL_INFO">TP_STRUCT_TYPE_CHANNEL_INFO</a>
63	64	#define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CHANNEL-INFO-LIST:CAPS" title="TP_ARRAY_TYPE_CHANNEL_INFO_LIST">TP_ARRAY_TYPE_CHANNEL_INFO_LIST</a>

528	529	</p>
529	530	</div>
530	531	<hr>
	532	<div class="refsect2" title="TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP">
	533	<a name="TP-HASH-TYPE-PROTOCOL-PROPERTIES-MAP:CAPS"></a><h3>TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP</h3>
	534	<pre class="programlisting">#define TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP (tp_type_dbus_hash_sa_7bsv_7d ())
	535	</pre>
	536	<p>
	537	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A map from protocol identifiers supported by a connection manager to the immutable properties of the corresponding <tp:dbus-ref namespace="org.freedesktop.Telepathy">Protocol.DRAFT</tp:dbus-ref> objects.</p>
	538	</p>
	539	<p>
	540	This macro expands to a call to a function
	541	that returns the <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>
	542	appropriate for representing a D-Bus
	543	dictionary of signature
	544	<code class="literal">a{sa{sv}}</code>.
	545	</p>
	546	<p>
	547	Keys (D-Bus type <code class="literal">s</code>,
	548	type <code class="literal">Protocol</code>,
	549	named <code class="literal">Protocol</code>):
	550	A protocol name
	551	</p>
	552	<p>
	553	Values (D-Bus type <code class="literal">a{sv}</code>,
	554	type <code class="literal">Qualified_Property_Value_Map</code>,
	555	named <code class="literal">Properties</code>):
	556	The immutable properties of the corresponding Protocol object
	557	</p>
	558	</div>
	559	<hr>
531	560	<div class="refsect2" title="TP_STRUCT_TYPE_CHANNEL_INFO">
532	561	<a name="TP-STRUCT-TYPE-CHANNEL-INFO:CAPS"></a><h3>TP_STRUCT_TYPE_CHANNEL_INFO</h3>
533	562	<pre class="programlisting">#define TP_STRUCT_TYPE_CHANNEL_INFO (tp_type_dbus_struct_osuu ())

1195	1224	Member 0 (D-Bus type <code class="literal">a{sv}</code>,
1196	1225	type <code class="literal">Channel_Class</code>,
1197	1226	named <code class="literal">Fixed_Properties</code>):
1198		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The property values that identify this requestable channel class. These properties MUST be included in requests for a channel of this class, and MUST take these values.</p> <p>Clients that do not understand the semantics of all the Fixed_Properties MUST NOT request channels of this class, since they would be unable to avoid making an incorrect request.</p> <p>This implies that connection managers wishing to make channels available to old or minimal clients SHOULD have a channel class with the minimum number of Fixed_Properties, and MAY additionally have channel classes with extra Fixed_Properties.</p>
	1227	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The property values that identify this requestable channel class. These properties MUST be included in requests for a channel of this class, and MUST take these values.</p> <p>Clients that do not understand the semantics of all the Fixed_Properties MUST NOT request channels of this class, since they would be unable to avoid making an incorrect request.</p> <p>This implies that connection managers wishing to make channels available to old or minimal clients SHOULD have a channel class with the minimum number of Fixed_Properties, and MAY additionally have channel classes with extra Fixed_Properties.</p> <p>Interface designers SHOULD avoid introducing fixed properties whose types are not serializable in a <code>.manager</code> file.</p> <tp:rationale> <p>Connection managers with a fixed property that is not serializable cannot have a complete <code>.manager</code> file.</p> </tp:rationale>
1199	1228	</p>
1200	1229	<p>
1201	1230	Member 1 (D-Bus type <code class="literal">as</code>,

1887	1916	<pre class="programlisting">#define TP_HASH_TYPE_MESSAGE_PART (tp_type_dbus_hash_sv ())
1888	1917	</pre>
1889	1918	<p>
1890		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Part of a message's content. In practice, this mapping never appears in isolation - messages are represented by a list of <tp:type>Message_Part</tp:type> mappings.</p> <p>An example of how a rich-text message, with an embedded image, might look, in a Python-like syntax:</p> <pre> [ { 'message-token': '9de9546a-3400-4419-a505-3ea270cb834c', 'message-sender': 42, 'message-sent': 1210067943, 'message-received': 1210067947, 'message-type': 0, # = Channel_Text_Message_Type_Normal 'pending-message-id': 437, }, { 'alternative': 'main', 'content-type': 'text/html', 'content': 'Here is a photo of my cat:&lt;br /&gt;' + '&lt;img src=&quot;cid:catphoto&quot; alt=&quot;lol!&quot; /&gt;' + '&lt;br /&gt;Isn't it cute?', }, { 'alternative': 'main', 'content-type': 'text/plain', 'content': 'Here is a photo of my cat:\n[IMG: lol!]\nIsn't it cute?', }, { 'identifier': 'catphoto', 'content-type': 'image/jpeg', 'size': 101000, 'needs-retrieval': True, }, ]</pre> <p>An example of how a non-text message — in particular, a vCard sent via SMS as implemented by telepathy-ring on Nokia's Maemo 5 — looks:</p> <pre> [ { 'message-token': '9de9546a-3400-4419-a505-3ea270cb834c', 'message-sender': 42, 'message-sent': 1210067943, 'message-received': 1210067947, 'message-type': 0, # = Channel_Text_Message_Type_Normal 'pending-message-id': 437, }, { 'content-type': 'text/x-vcard', 'content': [ 0x66, 0x69, 0x71, ...], # vCard data as an array of bytes }, ]</pre> <div> <p>The first part of the message contains &quot;headers&quot; which refer to the entire message.</p> <p>It is an error for a connection manager to put keys referring to the message as a whole in the second or subsequent Message_Part, but clients MUST recover from this error by ignoring these keys in the second and subsequent parts.</p> <tp:rationale> <p>Instead of representing messages as aa{sv} where the first dictionary is special (a dictionary of headers), we could have used a signature like (a{sv}aa{sv}) to separate out the headers and the body parts.</p> <p>However, this would make access to the messages more awkward. In Python, the syntax for access to a header field would remain <code>message[0]['message-type']</code>, but access to a body field in the second body part would change from message[2]['content'] to message[1][1]['content']. In GLib, the message would change from being a GPtrArray(GHashTable) to being a GValueArray(GHashTable, GPtrArray(GHashTable)) which is rather inconvenient to dereference.</p> </tp:rationale> <p>Well-known keys for the message as a whole, and the corresponding value types, include:</p> <dl> <dt>message-token (s)</dt> <dd> <p>An opaque, globally-unique identifier for the entire message. This MAY be treated as if it were a MIME Message-ID, e.g. for the mid: and cid: URI schemes. If omitted, there is no suitable token; the protocol-token key SHOULD be provided if the protocol identifies messages in some less unique way.</p> </dd> <dt>protocol-token (s - <tp:type>Protocol_Message_Token</tp:type>)</dt> <dd> <p>An opaque token for the entire message, with whatever uniqueness guarantee is provided by the underlying protocol. As described for the Protocol_Message_Token type, this token is <em>not</em> guaranteed to be unique between contacts, or even within the scope of a Channel.</p> <tp:rationale> <p>In practice, in most protocols there is no token with the uniqueness guarantees demanded for message-token; the definition of message-token was inappropriate, but must now be preserved for the benefit of clients that rely on it, at least until Telepathy breaks backwards compatibility.</p> </tp:rationale> <p>The message-token and protocol-token SHOULD NOT both be present; clients requiring an identifier with the semantics of the protocol-token SHOULD look for the message-token first, falling back to the protocol-token.</p> <tp:rationale> <p>This is for compatibility with CMs older than the protocol-token key.</p> </tp:rationale> </dd> <dt>message-sent (x - <tp:type>Unix_Timestamp64</tp:type>)</dt> <dd>The time the message was sent (if unavailable, the time it arrived at a central server MAY be used). Omitted if no reasonable approximation is available; SHOULD always be present on outgoing messages.</dd> <dt>message-received (x - <tp:type>Unix_Timestamp64</tp:type>)</dt> <dd>The time the message was received locally. SHOULD always be present.</dd> <dt>message-sender (u - <tp:type>Contact_Handle</tp:type>)</dt> <dd>The contact who sent the message. If 0 or omitted, the contact who sent the message could not be determined.</dd> <dt>sender-nickname (s)</dt> <dd>The nickname chosen by the sender of the message, which can be different for each message in a conversation.</dd> <dt>message-type (u - <tp:type>Channel_Text_Message_Type</tp:type>) </dt> <dd>The type of message; if omitted, Channel_Text_Message_Type_Normal MUST be assumed. MAY be omitted for normal chat messages.</dd> <dt>pending-message-id (u - <tp:type>Message_ID</tp:type>)</dt> <dd>The incoming message ID. This MUST NOT be present on outgoing messages. Clients SHOULD NOT store this key - it is only valid for as long as the message remains unacknowledged.</dd> <dt>interface (s - <tp:type>DBus_Interface</tp:type>)</dt> <dd>This message is specific to the given interface, which is neither Text nor Messages. It SHOULD be ignored if that interface is not supported. (Note that an 'interface' key can also appear on the second and subsequent parts, where it indicates that that part (only) should be ignored if unsupported.)</dd> <dt>scrollback (b)</dt> <dd>If present and true, the incoming message was part of a replay of message history (this matches the Scrollback flag in <tp:type>Channel_Text_Message_Flags</tp:type>). This flag does not make sense on outgoing messages and SHOULD NOT appear there.</dd> <dt>rescued (b)</dt> <dd>If present and true, the incoming message has been seen in a previous channel during the lifetime of the Connection, but had not been acknowledged when that channel closed, causing an identical channel (in which the message now appears) to open. This matches the Rescued flag in <tp:type>Channel_Text_Message_Flags</tp:type>; it does not make sense on outgoing messages, and SHOULD NOT appear there.</dd> </dl> </div> <div> <p>The second and subsequent parts contain the message's content, including plain text, formatted text and/or attached files.</p> <p>It is an error for a connection manager to put keys referring to the message body in the first Message_Part; clients MUST recover from this error by ignoring these keys in first part.</p> <p>In any group of parts with the same non-empty value for the &quot;alternative&quot; key (which represent alternative versions of the same content), more faithful versions of the intended message MUST come before less faithful versions (note that this order is the opposite of MIME &quot;multipart/alternative&quot; parts). Clients SHOULD display the first alternative that they understand.</p> <tp:rationale> <p>Specifying the preference order means that if the underlying protocol doesn't support alternatives, the CM can safely delete everything apart from the first supported alternative when sending messages.</p> <p>The order is the reverse of MIME because MIME's rationale for placing the &quot;plainest&quot; part first (legibility in pre-MIME UAs) does not apply to us, and placing the most preferred part first simplifies display (a client can iterate the message in order, display the first alternative that it understands, and skip displaying all subsequent parts with the same &quot;alternative&quot; key).</p> </tp:rationale> <p>Clients SHOULD present all parts that are not redundant alternatives in the order they appear in this array, possibly excluding parts that are referenced by another displayed part. It is implementation-specific how the parts are presented to the user.</p> <tp:rationale> <p>This allows CMs to assume that all parts are actually shown to the user, even if they are not explicitly referenced - we do not yet recommend formatted text, and there is no way for plain text to reference an attachment since it has no concept of markup or references. This also forces clients to do something sensible with messages that consist entirely of &quot;attachments&quot;, with no &quot;body&quot; at all.</p> <p>For instance, when displaying the above example, a client that understands the HTML part should display the JPEG image once, between the two lines &quot;Here is a photo of my cat:&quot; and &quot;Isn't it cute?&quot;; it may additionally present the image in some way for a second time, after &quot;Isn't it cute?&quot;, or may choose not to.</p> <p>A client that does not understand HTML, displaying the same message, should display the plain-text part, followed by the JPEG image.</p> </tp:rationale> <p>Well-known keys for the second and subsequent parts, and the corresponding value types, include:</p> <dl> <dt>identifier (s)</dt> <dd>An opaque identifier for this part. Parts of a message MAY reference other parts by treating this identifier as if it were a MIME Content-ID and using the cid: URI scheme.</dd> <dt>alternative (s)</dt> <dd> <p>If present, this part of the message is an alternative for all other parts with the same value for &quot;alternative&quot;. Clients SHOULD only display one of them (this is expected to be used for XHTML messages in a future version of this specification).</p> <p>If omitted, this part is not an alternative for any other part.</p> <p>Parts of a message MAY reference the group of alternatives as a whole (i.e. a reference to whichever of them is chosen) by treating this identifier as if it were the MIME Content-ID of a multipart/alternative part, and using the cid: URI scheme.</p> </dd> <dt>content-type (s)</dt> <dd> <p>The MIME type of this part. See the documentation for ReceivedMessage for notes on the special status of &quot;text/plain&quot; parts.</p> <p>Connection managers MUST NOT signal parts without a 'content-type' key; if a protocol provides no way to determine the MIME type, the connection manager is responsible for guessing it, but MAY fall back to &quot;text/plain&quot; for text and &quot;application/octet-stream&quot; for non-text.</p> <p>Clients MUST ignore parts without a 'content-type' key, which are reserved for future expansion.</p> </dd> <dt>lang (s)</dt> <dd>The natural language of this part, identified by a RFC 3066 language tag. <tp:rationale> XMPP allows alternative-selection by language as well as by content-type. </tp:rationale> </dd> <dt>size (u)</dt> <dd>The size in bytes (if needs-retrieval is true, this MAY be an estimated or approximate size). SHOULD be omitted if 'content' is provided. <tp:rationale> There's no point in providing the size if you're already providing all the content. </tp:rationale> </dd> <dt>thumbnail (b)</dt> <dd> <p>This part is a thumbnail. To represent an image together with its thumbnail in a single message, there should be one part for the full image followed by a part for the thumbnail (following the “more complete versions first” requirement), with the same 'alternative' value. For example:</p> <pre> [ ... , { 'alternative': 'catphoto', 'content-type': 'image/jpeg', 'size': 150000, 'content': [0xFF, 0xD8, ... 0xFF 0xD9], }, { 'alternative': 'catphoto', 'content-type': 'image/jpeg' 'size': 1024, 'thumbnail': True, 'content': [0xFF, 0xD8, ... 0xFF 0xD9], }, ... ] </pre> </dd> <dt>needs-retrieval (b)</dt> <dd>If false or omitted, the connection manager already holds this part in memory. If present and true, this part will be retrieved on demand (like MIME's message/external-body), so clients should expect retrieval to take time; if this specification is later extended to provide a streaming version of GetPendingMessageContent, clients should use it for parts with this flag.</dd> <dt>truncated (b)</dt> <dd>The content available via the 'content' key or GetPendingMessageContent has been truncated by the server or connection manager (equivalent to Channel_Text_Message_Flag_Truncated in the Text interface). </dd> <dt>content (s or ay)</dt> <dd>The part's content, if it is available and sufficiently small to include here (implies that 'needs-retrieval' is false or omitted). Otherwise, omitted. If the part is human-readable text or HTML, the value for this key MUST be a UTF-8 string (D-Bus signature 's'). If the part is not text, the value MUST be a byte-array (D-Bus signature 'ay'). If the part is a text-based format that is not the main body of the message (e.g. an iCalendar or an attached XML document), the value SHOULD be a UTF-8 string, transcoding from another charset to UTF-8 if necessary, but MAY be a byte-array (of unspecified character set) if transcoding fails or the source charset is not known.</dd> <!-- FIXME: "sufficiently small to include" is not currently defined; we should add some API so clients can tell the CM how large a message it should emit in the signal.--> <dt>interface (s - <tp:type>DBus_Interface</tp:type>)</dt> <dd>This part is specific to the given interface, which is neither Text nor Messages. It SHOULD be ignored if that interface is not supported. (Note that an 'interface' key can also appear on the first part, where it indicates that the entire message should be ignored if unsupported.)</dd> </dl> </div> <div> <p>Delivery reports are also represented as messages, of type Channel_Text_Message_Type_Delivery_Report, with the Non_Text_Content flag in the Text interface.</p> <p>Whenever a message of type Channel_Text_Message_Type_Delivery_Report is signalled for a delivery error report, Channel.Type.Text.SendError SHOULD also be emitted; whenever Channel.Type.Text.SendError is emitted by a channel which supports this interface, a message of type Channel_Text_Message_Type_Delivery_Report MUST also be emitted.</p> <p>The corresponding message in the Messages interface MUST contain &quot;headers&quot; for the delivery report, as specified below, in its first Message_Part.</p> <dl> <dt>message-sender (u - Contact_Handle as defined above)</dt> <dd>MUST be the intended recipient of the original message, if available (zero or omitted if the intended recipient is unavailable or is not a contact, e.g. a chatroom), even if the delivery report actually came from an intermediate server.</dd> <dt>message-type (u - Channel_Text_Message_Type as defined above)</dt> <dd>MUST be Channel_Text_Message_Type_Delivery_Report.</dd> <dt>delivery-status (u - Delivery_Status)</dt> <dd>The status of the message. All delivery reports MUST contain this key in the first Message_Part.</dd> <dt>delivery-token (s - <tp:type>Protocol_Message_Token</tp:type>)</dt> <dd> <p>An identifier for the message to which this delivery report refers. MUST NOT be an empty string. Omitted if not available.</p> <p>Clients may match this against the token produced by the SendMessage method and MessageSent signal. A status report with no token could match any sent message, and a sent message with an empty token could match any status report. If multiple sent messages match, clients SHOULD use some reasonable heuristic.</p> <tp:rationale> In an ideal world, we could unambiguously match reports against messages; however, deployed protocols are not ideal, and not all reports and messages can be matched. </tp:rationale> </dd> <dt>delivery-error (u - Channel_Text_Send_Error)</dt> <dd> The reason for the failure. MUST be omitted if this was a successful delivery; SHOULD be omitted if it would be Channel_Text_Send_Error_Unknown. </dd> <dt>delivery-dbus-error (s - DBus_Error_Name)</dt> <dd> The reason for the failure, specified as a (possibly implementation-specific) D-Bus error. MUST be omitted if this was a successful delivery. If set, the 'delivery-error' key SHOULD be set to the closest available value. </dd> <dt>delivery-error-message (s)</dt> <dd> Debugging information on why the message could not be delivered. MUST be omitted if this was a successful delivery; MAY always be omitted. </dd> <dt>delivery-echo (aa{sv} - Message_Part[])</dt> <dd> <p>The message content, as defined by the Messages interface. Omitted if no content is available. Content MAY have been truncated, message parts MAY have been removed, and message parts MAY have had their content removed (i.e. the message part metadata is present, but the 'content' key is not).</p> <tp:rationale> Some protocols, like XMPP, echo the failing message back to the sender. This is sometimes the only way to match it against the sent message, so we include it here. </tp:rationale> <p>Unlike in the Messages interface, content not visible in the value for this key cannot be retrieved by another means, so the connection manager SHOULD be more aggressive about including (possibly truncated) message content in the 'content' key.</p> <tp:rationale> The Messages interface needs to allow all content to be retrieved, but in this interface, the content we provide is merely a hint; so some is better than none, and it doesn't seem worth providing an API as complex as Messages' GetPendingMessageContent for the echoed message. </tp:rationale> </dd> </dl> <p>The second and subsequent Message_Part dictionaries, if present, are a human-readable report from the IM service.</p> <p>Clients MUST NOT attempt to send delivery reports using the SendMessage method in the Messages API, and connection managers MUST NOT allow this to be done. If support for sending delivery reports is later added, it will be part of this interface.</p> <p>Some example delivery reports in a Python-like syntax (in which arrays are indicated by [a, b] and dictionaries by {k1: v1, k2: v2}) follow.</p> <dl> <dt>A minimal delivery report indicating permanent failure of the sent message whose token was <code>b9a991bd-8845-4d7f-a704-215186f43bb4</code> for an unknown reason</dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Permanently_Failed, 'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4', } # no body ] </pre></dd> <dt>A delivery report where the failed message is echoed back to the sender rather than being referenced by ID, and the failure reason is that this protocol cannot send messages to offline contacts such as the contact with handle 123</dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Temporarily_Failed, 'delivery-error': Channel_Text_Send_Error_Offline, 'delivery-echo': [{ # header of original message 'message-sender': 1, 'message-sent': 1210067943, }, { # body of original message 'content-type': 'text/plain', 'content': 'Hello, world!', }] ], # no body ] </pre></dd> <dt>A maximally complex delivery report: the server reports a bilingual human-readable failure message because the user sent a message &quot;Hello, world!&quot; with token <code>b9a991bd-8845-4d7f-a704-215186f43bb4</code> to a contact with handle 123, but that handle represents a contact who does not actually exist</dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Permanently_Failed, 'delivery-error': Channel_Text_Send_Error_Invalid_Contact, 'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4', 'delivery-echo': [{ # header of original message 'message-sender': 1, 'message-sent': 1210067943, }, { # body of original message 'content-type': 'text/plain', 'content': 'Hello, world!', }] ], }, { # message from server (alternative in English) 'alternative': '404', 'content-type': 'text/plain', 'lang': 'en', 'content': 'I have no contact with that name', }, { # message from server (alternative in German) 'alternative': '404'. 'content-type': 'text/plain', 'lang': 'de', 'content', 'Ich habe keinen Kontakt mit diesem Namen', } ] </pre></dd> <dt>A minimal delivery report indicating successful delivery of the sent message whose token was <code>b9a991bd-8845-4d7f-a704-215186f43bb4</code></dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Delivered, 'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4', } # no body ] </pre></dd> </dl> </div>
	1919	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Part of a message's content. In practice, this mapping never appears in isolation: incoming messages are represented by a list of <tp:type>Message_Part</tp:type> mappings in the <tp:member-ref>MessageReceived</tp:member-ref> signal, and outgoing messages are passed to <tp:member-ref>SendMessage</tp:member-ref> as a list of these mappings.</p> <p>The first part of the message contains &quot;headers&quot;, which refer to the entire message. The second and subsequent parts contain the message's content, including plain text, formatted text and/or attached files. Well-known keys for the header and body parts are defined by the <tp:type>Message_Header_Key</tp:type> and <tp:type>Message_Body_Key</tp:type> types, respectively. It is an error for a connection manager to put keys referring to the message as a whole in the second or subsequent Message_Part, or keys intended for body parts in the first Message_Part; clients MUST recover from this error by ignoring these mis-placed keys.</p> <tp:rationale> <p>Instead of representing messages as aa{sv} where the first dictionary is special (a dictionary of headers), we could have used a signature like (a{sv}aa{sv}) to separate out the headers and the body parts.</p> <p>However, this would make access to the messages more awkward. In Python, the syntax for access to a header field would remain <code>message[0]['message-type']</code>, but access to a body field in the second body part would change from <code>message[2]['content'] to message[1][1]['content']</code>. In GLib, the message would change from being a <code>GPtrArray(GHashTable)</code> to being a <code>GValueArray(GHashTable, GPtrArray(GHashTable))</code> which is rather inconvenient to dereference.</p> </tp:rationale> <p>In any group of parts with the same non-empty value for the <tt>alternative</tt> key (which represent alternative versions of the same content), more faithful versions of the intended message MUST come before less faithful versions (note that this order is the opposite of MIME <tt>multipart/alternative</tt> parts). Clients SHOULD display the first alternative that they understand.</p> <tp:rationale> <p>Specifying the preference order means that if the underlying protocol doesn't support alternatives, the CM can safely delete everything apart from the first supported alternative when sending messages.</p> <p>The order is the reverse of MIME because MIME's rationale for placing the &quot;plainest&quot; part first (legibility in pre-MIME UAs) does not apply to us, and placing the most preferred part first simplifies display (a client can iterate the message in order, display the first alternative that it understands, and skip displaying all subsequent parts with the same &quot;alternative&quot; key).</p> </tp:rationale> <p>Clients SHOULD present all parts that are not redundant alternatives in the order they appear in this array, possibly excluding parts that are referenced by another displayed part. It is implementation-specific how the parts are presented to the user.</p> <tp:rationale> <p>This allows CMs to assume that all parts are actually shown to the user, even if they are not explicitly referenced - we do not yet recommend formatted text, and there is no way for plain text to reference an attachment since it has no concept of markup or references. This also forces clients to do something sensible with messages that consist entirely of &quot;attachments&quot;, with no &quot;body&quot; at all.</p> <p>For instance, when displaying the above example, a client that understands the HTML part should display the JPEG image once, between the two lines &quot;Here is a photo of my cat:&quot; and &quot;Isn't it cute?&quot;; it may additionally present the image in some way for a second time, after &quot;Isn't it cute?&quot;, or may choose not to.</p> <p>A client that does not understand HTML, displaying the same message, should display the plain-text part, followed by the JPEG image.</p> </tp:rationale> <h4>Example messages</h4> <p>A rich-text message, with an embedded image, might be represented as:</p> <pre> [ { 'message-token': '9de9546a-3400-4419-a505-3ea270cb834c', 'message-sender': 42, 'message-sent': 1210067943, 'message-received': 1210067947, 'message-type': 0, # = Channel_Text_Message_Type_Normal 'pending-message-id': 437, }, { 'alternative': 'main', 'content-type': 'text/html', 'content': 'Here is a photo of my cat:&lt;br /&gt;' + '&lt;img src=&quot;cid:catphoto&quot; alt=&quot;lol!&quot; /&gt;' + '&lt;br /&gt;Isn't it cute?', }, { 'alternative': 'main', 'content-type': 'text/plain', 'content': 'Here is a photo of my cat:\n[IMG: lol!]\nIsn't it cute?', }, { 'identifier': 'catphoto', 'content-type': 'image/jpeg', 'size': 101000, 'needs-retrieval': True, }, ]</pre> <p>telepathy-ring, Nokia's GSM connection manager, represents vCards sent via SMS as:</p> <pre> [ { 'message-token': '9de9546a-3400-4419-a505-3ea270cb834c', 'message-sender': 42, 'message-sent': 1210067943, 'message-received': 1210067947, 'message-type': 0, # = Channel_Text_Message_Type_Normal 'pending-message-id': 437, }, { 'content-type': 'text/x-vcard', 'content': [ 0x66, 0x69, 0x71, ...], # vCard data as an array of bytes }, ]</pre> <h3>Delivery reports</h3> <div> <p>Delivery reports are also represented as messages with the <tt>message-type</tt> header mapping to <tp:type>Channel_Text_Message_Type</tp:type> Delivery_Report. Delivery reports SHOULD contain the <tt>message-sender</tt> header, mapping to the intended recipient of the original message, if possible; other headers specific to delivery reports are defined by the <tp:type>Delivery_Report_Header_Key</tp:type> type. The second and subsequent parts, if present, are a human-readable report from the IM service.</p> <p>For backwards- and forwards-compatibility, whenever a delivery error report is signalled—that is, with <tt>delivery-status</tt> mapping to <tp:type>Delivery_Status</tp:type> Temporarily_Failed or Permanently_Failed—<tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">SendError</tp:dbus-ref> SHOULD also be emitted; whenever <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">SendError</tp:dbus-ref> is emitted, a delivery report MUST also be signalled. Delivery report messages on this interface MUST be represented in emissions of <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.Text">Received</tp:dbus-ref> as messages with the Non_Text_Content <tp:type>Channel_Text_Message_Flags</tp:type>; clients which understand this interface SHOULD ignore the SendError signal in favour of listening for delivery reports, as mentioned in the introduction.</p> <p>The result of attempting to send delivery reports using <tp:member-ref>SendMessage</tp:member-ref> is currently undefined.</p> <h4>Example delivery reports</h4> <dl> <dt>A minimal delivery report indicating permanent failure of the sent message whose token was <code>b9a991bd-8845-4d7f-a704-215186f43bb4</code> for an unknown reason</dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Permanently_Failed, 'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4', } # no body ]</pre></dd> <dt>A delivery report where the failed message is echoed back to the sender rather than being referenced by ID, and the failure reason is that this protocol cannot send messages to offline contacts such as the contact with handle 123</dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Temporarily_Failed, 'delivery-error': Channel_Text_Send_Error_Offline, 'delivery-echo': [{ # header of original message 'message-sender': 1, 'message-sent': 1210067943, }, { # body of original message 'content-type': 'text/plain', 'content': 'Hello, world!', }] ], # no body ]</pre></dd> <dt>A maximally complex delivery report: the server reports a bilingual human-readable failure message because the user sent a message &quot;Hello, world!&quot; with token <code>b9a991bd-8845-4d7f-a704-215186f43bb4</code> to a contact with handle 123, but that handle represents a contact who does not actually exist</dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Permanently_Failed, 'delivery-error': Channel_Text_Send_Error_Invalid_Contact, 'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4', 'delivery-echo': [{ # header of original message 'message-sender': 1, 'message-sent': 1210067943, }, { # body of original message 'content-type': 'text/plain', 'content': 'Hello, world!', }] ], }, { # message from server (alternative in English) 'alternative': '404', 'content-type': 'text/plain', 'lang': 'en', 'content': 'I have no contact with that name', }, { # message from server (alternative in German) 'alternative': '404'. 'content-type': 'text/plain', 'lang': 'de', 'content', 'Ich habe keinen Kontakt mit diesem Namen', } ]</pre></dd> <dt>A minimal delivery report indicating successful delivery of the sent message whose token was <code>b9a991bd-8845-4d7f-a704-215186f43bb4</code></dt> <dd><pre> [{ # header 'message-sender': 123, 'message-type': Channel_Text_Message_Type_Delivery_Report, 'delivery-status': Delivery_Status_Delivered, 'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4', } # no body ]</pre></dd> </dl> </div>
1891	1920	</p>
1892	1921	<p>
1893	1922	This macro expands to a call to a function

1899	1928	<p>
1900	1929	Keys (D-Bus type <code class="literal">s</code>,
1901	1930	named <code class="literal">Key</code>):
1902		A key, which SHOULD be one of the well-known keys specified, if possible.
	1931	A key, which SHOULD be one of the well-known keys specified by <tp:type>Message_Header_Key</tp:type>, <tp:type>Message_Body_Key</tp:type> or <tp:type>Delivery_Report_Header_Key</tp:type> if possible.
1903	1932	</p>
1904	1933	<p>
1905	1934	Values (D-Bus type <code class="literal">v</code>,
1906	1935	named <code class="literal">Value</code>):
1907		The value corresponding to the given key, which must be of one of the types indicated.
	1936	The value corresponding to the given key, which SHOULD be one of the specified types for well-known keys.
1908	1937	</p>
1909	1938	</div>
1910	1939	<hr>

+126

-0

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

44	44	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT:CAPS" title="TP_IFACE_QUARK_ACCOUNT">TP_IFACE_QUARK_ACCOUNT</a>
45	45	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR:CAPS" title="TP_IFACE_ACCOUNT_INTERFACE_AVATAR">TP_IFACE_ACCOUNT_INTERFACE_AVATAR</a>
46	46	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR:CAPS" title="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR">TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</a>
	47	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-STORAGE:CAPS" title="TP_IFACE_ACCOUNT_INTERFACE_STORAGE">TP_IFACE_ACCOUNT_INTERFACE_STORAGE</a>
	48	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-STORAGE:CAPS" title="TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE">TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE</a>
47	49	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER:CAPS" title="TP_IFACE_ACCOUNT_MANAGER">TP_IFACE_ACCOUNT_MANAGER</a>
48	50	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER:CAPS" title="TP_IFACE_QUARK_ACCOUNT_MANAGER">TP_IFACE_QUARK_ACCOUNT_MANAGER</a>
49	51	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON:CAPS" title="TP_IFACE_DBUS_DAEMON">TP_IFACE_DBUS_DAEMON</a>

70	72	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-BALANCE:CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_BALANCE">TP_IFACE_QUARK_CONNECTION_INTERFACE_BALANCE</a>
71	73	#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>
72	74	#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>
	75	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CELLULAR:CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CELLULAR">TP_IFACE_CONNECTION_INTERFACE_CELLULAR</a>
	76	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CELLULAR:CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR">TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR</a>
73	77	#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>
74	78	#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>
75	79	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO">TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO</a>

167	171	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-ICON:CAPS" title="TP_PROP_ACCOUNT_ICON">TP_PROP_ACCOUNT_ICON</a>
168	172	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACES:CAPS" title="TP_PROP_ACCOUNT_INTERFACES">TP_PROP_ACCOUNT_INTERFACES</a>
169	173	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-AVATAR-AVATAR:CAPS" title="TP_PROP_ACCOUNT_INTERFACE_AVATAR_AVATAR">TP_PROP_ACCOUNT_INTERFACE_AVATAR_AVATAR</a>
	174	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-IDENTIFIER:CAPS" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER">TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER</a>
	175	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-PROVIDER:CAPS" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER">TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER</a>
	176	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-RESTRICTIONS:CAPS" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS">TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS</a>
	177	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-SPECIFIC-INFORMATION:CAPS" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION">TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION</a>
170	178	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INTERFACES:CAPS" title="TP_PROP_ACCOUNT_MANAGER_INTERFACES">TP_PROP_ACCOUNT_MANAGER_INTERFACES</a>
171	179	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INVALID-ACCOUNTS:CAPS" title="TP_PROP_ACCOUNT_MANAGER_INVALID_ACCOUNTS">TP_PROP_ACCOUNT_MANAGER_INVALID_ACCOUNTS</a>
172	180	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-SUPPORTED-ACCOUNT-PROPERTIES:CAPS" title="TP_PROP_ACCOUNT_MANAGER_SUPPORTED_ACCOUNT_PROPERTIES">TP_PROP_ACCOUNT_MANAGER_SUPPORTED_ACCOUNT_PROPERTIES</a>

175	183	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-NORMALIZED-NAME:CAPS" title="TP_PROP_ACCOUNT_NORMALIZED_NAME">TP_PROP_ACCOUNT_NORMALIZED_NAME</a>
176	184	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-PARAMETERS:CAPS" title="TP_PROP_ACCOUNT_PARAMETERS">TP_PROP_ACCOUNT_PARAMETERS</a>
177	185	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-REQUESTED-PRESENCE:CAPS" title="TP_PROP_ACCOUNT_REQUESTED_PRESENCE">TP_PROP_ACCOUNT_REQUESTED_PRESENCE</a>
	186	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-SERVICE:CAPS" title="TP_PROP_ACCOUNT_SERVICE">TP_PROP_ACCOUNT_SERVICE</a>
178	187	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-VALID:CAPS" title="TP_PROP_ACCOUNT_VALID">TP_PROP_ACCOUNT_VALID</a>
179	188	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-CHANNEL-TYPE:CAPS" title="TP_PROP_CHANNEL_CHANNEL_TYPE">TP_PROP_CHANNEL_CHANNEL_TYPE</a>
180	189	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-DISPATCHER-INTERFACES:CAPS" title="TP_PROP_CHANNEL_DISPATCHER_INTERFACES">TP_PROP_CHANNEL_DISPATCHER_INTERFACES</a>

256	265	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-RECOMMENDED-AVATAR-WIDTH:CAPS" title="TP_PROP_CONNECTION_INTERFACE_AVATARS_RECOMMENDED_AVATAR_WIDTH">TP_PROP_CONNECTION_INTERFACE_AVATARS_RECOMMENDED_AVATAR_WIDTH</a>
257	266	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-SUPPORTED-AVATAR-MIME-TYPES:CAPS" title="TP_PROP_CONNECTION_INTERFACE_AVATARS_SUPPORTED_AVATAR_MIME_TYPES">TP_PROP_CONNECTION_INTERFACE_AVATARS_SUPPORTED_AVATAR_MIME_TYPES</a>
258	267	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-BALANCE-ACCOUNT-BALANCE:CAPS" title="TP_PROP_CONNECTION_INTERFACE_BALANCE_ACCOUNT_BALANCE">TP_PROP_CONNECTION_INTERFACE_BALANCE_ACCOUNT_BALANCE</a>
	268	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-IMSI:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI">TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI</a>
	269	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-REDUCED-CHARACTER-SET:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET">TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET</a>
	270	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-SERVICE-CENTRE:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE">TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE</a>
	271	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD">TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD</a>
259	272	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES">TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES</a>
260	273	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-CONTACT-INFO-FLAGS:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_CONTACT_INFO_FLAGS">TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_CONTACT_INFO_FLAGS</a>
261	274	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-SUPPORTED-FIELDS:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_SUPPORTED_FIELDS">TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_SUPPORTED_FIELDS</a>

267	280	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SERVICE-POINT-KNOWN-SERVICE-POINTS:CAPS" title="TP_PROP_CONNECTION_INTERFACE_SERVICE_POINT_KNOWN_SERVICE_POINTS">TP_PROP_CONNECTION_INTERFACE_SERVICE_POINT_KNOWN_SERVICE_POINTS</a>
268	281	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SIMPLE-PRESENCE-STATUSES:CAPS" title="TP_PROP_CONNECTION_INTERFACE_SIMPLE_PRESENCE_STATUSES">TP_PROP_CONNECTION_INTERFACE_SIMPLE_PRESENCE_STATUSES</a>
269	282	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-INTERFACES:CAPS" title="TP_PROP_CONNECTION_MANAGER_INTERFACES">TP_PROP_CONNECTION_MANAGER_INTERFACES</a>
	283	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-PROTOCOLS:CAPS" title="TP_PROP_CONNECTION_MANAGER_PROTOCOLS">TP_PROP_CONNECTION_MANAGER_PROTOCOLS</a>
270	284	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACES:CAPS" title="TP_PROP_CONNECTION_INTERFACES">TP_PROP_CONNECTION_INTERFACES</a>
271	285	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-SELF-HANDLE:CAPS" title="TP_PROP_CONNECTION_SELF_HANDLE">TP_PROP_CONNECTION_SELF_HANDLE</a>
272	286	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-STATUS:CAPS" title="TP_PROP_CONNECTION_STATUS">TP_PROP_CONNECTION_STATUS</a>

352	366	</p>
353	367	</div>
354	368	<hr>
	369	<div class="refsect2" title="TP_IFACE_ACCOUNT_INTERFACE_STORAGE">
	370	<a name="TP-IFACE-ACCOUNT-INTERFACE-STORAGE:CAPS"></a><h3>TP_IFACE_ACCOUNT_INTERFACE_STORAGE</h3>
	371	<pre class="programlisting">#define TP_IFACE_ACCOUNT_INTERFACE_STORAGE</pre>
	372	<p>
	373	The interface name "org.freedesktop.Telepathy.Account.Interface.Storage"
	374	</p>
	375	</div>
	376	<hr>
	377	<div class="refsect2" title="TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE">
	378	<a name="TP-IFACE-QUARK-ACCOUNT-INTERFACE-STORAGE:CAPS"></a><h3>TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE</h3>
	379	<pre class="programlisting">#define TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE</pre>
	380	<p>
	381	Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Account.Interface.Storage"
	382	</p>
	383	</div>
	384	<hr>
355	385	<div class="refsect2" title="TP_IFACE_ACCOUNT_MANAGER">
356	386	<a name="TP-IFACE-ACCOUNT-MANAGER:CAPS"></a><h3>TP_IFACE_ACCOUNT_MANAGER</h3>
357	387	<pre class="programlisting">#define TP_IFACE_ACCOUNT_MANAGER</pre>

560	590	</p>
561	591	</div>
562	592	<hr>
	593	<div class="refsect2" title="TP_IFACE_CONNECTION_INTERFACE_CELLULAR">
	594	<a name="TP-IFACE-CONNECTION-INTERFACE-CELLULAR:CAPS"></a><h3>TP_IFACE_CONNECTION_INTERFACE_CELLULAR</h3>
	595	<pre class="programlisting">#define TP_IFACE_CONNECTION_INTERFACE_CELLULAR</pre>
	596	<p>
	597	The interface name "org.freedesktop.Telepathy.Connection.Interface.Cellular"
	598	</p>
	599	</div>
	600	<hr>
	601	<div class="refsect2" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR">
	602	<a name="TP-IFACE-QUARK-CONNECTION-INTERFACE-CELLULAR:CAPS"></a><h3>TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR</h3>
	603	<pre class="programlisting">#define TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR</pre>
	604	<p>
	605	Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Connection.Interface.Cellular"
	606	</p>
	607	</div>
	608	<hr>
563	609	<div class="refsect2" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES">
564	610	<a name="TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS"></a><h3>TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</h3>
565	611	<pre class="programlisting">#define TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES</pre>

1336	1382	</p>
1337	1383	</div>
1338	1384	<hr>
	1385	<div class="refsect2" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER">
	1386	<a name="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-IDENTIFIER:CAPS"></a><h3>TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER</h3>
	1387	<pre class="programlisting">#define TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER</pre>
	1388	<p>
	1389	The fully-qualified property name "org.freedesktop.Telepathy.Account.Interface.Storage.StorageIdentifier"
	1390	</p>
	1391	</div>
	1392	<hr>
	1393	<div class="refsect2" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER">
	1394	<a name="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-PROVIDER:CAPS"></a><h3>TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER</h3>
	1395	<pre class="programlisting">#define TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER</pre>
	1396	<p>
	1397	The fully-qualified property name "org.freedesktop.Telepathy.Account.Interface.Storage.StorageProvider"
	1398	</p>
	1399	</div>
	1400	<hr>
	1401	<div class="refsect2" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS">
	1402	<a name="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-RESTRICTIONS:CAPS"></a><h3>TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS</h3>
	1403	<pre class="programlisting">#define TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS</pre>
	1404	<p>
	1405	The fully-qualified property name "org.freedesktop.Telepathy.Account.Interface.Storage.StorageRestrictions"
	1406	</p>
	1407	</div>
	1408	<hr>
	1409	<div class="refsect2" title="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION">
	1410	<a name="TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-SPECIFIC-INFORMATION:CAPS"></a><h3>TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION</h3>
	1411	<pre class="programlisting">#define TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION</pre>
	1412	<p>
	1413	The fully-qualified property name "org.freedesktop.Telepathy.Account.Interface.Storage.StorageSpecificInformation"
	1414	</p>
	1415	</div>
	1416	<hr>
1339	1417	<div class="refsect2" title="TP_PROP_ACCOUNT_MANAGER_INTERFACES">
1340	1418	<a name="TP-PROP-ACCOUNT-MANAGER-INTERFACES:CAPS"></a><h3>TP_PROP_ACCOUNT_MANAGER_INTERFACES</h3>
1341	1419	<pre class="programlisting">#define TP_PROP_ACCOUNT_MANAGER_INTERFACES</pre>

1400	1478	</p>
1401	1479	</div>
1402	1480	<hr>
	1481	<div class="refsect2" title="TP_PROP_ACCOUNT_SERVICE">
	1482	<a name="TP-PROP-ACCOUNT-SERVICE:CAPS"></a><h3>TP_PROP_ACCOUNT_SERVICE</h3>
	1483	<pre class="programlisting">#define TP_PROP_ACCOUNT_SERVICE</pre>
	1484	<p>
	1485	The fully-qualified property name "org.freedesktop.Telepathy.Account.Service"
	1486	</p>
	1487	</div>
	1488	<hr>
1403	1489	<div class="refsect2" title="TP_PROP_ACCOUNT_VALID">
1404	1490	<a name="TP-PROP-ACCOUNT-VALID:CAPS"></a><h3>TP_PROP_ACCOUNT_VALID</h3>
1405	1491	<pre class="programlisting">#define TP_PROP_ACCOUNT_VALID</pre>

2048	2134	</p>
2049	2135	</div>
2050	2136	<hr>
	2137	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI">
	2138	<a name="TP-PROP-CONNECTION-INTERFACE-CELLULAR-IMSI:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI</h3>
	2139	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI</pre>
	2140	<p>
	2141	The fully-qualified property name "org.freedesktop.Telepathy.Connection.Interface.Cellular.IMSI"
	2142	</p>
	2143	</div>
	2144	<hr>
	2145	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET">
	2146	<a name="TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-REDUCED-CHARACTER-SET:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET</h3>
	2147	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET</pre>
	2148	<p>
	2149	The fully-qualified property name "org.freedesktop.Telepathy.Connection.Interface.Cellular.MessageReducedCharacterSet"
	2150	</p>
	2151	</div>
	2152	<hr>
	2153	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE">
	2154	<a name="TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-SERVICE-CENTRE:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE</h3>
	2155	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE</pre>
	2156	<p>
	2157	The fully-qualified property name "org.freedesktop.Telepathy.Connection.Interface.Cellular.MessageServiceCentre"
	2158	</p>
	2159	</div>
	2160	<hr>
	2161	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD">
	2162	<a name="TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD</h3>
	2163	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD</pre>
	2164	<p>
	2165	The fully-qualified property name "org.freedesktop.Telepathy.Connection.Interface.Cellular.MessageValidityPeriod"
	2166	</p>
	2167	</div>
	2168	<hr>
2051	2169	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES">
2052	2170	<a name="TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES</h3>
2053	2171	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES</pre>

2136	2254	</p>
2137	2255	</div>
2138	2256	<hr>
	2257	<div class="refsect2" title="TP_PROP_CONNECTION_MANAGER_PROTOCOLS">
	2258	<a name="TP-PROP-CONNECTION-MANAGER-PROTOCOLS:CAPS"></a><h3>TP_PROP_CONNECTION_MANAGER_PROTOCOLS</h3>
	2259	<pre class="programlisting">#define TP_PROP_CONNECTION_MANAGER_PROTOCOLS</pre>
	2260	<p>
	2261	The fully-qualified property name "org.freedesktop.Telepathy.ConnectionManager.Protocols"
	2262	</p>
	2263	</div>
	2264	<hr>
2139	2265	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACES">
2140	2266	<a name="TP-PROP-CONNECTION-INTERFACES:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACES</h3>
2141	2267	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACES</pre>

-38

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

180	180	GQuark interface;
181	181
182	182	unsigned int must_have_unique_name:1;
183		guint _reserved_flags:31;
184
185		/* XXX: hide this from the g-i scanner, since vapigen can't cope */
186		#ifdef __GI_SCANNER__
187		GCallback _internal_list_features;
188		#else
189		TpProxyClassFeatureListFunc list_features;
190		#endif /* __GI_SCANNER__ */
191		GCallback _reserved[3];
192		gpointer priv;
193	183	} TpProxyClass;
194	184	</pre>
195	185	<p>
196		The class of a <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>.
	186	The class of a <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>. The struct fields not documented here are reserved.
197	187	</p>
198	188	<div class="variablelist"><table border="0">
199	189	<col align="left" valign="top">

213	203	<td><p><span class="term">unsigned <a href="/usr/share/gtk-doc/html/gnutls/gnutls-crypto.html#int"><span class="type">int</span></a> <em class="structfield"><code><a name="TpProxyClass.must-have-unique-name"></a>must_have_unique_name</code></em> :1;</span></p></td>
214	204	<td>If set <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> by a subclass, the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
215	205	constructor will fail if a well-known bus name is given
216		</td>
217		</tr>
218		<tr>
219		<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpProxyClass.-reserved-flags"></a>_reserved_flags</code></em> :31;</span></p></td>
220		<td>Reserved for future expansion
221		</td>
222		</tr>
223		<tr>
224		<td><p><span class="term"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> <em class="structfield"><code><a name="TpProxyClass.-internal-list-features"></a>_internal_list_features</code></em>;</span></p></td>
225		<td>
226		</td>
227		</tr>
228		<tr>
229		<td><p><span class="term"><a class="link" href="telepathy-glib-proxy.html#TpProxyClassFeatureListFunc" title="TpProxyClassFeatureListFunc ()"><span class="type">TpProxyClassFeatureListFunc</span></a> <em class="structfield"><code><a name="TpProxyClass.list-features"></a>list_features</code></em>;</span></p></td>
230		<td>Defined by subclasses to provide features for
231		<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> (currently only usable within telepathy-glib
232		itself)
233		</td>
234		</tr>
235		<tr>
236		<td><p><span class="term"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> <em class="structfield"><code><a name="TpProxyClass.-reserved"></a>_reserved</code></em>[3];</span></p></td>
237		<td>Reserved for future expansion
238		</td>
239		</tr>
240		<tr>
241		<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="TpProxyClass.priv"></a>priv</code></em>;</span></p></td>
242		<td>Opaque pointer for private data
243	206	</td>
244	207	</tr>
245	208	</tbody>

+29

-1

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

40	40	</tr></table></div>
41	41	<div class="refsynopsisdiv" title="Synopsis">
42	42	<a name="telepathy-glib-svc-account.synopsis"></a><h2>Synopsis</h2>
43		<a name="TpSvcAccount"></a><a name="TpSvcAccountInterfaceAvatar"></a><pre class="synopsis">
	43	<a name="TpSvcAccount"></a><a name="TpSvcAccountInterfaceAvatar"></a><a name="TpSvcAccountInterfaceStorage"></a><pre class="synopsis">
44	44	#include <telepathy-glib/svc-account.h>
45	45
46	46	<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount-struct" title="TpSvcAccount">TpSvcAccount</a>;

77	77	<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass" title="TpSvcAccountInterfaceAvatarClass">TpSvcAccountInterfaceAvatarClass</a>;
78	78	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed" title="tp_svc_account_interface_avatar_emit_avatar_changed ()">tp_svc_account_interface_avatar_emit_avatar_changed</a>
79	79	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>);
	80
	81
	82	<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorage-struct" title="TpSvcAccountInterfaceStorage">TpSvcAccountInterfaceStorage</a>;
	83	<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorageClass" title="TpSvcAccountInterfaceStorageClass">TpSvcAccountInterfaceStorageClass</a>;
80	84	</pre>
81	85	</div>
82	86	<div class="refsect1" title="Object Hierarchy">

88	92	<pre class="synopsis">
89	93	GInterface
90	94	+----TpSvcAccountInterfaceAvatar
	95	</pre>
	96	<pre class="synopsis">
	97	GInterface
	98	+----TpSvcAccountInterfaceStorage
91	99	</pre>
92	100	</div>
93	101	<div class="refsect1" title="Signals">

460	468	</tr></tbody>
461	469	</table></div>
462	470	</div>
	471	<hr>
	472	<div class="refsect2" title="TpSvcAccountInterfaceStorage">
	473	<a name="TpSvcAccountInterfaceStorage-struct"></a><h3>TpSvcAccountInterfaceStorage</h3>
	474	<pre class="programlisting">typedef struct _TpSvcAccountInterfaceStorage TpSvcAccountInterfaceStorage;</pre>
	475	<p>
	476	Dummy typedef representing any implementation of this interface.
	477	</p>
	478	</div>
	479	<hr>
	480	<div class="refsect2" title="TpSvcAccountInterfaceStorageClass">
	481	<a name="TpSvcAccountInterfaceStorageClass"></a><h3>TpSvcAccountInterfaceStorageClass</h3>
	482	<pre class="programlisting">typedef struct _TpSvcAccountInterfaceStorageClass TpSvcAccountInterfaceStorageClass;</pre>
	483	<p>
	484	The class of TpSvcAccountInterfaceStorage.
	485	This interface has no D-Bus methods, so an
	486	implementation can typically pass <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
	487	<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS"><code class="function">G_IMPLEMENT_INTERFACE()</code></a> as the interface
	488	initialization function.
	489	</p>
	490	</div>
463	491	</div>
464	492	<div class="refsect1" title="Signal Details">
465	493	<a name="telepathy-glib-svc-account.signal-details"></a><h2>Signal Details</h2>

+83

-1

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

42	42	</tr></table></div>
43	43	<div class="refsynopsisdiv" title="Synopsis">
44	44	<a name="telepathy-glib-svc-connection.synopsis"></a><h2>Synopsis</h2>
45		<a name="TpSvcConnection"></a><a name="TpSvcConnectionInterfaceContacts"></a><a name="TpSvcConnectionInterfaceRequests"></a><a name="TpSvcConnectionInterfaceSimplePresence"></a><a name="TpSvcConnectionInterfacePresence"></a><a name="TpSvcConnectionInterfaceAvatars"></a><a name="TpSvcConnectionInterfaceAliasing"></a><a name="TpSvcConnectionInterfaceBalance"></a><a name="TpSvcConnectionInterfaceCapabilities"></a><a name="TpSvcConnectionInterfaceContactCapabilities"></a><a name="TpSvcConnectionInterfaceLocation"></a><a name="TpSvcConnectionInterfaceContactInfo"></a><pre class="synopsis">
	45	<a name="TpSvcConnection"></a><a name="TpSvcConnectionInterfaceContacts"></a><a name="TpSvcConnectionInterfaceRequests"></a><a name="TpSvcConnectionInterfaceSimplePresence"></a><a name="TpSvcConnectionInterfacePresence"></a><a name="TpSvcConnectionInterfaceAvatars"></a><a name="TpSvcConnectionInterfaceAliasing"></a><a name="TpSvcConnectionInterfaceBalance"></a><a name="TpSvcConnectionInterfaceCapabilities"></a><a name="TpSvcConnectionInterfaceContactCapabilities"></a><a name="TpSvcConnectionInterfaceLocation"></a><a name="TpSvcConnectionInterfaceContactInfo"></a><a name="TpSvcConnectionInterfaceCellular"></a><pre class="synopsis">
46	46	#include <telepathy-glib/svc-connection.h>
47	47
48	48	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnection-struct" title="TpSvcConnection">TpSvcConnection</a>;

610	610	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo"><span class="type">TpSvcConnectionInterfaceContactInfo</span></a> *self</code></em>,
611	611	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_ContactInfo</code></em>,
612	612	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
	613
	614
	615	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-struct" title="TpSvcConnectionInterfaceCellular">TpSvcConnectionInterfaceCellular</a>;
	616	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellularClass" title="TpSvcConnectionInterfaceCellularClass">TpSvcConnectionInterfaceCellularClass</a>;
	617	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-cellular-emit-imsi-changed" title="tp_svc_connection_interface_cellular_emit_imsi_changed ()">tp_svc_connection_interface_cellular_emit_imsi_changed</a>
	618	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
	619	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_IMSI</code></em>);
613	620	</pre>
614	621	</div>
615	622	<div class="refsect1" title="Object Hierarchy">

662	669	GInterface
663	670	+----TpSvcConnectionInterfaceContactInfo
664	671	</pre>
	672	<pre class="synopsis">
	673	GInterface
	674	+----TpSvcConnectionInterfaceCellular
	675	</pre>
665	676	</div>
666	677	<div class="refsect1" title="Known Implementations">
667	678	<a name="telepathy-glib-svc-connection.implementations"></a><h2>Known Implementations</h2>

691	702	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed" title='The "contact-capabilities-changed" signal'>contact-capabilities-changed</a>" : Run Last / Has Details
692	703	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated" title='The "location-updated" signal'>location-updated</a>" : Run Last / Has Details
693	704	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed" title='The "contact-info-changed" signal'>contact-info-changed</a>" : Run Last / Has Details
	705	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-i-ms-ichanged" title='The "i-ms-ichanged" signal'>i-ms-ichanged</a>" : Run Last / Has Details
694	706	</pre>
695	707	</div>
696	708	<div class="refsect1" title="Description">

5562	5574	</tbody>
5563	5575	</table></div>
5564	5576	</div>
	5577	<hr>
	5578	<div class="refsect2" title="TpSvcConnectionInterfaceCellular">
	5579	<a name="TpSvcConnectionInterfaceCellular-struct"></a><h3>TpSvcConnectionInterfaceCellular</h3>
	5580	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceCellular TpSvcConnectionInterfaceCellular;</pre>
	5581	<p>
	5582	Dummy typedef representing any implementation of this interface.
	5583	</p>
	5584	</div>
	5585	<hr>
	5586	<div class="refsect2" title="TpSvcConnectionInterfaceCellularClass">
	5587	<a name="TpSvcConnectionInterfaceCellularClass"></a><h3>TpSvcConnectionInterfaceCellularClass</h3>
	5588	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceCellularClass TpSvcConnectionInterfaceCellularClass;</pre>
	5589	<p>
	5590	The class of TpSvcConnectionInterfaceCellular.
	5591	This interface has no D-Bus methods, so an
	5592	implementation can typically pass <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
	5593	<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS"><code class="function">G_IMPLEMENT_INTERFACE()</code></a> as the interface
	5594	initialization function.
	5595	</p>
	5596	</div>
	5597	<hr>
	5598	<div class="refsect2" title="tp_svc_connection_interface_cellular_emit_imsi_changed ()">
	5599	<a name="tp-svc-connection-interface-cellular-emit-imsi-changed"></a><h3>tp_svc_connection_interface_cellular_emit_imsi_changed ()</h3>
	5600	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_cellular_emit_imsi_changed
	5601	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
	5602	<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_IMSI</code></em>);</pre>
	5603	<p>
	5604	Type-safe wrapper around g_signal_emit to emit the
	5605	IMSIChanged signal on interface org.freedesktop.Telepathy.Connection.Interface.Cellular.
	5606	</p>
	5607	<div class="variablelist"><table border="0">
	5608	<col align="left" valign="top">
	5609	<tbody>
	5610	<tr>
	5611	<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
	5612	<td>The object implementing this interface
	5613	</td>
	5614	</tr>
	5615	<tr>
	5616	<td><p><span class="term"><em class="parameter"><code>arg_IMSI</code></em> :</span></p></td>
	5617	<td>const gchar * (FIXME, generate documentation)
	5618	</td>
	5619	</tr>
	5620	</tbody>
	5621	</table></div>
	5622	</div>
5565	5623	</div>
5566	5624	<div class="refsect1" title="Signal Details">
5567	5625	<a name="telepathy-glib-svc-connection.signal-details"></a><h2>Signal Details</h2>

6010	6068	</tbody>
6011	6069	</table></div>
6012	6070	</div>
	6071	<hr>
	6072	<div class="refsect2" title='The "i-ms-ichanged" signal'>
	6073	<a name="TpSvcConnectionInterfaceCellular-i-ms-ichanged"></a><h3>The <code class="literal">"i-ms-ichanged"</code> signal</h3>
	6074	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular"><span class="type">TpSvcConnectionInterfaceCellular</span></a> *arg_IMSI,
	6075	<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg1,
	6076	<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
	6077	<p>
	6078	The IMSIChanged D-Bus signal is emitted whenever this GObject signal is.
	6079	</p>
	6080	<div class="variablelist"><table border="0">
	6081	<col align="left" valign="top">
	6082	<tbody>
	6083	<tr>
	6084	<td><p><span class="term"><em class="parameter"><code>arg_IMSI</code></em> :</span></p></td>
	6085	<td>const gchar * (FIXME, generate documentation)
	6086	</td>
	6087	</tr>
	6088	<tr>
	6089	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	6090	<td>user data set when the signal handler was connected.</td>
	6091	</tr>
	6092	</tbody>
	6093	</table></div>
	6094	</div>
6013	6095	</div>
6014	6096	<div class="refsect1" title="See Also">
6015	6097	<a name="telepathy-glib-svc-connection.see-also"></a><h2>See Also</h2>

+55

-2

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

110	110	#define <a class="link" href="telepathy-glib-util.html#tp-clear-object" title="tp_clear_object()">tp_clear_object</a> (op)
111	111	#define <a class="link" href="telepathy-glib-util.html#tp-clear-boxed" title="tp_clear_boxed()">tp_clear_boxed</a> (gtype,
112	112	pp)
	113	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-util.html#tp-simple-async-report-success-in-idle" title="tp_simple_async_report_success_in_idle ()">tp_simple_async_report_success_in_idle</a>
	114	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *source</code></em>,
	115	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
	116	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	117	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_tag</code></em>);
113	118	</pre>
114	119	</div>
115	120	<div class="refsect1" title="Description">

1141	1146	<p>
1142	1147	</p>
1143	1148	<div class="example">
1144		<a name="id1091023"></a><p class="title"><b>Example 2. using tp_value_array_build</b></p>
	1149	<a name="id1127134"></a><p class="title"><b>Example 2. using tp_value_array_build</b></p>
1145	1150	<div class="example-contents">
1146	1151	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1147	1152	<tbody>

1207	1212	<p>
1208	1213	</p>
1209	1214	<div class="example">
1210		<a name="id1091202"></a><p class="title"><b>Example 3. using tp_value_array_unpack</b></p>
	1215	<a name="id1127313"></a><p class="title"><b>Example 3. using tp_value_array_unpack</b></p>
1211	1216	<div class="example-contents">
1212	1217	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1213	1218	<tbody>

1524	1529	</table></div>
1525	1530	<p class="since">Since 0.11.7</p>
1526	1531	</div>
	1532	<hr>
	1533	<div class="refsect2" title="tp_simple_async_report_success_in_idle ()">
	1534	<a name="tp-simple-async-report-success-in-idle"></a><h3>tp_simple_async_report_success_in_idle ()</h3>
	1535	<pre class="programlisting"><span class="returnvalue">void</span> tp_simple_async_report_success_in_idle
	1536	(<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *source</code></em>,
	1537	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
	1538	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1539	<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_tag</code></em>);</pre>
	1540	<p>
	1541	Create a new <a href="/usr/share/gtk-doc/html/gio/GSimpleAsyncResult.html"><span class="type">GSimpleAsyncResult</span></a> with no operation result, and call
	1542	<a href="/usr/share/gtk-doc/html/gio/GSimpleAsyncResult.html#g-simple-async-result-complete-in-idle"><code class="function">g_simple_async_result_complete_in_idle()</code></a> on it.
	1543	</p>
	1544	<p>
	1545	This is like a successful version of <a href="/usr/share/gtk-doc/html/gio/GSimpleAsyncResult.html#g-simple-async-report-error-in-idle"><code class="function">g_simple_async_report_error_in_idle()</code></a>,
	1546	suitable for asynchronous functions that (conceptually) either succeed and
	1547	return nothing, or raise an error, such as <a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a>.
	1548	</p>
	1549	<p>
	1550	The corresponding finish function should not call a function that attempts
	1551	to get a result, such as <a href="/usr/share/gtk-doc/html/gio/GSimpleAsyncResult.html#g-simple-async-result-get-op-res-gpointer"><code class="function">g_simple_async_result_get_op_res_gpointer()</code></a>.
	1552	</p>
	1553	<div class="variablelist"><table border="0">
	1554	<col align="left" valign="top">
	1555	<tbody>
	1556	<tr>
	1557	<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
	1558	<td>the source object
	1559	</td>
	1560	</tr>
	1561	<tr>
	1562	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	1563	<td>the callback
	1564	</td>
	1565	</tr>
	1566	<tr>
	1567	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	1568	<td>user data for <em class="parameter"><code>callback</code></em>
	1569	</td>
	1570	</tr>
	1571	<tr>
	1572	<td><p><span class="term"><em class="parameter"><code>source_tag</code></em> :</span></p></td>
	1573	<td>the source tag for the <a href="/usr/share/gtk-doc/html/gio/GSimpleAsyncResult.html"><span class="type">GSimpleAsyncResult</span></a>
	1574	</td>
	1575	</tr>
	1576	</tbody>
	1577	</table></div>
	1578	<p class="since">Since 0.11.UNRELEASED</p>
	1579	</div>
1527	1580	</div>
1528	1581	</div>
1529	1582	<div class="footer">

+30

-0

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

33	33	<sub name="Connection Requests interface" link="telepathy-glib-connection-requests.html"/>
34	34	<sub name="Connection SimplePresence interface" link="telepathy-glib-connection-simple-presence.html"/>
35	35	<sub name="Connection Presence interface" link="telepathy-glib-connection-presence.html"/>
	36	<sub name="Connection Cellular interface" link="telepathy-glib-connection-cellular.html"/>
36	37	<sub name="TpChannel" link="telepathy-glib-channel.html"/>
37	38	<sub name="Group interface on Channels" link="telepathy-glib-channel-group.html"/>
38	39	<sub name="Text channels" link="telepathy-glib-channel-text.html"/>

327	328	<function name="TP_IFACE_QUARK_ACCOUNT" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT:CAPS"/>
328	329	<function name="TP_IFACE_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR:CAPS"/>
329	330	<function name="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR:CAPS"/>
	331	<function name="TP_IFACE_ACCOUNT_INTERFACE_STORAGE" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-STORAGE:CAPS"/>
	332	<function name="TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-STORAGE:CAPS"/>
330	333	<function name="TP_IFACE_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER:CAPS"/>
331	334	<function name="TP_IFACE_QUARK_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER:CAPS"/>
332	335	<function name="TP_IFACE_DBUS_DAEMON" link="telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON:CAPS"/>

353	356	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_BALANCE" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-BALANCE:CAPS"/>
354	357	<function name="TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES:CAPS"/>
355	358	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES:CAPS"/>
	359	<function name="TP_IFACE_CONNECTION_INTERFACE_CELLULAR" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CELLULAR:CAPS"/>
	360	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CELLULAR:CAPS"/>
356	361	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS"/>
357	362	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS"/>
358	363	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"/>

450	455	<function name="TP_PROP_ACCOUNT_ICON" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-ICON:CAPS"/>
451	456	<function name="TP_PROP_ACCOUNT_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACES:CAPS"/>
452	457	<function name="TP_PROP_ACCOUNT_INTERFACE_AVATAR_AVATAR" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-AVATAR-AVATAR:CAPS"/>
	458	<function name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-IDENTIFIER:CAPS"/>
	459	<function name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-PROVIDER:CAPS"/>
	460	<function name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-RESTRICTIONS:CAPS"/>
	461	<function name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-SPECIFIC-INFORMATION:CAPS"/>
453	462	<function name="TP_PROP_ACCOUNT_MANAGER_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INTERFACES:CAPS"/>
454	463	<function name="TP_PROP_ACCOUNT_MANAGER_INVALID_ACCOUNTS" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INVALID-ACCOUNTS:CAPS"/>
455	464	<function name="TP_PROP_ACCOUNT_MANAGER_SUPPORTED_ACCOUNT_PROPERTIES" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-SUPPORTED-ACCOUNT-PROPERTIES:CAPS"/>

458	467	<function name="TP_PROP_ACCOUNT_NORMALIZED_NAME" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-NORMALIZED-NAME:CAPS"/>
459	468	<function name="TP_PROP_ACCOUNT_PARAMETERS" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-PARAMETERS:CAPS"/>
460	469	<function name="TP_PROP_ACCOUNT_REQUESTED_PRESENCE" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-REQUESTED-PRESENCE:CAPS"/>
	470	<function name="TP_PROP_ACCOUNT_SERVICE" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-SERVICE:CAPS"/>
461	471	<function name="TP_PROP_ACCOUNT_VALID" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-VALID:CAPS"/>
462	472	<function name="TP_PROP_CHANNEL_CHANNEL_TYPE" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-CHANNEL-TYPE:CAPS"/>
463	473	<function name="TP_PROP_CHANNEL_DISPATCHER_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-DISPATCHER-INTERFACES:CAPS"/>

539	549	<function name="TP_PROP_CONNECTION_INTERFACE_AVATARS_RECOMMENDED_AVATAR_WIDTH" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-RECOMMENDED-AVATAR-WIDTH:CAPS"/>
540	550	<function name="TP_PROP_CONNECTION_INTERFACE_AVATARS_SUPPORTED_AVATAR_MIME_TYPES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-SUPPORTED-AVATAR-MIME-TYPES:CAPS"/>
541	551	<function name="TP_PROP_CONNECTION_INTERFACE_BALANCE_ACCOUNT_BALANCE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-BALANCE-ACCOUNT-BALANCE:CAPS"/>
	552	<function name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-IMSI:CAPS"/>
	553	<function name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-REDUCED-CHARACTER-SET:CAPS"/>
	554	<function name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-SERVICE-CENTRE:CAPS"/>
	555	<function name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS"/>
542	556	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS"/>
543	557	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_CONTACT_INFO_FLAGS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-CONTACT-INFO-FLAGS:CAPS"/>
544	558	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_SUPPORTED_FIELDS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-SUPPORTED-FIELDS:CAPS"/>

550	564	<function name="TP_PROP_CONNECTION_INTERFACE_SERVICE_POINT_KNOWN_SERVICE_POINTS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SERVICE-POINT-KNOWN-SERVICE-POINTS:CAPS"/>
551	565	<function name="TP_PROP_CONNECTION_INTERFACE_SIMPLE_PRESENCE_STATUSES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SIMPLE-PRESENCE-STATUSES:CAPS"/>
552	566	<function name="TP_PROP_CONNECTION_MANAGER_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-INTERFACES:CAPS"/>
	567	<function name="TP_PROP_CONNECTION_MANAGER_PROTOCOLS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-PROTOCOLS:CAPS"/>
553	568	<function name="TP_PROP_CONNECTION_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACES:CAPS"/>
554	569	<function name="TP_PROP_CONNECTION_SELF_HANDLE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-SELF-HANDLE:CAPS"/>
555	570	<function name="TP_PROP_CONNECTION_STATUS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-STATUS:CAPS"/>

645	660	<function name="enum TpServicePointType" link="telepathy-glib-enums.html#TpServicePointType"/>
646	661	<function name="NUM_TP_SERVICE_POINT_TYPES" link="telepathy-glib-enums.html#NUM-TP-SERVICE-POINT-TYPES:CAPS"/>
647	662	<function name="enum TpAnonymityModeFlags" link="telepathy-glib-enums.html#TpAnonymityModeFlags"/>
	663	<function name="enum TpStorageRestrictionFlags" link="telepathy-glib-enums.html#TpStorageRestrictionFlags"/>
648	664	<function name="TP_ERROR_PREFIX" link="telepathy-glib-errors.html#TP-ERROR-PREFIX:CAPS"/>
649	665	<function name="TP_ERRORS" link="telepathy-glib-errors.html#TP-ERRORS:CAPS"/>
650	666	<function name="TP_TYPE_ERROR" link="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"/>

708	724	<function name="TP_STRUCT_TYPE_SOCKET_NETMASK_IPV6" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-SOCKET-NETMASK-IPV6:CAPS"/>
709	725	<function name="TP_STRUCT_TYPE_PARAM_SPEC" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-PARAM-SPEC:CAPS"/>
710	726	<function name="TP_ARRAY_TYPE_PARAM_SPEC_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-PARAM-SPEC-LIST:CAPS"/>
	727	<function name="TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-PROTOCOL-PROPERTIES-MAP:CAPS"/>
711	728	<function name="TP_STRUCT_TYPE_CHANNEL_INFO" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CHANNEL-INFO:CAPS"/>
712	729	<function name="TP_ARRAY_TYPE_CHANNEL_INFO_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CHANNEL-INFO-LIST:CAPS"/>
713	730	<function name="TP_HASH_TYPE_ALIAS_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-ALIAS-MAP:CAPS"/>

1128	1145	<function name="tp_cli_connection_interface_presence_callback_for_set_status ()" link="telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-callback-for-set-status"/>
1129	1146	<function name="tp_cli_connection_interface_presence_connect_to_presence_update ()" link="telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-connect-to-presence-update"/>
1130	1147	<function name="tp_cli_connection_interface_presence_signal_callback_presence_update ()" link="telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-signal-callback-presence-update"/>
	1148	<function name="tp_cli_connection_interface_cellular_connect_to_imsi_changed ()" link="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-connect-to-imsi-changed"/>
	1149	<function name="tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()" link="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-signal-callback-imsi-changed"/>
1131	1150	<function name="TpChannel" link="telepathy-glib-channel.html#TpChannel-struct"/>
1132	1151	<function name="TpChannelClass" link="telepathy-glib-channel.html#TpChannelClass"/>
1133	1152	<function name="tp_channel_new ()" link="telepathy-glib-channel.html#tp-channel-new"/>

1530	1549	<function name="tp_account_get_connection_manager ()" link="telepathy-glib-account.html#tp-account-get-connection-manager"/>
1531	1550	<function name="tp_account_get_protocol ()" link="telepathy-glib-account.html#tp-account-get-protocol"/>
1532	1551	<function name="tp_account_get_icon_name ()" link="telepathy-glib-account.html#tp-account-get-icon-name"/>
	1552	<function name="tp_account_get_service ()" link="telepathy-glib-account.html#tp-account-get-service"/>
1533	1553	<function name="tp_account_set_enabled_async ()" link="telepathy-glib-account.html#tp-account-set-enabled-async"/>
1534	1554	<function name="tp_account_set_enabled_finish ()" link="telepathy-glib-account.html#tp-account-set-enabled-finish"/>
1535	1555	<function name="tp_account_reconnect_async ()" link="telepathy-glib-account.html#tp-account-reconnect-async"/>

1544	1564	<function name="tp_account_set_display_name_finish ()" link="telepathy-glib-account.html#tp-account-set-display-name-finish"/>
1545	1565	<function name="tp_account_set_icon_name_async ()" link="telepathy-glib-account.html#tp-account-set-icon-name-async"/>
1546	1566	<function name="tp_account_set_icon_name_finish ()" link="telepathy-glib-account.html#tp-account-set-icon-name-finish"/>
	1567	<function name="tp_account_set_service_async ()" link="telepathy-glib-account.html#tp-account-set-service-async"/>
	1568	<function name="tp_account_set_service_finish ()" link="telepathy-glib-account.html#tp-account-set-service-finish"/>
1547	1569	<function name="tp_account_request_presence_async ()" link="telepathy-glib-account.html#tp-account-request-presence-async"/>
1548	1570	<function name="tp_account_request_presence_finish ()" link="telepathy-glib-account.html#tp-account-request-presence-finish"/>
1549	1571	<function name="tp_account_get_connect_automatically ()" link="telepathy-glib-account.html#tp-account-get-connect-automatically"/>

1599	1621	<function name="The "requested-presence-type" property" link="telepathy-glib-account.html#TpAccount--requested-presence-type"/>
1600	1622	<function name="The "requested-status" property" link="telepathy-glib-account.html#TpAccount--requested-status"/>
1601	1623	<function name="The "requested-status-message" property" link="telepathy-glib-account.html#TpAccount--requested-status-message"/>
	1624	<function name="The "service" property" link="telepathy-glib-account.html#TpAccount--service"/>
1602	1625	<function name="The "valid" property" link="telepathy-glib-account.html#TpAccount--valid"/>
1603	1626	<function name="The "presence-changed" signal" link="telepathy-glib-account.html#TpAccount-presence-changed"/>
1604	1627	<function name="The "status-changed" signal" link="telepathy-glib-account.html#TpAccount-status-changed"/>

2177	2200	<function name="tp_svc_connection_interface_contact_info_return_from_request_contact_info ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-return-from-request-contact-info"/>
2178	2201	<function name="tp_svc_connection_interface_contact_info_return_from_set_contact_info ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-return-from-set-contact-info"/>
2179	2202	<function name="tp_svc_connection_interface_contact_info_set_contact_info_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-set-contact-info-impl"/>
	2203	<function name="TpSvcConnectionInterfaceCellular" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-struct"/>
	2204	<function name="TpSvcConnectionInterfaceCellularClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellularClass"/>
	2205	<function name="tp_svc_connection_interface_cellular_emit_imsi_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-cellular-emit-imsi-changed"/>
2180	2206	<function name="The "connection-error" signal" link="telepathy-glib-svc-connection.html#TpSvcConnection-connection-error"/>
2181	2207	<function name="The "new-channel" signal" link="telepathy-glib-svc-connection.html#TpSvcConnection-new-channel"/>
2182	2208	<function name="The "self-handle-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnection-self-handle-changed"/>

2193	2219	<function name="The "contact-capabilities-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed"/>
2194	2220	<function name="The "location-updated" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated"/>
2195	2221	<function name="The "contact-info-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed"/>
	2222	<function name="The "i-ms-ichanged" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-i-ms-ichanged"/>
2196	2223	<function name="TpSvcConnectionInterfaceAnonymity" link="telepathy-glib-svc-anonymity.html#TpSvcConnectionInterfaceAnonymity-struct"/>
2197	2224	<function name="TpSvcConnectionInterfaceAnonymityClass" link="telepathy-glib-svc-anonymity.html#TpSvcConnectionInterfaceAnonymityClass"/>
2198	2225	<function name="tp_svc_connection_interface_anonymity_emit_anonymity_modes_changed ()" link="telepathy-glib-svc-anonymity.html#tp-svc-connection-interface-anonymity-emit-anonymity-modes-changed"/>

2315	2342	<function name="TpSvcAccountInterfaceAvatar" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct"/>
2316	2343	<function name="TpSvcAccountInterfaceAvatarClass" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass"/>
2317	2344	<function name="tp_svc_account_interface_avatar_emit_avatar_changed ()" link="telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed"/>
	2345	<function name="TpSvcAccountInterfaceStorage" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorage-struct"/>
	2346	<function name="TpSvcAccountInterfaceStorageClass" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorageClass"/>
2318	2347	<function name="The "account-property-changed" signal" link="telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed"/>
2319	2348	<function name="The "removed" signal" link="telepathy-glib-svc-account.html#TpSvcAccount-removed"/>
2320	2349	<function name="The "avatar-changed" signal" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-avatar-changed"/>

2814	2843	<function name="tp_clear_pointer()" link="telepathy-glib-util.html#tp-clear-pointer"/>
2815	2844	<function name="tp_clear_object()" link="telepathy-glib-util.html#tp-clear-object"/>
2816	2845	<function name="tp_clear_boxed()" link="telepathy-glib-util.html#tp-clear-boxed"/>
	2846	<function name="tp_simple_async_report_success_in_idle ()" link="telepathy-glib-util.html#tp-simple-async-report-success-in-idle"/>
2817	2847	<function name="tp_g_socket_address_from_variant ()" link="telepathy-glib-gnio-util.html#tp-g-socket-address-from-variant"/>
2818	2848	<function name="tp_address_variant_from_g_socket_address ()" link="telepathy-glib-gnio-util.html#tp-address-variant-from-g-socket-address"/>
2819	2849	<function name="TP_ANSI_RESET" link="telepathy-glib-debug-ansi.html#TP-ANSI-RESET:CAPS"/>

+35

-1

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

33	33	<sub name="Connection Requests interface" link="telepathy-glib-connection-requests.html"/>
34	34	<sub name="Connection SimplePresence interface" link="telepathy-glib-connection-simple-presence.html"/>
35	35	<sub name="Connection Presence interface" link="telepathy-glib-connection-presence.html"/>
	36	<sub name="Connection Cellular interface" link="telepathy-glib-connection-cellular.html"/>
36	37	<sub name="TpChannel" link="telepathy-glib-channel.html"/>
37	38	<sub name="Group interface on Channels" link="telepathy-glib-channel-group.html"/>
38	39	<sub name="Text channels" link="telepathy-glib-channel-text.html"/>

327	328	<keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT:CAPS"/>
328	329	<keyword type="macro" name="TP_IFACE_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR:CAPS"/>
329	330	<keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR:CAPS"/>
	331	<keyword type="macro" name="TP_IFACE_ACCOUNT_INTERFACE_STORAGE" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-STORAGE:CAPS"/>
	332	<keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-STORAGE:CAPS"/>
330	333	<keyword type="macro" name="TP_IFACE_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER:CAPS"/>
331	334	<keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER:CAPS"/>
332	335	<keyword type="macro" name="TP_IFACE_DBUS_DAEMON" link="telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON:CAPS"/>

353	356	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_BALANCE" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-BALANCE:CAPS"/>
354	357	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CAPABILITIES:CAPS"/>
355	358	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CAPABILITIES:CAPS"/>
	359	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CELLULAR" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CELLULAR:CAPS"/>
	360	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CELLULAR:CAPS"/>
356	361	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS"/>
357	362	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-CAPABILITIES:CAPS"/>
358	363	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"/>

450	455	<keyword type="macro" name="TP_PROP_ACCOUNT_ICON" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-ICON:CAPS"/>
451	456	<keyword type="macro" name="TP_PROP_ACCOUNT_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACES:CAPS"/>
452	457	<keyword type="macro" name="TP_PROP_ACCOUNT_INTERFACE_AVATAR_AVATAR" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-AVATAR-AVATAR:CAPS"/>
	458	<keyword type="macro" name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-IDENTIFIER:CAPS"/>
	459	<keyword type="macro" name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-PROVIDER:CAPS"/>
	460	<keyword type="macro" name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-RESTRICTIONS:CAPS"/>
	461	<keyword type="macro" name="TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-INTERFACE-STORAGE-STORAGE-SPECIFIC-INFORMATION:CAPS"/>
453	462	<keyword type="macro" name="TP_PROP_ACCOUNT_MANAGER_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INTERFACES:CAPS"/>
454	463	<keyword type="macro" name="TP_PROP_ACCOUNT_MANAGER_INVALID_ACCOUNTS" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-INVALID-ACCOUNTS:CAPS"/>
455	464	<keyword type="macro" name="TP_PROP_ACCOUNT_MANAGER_SUPPORTED_ACCOUNT_PROPERTIES" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-MANAGER-SUPPORTED-ACCOUNT-PROPERTIES:CAPS"/>

458	467	<keyword type="macro" name="TP_PROP_ACCOUNT_NORMALIZED_NAME" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-NORMALIZED-NAME:CAPS"/>
459	468	<keyword type="macro" name="TP_PROP_ACCOUNT_PARAMETERS" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-PARAMETERS:CAPS"/>
460	469	<keyword type="macro" name="TP_PROP_ACCOUNT_REQUESTED_PRESENCE" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-REQUESTED-PRESENCE:CAPS"/>
	470	<keyword type="macro" name="TP_PROP_ACCOUNT_SERVICE" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-SERVICE:CAPS"/>
461	471	<keyword type="macro" name="TP_PROP_ACCOUNT_VALID" link="telepathy-glib-interfaces.html#TP-PROP-ACCOUNT-VALID:CAPS"/>
462	472	<keyword type="macro" name="TP_PROP_CHANNEL_CHANNEL_TYPE" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-CHANNEL-TYPE:CAPS"/>
463	473	<keyword type="macro" name="TP_PROP_CHANNEL_DISPATCHER_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-DISPATCHER-INTERFACES:CAPS"/>

539	549	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_AVATARS_RECOMMENDED_AVATAR_WIDTH" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-RECOMMENDED-AVATAR-WIDTH:CAPS"/>
540	550	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_AVATARS_SUPPORTED_AVATAR_MIME_TYPES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-AVATARS-SUPPORTED-AVATAR-MIME-TYPES:CAPS"/>
541	551	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_BALANCE_ACCOUNT_BALANCE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-BALANCE-ACCOUNT-BALANCE:CAPS"/>
	552	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-IMSI:CAPS"/>
	553	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-REDUCED-CHARACTER-SET:CAPS"/>
	554	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-SERVICE-CENTRE:CAPS"/>
	555	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS"/>
542	556	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS"/>
543	557	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_CONTACT_INFO_FLAGS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-CONTACT-INFO-FLAGS:CAPS"/>
544	558	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_SUPPORTED_FIELDS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-INFO-SUPPORTED-FIELDS:CAPS"/>

550	564	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_SERVICE_POINT_KNOWN_SERVICE_POINTS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SERVICE-POINT-KNOWN-SERVICE-POINTS:CAPS"/>
551	565	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_SIMPLE_PRESENCE_STATUSES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-SIMPLE-PRESENCE-STATUSES:CAPS"/>
552	566	<keyword type="macro" name="TP_PROP_CONNECTION_MANAGER_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-INTERFACES:CAPS"/>
	567	<keyword type="macro" name="TP_PROP_CONNECTION_MANAGER_PROTOCOLS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-MANAGER-PROTOCOLS:CAPS"/>
553	568	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACES:CAPS"/>
554	569	<keyword type="macro" name="TP_PROP_CONNECTION_SELF_HANDLE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-SELF-HANDLE:CAPS"/>
555	570	<keyword type="macro" name="TP_PROP_CONNECTION_STATUS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-STATUS:CAPS"/>

645	660	<keyword type="enum" name="enum TpServicePointType" link="telepathy-glib-enums.html#TpServicePointType"/>
646	661	<keyword type="macro" name="NUM_TP_SERVICE_POINT_TYPES" link="telepathy-glib-enums.html#NUM-TP-SERVICE-POINT-TYPES:CAPS"/>
647	662	<keyword type="enum" name="enum TpAnonymityModeFlags" link="telepathy-glib-enums.html#TpAnonymityModeFlags"/>
	663	<keyword type="enum" name="enum TpStorageRestrictionFlags" link="telepathy-glib-enums.html#TpStorageRestrictionFlags"/>
648	664	<keyword type="macro" name="TP_ERROR_PREFIX" link="telepathy-glib-errors.html#TP-ERROR-PREFIX:CAPS" since="0.7.1"/>
649	665	<keyword type="macro" name="TP_ERRORS" link="telepathy-glib-errors.html#TP-ERRORS:CAPS"/>
650	666	<keyword type="macro" name="TP_TYPE_ERROR" link="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"/>

708	724	<keyword type="macro" name="TP_STRUCT_TYPE_SOCKET_NETMASK_IPV6" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-SOCKET-NETMASK-IPV6:CAPS"/>
709	725	<keyword type="macro" name="TP_STRUCT_TYPE_PARAM_SPEC" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-PARAM-SPEC:CAPS"/>
710	726	<keyword type="macro" name="TP_ARRAY_TYPE_PARAM_SPEC_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-PARAM-SPEC-LIST:CAPS"/>
	727	<keyword type="macro" name="TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-PROTOCOL-PROPERTIES-MAP:CAPS"/>
711	728	<keyword type="macro" name="TP_STRUCT_TYPE_CHANNEL_INFO" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-CHANNEL-INFO:CAPS"/>
712	729	<keyword type="macro" name="TP_ARRAY_TYPE_CHANNEL_INFO_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-CHANNEL-INFO-LIST:CAPS"/>
713	730	<keyword type="macro" name="TP_HASH_TYPE_ALIAS_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-ALIAS-MAP:CAPS"/>

1000	1017	<keyword type="property" name="The "presence-type" property" link="telepathy-glib-contact.html#TpContact--presence-type"/>
1001	1018	<keyword type="signal" name="The "presence-changed" signal" link="telepathy-glib-contact.html#TpContact-presence-changed"/>
1002	1019	<keyword type="struct" name="TpCapabilities" link="telepathy-glib-capabilities.html#TpCapabilities-struct"/>
1003		<keyword type="function" name="tp_capabilities_get_channel_classes ()" link="telepathy-glib-capabilities.html#tp-capabilities-get-channel-classes"/>
	1020	<keyword type="function" name="tp_capabilities_get_channel_classes ()" link="telepathy-glib-capabilities.html#tp-capabilities-get-channel-classes" since="0.11.3"/>
1004	1021	<keyword type="function" name="tp_capabilities_is_specific_to_contact ()" link="telepathy-glib-capabilities.html#tp-capabilities-is-specific-to-contact" since="0.11.3"/>
1005	1022	<keyword type="function" name="tp_capabilities_supports_text_chatrooms ()" link="telepathy-glib-capabilities.html#tp-capabilities-supports-text-chatrooms" since="0.11.3"/>
1006	1023	<keyword type="function" name="tp_capabilities_supports_text_chats ()" link="telepathy-glib-capabilities.html#tp-capabilities-supports-text-chats" since="0.11.3"/>

1128	1145	<keyword type="function" name="tp_cli_connection_interface_presence_callback_for_set_status ()" link="telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-callback-for-set-status"/>
1129	1146	<keyword type="function" name="tp_cli_connection_interface_presence_connect_to_presence_update ()" link="telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-connect-to-presence-update"/>
1130	1147	<keyword type="function" name="tp_cli_connection_interface_presence_signal_callback_presence_update ()" link="telepathy-glib-connection-presence.html#tp-cli-connection-interface-presence-signal-callback-presence-update"/>
	1148	<keyword type="function" name="tp_cli_connection_interface_cellular_connect_to_imsi_changed ()" link="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-connect-to-imsi-changed"/>
	1149	<keyword type="function" name="tp_cli_connection_interface_cellular_signal_callback_imsi_changed ()" link="telepathy-glib-connection-cellular.html#tp-cli-connection-interface-cellular-signal-callback-imsi-changed"/>
1131	1150	<keyword type="struct" name="TpChannel" link="telepathy-glib-channel.html#TpChannel-struct"/>
1132	1151	<keyword type="struct" name="TpChannelClass" link="telepathy-glib-channel.html#TpChannelClass" since="0.7.1"/>
1133	1152	<keyword type="function" name="tp_channel_new ()" link="telepathy-glib-channel.html#tp-channel-new" since="0.7.1"/>

1530	1549	<keyword type="function" name="tp_account_get_connection_manager ()" link="telepathy-glib-account.html#tp-account-get-connection-manager" since="0.9.0"/>
1531	1550	<keyword type="function" name="tp_account_get_protocol ()" link="telepathy-glib-account.html#tp-account-get-protocol" since="0.9.0"/>
1532	1551	<keyword type="function" name="tp_account_get_icon_name ()" link="telepathy-glib-account.html#tp-account-get-icon-name" since="0.9.0"/>
	1552	<keyword type="function" name="tp_account_get_service ()" link="telepathy-glib-account.html#tp-account-get-service" since="0.11.UNRELEASED"/>
1533	1553	<keyword type="function" name="tp_account_set_enabled_async ()" link="telepathy-glib-account.html#tp-account-set-enabled-async" since="0.9.0"/>
1534	1554	<keyword type="function" name="tp_account_set_enabled_finish ()" link="telepathy-glib-account.html#tp-account-set-enabled-finish" since="0.9.0"/>
1535	1555	<keyword type="function" name="tp_account_reconnect_async ()" link="telepathy-glib-account.html#tp-account-reconnect-async" since="0.9.0"/>

1544	1564	<keyword type="function" name="tp_account_set_display_name_finish ()" link="telepathy-glib-account.html#tp-account-set-display-name-finish" since="0.9.0"/>
1545	1565	<keyword type="function" name="tp_account_set_icon_name_async ()" link="telepathy-glib-account.html#tp-account-set-icon-name-async" since="0.9.0"/>
1546	1566	<keyword type="function" name="tp_account_set_icon_name_finish ()" link="telepathy-glib-account.html#tp-account-set-icon-name-finish" since="0.9.0"/>
	1567	<keyword type="function" name="tp_account_set_service_async ()" link="telepathy-glib-account.html#tp-account-set-service-async" since="0.11.UNRELEASED"/>
	1568	<keyword type="function" name="tp_account_set_service_finish ()" link="telepathy-glib-account.html#tp-account-set-service-finish" since="0.11.UNRELEASED"/>
1547	1569	<keyword type="function" name="tp_account_request_presence_async ()" link="telepathy-glib-account.html#tp-account-request-presence-async" since="0.9.0"/>
1548	1570	<keyword type="function" name="tp_account_request_presence_finish ()" link="telepathy-glib-account.html#tp-account-request-presence-finish" since="0.9.0"/>
1549	1571	<keyword type="function" name="tp_account_get_connect_automatically ()" link="telepathy-glib-account.html#tp-account-get-connect-automatically" since="0.9.0"/>

1599	1621	<keyword type="property" name="The "requested-presence-type" property" link="telepathy-glib-account.html#TpAccount--requested-presence-type"/>
1600	1622	<keyword type="property" name="The "requested-status" property" link="telepathy-glib-account.html#TpAccount--requested-status"/>
1601	1623	<keyword type="property" name="The "requested-status-message" property" link="telepathy-glib-account.html#TpAccount--requested-status-message"/>
	1624	<keyword type="property" name="The "service" property" link="telepathy-glib-account.html#TpAccount--service"/>
1602	1625	<keyword type="property" name="The "valid" property" link="telepathy-glib-account.html#TpAccount--valid"/>
1603	1626	<keyword type="signal" name="The "presence-changed" signal" link="telepathy-glib-account.html#TpAccount-presence-changed"/>
1604	1627	<keyword type="signal" name="The "status-changed" signal" link="telepathy-glib-account.html#TpAccount-status-changed"/>

2177	2200	<keyword type="function" name="tp_svc_connection_interface_contact_info_return_from_request_contact_info ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-return-from-request-contact-info"/>
2178	2201	<keyword type="function" name="tp_svc_connection_interface_contact_info_return_from_set_contact_info ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-return-from-set-contact-info"/>
2179	2202	<keyword type="function" name="tp_svc_connection_interface_contact_info_set_contact_info_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-info-set-contact-info-impl"/>
	2203	<keyword type="struct" name="TpSvcConnectionInterfaceCellular" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-struct"/>
	2204	<keyword type="struct" name="TpSvcConnectionInterfaceCellularClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellularClass"/>
	2205	<keyword type="function" name="tp_svc_connection_interface_cellular_emit_imsi_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-cellular-emit-imsi-changed"/>
2180	2206	<keyword type="signal" name="The "connection-error" signal" link="telepathy-glib-svc-connection.html#TpSvcConnection-connection-error"/>
2181	2207	<keyword type="signal" name="The "new-channel" signal" link="telepathy-glib-svc-connection.html#TpSvcConnection-new-channel"/>
2182	2208	<keyword type="signal" name="The "self-handle-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnection-self-handle-changed"/>

2193	2219	<keyword type="signal" name="The "contact-capabilities-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed"/>
2194	2220	<keyword type="signal" name="The "location-updated" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated"/>
2195	2221	<keyword type="signal" name="The "contact-info-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed"/>
	2222	<keyword type="signal" name="The "i-ms-ichanged" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular-i-ms-ichanged"/>
2196	2223	<keyword type="struct" name="TpSvcConnectionInterfaceAnonymity" link="telepathy-glib-svc-anonymity.html#TpSvcConnectionInterfaceAnonymity-struct"/>
2197	2224	<keyword type="struct" name="TpSvcConnectionInterfaceAnonymityClass" link="telepathy-glib-svc-anonymity.html#TpSvcConnectionInterfaceAnonymityClass"/>
2198	2225	<keyword type="function" name="tp_svc_connection_interface_anonymity_emit_anonymity_modes_changed ()" link="telepathy-glib-svc-anonymity.html#tp-svc-connection-interface-anonymity-emit-anonymity-modes-changed"/>

2315	2342	<keyword type="struct" name="TpSvcAccountInterfaceAvatar" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct"/>
2316	2343	<keyword type="struct" name="TpSvcAccountInterfaceAvatarClass" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass"/>
2317	2344	<keyword type="function" name="tp_svc_account_interface_avatar_emit_avatar_changed ()" link="telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed"/>
	2345	<keyword type="struct" name="TpSvcAccountInterfaceStorage" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorage-struct"/>
	2346	<keyword type="struct" name="TpSvcAccountInterfaceStorageClass" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceStorageClass"/>
2318	2347	<keyword type="signal" name="The "account-property-changed" signal" link="telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed"/>
2319	2348	<keyword type="signal" name="The "removed" signal" link="telepathy-glib-svc-account.html#TpSvcAccount-removed"/>
2320	2349	<keyword type="signal" name="The "avatar-changed" signal" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-avatar-changed"/>

2814	2843	<keyword type="macro" name="tp_clear_pointer()" link="telepathy-glib-util.html#tp-clear-pointer" since="0.11.7"/>
2815	2844	<keyword type="macro" name="tp_clear_object()" link="telepathy-glib-util.html#tp-clear-object" since="0.11.7"/>
2816	2845	<keyword type="macro" name="tp_clear_boxed()" link="telepathy-glib-util.html#tp-clear-boxed" since="0.11.7"/>
	2846	<keyword type="function" name="tp_simple_async_report_success_in_idle ()" link="telepathy-glib-util.html#tp-simple-async-report-success-in-idle" since="0.11.UNRELEASED"/>
2817	2847	<keyword type="function" name="tp_g_socket_address_from_variant ()" link="telepathy-glib-gnio-util.html#tp-g-socket-address-from-variant"/>
2818	2848	<keyword type="function" name="tp_address_variant_from_g_socket_address ()" link="telepathy-glib-gnio-util.html#tp-address-variant-from-g-socket-address"/>
2819	2849	<keyword type="macro" name="TP_ANSI_RESET" link="telepathy-glib-debug-ansi.html#TP-ANSI-RESET:CAPS"/>

3112	3142	<keyword type="constant" name="TP_ANONYMITY_MODE_CLIENT_INFO" link="telepathy-glib-enums.html#TP-ANONYMITY-MODE-CLIENT-INFO:CAPS"/>
3113	3143	<keyword type="constant" name="TP_ANONYMITY_MODE_SHOW_CLIENT_INFO" link="telepathy-glib-enums.html#TP-ANONYMITY-MODE-SHOW-CLIENT-INFO:CAPS"/>
3114	3144	<keyword type="constant" name="TP_ANONYMITY_MODE_NETWORK_INFO" link="telepathy-glib-enums.html#TP-ANONYMITY-MODE-NETWORK-INFO:CAPS"/>
	3145	<keyword type="constant" name="TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PARAMETERS" link="telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PARAMETERS:CAPS"/>
	3146	<keyword type="constant" name="TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_ENABLED" link="telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-ENABLED:CAPS"/>
	3147	<keyword type="constant" name="TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PRESENCE" link="telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-PRESENCE:CAPS"/>
	3148	<keyword type="constant" name="TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_SERVICE" link="telepathy-glib-enums.html#TP-STORAGE-RESTRICTION-FLAG-CANNOT-SET-SERVICE:CAPS"/>
3115	3149	<keyword type="constant" name="TP_ERROR_NETWORK_ERROR" link="telepathy-glib-errors.html#TP-ERROR-NETWORK-ERROR:CAPS"/>
3116	3150	<keyword type="constant" name="TP_ERROR_NOT_IMPLEMENTED" link="telepathy-glib-errors.html#TP-ERROR-NOT-IMPLEMENTED:CAPS"/>
3117	3151	<keyword type="constant" name="TP_ERROR_INVALID_ARGUMENT" link="telepathy-glib-errors.html#TP-ERROR-INVALID-ARGUMENT:CAPS"/>

-0

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

40	40	<xi:include href="xml/connection-requests.xml"/>
41	41	<xi:include href="xml/connection-simple-presence.xml"/>
42	42	<xi:include href="xml/connection-presence.xml"/>
	43	<xi:include href="xml/connection-cellular.xml"/>
43	44	<xi:include href="xml/channel.xml"/>
44	45	<xi:include href="xml/channel-group.xml"/>
45	46	<xi:include href="xml/channel-text.xml"/>

+49

-0

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

1041	1041	TP_SVC_CONNECTION_INTERFACE_CONTACT_INFO
1042	1042	TP_SVC_CONNECTION_INTERFACE_CONTACT_INFO_GET_CLASS
1043	1043	TP_TYPE_SVC_CONNECTION_INTERFACE_CONTACT_INFO
	1044	<SUBSECTION>
	1045	TpSvcConnectionInterfaceCellular
	1046	TpSvcConnectionInterfaceCellularClass
	1047	tp_svc_connection_interface_cellular_emit_imsi_changed
	1048	<SUBSECTION Standard>
	1049	TP_IS_SVC_CONNECTION_INTERFACE_CELLULAR
	1050	TP_SVC_CONNECTION_INTERFACE_CELLULAR
	1051	TP_SVC_CONNECTION_INTERFACE_CELLULAR_GET_CLASS
	1052	TP_TYPE_SVC_CONNECTION_INTERFACE_CELLULAR
	1053	tp_svc_connection_interface_cellular_get_type
1044	1054	</SECTION>
1045	1055
1046	1056	<SECTION>

1190	1200	tp_clear_pointer
1191	1201	tp_clear_object
1192	1202	tp_clear_boxed
	1203	tp_simple_async_report_success_in_idle
1193	1204	</SECTION>
1194	1205
1195	1206	<SECTION>

1225	1236	# Connection Manager
1226	1237	TP_STRUCT_TYPE_PARAM_SPEC
1227	1238	TP_ARRAY_TYPE_PARAM_SPEC_LIST
	1239	TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP
1228	1240	<SUBSECTION>
1229	1241	# Connection
1230	1242	TP_STRUCT_TYPE_CHANNEL_INFO

2097	2109	TpServicePointType
2098	2110	NUM_TP_SERVICE_POINT_TYPES
2099	2111	TpAnonymityModeFlags
	2112	TpStorageRestrictionFlags
2100	2113	</SECTION>
2101	2114
2102	2115	<SECTION>

2107	2120	TP_IFACE_QUARK_ACCOUNT
2108	2121	TP_IFACE_ACCOUNT_INTERFACE_AVATAR
2109	2122	TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR
	2123	TP_IFACE_ACCOUNT_INTERFACE_STORAGE
	2124	TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE
2110	2125	TP_IFACE_ACCOUNT_MANAGER
2111	2126	TP_IFACE_QUARK_ACCOUNT_MANAGER
2112	2127	TP_IFACE_DBUS_DAEMON

2133	2148	TP_IFACE_QUARK_CONNECTION_INTERFACE_BALANCE
2134	2149	TP_IFACE_CONNECTION_INTERFACE_CAPABILITIES
2135	2150	TP_IFACE_QUARK_CONNECTION_INTERFACE_CAPABILITIES
	2151	TP_IFACE_CONNECTION_INTERFACE_CELLULAR
	2152	TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR
2136	2153	TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
2137	2154	TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
2138	2155	TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO

2230	2247	TP_PROP_ACCOUNT_ICON
2231	2248	TP_PROP_ACCOUNT_INTERFACES
2232	2249	TP_PROP_ACCOUNT_INTERFACE_AVATAR_AVATAR
	2250	TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER
	2251	TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER
	2252	TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS
	2253	TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION
2233	2254	TP_PROP_ACCOUNT_MANAGER_INTERFACES
2234	2255	TP_PROP_ACCOUNT_MANAGER_INVALID_ACCOUNTS
2235	2256	TP_PROP_ACCOUNT_MANAGER_SUPPORTED_ACCOUNT_PROPERTIES

2238	2259	TP_PROP_ACCOUNT_NORMALIZED_NAME
2239	2260	TP_PROP_ACCOUNT_PARAMETERS
2240	2261	TP_PROP_ACCOUNT_REQUESTED_PRESENCE
	2262	TP_PROP_ACCOUNT_SERVICE
2241	2263	TP_PROP_ACCOUNT_VALID
2242	2264	TP_PROP_CHANNEL_CHANNEL_TYPE
2243	2265	TP_PROP_CHANNEL_DISPATCHER_INTERFACES

2319	2341	TP_PROP_CONNECTION_INTERFACE_AVATARS_RECOMMENDED_AVATAR_WIDTH
2320	2342	TP_PROP_CONNECTION_INTERFACE_AVATARS_SUPPORTED_AVATAR_MIME_TYPES
2321	2343	TP_PROP_CONNECTION_INTERFACE_BALANCE_ACCOUNT_BALANCE
	2344	TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI
	2345	TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET
	2346	TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE
	2347	TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD
2322	2348	TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES
2323	2349	TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_CONTACT_INFO_FLAGS
2324	2350	TP_PROP_CONNECTION_INTERFACE_CONTACT_INFO_SUPPORTED_FIELDS

2330	2356	TP_PROP_CONNECTION_INTERFACE_SERVICE_POINT_KNOWN_SERVICE_POINTS
2331	2357	TP_PROP_CONNECTION_INTERFACE_SIMPLE_PRESENCE_STATUSES
2332	2358	TP_PROP_CONNECTION_MANAGER_INTERFACES
	2359	TP_PROP_CONNECTION_MANAGER_PROTOCOLS
2333	2360	TP_PROP_CONNECTION_INTERFACES
2334	2361	TP_PROP_CONNECTION_SELF_HANDLE
2335	2362	TP_PROP_CONNECTION_STATUS

2353	2380	<SUBSECTION Private>
2354	2381	tp_iface_quark_account
2355	2382	tp_iface_quark_account_interface_avatar
	2383	tp_iface_quark_account_interface_storage
2356	2384	tp_iface_quark_account_manager
2357	2385	tp_iface_quark_dbus_introspectable
2358	2386	tp_iface_quark_dbus_peer

2389	2417	tp_iface_quark_connection_interface_aliasing
2390	2418	tp_iface_quark_connection_interface_avatars
2391	2419	tp_iface_quark_connection_interface_balance
	2420	tp_iface_quark_connection_interface_cellular
2392	2421	tp_iface_quark_connection_interface_contacts
2393	2422	tp_iface_quark_connection_interface_contact_capabilities
2394	2423	tp_iface_quark_connection_interface_contact_info

3089	3118	tp_cli_connection_interface_capabilities_callback_for_get_capabilities
3090	3119	tp_cli_connection_interface_capabilities_connect_to_capabilities_changed
3091	3120	tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed
	3121	</SECTION>
	3122
	3123	<SECTION>
	3124	<FILE>connection-cellular</FILE>
	3125	<TITLE>connection-cellular</TITLE>
	3126	<INCLUDE>telepathy-glib/connection.h</INCLUDE>
	3127	tp_cli_connection_interface_cellular_connect_to_imsi_changed
	3128	tp_cli_connection_interface_cellular_signal_callback_imsi_changed
3092	3129	</SECTION>
3093	3130
3094	3131	<SECTION>

3470	3507	TP_TYPE_SVC_ACCOUNT_INTERFACE_AVATAR
3471	3508	tp_svc_account_interface_avatar_get_type
3472	3509	TP_SVC_ACCOUNT_INTERFACE_AVATAR_GET_CLASS
	3510	<SUBSECTION>
	3511	TpSvcAccountInterfaceStorage
	3512	TpSvcAccountInterfaceStorageClass
	3513	<SUBSECTION Standard>
	3514	TP_IS_SVC_ACCOUNT_INTERFACE_STORAGE
	3515	TP_SVC_ACCOUNT_INTERFACE_STORAGE
	3516	TP_SVC_ACCOUNT_INTERFACE_STORAGE_GET_CLASS
	3517	TP_TYPE_SVC_ACCOUNT_INTERFACE_STORAGE
	3518	tp_svc_account_interface_storage_get_type
3473	3519	</SECTION>
3474	3520
3475	3521	<SECTION>

3506	3552	tp_account_get_connection_manager
3507	3553	tp_account_get_protocol
3508	3554	tp_account_get_icon_name
	3555	tp_account_get_service
3509	3556	tp_account_set_enabled_async
3510	3557	tp_account_set_enabled_finish
3511	3558	tp_account_reconnect_async

3520	3567	tp_account_set_display_name_finish
3521	3568	tp_account_set_icon_name_async
3522	3569	tp_account_set_icon_name_finish
	3570	tp_account_set_service_async
	3571	tp_account_set_service_finish
3523	3572	tp_account_request_presence_async
3524	3573	tp_account_request_presence_finish
3525	3574	tp_account_get_connect_automatically

-0

docs/reference/telepathy-glib.types less more

46	46	tp_static_handle_repo_get_type
47	47	tp_svc_account_get_type
48	48	tp_svc_account_interface_avatar_get_type
	49	tp_svc_account_interface_storage_get_type
49	50	tp_svc_account_manager_get_type
50	51	tp_svc_channel_dispatch_operation_get_type
51	52	tp_svc_channel_dispatcher_get_type

83	84	tp_svc_connection_interface_avatars_get_type
84	85	tp_svc_connection_interface_balance_get_type
85	86	tp_svc_connection_interface_capabilities_get_type
	87	tp_svc_connection_interface_cellular_get_type
86	88	tp_svc_connection_interface_contact_capabilities_get_type
87	89	tp_svc_connection_interface_contact_info_get_type
88	90	tp_svc_connection_interface_contacts_get_type

+36

-0

docs/reference/tmpl/account.sgml less more

147	147
148	148	</para>
149	149
	150	<!-- ##### ARG TpAccount:service ##### -->
	151	<para>
	152
	153	</para>
	154
150	155	<!-- ##### ARG TpAccount:valid ##### -->
151	156	<para>
152	157

245	250	@Returns:
246	251
247	252
	253	<!-- ##### FUNCTION tp_account_get_service ##### -->
	254	<para>
	255
	256	</para>
	257
	258	@self:
	259	@Returns:
	260
	261
248	262	<!-- ##### FUNCTION tp_account_set_enabled_async ##### -->
249	263	<para>
250	264

390	404	</para>
391	405
392	406	@account:
	407	@result:
	408	@error:
	409	@Returns:
	410
	411
	412	<!-- ##### FUNCTION tp_account_set_service_async ##### -->
	413	<para>
	414
	415	</para>
	416
	417	@self:
	418	@service:
	419	@callback:
	420	@user_data:
	421
	422
	423	<!-- ##### FUNCTION tp_account_set_service_finish ##### -->
	424	<para>
	425
	426	</para>
	427
	428	@self:
393	429	@result:
394	430	@error:
395	431	@Returns:

-768

~~docs/reference/tmpl/base-contact-list.sgml~~ less more

0		<!-- ##### SECTION Title ##### -->
1		base-contact-list
2
3		<!-- ##### SECTION Short_Description ##### -->
4
5
6		<!-- ##### SECTION Long_Description ##### -->
7		<para>
8
9		</para>
10
11		<!-- ##### SECTION See_Also ##### -->
12		<para>
13
14		</para>
15
16		<!-- ##### SECTION Stability_Level ##### -->
17
18
19		<!-- ##### SECTION Image ##### -->
20
21
22		<!-- ##### STRUCT TpBaseContactList ##### -->
23		<para>
24
25		</para>
26
27
28		<!-- ##### ARG TpBaseContactList:connection ##### -->
29		<para>
30
31		</para>
32
33		<!-- ##### STRUCT TpBaseContactListClass ##### -->
34		<para>
35
36		</para>
37
38		@parent_class:
39		@get_contacts:
40		@get_states:
41		@get_subscriptions_persist:
42
43		<!-- ##### FUNCTION tp_base_contact_list_mixin_class_init ##### -->
44		<para>
45
46		</para>
47
48		@cls:
49
50
51		<!-- ##### FUNCTION tp_base_contact_list_mixin_register_with_contacts_mixin ##### -->
52		<para>
53
54		</para>
55
56		@conn:
57
58
59		<!-- ##### FUNCTION tp_base_contact_list_mixin_list_iface_init ##### -->
60		<para>
61
62		</para>
63
64		@klass:
65
66
67		<!-- ##### FUNCTION tp_base_contact_list_mixin_groups_iface_init ##### -->
68		<para>
69
70		</para>
71
72		@klass:
73
74
75		<!-- ##### FUNCTION tp_base_contact_list_set_list_received ##### -->
76		<para>
77
78		</para>
79
80		@self:
81
82
83		<!-- ##### FUNCTION tp_base_contact_list_contacts_changed ##### -->
84		<para>
85
86		</para>
87
88		@self:
89		@changed:
90		@removed:
91
92
93		<!-- ##### USER_FUNCTION TpBaseContactListBooleanFunc ##### -->
94		<para>
95
96		</para>
97
98		@self:
99		@Returns:
100
101
102		<!-- ##### FUNCTION tp_base_contact_list_false_func ##### -->
103		<para>
104
105		</para>
106
107		@self:
108		@Returns:
109
110
111		<!-- ##### FUNCTION tp_base_contact_list_true_func ##### -->
112		<para>
113
114		</para>
115
116		@self:
117		@Returns:
118
119
120		<!-- ##### FUNCTION tp_base_contact_list_get_subscriptions_persist ##### -->
121		<para>
122
123		</para>
124
125		@self:
126		@Returns:
127
128
129		<!-- ##### USER_FUNCTION TpBaseContactListGetContactsFunc ##### -->
130		<para>
131
132		</para>
133
134		@self:
135		@Returns:
136
137
138		<!-- ##### FUNCTION tp_base_contact_list_get_contacts ##### -->
139		<para>
140
141		</para>
142
143		@self:
144		@Returns:
145
146
147		<!-- ##### USER_FUNCTION TpBaseContactListGetStatesFunc ##### -->
148		<para>
149
150		</para>
151
152		@self:
153		@contact:
154		@subscribe:
155		@publish:
156		@publish_request:
157
158
159		<!-- ##### FUNCTION tp_base_contact_list_get_states ##### -->
160		<para>
161
162		</para>
163
164		@self:
165		@contact:
166		@subscribe:
167		@publish:
168		@publish_request:
169
170
171		<!-- ##### USER_FUNCTION TpBaseContactListUIntFunc ##### -->
172		<para>
173
174		</para>
175
176		@self:
177		@Returns:
178
179
180		<!-- ##### USER_FUNCTION TpBaseContactListAsyncFinishFunc ##### -->
181		<para>
182
183		</para>
184
185		@self:
186		@result:
187		@error:
188		@Returns:
189
190
191		<!-- ##### MACRO TP_TYPE_MUTABLE_CONTACT_LIST ##### -->
192		<para>
193
194		</para>
195
196
197
198		<!-- ##### STRUCT TpMutableContactListInterface ##### -->
199		<para>
200
201		</para>
202
203		@parent:
204		@request_subscription_async:
205		@request_subscription_finish:
206		@authorize_publication_async:
207		@authorize_publication_finish:
208		@remove_contacts_async:
209		@remove_contacts_finish:
210		@unsubscribe_async:
211		@unsubscribe_finish:
212		@unpublish_async:
213		@unpublish_finish:
214		@store_contacts_async:
215		@store_contacts_finish:
216		@can_change_subscriptions:
217		@get_request_uses_message:
218
219		<!-- ##### FUNCTION tp_base_contact_list_can_change_subscriptions ##### -->
220		<para>
221
222		</para>
223
224		@self:
225		@Returns:
226
227
228		<!-- ##### FUNCTION tp_base_contact_list_get_request_uses_message ##### -->
229		<para>
230
231		</para>
232
233		@self:
234		@Returns:
235
236
237		<!-- ##### USER_FUNCTION TpBaseContactListRequestSubscriptionFunc ##### -->
238		<para>
239
240		</para>
241
242		@self:
243		@contacts:
244		@message:
245		@callback:
246		@user_data:
247
248
249		<!-- ##### FUNCTION tp_base_contact_list_request_subscription_async ##### -->
250		<para>
251
252		</para>
253
254		@self:
255		@contacts:
256		@message:
257		@callback:
258		@user_data:
259
260
261		<!-- ##### FUNCTION tp_base_contact_list_request_subscription_finish ##### -->
262		<para>
263
264		</para>
265
266		@self:
267		@result:
268		@error:
269		@Returns:
270
271
272		<!-- ##### USER_FUNCTION TpBaseContactListActOnContactsFunc ##### -->
273		<para>
274
275		</para>
276
277		@self:
278		@contacts:
279		@callback:
280		@user_data:
281
282
283		<!-- ##### FUNCTION tp_base_contact_list_authorize_publication_async ##### -->
284		<para>
285
286		</para>
287
288		@self:
289		@contacts:
290		@callback:
291		@user_data:
292
293
294		<!-- ##### FUNCTION tp_base_contact_list_authorize_publication_finish ##### -->
295		<para>
296
297		</para>
298
299		@self:
300		@result:
301		@error:
302		@Returns:
303
304
305		<!-- ##### FUNCTION tp_base_contact_list_store_contacts_async ##### -->
306		<para>
307
308		</para>
309
310		@self:
311		@contacts:
312		@callback:
313		@user_data:
314
315
316		<!-- ##### FUNCTION tp_base_contact_list_store_contacts_finish ##### -->
317		<para>
318
319		</para>
320
321		@self:
322		@result:
323		@error:
324		@Returns:
325
326
327		<!-- ##### FUNCTION tp_base_contact_list_remove_contacts_async ##### -->
328		<para>
329
330		</para>
331
332		@self:
333		@contacts:
334		@callback:
335		@user_data:
336
337
338		<!-- ##### FUNCTION tp_base_contact_list_remove_contacts_finish ##### -->
339		<para>
340
341		</para>
342
343		@self:
344		@result:
345		@error:
346		@Returns:
347
348
349		<!-- ##### FUNCTION tp_base_contact_list_unsubscribe_async ##### -->
350		<para>
351
352		</para>
353
354		@self:
355		@contacts:
356		@callback:
357		@user_data:
358
359
360		<!-- ##### FUNCTION tp_base_contact_list_unsubscribe_finish ##### -->
361		<para>
362
363		</para>
364
365		@self:
366		@result:
367		@error:
368		@Returns:
369
370
371		<!-- ##### FUNCTION tp_base_contact_list_unpublish_async ##### -->
372		<para>
373
374		</para>
375
376		@self:
377		@contacts:
378		@callback:
379		@user_data:
380
381
382		<!-- ##### FUNCTION tp_base_contact_list_unpublish_finish ##### -->
383		<para>
384
385		</para>
386
387		@self:
388		@result:
389		@error:
390		@Returns:
391
392
393		<!-- ##### MACRO TP_TYPE_CONTACT_GROUP_LIST ##### -->
394		<para>
395
396		</para>
397
398
399
400		<!-- ##### STRUCT TpContactGroupListInterface ##### -->
401		<para>
402
403		</para>
404
405		@parent:
406		@get_groups:
407		@get_contact_groups:
408		@has_disjoint_groups:
409		@normalize_group:
410
411		<!-- ##### USER_FUNCTION TpBaseContactListNormalizeFunc ##### -->
412		<para>
413
414		</para>
415
416		@self:
417		@s:
418		@Returns:
419
420
421		<!-- ##### FUNCTION tp_base_contact_list_normalize_group ##### -->
422		<para>
423
424		</para>
425
426		@self:
427		@s:
428		@Returns:
429
430
431		<!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### -->
432		<para>
433
434		</para>
435
436		@self:
437		@contact:
438		@Returns:
439
440
441		<!-- ##### FUNCTION tp_base_contact_list_get_contact_groups ##### -->
442		<para>
443
444		</para>
445
446		@self:
447		@contact:
448		@Returns:
449
450
451		<!-- ##### USER_FUNCTION TpBaseContactListGetGroupsFunc ##### -->
452		<para>
453
454		</para>
455
456		@self:
457		@Returns:
458
459
460		<!-- ##### FUNCTION tp_base_contact_list_get_groups ##### -->
461		<para>
462
463		</para>
464
465		@self:
466		@Returns:
467
468
469		<!-- ##### FUNCTION tp_base_contact_list_group_renamed ##### -->
470		<para>
471
472		</para>
473
474		@self:
475		@old_name:
476		@new_name:
477
478
479		<!-- ##### FUNCTION tp_base_contact_list_groups_changed ##### -->
480		<para>
481
482		</para>
483
484		@self:
485		@contacts:
486		@added:
487		@n_added:
488		@removed:
489		@n_removed:
490
491
492		<!-- ##### FUNCTION tp_base_contact_list_groups_created ##### -->
493		<para>
494
495		</para>
496
497		@self:
498		@created:
499		@n_created:
500
501
502		<!-- ##### FUNCTION tp_base_contact_list_groups_removed ##### -->
503		<para>
504
505		</para>
506
507		@self:
508		@removed:
509		@n_removed:
510
511
512		<!-- ##### FUNCTION tp_base_contact_list_has_disjoint_groups ##### -->
513		<para>
514
515		</para>
516
517		@self:
518		@Returns:
519
520
521		<!-- ##### MACRO TP_TYPE_MUTABLE_CONTACT_GROUP_LIST ##### -->
522		<para>
523
524		</para>
525
526
527
528		<!-- ##### STRUCT TpMutableContactGroupListInterface ##### -->
529		<para>
530
531		</para>
532
533		@parent:
534		@set_contact_groups_async:
535		@set_contact_groups_finish:
536		@create_groups:
537		@add_to_group:
538		@remove_from_group:
539		@remove_group:
540		@rename_group:
541		@get_group_storage:
542
543		<!-- ##### USER_FUNCTION TpBaseContactListSetContactGroupsFunc ##### -->
544		<para>
545
546		</para>
547
548		@self:
549		@contact:
550		@normalized_names:
551		@n_names:
552		@callback:
553		@user_data:
554
555
556		<!-- ##### FUNCTION tp_base_contact_list_set_contact_groups_async ##### -->
557		<para>
558
559		</para>
560
561		@self:
562		@contact:
563		@normalized_names:
564		@n_names:
565		@callback:
566		@user_data:
567
568
569		<!-- ##### FUNCTION tp_base_contact_list_set_contact_groups_finish ##### -->
570		<para>
571
572		</para>
573
574		@self:
575		@result:
576		@error:
577		@Returns:
578
579
580		<!-- ##### USER_FUNCTION TpBaseContactListCreateGroupsFunc ##### -->
581		<para>
582
583		</para>
584
585		@self:
586		@normalized_names:
587		@n_names:
588
589
590		<!-- ##### FUNCTION tp_base_contact_list_create_groups ##### -->
591		<para>
592
593		</para>
594
595		@self:
596		@normalized_names:
597		@n_names:
598
599
600		<!-- ##### USER_FUNCTION TpBaseContactListGroupContactsFunc ##### -->
601		<para>
602
603		</para>
604
605		@self:
606		@group:
607		@contacts:
608
609
610		<!-- ##### FUNCTION tp_base_contact_list_add_to_group ##### -->
611		<para>
612
613		</para>
614
615		@self:
616		@group:
617		@contacts:
618
619
620		<!-- ##### FUNCTION tp_base_contact_list_remove_from_group ##### -->
621		<para>
622
623		</para>
624
625		@self:
626		@group:
627		@contacts:
628
629
630		<!-- ##### USER_FUNCTION TpBaseContactListRemoveGroupFunc ##### -->
631		<para>
632
633		</para>
634
635		@self:
636		@group:
637
638
639		<!-- ##### FUNCTION tp_base_contact_list_remove_group ##### -->
640		<para>
641
642		</para>
643
644		@self:
645		@group:
646
647
648		<!-- ##### USER_FUNCTION TpBaseContactListRenameGroupFunc ##### -->
649		<para>
650
651		</para>
652
653		@self:
654		@old_name:
655		@new_name:
656
657
658		<!-- ##### FUNCTION tp_base_contact_list_rename_group ##### -->
659		<para>
660
661		</para>
662
663		@self:
664		@old_name:
665		@new_name:
666
667
668		<!-- ##### FUNCTION tp_base_contact_list_get_group_storage ##### -->
669		<para>
670
671		</para>
672
673		@self:
674		@Returns:
675
676
677		<!-- ##### MACRO TP_TYPE_BLOCKABLE_CONTACT_LIST ##### -->
678		<para>
679
680		</para>
681
682
683
684		<!-- ##### STRUCT TpBlockableContactListInterface ##### -->
685		<para>
686
687		</para>
688
689		@parent:
690		@get_blocked_contacts:
691		@block_contacts_async:
692		@block_contacts_finish:
693		@unblock_contacts_async:
694		@unblock_contacts_finish:
695		@can_block:
696
697		<!-- ##### FUNCTION tp_base_contact_list_can_block ##### -->
698		<para>
699
700		</para>
701
702		@self:
703		@Returns:
704
705
706		<!-- ##### FUNCTION tp_base_contact_list_get_blocked_contacts ##### -->
707		<para>
708
709		</para>
710
711		@self:
712		@Returns:
713
714
715		<!-- ##### FUNCTION tp_base_contact_list_block_contacts_async ##### -->
716		<para>
717
718		</para>
719
720		@self:
721		@contacts:
722		@callback:
723		@user_data:
724
725
726		<!-- ##### FUNCTION tp_base_contact_list_block_contacts_finish ##### -->
727		<para>
728
729		</para>
730
731		@self:
732		@result:
733		@error:
734		@Returns:
735
736
737		<!-- ##### FUNCTION tp_base_contact_list_unblock_contacts_async ##### -->
738		<para>
739
740		</para>
741
742		@self:
743		@contacts:
744		@callback:
745		@user_data:
746
747
748		<!-- ##### FUNCTION tp_base_contact_list_unblock_contacts_finish ##### -->
749		<para>
750
751		</para>
752
753		@self:
754		@result:
755		@error:
756		@Returns:
757
758
759		<!-- ##### FUNCTION tp_base_contact_list_contact_blocking_changed ##### -->
760		<para>
761
762		</para>
763
764		@self:
765		@changed:
766
767

+47

-0

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

	0	<!-- ##### SECTION Title ##### -->
	1	connection-cellular
	2
	3	<!-- ##### SECTION Short_Description ##### -->
	4
	5
	6	<!-- ##### SECTION Long_Description ##### -->
	7	<para>
	8
	9	</para>
	10
	11	<!-- ##### SECTION See_Also ##### -->
	12	<para>
	13
	14	</para>
	15
	16	<!-- ##### SECTION Stability_Level ##### -->
	17
	18
	19	<!-- ##### SECTION Image ##### -->
	20
	21
	22	<!-- ##### FUNCTION tp_cli_connection_interface_cellular_connect_to_imsi_changed ##### -->
	23	<para>
	24
	25	</para>
	26
	27	@proxy:
	28	@callback:
	29	@user_data:
	30	@destroy:
	31	@weak_object:
	32	@error:
	33	@Returns:
	34
	35
	36	<!-- ##### USER_FUNCTION tp_cli_connection_interface_cellular_signal_callback_imsi_changed ##### -->
	37	<para>
	38
	39	</para>
	40
	41	@proxy:
	42	@arg_IMSI:
	43	@user_data:
	44	@weak_object:
	45
	46

-443

~~docs/reference/tmpl/connection-contact-list.sgml~~ less more

0		<!-- ##### SECTION Title ##### -->
1		connection-contact-list
2
3		<!-- ##### SECTION Short_Description ##### -->
4
5
6		<!-- ##### SECTION Long_Description ##### -->
7		<para>
8
9		</para>
10
11		<!-- ##### SECTION See_Also ##### -->
12		<para>
13
14		</para>
15
16		<!-- ##### SECTION Stability_Level ##### -->
17
18
19		<!-- ##### SECTION Image ##### -->
20
21
22		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_add_to_group ##### -->
23		<para>
24
25		</para>
26
27		@proxy:
28		@timeout_ms:
29		@in_Group:
30		@in_Members:
31		@callback:
32		@user_data:
33		@destroy:
34		@weak_object:
35		@Returns:
36
37
38		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_remove_from_group ##### -->
39		<para>
40
41		</para>
42
43		@proxy:
44		@timeout_ms:
45		@in_Group:
46		@in_Members:
47		@callback:
48		@user_data:
49		@destroy:
50		@weak_object:
51		@Returns:
52
53
54		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_remove_group ##### -->
55		<para>
56
57		</para>
58
59		@proxy:
60		@timeout_ms:
61		@in_Group:
62		@callback:
63		@user_data:
64		@destroy:
65		@weak_object:
66		@Returns:
67
68
69		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_rename_group ##### -->
70		<para>
71
72		</para>
73
74		@proxy:
75		@timeout_ms:
76		@in_Old_Name:
77		@in_New_Name:
78		@callback:
79		@user_data:
80		@destroy:
81		@weak_object:
82		@Returns:
83
84
85		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_set_contact_groups ##### -->
86		<para>
87
88		</para>
89
90		@proxy:
91		@timeout_ms:
92		@in_Contact:
93		@in_Groups:
94		@callback:
95		@user_data:
96		@destroy:
97		@weak_object:
98		@Returns:
99
100
101		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_set_group_members ##### -->
102		<para>
103
104		</para>
105
106		@proxy:
107		@timeout_ms:
108		@in_Group:
109		@in_Members:
110		@callback:
111		@user_data:
112		@destroy:
113		@weak_object:
114		@Returns:
115
116
117		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_add_to_group ##### -->
118		<para>
119
120		</para>
121
122		@proxy:
123		@error:
124		@user_data:
125		@weak_object:
126
127
128		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_remove_from_group ##### -->
129		<para>
130
131		</para>
132
133		@proxy:
134		@error:
135		@user_data:
136		@weak_object:
137
138
139		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_remove_group ##### -->
140		<para>
141
142		</para>
143
144		@proxy:
145		@error:
146		@user_data:
147		@weak_object:
148
149
150		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_rename_group ##### -->
151		<para>
152
153		</para>
154
155		@proxy:
156		@error:
157		@user_data:
158		@weak_object:
159
160
161		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_set_contact_groups ##### -->
162		<para>
163
164		</para>
165
166		@proxy:
167		@error:
168		@user_data:
169		@weak_object:
170
171
172		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_set_group_members ##### -->
173		<para>
174
175		</para>
176
177		@proxy:
178		@error:
179		@user_data:
180		@weak_object:
181
182
183		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_group_renamed ##### -->
184		<para>
185
186		</para>
187
188		@proxy:
189		@callback:
190		@user_data:
191		@destroy:
192		@weak_object:
193		@error:
194		@Returns:
195
196
197		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_groups_changed ##### -->
198		<para>
199
200		</para>
201
202		@proxy:
203		@callback:
204		@user_data:
205		@destroy:
206		@weak_object:
207		@error:
208		@Returns:
209
210
211		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_groups_created ##### -->
212		<para>
213
214		</para>
215
216		@proxy:
217		@callback:
218		@user_data:
219		@destroy:
220		@weak_object:
221		@error:
222		@Returns:
223
224
225		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_groups_removed ##### -->
226		<para>
227
228		</para>
229
230		@proxy:
231		@callback:
232		@user_data:
233		@destroy:
234		@weak_object:
235		@error:
236		@Returns:
237
238
239		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_group_renamed ##### -->
240		<para>
241
242		</para>
243
244		@proxy:
245		@arg_Old_Name:
246		@arg_New_Name:
247		@user_data:
248		@weak_object:
249
250
251		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_groups_changed ##### -->
252		<para>
253
254		</para>
255
256		@proxy:
257		@arg_Contact:
258		@arg_Added:
259		@arg_Removed:
260		@user_data:
261		@weak_object:
262
263
264		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_groups_created ##### -->
265		<para>
266
267		</para>
268
269		@proxy:
270		@arg_Names:
271		@user_data:
272		@weak_object:
273
274
275		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_groups_removed ##### -->
276		<para>
277
278		</para>
279
280		@proxy:
281		@arg_Names:
282		@user_data:
283		@weak_object:
284
285
286		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_authorize_publication ##### -->
287		<para>
288
289		</para>
290
291		@proxy:
292		@timeout_ms:
293		@in_Contacts:
294		@callback:
295		@user_data:
296		@destroy:
297		@weak_object:
298		@Returns:
299
300
301		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_remove_contacts ##### -->
302		<para>
303
304		</para>
305
306		@proxy:
307		@timeout_ms:
308		@in_Contacts:
309		@callback:
310		@user_data:
311		@destroy:
312		@weak_object:
313		@Returns:
314
315
316		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_request_subscription ##### -->
317		<para>
318
319		</para>
320
321		@proxy:
322		@timeout_ms:
323		@in_Contacts:
324		@in_Message:
325		@callback:
326		@user_data:
327		@destroy:
328		@weak_object:
329		@Returns:
330
331
332		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_unpublish ##### -->
333		<para>
334
335		</para>
336
337		@proxy:
338		@timeout_ms:
339		@in_Contacts:
340		@callback:
341		@user_data:
342		@destroy:
343		@weak_object:
344		@Returns:
345
346
347		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_unsubscribe ##### -->
348		<para>
349
350		</para>
351
352		@proxy:
353		@timeout_ms:
354		@in_Contacts:
355		@callback:
356		@user_data:
357		@destroy:
358		@weak_object:
359		@Returns:
360
361
362		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_authorize_publication ##### -->
363		<para>
364
365		</para>
366
367		@proxy:
368		@error:
369		@user_data:
370		@weak_object:
371
372
373		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_remove_contacts ##### -->
374		<para>
375
376		</para>
377
378		@proxy:
379		@error:
380		@user_data:
381		@weak_object:
382
383
384		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_request_subscription ##### -->
385		<para>
386
387		</para>
388
389		@proxy:
390		@error:
391		@user_data:
392		@weak_object:
393
394
395		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_unpublish ##### -->
396		<para>
397
398		</para>
399
400		@proxy:
401		@error:
402		@user_data:
403		@weak_object:
404
405
406		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_unsubscribe ##### -->
407		<para>
408
409		</para>
410
411		@proxy:
412		@error:
413		@user_data:
414		@weak_object:
415
416
417		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_connect_to_contacts_changed ##### -->
418		<para>
419
420		</para>
421
422		@proxy:
423		@callback:
424		@user_data:
425		@destroy:
426		@weak_object:
427		@error:
428		@Returns:
429
430
431		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_signal_callback_contacts_changed ##### -->
432		<para>
433
434		</para>
435
436		@proxy:
437		@arg_Changes:
438		@arg_Removals:
439		@user_data:
440		@weak_object:
441
442

-456

~~docs/reference/tmpl/contact-list-manager.sgml~~ less more

0		<!-- ##### SECTION Title ##### -->
1		contact-list-manager
2
3		<!-- ##### SECTION Short_Description ##### -->
4
5
6		<!-- ##### SECTION Long_Description ##### -->
7		<para>
8
9		</para>
10
11		<!-- ##### SECTION See_Also ##### -->
12		<para>
13
14		</para>
15
16		<!-- ##### SECTION Stability_Level ##### -->
17
18
19		<!-- ##### SECTION Image ##### -->
20
21
22		<!-- ##### STRUCT TpBaseContactList ##### -->
23		<para>
24
25		</para>
26
27
28		<!-- ##### ARG TpBaseContactList:connection ##### -->
29		<para>
30
31		</para>
32
33		<!-- ##### STRUCT TpBaseContactListClass ##### -->
34		<para>
35
36		</para>
37
38
39		<!-- ##### ENUM TpPresenceState ##### -->
40		<para>
41
42		</para>
43
44		@TP_PRESENCE_STATE_NO:
45		@TP_PRESENCE_STATE_ASK:
46		@TP_PRESENCE_STATE_YES:
47
48		<!-- ##### FUNCTION tp_base_contact_list_set_list_received ##### -->
49		<para>
50
51		</para>
52
53		@self:
54
55
56		<!-- ##### FUNCTION tp_base_contact_list_contacts_changed ##### -->
57		<para>
58
59		</para>
60
61		@self:
62		@changed:
63		@removed:
64
65
66		<!-- ##### USER_FUNCTION TpBaseContactListBooleanFunc ##### -->
67		<para>
68
69		</para>
70
71		@self:
72		@Returns:
73
74
75		<!-- ##### FUNCTION tp_base_contact_list_false_func ##### -->
76		<para>
77
78		</para>
79
80		@self:
81		@Returns:
82
83
84		<!-- ##### FUNCTION tp_base_contact_list_true_func ##### -->
85		<para>
86
87		</para>
88
89		@self:
90		@Returns:
91
92
93		<!-- ##### FUNCTION tp_base_contact_list_class_implement_can_change_subscriptions ##### -->
94		<para>
95
96		</para>
97
98		@cls:
99		@check:
100
101
102		<!-- ##### FUNCTION tp_base_contact_list_class_implement_request_uses_message ##### -->
103		<para>
104
105		</para>
106
107		@cls:
108		@check:
109
110
111		<!-- ##### FUNCTION tp_base_contact_list_class_implement_subscriptions_persist ##### -->
112		<para>
113
114		</para>
115
116		@cls:
117		@check:
118
119
120		<!-- ##### USER_FUNCTION TpBaseContactListGetContactsFunc ##### -->
121		<para>
122
123		</para>
124
125		@self:
126		@Returns:
127
128
129		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_contacts ##### -->
130		<para>
131
132		</para>
133
134		@cls:
135		@impl:
136
137
138		<!-- ##### USER_FUNCTION TpBaseContactListGetPresenceStatesFunc ##### -->
139		<para>
140
141		</para>
142
143		@self:
144		@contact:
145		@subscribe:
146		@publish:
147		@publish_request:
148
149
150		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_states ##### -->
151		<para>
152
153		</para>
154
155		@cls:
156		@impl:
157
158
159		<!-- ##### USER_FUNCTION TpBaseContactListRequestSubscriptionFunc ##### -->
160		<para>
161
162		</para>
163
164		@self:
165		@contacts:
166		@message:
167		@error:
168		@Returns:
169
170
171		<!-- ##### FUNCTION tp_base_contact_list_class_implement_request_subscription ##### -->
172		<para>
173
174		</para>
175
176		@cls:
177		@impl:
178
179
180		<!-- ##### USER_FUNCTION TpBaseContactListActOnContactsFunc ##### -->
181		<para>
182
183		</para>
184
185		@self:
186		@contacts:
187		@error:
188		@Returns:
189
190
191		<!-- ##### FUNCTION tp_base_contact_list_class_implement_authorize_publication ##### -->
192		<para>
193
194		</para>
195
196		@cls:
197		@impl:
198
199
200		<!-- ##### FUNCTION tp_base_contact_list_class_implement_just_store_contacts ##### -->
201		<para>
202
203		</para>
204
205		@cls:
206		@impl:
207
208
209		<!-- ##### FUNCTION tp_base_contact_list_class_implement_remove_contacts ##### -->
210		<para>
211
212		</para>
213
214		@cls:
215		@impl:
216
217
218		<!-- ##### FUNCTION tp_base_contact_list_class_implement_unsubscribe ##### -->
219		<para>
220
221		</para>
222
223		@cls:
224		@impl:
225
226
227		<!-- ##### FUNCTION tp_base_contact_list_class_implement_unpublish ##### -->
228		<para>
229
230		</para>
231
232		@cls:
233		@impl:
234
235
236		<!-- ##### USER_FUNCTION TpBaseContactListNormalizeFunc ##### -->
237		<para>
238
239		</para>
240
241		@self:
242		@s:
243		@Returns:
244
245
246		<!-- ##### FUNCTION tp_base_contact_list_class_implement_normalize_group ##### -->
247		<para>
248
249		</para>
250
251		@cls:
252		@impl:
253
254
255		<!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### -->
256		<para>
257
258		</para>
259
260		@self:
261		@contact:
262		@Returns:
263
264
265		<!-- ##### USER_FUNCTION TpBaseContactListGetGroupsFunc ##### -->
266		<para>
267
268		</para>
269
270		@self:
271		@Returns:
272
273
274		<!-- ##### USER_FUNCTION TpBaseContactListGroupContactsFunc ##### -->
275		<para>
276
277		</para>
278
279		@self:
280		@group:
281		@contacts:
282
283
284		<!-- ##### USER_FUNCTION TpBaseContactListRemoveGroupFunc ##### -->
285		<para>
286
287		</para>
288
289		@self:
290		@group:
291		@error:
292		@Returns:
293
294
295		<!-- ##### FUNCTION tp_base_contact_list_class_implement_add_to_group ##### -->
296		<para>
297
298		</para>
299
300		@cls:
301		@impl:
302
303
304		<!-- ##### FUNCTION tp_base_contact_list_class_implement_disjoint_groups ##### -->
305		<para>
306
307		</para>
308
309		@cls:
310		@impl:
311
312
313		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_contact_groups ##### -->
314		<para>
315
316		</para>
317
318		@cls:
319		@impl:
320
321
322		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_groups ##### -->
323		<para>
324
325		</para>
326
327		@cls:
328		@impl:
329
330
331		<!-- ##### FUNCTION tp_base_contact_list_class_implement_remove_from_group ##### -->
332		<para>
333
334		</para>
335
336		@cls:
337		@impl:
338
339
340		<!-- ##### FUNCTION tp_base_contact_list_class_implement_remove_group ##### -->
341		<para>
342
343		</para>
344
345		@cls:
346		@impl:
347
348
349		<!-- ##### FUNCTION tp_base_contact_list_group_renamed ##### -->
350		<para>
351
352		</para>
353
354		@self:
355		@old_name:
356		@new_name:
357
358
359		<!-- ##### FUNCTION tp_base_contact_list_groups_changed ##### -->
360		<para>
361
362		</para>
363
364		@self:
365		@contacts:
366		@added:
367		@n_added:
368		@removed:
369		@n_removed:
370
371
372		<!-- ##### FUNCTION tp_base_contact_list_groups_created ##### -->
373		<para>
374
375		</para>
376
377		@self:
378		@created:
379		@n_created:
380
381
382		<!-- ##### FUNCTION tp_base_contact_list_groups_removed ##### -->
383		<para>
384
385		</para>
386
387		@self:
388		@removed:
389		@n_removed:
390
391
392		<!-- ##### USER_FUNCTION TpBaseContactListContactBooleanFunc ##### -->
393		<para>
394
395		</para>
396
397		@self:
398		@contact:
399		@Returns:
400
401
402		<!-- ##### FUNCTION tp_base_contact_list_class_implement_can_block ##### -->
403		<para>
404
405		</para>
406
407		@cls:
408		@check:
409
410
411		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_blocked_contacts ##### -->
412		<para>
413
414		</para>
415
416		@cls:
417		@impl:
418
419
420		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_contact_blocked ##### -->
421		<para>
422
423		</para>
424
425		@cls:
426		@impl:
427
428
429		<!-- ##### FUNCTION tp_base_contact_list_class_implement_block_contacts ##### -->
430		<para>
431
432		</para>
433
434		@cls:
435		@impl:
436
437
438		<!-- ##### FUNCTION tp_base_contact_list_class_implement_unblock_contacts ##### -->
439		<para>
440
441		</para>
442
443		@cls:
444		@impl:
445
446
447		<!-- ##### FUNCTION tp_base_contact_list_contact_blocking_changed ##### -->
448		<para>
449
450		</para>
451
452		@self:
453		@changed:
454
455

+10

-0

docs/reference/tmpl/enums.sgml less more

707	707	@TP_ANONYMITY_MODE_SHOW_CLIENT_INFO:
708	708	@TP_ANONYMITY_MODE_NETWORK_INFO:
709	709
	710	<!-- ##### ENUM TpStorageRestrictionFlags ##### -->
	711	<para>
	712
	713	</para>
	714
	715	@TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PARAMETERS:
	716	@TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_ENABLED:
	717	@TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_PRESENCE:
	718	@TP_STORAGE_RESTRICTION_FLAG_CANNOT_SET_SERVICE:
	719

-0

docs/reference/tmpl/gtypes.sgml less more

140	140
141	141
142	142
	143	<!-- ##### MACRO TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP ##### -->
	144	<para>
	145
	146	</para>
	147
	148
	149
143	150	<!-- ##### MACRO TP_STRUCT_TYPE_CHANNEL_INFO ##### -->
144	151	<para>
145	152

+98

-0

docs/reference/tmpl/interfaces.sgml less more

47	47
48	48
49	49
	50	<!-- ##### MACRO TP_IFACE_ACCOUNT_INTERFACE_STORAGE ##### -->
	51	<para>
	52
	53	</para>
	54
	55
	56
	57	<!-- ##### MACRO TP_IFACE_QUARK_ACCOUNT_INTERFACE_STORAGE ##### -->
	58	<para>
	59
	60	</para>
	61
	62
	63
50	64	<!-- ##### MACRO TP_IFACE_ACCOUNT_MANAGER ##### -->
51	65	<para>
52	66

229	243
230	244
231	245
	246	<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CELLULAR ##### -->
	247	<para>
	248
	249	</para>
	250
	251
	252
	253	<!-- ##### MACRO TP_IFACE_QUARK_CONNECTION_INTERFACE_CELLULAR ##### -->
	254	<para>
	255
	256	</para>
	257
	258
	259
232	260	<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES ##### -->
233	261	<para>
234	262

908	936
909	937
910	938
	939	<!-- ##### MACRO TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_IDENTIFIER ##### -->
	940	<para>
	941
	942	</para>
	943
	944
	945
	946	<!-- ##### MACRO TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_PROVIDER ##### -->
	947	<para>
	948
	949	</para>
	950
	951
	952
	953	<!-- ##### MACRO TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_RESTRICTIONS ##### -->
	954	<para>
	955
	956	</para>
	957
	958
	959
	960	<!-- ##### MACRO TP_PROP_ACCOUNT_INTERFACE_STORAGE_STORAGE_SPECIFIC_INFORMATION ##### -->
	961	<para>
	962
	963	</para>
	964
	965
	966
911	967	<!-- ##### MACRO TP_PROP_ACCOUNT_MANAGER_INTERFACES ##### -->
912	968	<para>
913	969

964	1020
965	1021
966	1022
	1023	<!-- ##### MACRO TP_PROP_ACCOUNT_SERVICE ##### -->
	1024	<para>
	1025
	1026	</para>
	1027
	1028
	1029
967	1030	<!-- ##### MACRO TP_PROP_ACCOUNT_VALID ##### -->
968	1031	<para>
969	1032

1531	1594
1532	1595
1533	1596
	1597	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CELLULAR_IMSI ##### -->
	1598	<para>
	1599
	1600	</para>
	1601
	1602
	1603
	1604	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_REDUCED_CHARACTER_SET ##### -->
	1605	<para>
	1606
	1607	</para>
	1608
	1609
	1610
	1611	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_SERVICE_CENTRE ##### -->
	1612	<para>
	1613
	1614	</para>
	1615
	1616
	1617
	1618	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD ##### -->
	1619	<para>
	1620
	1621	</para>
	1622
	1623
	1624
1534	1625	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES ##### -->
1535	1626	<para>
1536	1627

1608	1699
1609	1700
1610	1701
	1702	<!-- ##### MACRO TP_PROP_CONNECTION_MANAGER_PROTOCOLS ##### -->
	1703	<para>
	1704
	1705	</para>
	1706
	1707
	1708
1611	1709	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACES ##### -->
1612	1710	<para>
1613	1711

-5

docs/reference/tmpl/proxy.sgml less more

92	92	@parent_class:
93	93	@interface:
94	94	@must_have_unique_name:
95		@_reserved_flags:
96		@_internal_list_features:
97		@list_features:
98		@_reserved:
99		@priv:
100	95
101	96	<!-- ##### MACRO tp_proxy_has_interface ##### -->
102	97	<para>

+12

-0

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

170	170	@instance:
171	171
172	172
	173	<!-- ##### STRUCT TpSvcAccountInterfaceStorage ##### -->
	174	<para>
	175
	176	</para>
	177
	178
	179	<!-- ##### STRUCT TpSvcAccountInterfaceStorageClass ##### -->
	180	<para>
	181
	182	</para>
	183
	184

+29

-0

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

1757	1757	@context:
1758	1758
1759	1759
	1760	<!-- ##### STRUCT TpSvcConnectionInterfaceCellular ##### -->
	1761	<para>
	1762
	1763	</para>
	1764
	1765
	1766	<!-- ##### SIGNAL TpSvcConnectionInterfaceCellular::i-ms-ichanged ##### -->
	1767	<para>
	1768
	1769	</para>
	1770
	1771	@tpsvcconnectioninterfacecellular: the object which received the signal.
	1772	@arg1:
	1773
	1774	<!-- ##### STRUCT TpSvcConnectionInterfaceCellularClass ##### -->
	1775	<para>
	1776
	1777	</para>
	1778
	1779
	1780	<!-- ##### FUNCTION tp_svc_connection_interface_cellular_emit_imsi_changed ##### -->
	1781	<para>
	1782
	1783	</para>
	1784
	1785	@instance:
	1786	@arg_IMSI:
	1787
	1788

-2851

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

0		<!-- ##### SECTION ./tmpl/base-contact-list.sgml:Image ##### -->
1
2
3
4		<!-- ##### SECTION ./tmpl/base-contact-list.sgml:Long_Description ##### -->
5		<para>
6
7		</para>
8
9
10		<!-- ##### SECTION ./tmpl/base-contact-list.sgml:See_Also ##### -->
11		<para>
12
13		</para>
14
15
16		<!-- ##### SECTION ./tmpl/base-contact-list.sgml:Short_Description ##### -->
17
18
19
20		<!-- ##### SECTION ./tmpl/base-contact-list.sgml:Stability_Level ##### -->
21
22
23
24		<!-- ##### SECTION ./tmpl/base-contact-list.sgml:Title ##### -->
25		base-contact-list
26
27
28	0	<!-- ##### SECTION ./tmpl/base-protocol.sgml:Image ##### -->
29	1
30	2

53	25	base-protocol
54	26
55	27
56		<!-- ##### SECTION ./tmpl/connection-contact-list.sgml:Image ##### -->
57
58
59
60		<!-- ##### SECTION ./tmpl/connection-contact-list.sgml:Long_Description ##### -->
61		<para>
62
63		</para>
64
65
66		<!-- ##### SECTION ./tmpl/connection-contact-list.sgml:See_Also ##### -->
67		<para>
68
69		</para>
70
71
72		<!-- ##### SECTION ./tmpl/connection-contact-list.sgml:Short_Description ##### -->
73
74
75
76		<!-- ##### SECTION ./tmpl/connection-contact-list.sgml:Stability_Level ##### -->
77
78
79
80		<!-- ##### SECTION ./tmpl/connection-contact-list.sgml:Title ##### -->
81		connection-contact-list
82
83
84		<!-- ##### SECTION ./tmpl/contact-list-manager.sgml:Image ##### -->
85
86
87
88		<!-- ##### SECTION ./tmpl/contact-list-manager.sgml:Long_Description ##### -->
89		<para>
90
91		</para>
92
93
94		<!-- ##### SECTION ./tmpl/contact-list-manager.sgml:See_Also ##### -->
95		<para>
96
97		</para>
98
99
100		<!-- ##### SECTION ./tmpl/contact-list-manager.sgml:Short_Description ##### -->
101
102
103
104		<!-- ##### SECTION ./tmpl/contact-list-manager.sgml:Stability_Level ##### -->
105
106
107
108		<!-- ##### SECTION ./tmpl/contact-list-manager.sgml:Title ##### -->
109		contact-list-manager
110
111
112	28	<!-- ##### SECTION ./tmpl/protocol.sgml:Image ##### -->
113	29
114	30

165	81	svc-protocol
166	82
167	83
168		<!-- ##### MACRO NUM_TP_CONTACT_METADATA_STORAGE_TYPES ##### -->
169		<para>
170
171		</para>
172
173
174		<!-- ##### MACRO NUM_TP_PRESENCE_STATES ##### -->
175		<para>
176
177		</para>
178
179
180		<!-- ##### MACRO TP_HASH_TYPE_CONTACT_SUBSCRIPTION_MAP ##### -->
181		<para>
182
183		</para>
184
185
186		<!-- ##### MACRO TP_HASH_TYPE_PROTOCOL_PROPERTIES_MAP ##### -->
187		<para>
188
189		</para>
190
191
192		<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACT_GROUPS ##### -->
193		<para>
194
195		</para>
196
197
198		<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACT_LIST ##### -->
199		<para>
200
201		</para>
202
203
204	84	<!-- ##### MACRO TP_IFACE_PROTOCOL ##### -->
205	85	<para>
206	86
207	87	</para>
208	88
209	89
210		<!-- ##### MACRO TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_GROUPS ##### -->
211		<para>
212
213		</para>
214
215
216		<!-- ##### MACRO TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_LIST ##### -->
217		<para>
218
219		</para>
220
221
222	90	<!-- ##### MACRO TP_IFACE_QUARK_PROTOCOL ##### -->
223	91	<para>
224	92
225	93	</para>
226	94
227	95
228		<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS ##### -->
229		<para>
230
231		</para>
232
233
234		<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS ##### -->
235		<para>
236
237		</para>
238
239
240		<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUP_STORAGE ##### -->
241		<para>
242
243		</para>
244
245
246		<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_LIST_CAN_CHANGE_SUBSCRIPTIONS ##### -->
247		<para>
248
249		</para>
250
251
252		<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_LIST_REQUEST_USES_MESSAGE ##### -->
253		<para>
254
255		</para>
256
257
258		<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_LIST_SUBSCRIPTIONS_PERSIST ##### -->
259		<para>
260
261		</para>
262
263
264		<!-- ##### MACRO TP_PROP_CONNECTION_MANAGER_PROTOCOLS ##### -->
265		<para>
266
267		</para>
268
269
270	96	<!-- ##### MACRO TP_PROP_PROTOCOL_CONNECTION_INTERFACES ##### -->
271	97	<para>
272	98
273	99	</para>
274	100
275	101
276		<!-- ##### MACRO TP_PROP_PROTOCOL_DISPLAY_NAME ##### -->
277		<para>
278
279		</para>
280
281
282	102	<!-- ##### MACRO TP_PROP_PROTOCOL_ENGLISH_NAME ##### -->
283	103	<para>
284	104
285	105	</para>
286	106
287	107
288		<!-- ##### MACRO TP_PROP_PROTOCOL_GUARANTEED_CHANNEL_CLASSES ##### -->
289		<para>
290
291		</para>
292
293
294		<!-- ##### MACRO TP_PROP_PROTOCOL_GUARANTEED_INTERFACES ##### -->
295		<para>
296
297		</para>
298
299
300	108	<!-- ##### MACRO TP_PROP_PROTOCOL_ICON ##### -->
301	109	<para>
302	110

315	123	</para>
316	124
317	125
318		<!-- ##### MACRO TP_PROP_PROTOCOL_POSSIBLE_CHANNEL_CLASSES ##### -->
319		<para>
320
321		</para>
322
323
324		<!-- ##### MACRO TP_PROP_PROTOCOL_POSSIBLE_INTERFACES ##### -->
325		<para>
326
327		</para>
328
329
330	126	<!-- ##### MACRO TP_PROP_PROTOCOL_REQUESTABLE_CHANNEL_CLASSES ##### -->
331	127	<para>
332	128

351	147	</para>
352	148
353	149
354		<!-- ##### MACRO TP_STRUCT_TYPE_CONTACT_SUBSCRIPTIONS ##### -->
355		<para>
356
357		</para>
358
359
360		<!-- ##### MACRO TP_TOKEN_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS ##### -->
361		<para>
362
363		</para>
364
365
366		<!-- ##### MACRO TP_TOKEN_CONNECTION_INTERFACE_CONTACT_LIST_PUBLISH ##### -->
367		<para>
368
369		</para>
370
371
372		<!-- ##### MACRO TP_TOKEN_CONNECTION_INTERFACE_CONTACT_LIST_PUBLISH_REQUEST ##### -->
373		<para>
374
375		</para>
376
377
378		<!-- ##### MACRO TP_TOKEN_CONNECTION_INTERFACE_CONTACT_LIST_SUBSCRIBE ##### -->
379		<para>
380
381		</para>
382
383
384		<!-- ##### MACRO TP_TYPE_BLOCKABLE_CONTACT_LIST ##### -->
385		<para>
386
387		</para>
388
389
390		<!-- ##### MACRO TP_TYPE_CONTACT_GROUP_LIST ##### -->
391		<para>
392
393		</para>
394
395
396		<!-- ##### MACRO TP_TYPE_MUTABLE_CONTACT_GROUP_LIST ##### -->
397		<para>
398
399		</para>
400
401
402		<!-- ##### MACRO TP_TYPE_MUTABLE_CONTACT_LIST ##### -->
403		<para>
404
405		</para>
406
407
408		<!-- ##### SIGNAL TpBaseConnection::clients-interested ##### -->
409		<para>
410
411		</para>
412
413		@tpbaseconnection: the object which received the signal.
414		@arg1:
415
416		<!-- ##### SIGNAL TpBaseConnection::clients-uninterested ##### -->
417		<para>
418
419		</para>
420
421		@tpbaseconnection: the object which received the signal.
422		@arg1:
423
424	150	<!-- ##### ARG TpBaseConnectionManager:interfaces ##### -->
425	151	<para>
426	152

432	158
433	159	</para>
434	160
435
436		<!-- ##### STRUCT TpBaseContactList ##### -->
437		<para>
438
439		</para>
440
441
442		<!-- ##### ARG TpBaseContactList:connection ##### -->
443		<para>
444
445		</para>
446
447
448		<!-- ##### USER_FUNCTION TpBaseContactListActOnContactsFunc ##### -->
449		<para>
450
451		</para>
452
453		@self:
454		@contacts:
455		@error:
456		@Returns:
457
458		<!-- ##### USER_FUNCTION TpBaseContactListAsyncFinishFunc ##### -->
459		<para>
460
461		</para>
462
463		@self:
464		@result:
465		@error:
466		@Returns:
467
468		<!-- ##### USER_FUNCTION TpBaseContactListBooleanFunc ##### -->
469		<para>
470
471		</para>
472
473		@self:
474		@Returns:
475
476		<!-- ##### STRUCT TpBaseContactListClass ##### -->
477		<para>
478
479		</para>
480
481
482		<!-- ##### USER_FUNCTION TpBaseContactListContactBooleanFunc ##### -->
483		<para>
484
485		</para>
486
487		@self:
488		@contact:
489		@Returns:
490
491		<!-- ##### USER_FUNCTION TpBaseContactListCreateGroupsFunc ##### -->
492		<para>
493
494		</para>
495
496		@self:
497		@normalized_names:
498		@n_names:
499
500		<!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### -->
501		<para>
502
503		</para>
504
505		@self:
506		@contact:
507		@Returns:
508
509		<!-- ##### USER_FUNCTION TpBaseContactListGetContactsFunc ##### -->
510		<para>
511
512		</para>
513
514		@self:
515		@Returns:
516
517		<!-- ##### USER_FUNCTION TpBaseContactListGetGroupsFunc ##### -->
518		<para>
519
520		</para>
521
522		@self:
523		@Returns:
524
525		<!-- ##### USER_FUNCTION TpBaseContactListGetPresenceStatesFunc ##### -->
526		<para>
527
528		</para>
529
530		@self:
531		@contact:
532		@subscribe:
533		@publish:
534		@publish_request:
535
536		<!-- ##### USER_FUNCTION TpBaseContactListGetStatesFunc ##### -->
537		<para>
538
539		</para>
540
541		@self:
542		@contact:
543		@subscribe:
544		@publish:
545		@publish_request:
546
547		<!-- ##### USER_FUNCTION TpBaseContactListGroupContactsFunc ##### -->
548		<para>
549
550		</para>
551
552		@self:
553		@group:
554		@contacts:
555
556		<!-- ##### USER_FUNCTION TpBaseContactListNormalizeFunc ##### -->
557		<para>
558
559		</para>
560
561		@self:
562		@s:
563		@Returns:
564
565		<!-- ##### USER_FUNCTION TpBaseContactListRemoveGroupFunc ##### -->
566		<para>
567
568		</para>
569
570		@self:
571		@group:
572		@error:
573		@Returns:
574
575		<!-- ##### USER_FUNCTION TpBaseContactListRenameGroupFunc ##### -->
576		<para>
577
578		</para>
579
580		@self:
581		@old_name:
582		@new_name:
583
584		<!-- ##### USER_FUNCTION TpBaseContactListRequestSubscriptionFunc ##### -->
585		<para>
586
587		</para>
588
589		@self:
590		@contacts:
591		@message:
592		@error:
593		@Returns:
594
595		<!-- ##### USER_FUNCTION TpBaseContactListSetContactGroupsFunc ##### -->
596		<para>
597
598		</para>
599
600		@self:
601		@contact:
602		@normalized_names:
603		@n_names:
604		@callback:
605		@user_data:
606
607		<!-- ##### USER_FUNCTION TpBaseContactListUIntFunc ##### -->
608		<para>
609
610		</para>
611
612		@self:
613		@Returns:
614
615		<!-- ##### USER_FUNCTION TpBaseContactListUintFunc ##### -->
616		<para>
617
618		</para>
619
620		@self:
621		@Returns:
622	161
623	162	<!-- ##### STRUCT TpBaseProtocol ##### -->
624	163	<para>

653	192	@get_interfaces:
654	193	@get_connection_details:
655	194
656		<!-- ##### STRUCT TpBlockableContactListInterface ##### -->
657		<para>
658
659		</para>
660
661		@parent:
662		@get_blocked_contacts:
663		@block_contacts_async:
664		@block_contacts_finish:
665		@unblock_contacts_async:
666		@unblock_contacts_finish:
667		@can_block:
668
669		<!-- ##### STRUCT TpContactGroupListInterface ##### -->
670		<para>
671
672		</para>
673
674		@parent:
675		@get_groups:
676		@get_contact_groups:
677		@has_disjoint_groups:
678		@normalize_group:
679
680		<!-- ##### STRUCT TpContactListManager ##### -->
681		<para>
682
683		</para>
684
685
686		<!-- ##### ARG TpContactListManager:connection ##### -->
687		<para>
688
689		</para>
690
691
692		<!-- ##### USER_FUNCTION TpContactListManagerActOnContactsFunc ##### -->
693		<para>
694
695		</para>
696
697		@self:
698		@contacts:
699		@error:
700		@Returns:
701
702		<!-- ##### USER_FUNCTION TpContactListManagerBooleanFunc ##### -->
703		<para>
704
705		</para>
706
707		@self:
708		@Returns:
709
710		<!-- ##### STRUCT TpContactListManagerClass ##### -->
711		<para>
712
713		</para>
714
715
716		<!-- ##### USER_FUNCTION TpContactListManagerContactBooleanFunc ##### -->
717		<para>
718
719		</para>
720
721		@self:
722		@contact:
723		@Returns:
724
725		<!-- ##### USER_FUNCTION TpContactListManagerGetContactGroupsFunc ##### -->
726		<para>
727
728		</para>
729
730		@self:
731		@contact:
732		@Returns:
733
734		<!-- ##### USER_FUNCTION TpContactListManagerGetContactsFunc ##### -->
735		<para>
736
737		</para>
738
739		@self:
740		@Returns:
741
742		<!-- ##### USER_FUNCTION TpContactListManagerGetGroupsFunc ##### -->
743		<para>
744
745		</para>
746
747		@self:
748		@Returns:
749
750		<!-- ##### USER_FUNCTION TpContactListManagerGetPresenceStatesFunc ##### -->
751		<para>
752
753		</para>
754
755		@self:
756		@contact:
757		@subscribe:
758		@publish:
759		@publish_request:
760
761		<!-- ##### USER_FUNCTION TpContactListManagerGroupContactsFunc ##### -->
762		<para>
763
764		</para>
765
766		@self:
767		@group:
768		@contacts:
769
770		<!-- ##### USER_FUNCTION TpContactListManagerNormalizeFunc ##### -->
771		<para>
772
773		</para>
774
775		@self:
776		@s:
777		@Returns:
778
779		<!-- ##### USER_FUNCTION TpContactListManagerRemoveGroupFunc ##### -->
780		<para>
781
782		</para>
783
784		@self:
785		@group:
786		@error:
787		@Returns:
788
789		<!-- ##### STRUCT TpContactListManagerRequest ##### -->
790		<para>
791
792		</para>
793
794
795		<!-- ##### USER_FUNCTION TpContactListManagerRequestSubscriptionFunc ##### -->
796		<para>
797
798		</para>
799
800		@self:
801		@contacts:
802		@message:
803		@error:
804		@Returns:
805
806		<!-- ##### ENUM TpContactMetadataStorageType ##### -->
807		<para>
808
809		</para>
810
811		@TP_CONTACT_METADATA_STORAGE_TYPE_NONE:
812		@TP_CONTACT_METADATA_STORAGE_TYPE_SUBSCRIBED_OR_PENDING:
813		@TP_CONTACT_METADATA_STORAGE_TYPE_SUBSCRIBED:
814		@TP_CONTACT_METADATA_STORAGE_TYPE_ANYONE:
815
816		<!-- ##### STRUCT TpMutableContactGroupListInterface ##### -->
817		<para>
818
819		</para>
820
821		@parent:
822		@set_contact_groups_async:
823		@set_contact_groups_finish:
824		@create_groups:
825		@add_to_group:
826		@remove_from_group:
827		@remove_group:
828		@rename_group:
829		@get_group_storage:
830
831		<!-- ##### STRUCT TpMutableContactListInterface ##### -->
832		<para>
833
834		</para>
835
836		@parent:
837		@request_subscription_async:
838		@request_subscription_finish:
839		@authorize_publication_async:
840		@authorize_publication_finish:
841		@remove_contacts_async:
842		@remove_contacts_finish:
843		@unsubscribe_async:
844		@unsubscribe_finish:
845		@unpublish_async:
846		@unpublish_finish:
847		@store_contacts_async:
848		@store_contacts_finish:
849		@can_change_subscriptions:
850		@get_request_uses_message:
851
852		<!-- ##### ENUM TpPresenceState ##### -->
853		<para>
854
855		</para>
856
857		@TP_PRESENCE_STATE_NO:
858		@TP_PRESENCE_STATE_ASK:
859		@TP_PRESENCE_STATE_YES:
860
861	195	<!-- ##### STRUCT TpProtocol ##### -->
862	196	<para>
863	197

912	246	</para>
913	247
914	248
915		<!-- ##### STRUCT TpSvcConnectionInterfaceContactGroups ##### -->
916		<para>
917
918		</para>
919
920
921		<!-- ##### SIGNAL TpSvcConnectionInterfaceContactGroups::group-renamed ##### -->
922		<para>
923
924		</para>
925
926		@tpsvcconnectioninterfacecontactgroups: the object which received the signal.
927		@arg1:
928		@arg2:
929
930		<!-- ##### SIGNAL TpSvcConnectionInterfaceContactGroups::groups-changed ##### -->
931		<para>
932
933		</para>
934
935		@tpsvcconnectioninterfacecontactgroups: the object which received the signal.
936		@arg1:
937		@arg2:
938		@arg3:
939
940		<!-- ##### SIGNAL TpSvcConnectionInterfaceContactGroups::groups-created ##### -->
941		<para>
942
943		</para>
944
945		@tpsvcconnectioninterfacecontactgroups: the object which received the signal.
946		@arg1:
947
948		<!-- ##### SIGNAL TpSvcConnectionInterfaceContactGroups::groups-removed ##### -->
949		<para>
950
951		</para>
952
953		@tpsvcconnectioninterfacecontactgroups: the object which received the signal.
954		@arg1:
955
956		<!-- ##### STRUCT TpSvcConnectionInterfaceContactGroupsClass ##### -->
957		<para>
958
959		</para>
960
961
962		<!-- ##### STRUCT TpSvcConnectionInterfaceContactList ##### -->
963		<para>
964
965		</para>
966
967
968		<!-- ##### SIGNAL TpSvcConnectionInterfaceContactList::contacts-changed ##### -->
969		<para>
970
971		</para>
972
973		@tpsvcconnectioninterfacecontactlist: the object which received the signal.
974		@Param3:
975
976		<!-- ##### STRUCT TpSvcConnectionInterfaceContactListClass ##### -->
977		<para>
978
979		</para>
980
981
982	249	<!-- ##### STRUCT TpSvcProtocol ##### -->
983	250	<para>
984	251

991	258	</para>
992	259
993	260
994		<!-- ##### FUNCTION tp_base_connection_add_client_interest ##### -->
995		<para>
996
997		</para>
998
999		@self:
1000		@unique_name:
1001		@iface:
1002		@only_if_uninterested:
1003
1004	261	<!-- ##### FUNCTION tp_base_connection_manager_add_protocol ##### -->
1005	262	<para>
1006	263

1008	265
1009	266	@self:
1010	267	@protocol:
1011
1012		<!-- ##### FUNCTION tp_base_contact_list_add_to_group ##### -->
1013		<para>
1014
1015		</para>
1016
1017		@self:
1018		@group:
1019		@contacts:
1020
1021		<!-- ##### FUNCTION tp_base_contact_list_authorize_publication ##### -->
1022		<para>
1023
1024		</para>
1025
1026		@self:
1027		@contacts:
1028
1029		<!-- ##### FUNCTION tp_base_contact_list_authorize_publication_async ##### -->
1030		<para>
1031
1032		</para>
1033
1034		@self:
1035		@contacts:
1036		@callback:
1037		@user_data:
1038
1039		<!-- ##### FUNCTION tp_base_contact_list_authorize_publication_finish ##### -->
1040		<para>
1041
1042		</para>
1043
1044		@self:
1045		@result:
1046		@error:
1047		@Returns:
1048
1049		<!-- ##### FUNCTION tp_base_contact_list_block_contacts ##### -->
1050		<para>
1051
1052		</para>
1053
1054		@self:
1055		@contacts:
1056
1057		<!-- ##### FUNCTION tp_base_contact_list_block_contacts_async ##### -->
1058		<para>
1059
1060		</para>
1061
1062		@self:
1063		@contacts:
1064		@callback:
1065		@user_data:
1066
1067		<!-- ##### FUNCTION tp_base_contact_list_block_contacts_finish ##### -->
1068		<para>
1069
1070		</para>
1071
1072		@self:
1073		@result:
1074		@error:
1075		@Returns:
1076
1077		<!-- ##### FUNCTION tp_base_contact_list_can_block ##### -->
1078		<para>
1079
1080		</para>
1081
1082		@self:
1083		@Returns:
1084
1085		<!-- ##### FUNCTION tp_base_contact_list_can_change_subscriptions ##### -->
1086		<para>
1087
1088		</para>
1089
1090		@self:
1091		@Returns:
1092
1093		<!-- ##### FUNCTION tp_base_contact_list_class_implement_add_to_group ##### -->
1094		<para>
1095
1096		</para>
1097
1098		@cls:
1099		@impl:
1100
1101		<!-- ##### FUNCTION tp_base_contact_list_class_implement_authorize_publication ##### -->
1102		<para>
1103
1104		</para>
1105
1106		@cls:
1107		@impl:
1108
1109		<!-- ##### FUNCTION tp_base_contact_list_class_implement_block_contacts ##### -->
1110		<para>
1111
1112		</para>
1113
1114		@cls:
1115		@impl:
1116
1117		<!-- ##### FUNCTION tp_base_contact_list_class_implement_can_block ##### -->
1118		<para>
1119
1120		</para>
1121
1122		@cls:
1123		@check:
1124
1125		<!-- ##### FUNCTION tp_base_contact_list_class_implement_can_change_subscriptions ##### -->
1126		<para>
1127
1128		</para>
1129
1130		@cls:
1131		@check:
1132
1133		<!-- ##### FUNCTION tp_base_contact_list_class_implement_create_groups ##### -->
1134		<para>
1135
1136		</para>
1137
1138		@cls:
1139		@impl:
1140
1141		<!-- ##### FUNCTION tp_base_contact_list_class_implement_disjoint_groups ##### -->
1142		<para>
1143
1144		</para>
1145
1146		@cls:
1147		@impl:
1148
1149		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_blocked_contacts ##### -->
1150		<para>
1151
1152		</para>
1153
1154		@cls:
1155		@impl:
1156
1157		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_contact_blocked ##### -->
1158		<para>
1159
1160		</para>
1161
1162		@cls:
1163		@impl:
1164
1165		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_contact_groups ##### -->
1166		<para>
1167
1168		</para>
1169
1170		@cls:
1171		@impl:
1172
1173		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_contacts ##### -->
1174		<para>
1175
1176		</para>
1177
1178		@cls:
1179		@impl:
1180
1181		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_group_storage ##### -->
1182		<para>
1183
1184		</para>
1185
1186		@cls:
1187		@impl:
1188
1189		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_groups ##### -->
1190		<para>
1191
1192		</para>
1193
1194		@cls:
1195		@impl:
1196
1197		<!-- ##### FUNCTION tp_base_contact_list_class_implement_get_states ##### -->
1198		<para>
1199
1200		</para>
1201
1202		@cls:
1203		@impl:
1204
1205		<!-- ##### FUNCTION tp_base_contact_list_class_implement_just_store_contacts ##### -->
1206		<para>
1207
1208		</para>
1209
1210		@cls:
1211		@impl:
1212
1213		<!-- ##### FUNCTION tp_base_contact_list_class_implement_normalize_group ##### -->
1214		<para>
1215
1216		</para>
1217
1218		@cls:
1219		@impl:
1220
1221		<!-- ##### FUNCTION tp_base_contact_list_class_implement_remove_contacts ##### -->
1222		<para>
1223
1224		</para>
1225
1226		@cls:
1227		@impl:
1228
1229		<!-- ##### FUNCTION tp_base_contact_list_class_implement_remove_from_group ##### -->
1230		<para>
1231
1232		</para>
1233
1234		@cls:
1235		@impl:
1236
1237		<!-- ##### FUNCTION tp_base_contact_list_class_implement_remove_group ##### -->
1238		<para>
1239
1240		</para>
1241
1242		@cls:
1243		@impl:
1244
1245		<!-- ##### FUNCTION tp_base_contact_list_class_implement_rename_group ##### -->
1246		<para>
1247
1248		</para>
1249
1250		@cls:
1251		@impl:
1252
1253		<!-- ##### FUNCTION tp_base_contact_list_class_implement_request_subscription ##### -->
1254		<para>
1255
1256		</para>
1257
1258		@cls:
1259		@impl:
1260
1261		<!-- ##### FUNCTION tp_base_contact_list_class_implement_request_uses_message ##### -->
1262		<para>
1263
1264		</para>
1265
1266		@cls:
1267		@check:
1268
1269		<!-- ##### FUNCTION tp_base_contact_list_class_implement_set_contact_groups ##### -->
1270		<para>
1271
1272		</para>
1273
1274		@cls:
1275		@impl:
1276
1277		<!-- ##### FUNCTION tp_base_contact_list_class_implement_subscriptions_persist ##### -->
1278		<para>
1279
1280		</para>
1281
1282		@cls:
1283		@check:
1284
1285		<!-- ##### FUNCTION tp_base_contact_list_class_implement_unblock_contacts ##### -->
1286		<para>
1287
1288		</para>
1289
1290		@cls:
1291		@impl:
1292
1293		<!-- ##### FUNCTION tp_base_contact_list_class_implement_unpublish ##### -->
1294		<para>
1295
1296		</para>
1297
1298		@cls:
1299		@impl:
1300
1301		<!-- ##### FUNCTION tp_base_contact_list_class_implement_unsubscribe ##### -->
1302		<para>
1303
1304		</para>
1305
1306		@cls:
1307		@impl:
1308
1309		<!-- ##### FUNCTION tp_base_contact_list_contact_blocking_changed ##### -->
1310		<para>
1311
1312		</para>
1313
1314		@self:
1315		@changed:
1316
1317		<!-- ##### FUNCTION tp_base_contact_list_contacts_changed ##### -->
1318		<para>
1319
1320		</para>
1321
1322		@self:
1323		@changed:
1324		@removed:
1325
1326		<!-- ##### FUNCTION tp_base_contact_list_create_groups ##### -->
1327		<para>
1328
1329		</para>
1330
1331		@self:
1332		@normalized_names:
1333		@n_names:
1334
1335		<!-- ##### FUNCTION tp_base_contact_list_false_func ##### -->
1336		<para>
1337
1338		</para>
1339
1340		@self:
1341		@Returns:
1342
1343		<!-- ##### FUNCTION tp_base_contact_list_get_blocked_contacts ##### -->
1344		<para>
1345
1346		</para>
1347
1348		@self:
1349		@Returns:
1350
1351		<!-- ##### FUNCTION tp_base_contact_list_get_contact_groups ##### -->
1352		<para>
1353
1354		</para>
1355
1356		@self:
1357		@contact:
1358		@Returns:
1359
1360		<!-- ##### FUNCTION tp_base_contact_list_get_contacts ##### -->
1361		<para>
1362
1363		</para>
1364
1365		@self:
1366		@Returns:
1367
1368		<!-- ##### FUNCTION tp_base_contact_list_get_group_storage ##### -->
1369		<para>
1370
1371		</para>
1372
1373		@self:
1374		@Returns:
1375
1376		<!-- ##### FUNCTION tp_base_contact_list_get_groups ##### -->
1377		<para>
1378
1379		</para>
1380
1381		@self:
1382		@Returns:
1383
1384		<!-- ##### FUNCTION tp_base_contact_list_get_request_uses_message ##### -->
1385		<para>
1386
1387		</para>
1388
1389		@self:
1390		@Returns:
1391
1392		<!-- ##### FUNCTION tp_base_contact_list_get_states ##### -->
1393		<para>
1394
1395		</para>
1396
1397		@self:
1398		@contact:
1399		@subscribe:
1400		@publish:
1401		@publish_request:
1402
1403		<!-- ##### FUNCTION tp_base_contact_list_get_subscriptions_persist ##### -->
1404		<para>
1405
1406		</para>
1407
1408		@self:
1409		@Returns:
1410
1411		<!-- ##### FUNCTION tp_base_contact_list_group_renamed ##### -->
1412		<para>
1413
1414		</para>
1415
1416		@self:
1417		@old_name:
1418		@new_name:
1419
1420		<!-- ##### FUNCTION tp_base_contact_list_groups_changed ##### -->
1421		<para>
1422
1423		</para>
1424
1425		@self:
1426		@contacts:
1427		@added:
1428		@n_added:
1429		@removed:
1430		@n_removed:
1431
1432		<!-- ##### FUNCTION tp_base_contact_list_groups_created ##### -->
1433		<para>
1434
1435		</para>
1436
1437		@self:
1438		@created:
1439		@n_created:
1440
1441		<!-- ##### FUNCTION tp_base_contact_list_groups_removed ##### -->
1442		<para>
1443
1444		</para>
1445
1446		@self:
1447		@removed:
1448		@n_removed:
1449
1450		<!-- ##### FUNCTION tp_base_contact_list_has_disjoint_groups ##### -->
1451		<para>
1452
1453		</para>
1454
1455		@self:
1456		@Returns:
1457
1458		<!-- ##### FUNCTION tp_base_contact_list_mixin_class_init ##### -->
1459		<para>
1460
1461		</para>
1462
1463		@cls:
1464
1465		<!-- ##### FUNCTION tp_base_contact_list_mixin_groups_iface_init ##### -->
1466		<para>
1467
1468		</para>
1469
1470		@klass:
1471
1472		<!-- ##### FUNCTION tp_base_contact_list_mixin_implement_groups ##### -->
1473		<para>
1474
1475		</para>
1476
1477		@klass:
1478
1479		<!-- ##### FUNCTION tp_base_contact_list_mixin_implement_list ##### -->
1480		<para>
1481
1482		</para>
1483
1484		@klass:
1485
1486		<!-- ##### FUNCTION tp_base_contact_list_mixin_list_iface_init ##### -->
1487		<para>
1488
1489		</para>
1490
1491		@klass:
1492
1493		<!-- ##### FUNCTION tp_base_contact_list_mixin_register_with_contacts_mixin ##### -->
1494		<para>
1495
1496		</para>
1497
1498		@conn:
1499
1500		<!-- ##### FUNCTION tp_base_contact_list_normalize_group ##### -->
1501		<para>
1502
1503		</para>
1504
1505		@self:
1506		@s:
1507		@Returns:
1508
1509		<!-- ##### FUNCTION tp_base_contact_list_remove_contacts ##### -->
1510		<para>
1511
1512		</para>
1513
1514		@self:
1515		@contacts:
1516
1517		<!-- ##### FUNCTION tp_base_contact_list_remove_contacts_async ##### -->
1518		<para>
1519
1520		</para>
1521
1522		@self:
1523		@contacts:
1524		@callback:
1525		@user_data:
1526
1527		<!-- ##### FUNCTION tp_base_contact_list_remove_contacts_finish ##### -->
1528		<para>
1529
1530		</para>
1531
1532		@self:
1533		@result:
1534		@error:
1535		@Returns:
1536
1537		<!-- ##### FUNCTION tp_base_contact_list_remove_from_group ##### -->
1538		<para>
1539
1540		</para>
1541
1542		@self:
1543		@group:
1544		@contacts:
1545
1546		<!-- ##### FUNCTION tp_base_contact_list_remove_group ##### -->
1547		<para>
1548
1549		</para>
1550
1551		@self:
1552		@group:
1553
1554		<!-- ##### FUNCTION tp_base_contact_list_rename_group ##### -->
1555		<para>
1556
1557		</para>
1558
1559		@self:
1560		@old_name:
1561		@new_name:
1562
1563		<!-- ##### FUNCTION tp_base_contact_list_request_subscription ##### -->
1564		<para>
1565
1566		</para>
1567
1568		@self:
1569		@contacts:
1570		@message:
1571
1572		<!-- ##### FUNCTION tp_base_contact_list_request_subscription_async ##### -->
1573		<para>
1574
1575		</para>
1576
1577		@self:
1578		@contacts:
1579		@message:
1580		@callback:
1581		@user_data:
1582
1583		<!-- ##### FUNCTION tp_base_contact_list_request_subscription_finish ##### -->
1584		<para>
1585
1586		</para>
1587
1588		@self:
1589		@result:
1590		@error:
1591		@Returns:
1592
1593		<!-- ##### FUNCTION tp_base_contact_list_set_contact_groups ##### -->
1594		<para>
1595
1596		</para>
1597
1598		@self:
1599		@contact:
1600		@normalized_names:
1601		@n_names:
1602
1603		<!-- ##### FUNCTION tp_base_contact_list_set_contact_groups_async ##### -->
1604		<para>
1605
1606		</para>
1607
1608		@self:
1609		@contact:
1610		@normalized_names:
1611		@n_names:
1612		@callback:
1613		@user_data:
1614
1615		<!-- ##### FUNCTION tp_base_contact_list_set_contact_groups_finish ##### -->
1616		<para>
1617
1618		</para>
1619
1620		@self:
1621		@result:
1622		@error:
1623		@Returns:
1624
1625		<!-- ##### FUNCTION tp_base_contact_list_set_list_received ##### -->
1626		<para>
1627
1628		</para>
1629
1630		@self:
1631
1632		<!-- ##### FUNCTION tp_base_contact_list_store_contacts ##### -->
1633		<para>
1634
1635		</para>
1636
1637		@self:
1638		@contacts:
1639
1640		<!-- ##### FUNCTION tp_base_contact_list_store_contacts_async ##### -->
1641		<para>
1642
1643		</para>
1644
1645		@self:
1646		@contacts:
1647		@callback:
1648		@user_data:
1649
1650		<!-- ##### FUNCTION tp_base_contact_list_store_contacts_finish ##### -->
1651		<para>
1652
1653		</para>
1654
1655		@self:
1656		@result:
1657		@error:
1658		@Returns:
1659
1660		<!-- ##### FUNCTION tp_base_contact_list_true_func ##### -->
1661		<para>
1662
1663		</para>
1664
1665		@self:
1666		@Returns:
1667
1668		<!-- ##### FUNCTION tp_base_contact_list_unblock_contacts ##### -->
1669		<para>
1670
1671		</para>
1672
1673		@self:
1674		@contacts:
1675
1676		<!-- ##### FUNCTION tp_base_contact_list_unblock_contacts_async ##### -->
1677		<para>
1678
1679		</para>
1680
1681		@self:
1682		@contacts:
1683		@callback:
1684		@user_data:
1685
1686		<!-- ##### FUNCTION tp_base_contact_list_unblock_contacts_finish ##### -->
1687		<para>
1688
1689		</para>
1690
1691		@self:
1692		@result:
1693		@error:
1694		@Returns:
1695
1696		<!-- ##### FUNCTION tp_base_contact_list_unpublish ##### -->
1697		<para>
1698
1699		</para>
1700
1701		@self:
1702		@contacts:
1703
1704		<!-- ##### FUNCTION tp_base_contact_list_unpublish_async ##### -->
1705		<para>
1706
1707		</para>
1708
1709		@self:
1710		@contacts:
1711		@callback:
1712		@user_data:
1713
1714		<!-- ##### FUNCTION tp_base_contact_list_unpublish_finish ##### -->
1715		<para>
1716
1717		</para>
1718
1719		@self:
1720		@result:
1721		@error:
1722		@Returns:
1723
1724		<!-- ##### FUNCTION tp_base_contact_list_unsubscribe ##### -->
1725		<para>
1726
1727		</para>
1728
1729		@self:
1730		@contacts:
1731
1732		<!-- ##### FUNCTION tp_base_contact_list_unsubscribe_async ##### -->
1733		<para>
1734
1735		</para>
1736
1737		@self:
1738		@contacts:
1739		@callback:
1740		@user_data:
1741
1742		<!-- ##### FUNCTION tp_base_contact_list_unsubscribe_finish ##### -->
1743		<para>
1744
1745		</para>
1746
1747		@self:
1748		@result:
1749		@error:
1750		@Returns:
1751	268
1752	269	<!-- ##### FUNCTION tp_base_protocol_get_immutable_properties ##### -->
1753	270	<para>

1774	291	@asv:
1775	292	@error:
1776	293	@Returns:
1777
1778		<!-- ##### FUNCTION tp_cli_connection_call_add_client_interest ##### -->
1779		<para>
1780
1781		</para>
1782
1783		@proxy:
1784		@timeout_ms:
1785		@in_Interfaces:
1786		@callback:
1787		@user_data:
1788		@destroy:
1789		@weak_object:
1790		@Returns:
1791
1792		<!-- ##### FUNCTION tp_cli_connection_call_remove_client_interest ##### -->
1793		<para>
1794
1795		</para>
1796
1797		@proxy:
1798		@timeout_ms:
1799		@in_Interfaces:
1800		@callback:
1801		@user_data:
1802		@destroy:
1803		@weak_object:
1804		@Returns:
1805
1806		<!-- ##### USER_FUNCTION tp_cli_connection_callback_for_add_client_interest ##### -->
1807		<para>
1808
1809		</para>
1810
1811		@proxy:
1812		@error:
1813		@user_data:
1814		@weak_object:
1815
1816		<!-- ##### USER_FUNCTION tp_cli_connection_callback_for_remove_client_interest ##### -->
1817		<para>
1818
1819		</para>
1820
1821		@proxy:
1822		@error:
1823		@user_data:
1824		@weak_object:
1825
1826		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_add_to_group ##### -->
1827		<para>
1828
1829		</para>
1830
1831		@proxy:
1832		@timeout_ms:
1833		@in_Group:
1834		@in_Members:
1835		@callback:
1836		@user_data:
1837		@destroy:
1838		@weak_object:
1839		@Returns:
1840
1841		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_remove_from_group ##### -->
1842		<para>
1843
1844		</para>
1845
1846		@proxy:
1847		@timeout_ms:
1848		@in_Group:
1849		@in_Members:
1850		@callback:
1851		@user_data:
1852		@destroy:
1853		@weak_object:
1854		@Returns:
1855
1856		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_remove_group ##### -->
1857		<para>
1858
1859		</para>
1860
1861		@proxy:
1862		@timeout_ms:
1863		@in_Group:
1864		@callback:
1865		@user_data:
1866		@destroy:
1867		@weak_object:
1868		@Returns:
1869
1870		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_rename_group ##### -->
1871		<para>
1872
1873		</para>
1874
1875		@proxy:
1876		@timeout_ms:
1877		@in_Old_Name:
1878		@in_New_Name:
1879		@callback:
1880		@user_data:
1881		@destroy:
1882		@weak_object:
1883		@Returns:
1884
1885		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_set_contact_groups ##### -->
1886		<para>
1887
1888		</para>
1889
1890		@proxy:
1891		@timeout_ms:
1892		@in_Contact:
1893		@in_Groups:
1894		@callback:
1895		@user_data:
1896		@destroy:
1897		@weak_object:
1898		@Returns:
1899
1900		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_set_group_members ##### -->
1901		<para>
1902
1903		</para>
1904
1905		@proxy:
1906		@timeout_ms:
1907		@in_Group:
1908		@in_Members:
1909		@callback:
1910		@user_data:
1911		@destroy:
1912		@weak_object:
1913		@Returns:
1914
1915		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_add_to_group ##### -->
1916		<para>
1917
1918		</para>
1919
1920		@proxy:
1921		@error:
1922		@user_data:
1923		@weak_object:
1924
1925		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_remove_from_group ##### -->
1926		<para>
1927
1928		</para>
1929
1930		@proxy:
1931		@error:
1932		@user_data:
1933		@weak_object:
1934
1935		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_remove_group ##### -->
1936		<para>
1937
1938		</para>
1939
1940		@proxy:
1941		@error:
1942		@user_data:
1943		@weak_object:
1944
1945		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_rename_group ##### -->
1946		<para>
1947
1948		</para>
1949
1950		@proxy:
1951		@error:
1952		@user_data:
1953		@weak_object:
1954
1955		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_set_contact_groups ##### -->
1956		<para>
1957
1958		</para>
1959
1960		@proxy:
1961		@error:
1962		@user_data:
1963		@weak_object:
1964
1965		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_callback_for_set_group_members ##### -->
1966		<para>
1967
1968		</para>
1969
1970		@proxy:
1971		@error:
1972		@user_data:
1973		@weak_object:
1974
1975		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_group_renamed ##### -->
1976		<para>
1977
1978		</para>
1979
1980		@proxy:
1981		@callback:
1982		@user_data:
1983		@destroy:
1984		@weak_object:
1985		@error:
1986		@Returns:
1987
1988		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_groups_changed ##### -->
1989		<para>
1990
1991		</para>
1992
1993		@proxy:
1994		@callback:
1995		@user_data:
1996		@destroy:
1997		@weak_object:
1998		@error:
1999		@Returns:
2000
2001		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_groups_created ##### -->
2002		<para>
2003
2004		</para>
2005
2006		@proxy:
2007		@callback:
2008		@user_data:
2009		@destroy:
2010		@weak_object:
2011		@error:
2012		@Returns:
2013
2014		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_connect_to_groups_removed ##### -->
2015		<para>
2016
2017		</para>
2018
2019		@proxy:
2020		@callback:
2021		@user_data:
2022		@destroy:
2023		@weak_object:
2024		@error:
2025		@Returns:
2026
2027		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_run_add_to_group ##### -->
2028		<para>
2029
2030		</para>
2031
2032		@proxy:
2033		@timeout_ms:
2034		@in_Group:
2035		@in_Members:
2036		@error:
2037		@loop:
2038		@Returns:
2039
2040		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_run_remove_from_group ##### -->
2041		<para>
2042
2043		</para>
2044
2045		@proxy:
2046		@timeout_ms:
2047		@in_Group:
2048		@in_Members:
2049		@error:
2050		@loop:
2051		@Returns:
2052
2053		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_run_remove_group ##### -->
2054		<para>
2055
2056		</para>
2057
2058		@proxy:
2059		@timeout_ms:
2060		@in_Group:
2061		@error:
2062		@loop:
2063		@Returns:
2064
2065		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_run_rename_group ##### -->
2066		<para>
2067
2068		</para>
2069
2070		@proxy:
2071		@timeout_ms:
2072		@in_Old_Name:
2073		@in_New_Name:
2074		@error:
2075		@loop:
2076		@Returns:
2077
2078		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_run_set_contact_groups ##### -->
2079		<para>
2080
2081		</para>
2082
2083		@proxy:
2084		@timeout_ms:
2085		@in_Contact:
2086		@in_Groups:
2087		@error:
2088		@loop:
2089		@Returns:
2090
2091		<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_run_set_group_members ##### -->
2092		<para>
2093
2094		</para>
2095
2096		@proxy:
2097		@timeout_ms:
2098		@in_Group:
2099		@in_Members:
2100		@error:
2101		@loop:
2102		@Returns:
2103
2104		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_group_renamed ##### -->
2105		<para>
2106
2107		</para>
2108
2109		@proxy:
2110		@arg_Old_Name:
2111		@arg_New_Name:
2112		@user_data:
2113		@weak_object:
2114
2115		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_groups_changed ##### -->
2116		<para>
2117
2118		</para>
2119
2120		@proxy:
2121		@arg_Contact:
2122		@arg_Added:
2123		@arg_Removed:
2124		@user_data:
2125		@weak_object:
2126
2127		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_groups_created ##### -->
2128		<para>
2129
2130		</para>
2131
2132		@proxy:
2133		@arg_Names:
2134		@user_data:
2135		@weak_object:
2136
2137		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_groups_signal_callback_groups_removed ##### -->
2138		<para>
2139
2140		</para>
2141
2142		@proxy:
2143		@arg_Names:
2144		@user_data:
2145		@weak_object:
2146
2147		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_authorize_publication ##### -->
2148		<para>
2149
2150		</para>
2151
2152		@proxy:
2153		@timeout_ms:
2154		@in_Contacts:
2155		@callback:
2156		@user_data:
2157		@destroy:
2158		@weak_object:
2159		@Returns:
2160
2161		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_get_contact_list_attributes ##### -->
2162		<para>
2163
2164		</para>
2165
2166		@proxy:
2167		@timeout_ms:
2168		@in_Interfaces:
2169		@in_Hold:
2170		@callback:
2171		@user_data:
2172		@destroy:
2173		@weak_object:
2174		@Returns:
2175
2176		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_remove_contacts ##### -->
2177		<para>
2178
2179		</para>
2180
2181		@proxy:
2182		@timeout_ms:
2183		@in_Contacts:
2184		@callback:
2185		@user_data:
2186		@destroy:
2187		@weak_object:
2188		@Returns:
2189
2190		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_request_subscription ##### -->
2191		<para>
2192
2193		</para>
2194
2195		@proxy:
2196		@timeout_ms:
2197		@in_Contacts:
2198		@in_Message:
2199		@callback:
2200		@user_data:
2201		@destroy:
2202		@weak_object:
2203		@Returns:
2204
2205		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_unpublish ##### -->
2206		<para>
2207
2208		</para>
2209
2210		@proxy:
2211		@timeout_ms:
2212		@in_Contacts:
2213		@callback:
2214		@user_data:
2215		@destroy:
2216		@weak_object:
2217		@Returns:
2218
2219		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_call_unsubscribe ##### -->
2220		<para>
2221
2222		</para>
2223
2224		@proxy:
2225		@timeout_ms:
2226		@in_Contacts:
2227		@callback:
2228		@user_data:
2229		@destroy:
2230		@weak_object:
2231		@Returns:
2232
2233		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_authorize_publication ##### -->
2234		<para>
2235
2236		</para>
2237
2238		@proxy:
2239		@error:
2240		@user_data:
2241		@weak_object:
2242
2243		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_get_contact_list_attributes ##### -->
2244		<para>
2245
2246		</para>
2247
2248		@proxy:
2249		@out_Attributes:
2250		@error:
2251		@user_data:
2252		@weak_object:
2253
2254		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_remove_contacts ##### -->
2255		<para>
2256
2257		</para>
2258
2259		@proxy:
2260		@error:
2261		@user_data:
2262		@weak_object:
2263
2264		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_request_subscription ##### -->
2265		<para>
2266
2267		</para>
2268
2269		@proxy:
2270		@error:
2271		@user_data:
2272		@weak_object:
2273
2274		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_unpublish ##### -->
2275		<para>
2276
2277		</para>
2278
2279		@proxy:
2280		@error:
2281		@user_data:
2282		@weak_object:
2283
2284		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_callback_for_unsubscribe ##### -->
2285		<para>
2286
2287		</para>
2288
2289		@proxy:
2290		@error:
2291		@user_data:
2292		@weak_object:
2293
2294		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_connect_to_contacts_changed ##### -->
2295		<para>
2296
2297		</para>
2298
2299		@proxy:
2300		@callback:
2301		@user_data:
2302		@destroy:
2303		@weak_object:
2304		@error:
2305		@Returns:
2306
2307		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_run_authorize_publication ##### -->
2308		<para>
2309
2310		</para>
2311
2312		@proxy:
2313		@timeout_ms:
2314		@in_Contacts:
2315		@error:
2316		@loop:
2317		@Returns:
2318
2319		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_run_get_contact_list_attributes ##### -->
2320		<para>
2321
2322		</para>
2323
2324		@proxy:
2325		@timeout_ms:
2326		@in_Interfaces:
2327		@in_Hold:
2328		@out_Attributes:
2329		@error:
2330		@loop:
2331		@Returns:
2332
2333		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_run_remove_contacts ##### -->
2334		<para>
2335
2336		</para>
2337
2338		@proxy:
2339		@timeout_ms:
2340		@in_Contacts:
2341		@error:
2342		@loop:
2343		@Returns:
2344
2345		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_run_request_subscription ##### -->
2346		<para>
2347
2348		</para>
2349
2350		@proxy:
2351		@timeout_ms:
2352		@in_Contacts:
2353		@in_Message:
2354		@error:
2355		@loop:
2356		@Returns:
2357
2358		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_run_unpublish ##### -->
2359		<para>
2360
2361		</para>
2362
2363		@proxy:
2364		@timeout_ms:
2365		@in_Contacts:
2366		@error:
2367		@loop:
2368		@Returns:
2369
2370		<!-- ##### FUNCTION tp_cli_connection_interface_contact_list_run_unsubscribe ##### -->
2371		<para>
2372
2373		</para>
2374
2375		@proxy:
2376		@timeout_ms:
2377		@in_Contacts:
2378		@error:
2379		@loop:
2380		@Returns:
2381
2382		<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_list_signal_callback_contacts_changed ##### -->
2383		<para>
2384
2385		</para>
2386
2387		@proxy:
2388		@arg_Changes:
2389		@arg_Removals:
2390		@user_data:
2391		@weak_object:
2392	294
2393	295	<!-- ##### FUNCTION tp_cli_protocol_call_identify_account ##### -->
2394	296	<para>

2440	342	@user_data:
2441	343	@weak_object:
2442	344
2443		<!-- ##### FUNCTION tp_connection_add_client_interest ##### -->
2444		<para>
2445
2446		</para>
2447
2448		@self:
2449		@interested_in:
2450
2451		<!-- ##### FUNCTION tp_connection_add_client_interest_by_id ##### -->
2452		<para>
2453
2454		</para>
2455
2456		@self:
2457		@interested_in:
2458
2459	345	<!-- ##### FUNCTION tp_connection_manager_get_protocol_object ##### -->
2460	346	<para>
2461	347

2463	349
2464	350	@self:
2465	351	@protocol:
2466		@Returns:
2467
2468		<!-- ##### FUNCTION tp_connection_request_contact_list_attributes ##### -->
2469		<para>
2470
2471		</para>
2472
2473		@self:
2474		@timeout_ms:
2475		@interfaces:
2476		@hold:
2477		@callback:
2478		@user_data:
2479		@destroy:
2480		@weak_object:
2481
2482		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_add_to_group ##### -->
2483		<para>
2484
2485		</para>
2486
2487		@cls:
2488		@impl:
2489
2490		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_authorize_publication ##### -->
2491		<para>
2492
2493		</para>
2494
2495		@cls:
2496		@impl:
2497
2498		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_block_contacts ##### -->
2499		<para>
2500
2501		</para>
2502
2503		@cls:
2504		@impl:
2505
2506		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_can_block ##### -->
2507		<para>
2508
2509		</para>
2510
2511		@cls:
2512		@check:
2513
2514		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_can_change_subscriptions ##### -->
2515		<para>
2516
2517		</para>
2518
2519		@cls:
2520		@check:
2521
2522		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_disjoint_groups ##### -->
2523		<para>
2524
2525		</para>
2526
2527		@cls:
2528		@impl:
2529
2530		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_get_blocked_contacts ##### -->
2531		<para>
2532
2533		</para>
2534
2535		@cls:
2536		@impl:
2537
2538		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_get_contact_blocked ##### -->
2539		<para>
2540
2541		</para>
2542
2543		@cls:
2544		@impl:
2545
2546		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_get_contact_groups ##### -->
2547		<para>
2548
2549		</para>
2550
2551		@cls:
2552		@impl:
2553
2554		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_get_contacts ##### -->
2555		<para>
2556
2557		</para>
2558
2559		@cls:
2560		@impl:
2561
2562		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_get_groups ##### -->
2563		<para>
2564
2565		</para>
2566
2567		@cls:
2568		@impl:
2569
2570		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_get_states ##### -->
2571		<para>
2572
2573		</para>
2574
2575		@cls:
2576		@impl:
2577
2578		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_just_store_contacts ##### -->
2579		<para>
2580
2581		</para>
2582
2583		@cls:
2584		@impl:
2585
2586		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_normalize_group ##### -->
2587		<para>
2588
2589		</para>
2590
2591		@cls:
2592		@impl:
2593
2594		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_remove_contacts ##### -->
2595		<para>
2596
2597		</para>
2598
2599		@cls:
2600		@impl:
2601
2602		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_remove_from_group ##### -->
2603		<para>
2604
2605		</para>
2606
2607		@cls:
2608		@impl:
2609
2610		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_remove_group ##### -->
2611		<para>
2612
2613		</para>
2614
2615		@cls:
2616		@impl:
2617
2618		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_request_subscription ##### -->
2619		<para>
2620
2621		</para>
2622
2623		@cls:
2624		@impl:
2625
2626		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_request_uses_message ##### -->
2627		<para>
2628
2629		</para>
2630
2631		@cls:
2632		@check:
2633
2634		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_subscriptions_persist ##### -->
2635		<para>
2636
2637		</para>
2638
2639		@cls:
2640		@check:
2641
2642		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_unblock_contacts ##### -->
2643		<para>
2644
2645		</para>
2646
2647		@cls:
2648		@impl:
2649
2650		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_unpublish ##### -->
2651		<para>
2652
2653		</para>
2654
2655		@cls:
2656		@impl:
2657
2658		<!-- ##### FUNCTION tp_contact_list_manager_class_implement_unsubscribe ##### -->
2659		<para>
2660
2661		</para>
2662
2663		@cls:
2664		@impl:
2665
2666		<!-- ##### FUNCTION tp_contact_list_manager_contact_blocking_changed ##### -->
2667		<para>
2668
2669		</para>
2670
2671		@self:
2672		@changed:
2673
2674		<!-- ##### FUNCTION tp_contact_list_manager_contacts_changed ##### -->
2675		<para>
2676
2677		</para>
2678
2679		@self:
2680		@changed:
2681		@removed:
2682
2683		<!-- ##### FUNCTION tp_contact_list_manager_false_func ##### -->
2684		<para>
2685
2686		</para>
2687
2688		@self:
2689		@Returns:
2690
2691		<!-- ##### FUNCTION tp_contact_list_manager_group_renamed ##### -->
2692		<para>
2693
2694		</para>
2695
2696		@self:
2697		@old_name:
2698		@new_name:
2699
2700		<!-- ##### FUNCTION tp_contact_list_manager_groups_changed ##### -->
2701		<para>
2702
2703		</para>
2704
2705		@self:
2706		@contacts:
2707		@added:
2708		@n_added:
2709		@removed:
2710		@n_removed:
2711
2712		<!-- ##### FUNCTION tp_contact_list_manager_groups_created ##### -->
2713		<para>
2714
2715		</para>
2716
2717		@self:
2718		@created:
2719		@n_created:
2720
2721		<!-- ##### FUNCTION tp_contact_list_manager_groups_removed ##### -->
2722		<para>
2723
2724		</para>
2725
2726		@self:
2727		@removed:
2728		@n_removed:
2729
2730		<!-- ##### FUNCTION tp_contact_list_manager_request_failed ##### -->
2731		<para>
2732
2733		</para>
2734
2735		@self:
2736		@req:
2737		@domain:
2738		@code:
2739		@message:
2740
2741		<!-- ##### FUNCTION tp_contact_list_manager_request_succeeded ##### -->
2742		<para>
2743
2744		</para>
2745
2746		@self:
2747		@req:
2748
2749		<!-- ##### FUNCTION tp_contact_list_manager_set_default_group ##### -->
2750		<para>
2751
2752		</para>
2753
2754		@self:
2755		@def:
2756
2757		<!-- ##### FUNCTION tp_contact_list_manager_set_list_received ##### -->
2758		<para>
2759
2760		</para>
2761
2762		@self:
2763
2764		<!-- ##### FUNCTION tp_contact_list_manager_true_func ##### -->
2765		<para>
2766
2767		</para>
2768
2769		@self:
2770	352	@Returns:
2771	353
2772	354	<!-- ##### FUNCTION tp_dbus_properties_mixin_fill_properties_hash ##### -->

2873	455	@error:
2874	456	@Returns:
2875	457
2876		<!-- ##### FUNCTION tp_simple_async_report_success_in_idle ##### -->
2877		<para>
2878
2879		</para>
2880
2881		@source:
2882		@callback:
2883		@user_data:
2884		@source_tag:
2885
2886		<!-- ##### USER_FUNCTION tp_svc_connection_add_client_interest_impl ##### -->
2887		<para>
2888
2889		</para>
2890
2891		@self:
2892		@in_Interfaces:
	458	<!-- ##### USER_FUNCTION tp_svc_protocol_identify_account_impl ##### -->
	459	<para>
	460
	461	</para>
	462
	463	@self:
	464	@in_Parameters:
2893	465	@context:
2894	466
2895		<!-- ##### FUNCTION tp_svc_connection_implement_add_client_interest ##### -->
	467	<!-- ##### FUNCTION tp_svc_protocol_implement_identify_account ##### -->
2896	468	<para>
2897	469
2898	470	</para>

2900	472	@klass:
2901	473	@impl:
2902	474
2903		<!-- ##### FUNCTION tp_svc_connection_implement_remove_client_interest ##### -->
	475	<!-- ##### FUNCTION tp_svc_protocol_implement_normalize_contact ##### -->
2904	476	<para>
2905	477
2906	478	</para>

2908	480	@klass:
2909	481	@impl:
2910	482
2911		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_groups_add_to_group_impl ##### -->
2912		<para>
2913
2914		</para>
2915
2916		@self:
2917		@in_Group:
2918		@in_Members:
2919		@context:
2920
2921		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_emit_group_renamed ##### -->
2922		<para>
2923
2924		</para>
2925
2926		@instance:
2927		@arg_Old_Name:
2928		@arg_New_Name:
2929
2930		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_emit_groups_changed ##### -->
2931		<para>
2932
2933		</para>
2934
2935		@instance:
2936		@arg_Contact:
2937		@arg_Added:
2938		@arg_Removed:
2939
2940		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_emit_groups_created ##### -->
2941		<para>
2942
2943		</para>
2944
2945		@instance:
2946		@arg_Names:
2947
2948		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_emit_groups_removed ##### -->
2949		<para>
2950
2951		</para>
2952
2953		@instance:
2954		@arg_Names:
2955
2956		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_implement_add_to_group ##### -->
2957		<para>
2958
2959		</para>
2960
2961		@klass:
2962		@impl:
2963
2964		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_implement_remove_from_group ##### -->
2965		<para>
2966
2967		</para>
2968
2969		@klass:
2970		@impl:
2971
2972		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_implement_remove_group ##### -->
2973		<para>
2974
2975		</para>
2976
2977		@klass:
2978		@impl:
2979
2980		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_implement_rename_group ##### -->
2981		<para>
2982
2983		</para>
2984
2985		@klass:
2986		@impl:
2987
2988		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_implement_set_contact_groups ##### -->
2989		<para>
2990
2991		</para>
2992
2993		@klass:
2994		@impl:
2995
2996		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_implement_set_group_members ##### -->
2997		<para>
2998
2999		</para>
3000
3001		@klass:
3002		@impl:
3003
3004		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_groups_remove_from_group_impl ##### -->
3005		<para>
3006
3007		</para>
3008
3009		@self:
3010		@in_Group:
3011		@in_Members:
3012		@context:
3013
3014		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_groups_remove_group_impl ##### -->
3015		<para>
3016
3017		</para>
3018
3019		@self:
3020		@in_Group:
3021		@context:
3022
3023		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_groups_rename_group_impl ##### -->
3024		<para>
3025
3026		</para>
3027
3028		@self:
3029		@in_Old_Name:
3030		@in_New_Name:
3031		@context:
3032
3033		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_return_from_add_to_group ##### -->
3034		<para>
3035
3036		</para>
3037
3038		@context:
3039
3040		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_return_from_remove_from_group ##### -->
3041		<para>
3042
3043		</para>
3044
3045		@context:
3046
3047		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_return_from_remove_group ##### -->
3048		<para>
3049
3050		</para>
3051
3052		@context:
3053
3054		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_return_from_rename_group ##### -->
3055		<para>
3056
3057		</para>
3058
3059		@context:
3060
3061		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_return_from_set_contact_groups ##### -->
3062		<para>
3063
3064		</para>
3065
3066		@context:
3067
3068		<!-- ##### FUNCTION tp_svc_connection_interface_contact_groups_return_from_set_group_members ##### -->
3069		<para>
3070
3071		</para>
3072
3073		@context:
3074
3075		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_groups_set_contact_groups_impl ##### -->
3076		<para>
3077
3078		</para>
3079
3080		@self:
3081		@in_Contact:
3082		@in_Groups:
3083		@context:
3084
3085		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_groups_set_group_members_impl ##### -->
3086		<para>
3087
3088		</para>
3089
3090		@self:
3091		@in_Group:
3092		@in_Members:
3093		@context:
3094
3095		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_authorize_publication_impl ##### -->
3096		<para>
3097
3098		</para>
3099
3100		@self:
3101		@in_Contacts:
3102		@context:
3103
3104		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_emit_contacts_changed ##### -->
3105		<para>
3106
3107		</para>
3108
3109		@instance:
3110		@arg_Changes:
3111		@arg_Removals:
3112
3113		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_get_contact_list_attributes_impl ##### -->
3114		<para>
3115
3116		</para>
3117
3118		@self:
3119		@in_Interfaces:
3120		@in_Hold:
3121		@context:
3122
3123		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_authorize_publication ##### -->
3124		<para>
3125
3126		</para>
3127
3128		@klass:
3129		@impl:
3130
3131		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_get_contact_list_attributes ##### -->
3132		<para>
3133
3134		</para>
3135
3136		@klass:
3137		@impl:
3138
3139		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_remove_contacts ##### -->
3140		<para>
3141
3142		</para>
3143
3144		@klass:
3145		@impl:
3146
3147		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_request_contact_list ##### -->
3148		<para>
3149
3150		</para>
3151
3152		@klass:
3153		@impl:
3154
3155		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_request_subscription ##### -->
3156		<para>
3157
3158		</para>
3159
3160		@klass:
3161		@impl:
3162
3163		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_unpublish ##### -->
3164		<para>
3165
3166		</para>
3167
3168		@klass:
3169		@impl:
3170
3171		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_implement_unsubscribe ##### -->
3172		<para>
3173
3174		</para>
3175
3176		@klass:
3177		@impl:
3178
3179		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_remove_contacts_impl ##### -->
3180		<para>
3181
3182		</para>
3183
3184		@self:
3185		@in_Contacts:
3186		@context:
3187
3188		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_request_contact_list_impl ##### -->
3189		<para>
3190
3191		</para>
3192
3193		@self:
3194		@in_Interfaces:
3195		@in_Hold:
3196		@context:
3197
3198		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_request_subscription_impl ##### -->
3199		<para>
3200
3201		</para>
3202
3203		@self:
3204		@in_Contacts:
3205		@in_Message:
3206		@context:
3207
3208		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_authorize_publication ##### -->
3209		<para>
3210
3211		</para>
3212
3213		@context:
3214
3215		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_get_contact_list_attributes ##### -->
3216		<para>
3217
3218		</para>
3219
3220		@context:
3221		@out_Attributes:
3222
3223		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_remove_contacts ##### -->
3224		<para>
3225
3226		</para>
3227
3228		@context:
3229
3230		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_request_contact_list ##### -->
3231		<para>
3232
3233		</para>
3234
3235		@context:
3236		@out_Attributes:
3237
3238		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_request_subscription ##### -->
3239		<para>
3240
3241		</para>
3242
3243		@context:
3244
3245		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_unpublish ##### -->
3246		<para>
3247
3248		</para>
3249
3250		@context:
3251
3252		<!-- ##### FUNCTION tp_svc_connection_interface_contact_list_return_from_unsubscribe ##### -->
3253		<para>
3254
3255		</para>
3256
3257		@context:
3258
3259		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_unpublish_impl ##### -->
3260		<para>
3261
3262		</para>
3263
3264		@self:
3265		@in_Contacts:
3266		@context:
3267
3268		<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_list_unsubscribe_impl ##### -->
3269		<para>
3270
3271		</para>
3272
3273		@self:
3274		@in_Contacts:
3275		@context:
3276
3277		<!-- ##### USER_FUNCTION tp_svc_connection_remove_client_interest_impl ##### -->
3278		<para>
3279
3280		</para>
3281
3282		@self:
3283		@in_Interfaces:
3284		@context:
3285
3286		<!-- ##### FUNCTION tp_svc_connection_return_from_add_client_interest ##### -->
3287		<para>
3288
3289		</para>
3290
3291		@context:
3292
3293		<!-- ##### FUNCTION tp_svc_connection_return_from_remove_client_interest ##### -->
3294		<para>
3295
3296		</para>
3297
3298		@context:
3299
3300		<!-- ##### USER_FUNCTION tp_svc_protocol_identify_account_impl ##### -->
3301		<para>
3302
3303		</para>
3304
3305		@self:
3306		@in_Parameters:
3307		@context:
3308
3309		<!-- ##### FUNCTION tp_svc_protocol_implement_identify_account ##### -->
3310		<para>
3311
3312		</para>
3313
3314		@klass:
3315		@impl:
3316
3317		<!-- ##### FUNCTION tp_svc_protocol_implement_normalize_contact ##### -->
3318		<para>
3319
3320		</para>
3321
3322		@klass:
3323		@impl:
3324
3325	483	<!-- ##### USER_FUNCTION tp_svc_protocol_normalize_contact_impl ##### -->
3326	484	<para>
3327	485

+11

-0

docs/reference/tmpl/util.sgml less more

404	404	@pp:
405	405
406	406
	407	<!-- ##### FUNCTION tp_simple_async_report_success_in_idle ##### -->
	408	<para>
	409
	410	</para>
	411
	412	@source:
	413	@callback:
	414	@user_data:
	415	@source_tag:
	416
	417

+51

-7

spec/Account.xml less more

260	260	</tp:docstring>
261	261	</property>
262	262
	263	<property name="Service" tp:name-for-bindings="Service" type="s"
	264	access="readwrite">
	265	<tp:added version="0.19.8"/>
	266	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	267	<p>Some protocols, like XMPP and SIP, are used by various different
	268	user-recognised brands, such as <i>Google Talk</i> and <i>Ovi by
	269	Nokia</i>. On accounts for such services, this property SHOULD be
	270	set to a string describing the service, which MUST consist only of
	271	ASCII letters, numbers and hyphen/minus signs, and start with a
	272	letter (matching the requirements for <tp:type>Protocol</tp:type>).
	273	For the <tt>jabber</tt> protocol, one of the following service names
	274	should be used if possible:</p>
	275
	276	<ul>
	277	<li><tt>google-talk</tt> (for <a
	278	href="http://www.google.com/talk/">Google's IM service</a>)</li>
	279	<li><tt>ovi-chat</tt> (for <a href="http://www.ovi.com/">Ovi</a>'s IM
	280	service)</li>
	281	<li><tt>facebook</tt> (for <a
	282	href="http://www.facebook.com/sitetour/chat.php">Facebook's IM
	283	service</a>)</li>
	284	<li><tt>lj-talk</tt> (for <a
	285	href="http://www.livejournal.com/chat/">LiveJournal's IM
	286	service</a>)</li>
	287
	288	</ul>
	289
	290	<p>The <tp:member-ref>Icon</tp:member-ref> property SHOULD be set to a
	291	corresponding brand-specific icon name, if possible. In the future,
	292	this property may be used as an index into additional
	293	service-specific customizations. If this property is the empty string
	294	(or missing), the service is determined by the protocol name (either
	295	because this is a single-service protocol like <tt>msn</tt>, or
	296	because this is just a generic <tt>jabber</tt> or <tt>sip</tt>
	297	account without specific branding).</p>
	298
	299	<p>This property MAY be set, if appropriate, when calling
	300	<tp:dbus-ref
	301	namespace="org.freedesktop.Telepathy.AccountManager"
	302	>CreateAccount</tp:dbus-ref>. Updating this property will fail on
	303	externally-stored accounts whose <tp:dbus-ref
	304	namespace="org.freedesktop.Telepathy.Account.Interface.Storage"
	305	>StorageRestrictions</tp:dbus-ref> include
	306	<code>Cannot_Set_Service</code>.</p>
	307	</tp:docstring>
	308	</property>
	309
263	310	<property name="Parameters" tp:name-for-bindings="Parameters"
264	311	type="a{sv}" access="read">
265	312	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">

272	319	</p>
273	320	<p>This property cannot be altered using Set() - use
274	321	<tp:member-ref>UpdateParameters</tp:member-ref> instead.</p>
275
276		<tp:rationale>
277		This avoids NMC being tied to gconf as a matter of API.
278		</tp:rationale>
279	322	</tp:docstring>
280	323	</property>
281	324

404	447	</tp:docstring>
405	448	</property>
406	449
407		<property name="ConnectionStatus" type="u" access="read"
408		tp:name-for-bindings="Connection_Status">
	450	<property name="ConnectionStatus" type="u" tp:type="Connection_Status"
	451	access="read" tp:name-for-bindings="Connection_Status">
409	452	<tp:docstring>
410	453	If the <tp:member-ref>Connection</tp:member-ref> property is non-empty,
411	454	the status of that connection.

425	468	</tp:docstring>
426	469	</property>
427	470
428		<property name="ConnectionStatusReason" type="u" access="read"
	471	<property name="ConnectionStatusReason" type="u"
	472	tp:type="Connection_Status_Reason" access="read"
429	473	tp:name-for-bindings="Connection_Status_Reason">
430	474	<tp:docstring>
431	475	The reason for the last change to

+169

-0

spec/Account_Interface_Storage.xml less more

	0	<?xml version="1.0" ?>
	1	<node name="/Account_Interface_Storage"
	2	xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
	3	<tp:copyright>Copyright (C) 2010 Collabora Ltd.</tp:copyright>
	4	<tp:license xmlns="http://www.w3.org/1999/xhtml">
	5	<p>This library is free software; you can redistribute it and/or
	6	modify it under the terms of the GNU Lesser General Public
	7	License as published by the Free Software Foundation; either
	8	version 2.1 of the License, or (at your option) any later version.</p>
	9
	10	<p>This library is distributed in the hope that it will be useful,
	11	but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	13	Lesser General Public License for more details.</p>
	14
	15	<p>You should have received a copy of the GNU Lesser General Public
	16	License along with this library; if not, write to the Free Software
	17	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
	18	</p>
	19	</tp:license>
	20	<interface name="org.freedesktop.Telepathy.Account.Interface.Storage">
	21	<tp:requires interface="org.freedesktop.Telepathy.Account"/>
	22
	23	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	24	<p>
	25	This interface extends the core Account interface to specify details
	26	regarding the storage of this account.
	27	</p>
	28
	29	<tp:rationale>
	30	<p>
	31	Single-sign-on systems do not generally have directly user-editable
	32	properties for Accounts, and require the user to visit a specific UI
	33	to alter their account properties. User interfaces should know not to
	34	expose these account properties as user-editable, and instead
	35	redirect the user to the appropriate interface.
	36	</p>
	37	</tp:rationale>
	38
	39	</tp:docstring>
	40	<tp:added version="0.19.8"/>
	41
	42	<property name="StorageProvider" tp:name-for-bindings="Storage_Provider"
	43	type="s" access="read">
	44	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	45	<p>
	46	The name of the account storage implementation, which SHOULD start
	47	with a reversed domain name in the same way as D-Bus interface names.
	48	When this is the empty string the account is internally stored.
	49	</p>
	50	<p>
	51	This property cannot change once an Account has been created.
	52	</p>
	53	</tp:docstring>
	54	</property>
	55
	56	<property name="StorageIdentifier"
	57	tp:name-for-bindings="Storage_Identifier" type="v" access="read">
	58	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	59	<p>
	60	Unique identification of the account within the storage backend.
	61	The contents of the variant are defined by the
	62	<tp:member-ref>StorageProvider</tp:member-ref>.
	63	</p>
	64	<p>
	65	This property cannot change once an Account has been created.
	66	</p>
	67	<tp:rationale>
	68	<p>
	69	Different storage systems will have their own way of uniquely
	70	identifying an account, typically an integer or a string.
	71	Given that all users of this property should have direct knowledge
	72	of the backend they should know what types to expect and how to
	73	handle it.
	74	</p>
	75	</tp:rationale>
	76	</tp:docstring>
	77	</property>
	78
	79	<property name="StorageSpecificInformation"
	80	tp:name-for-bindings="Storage_Specific_Information" type="a{sv}"
	81	access="read">
	82	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	83	<p>
	84	Map containing information specific to the storage backend. The keys
	85	and the types of their values are defined by the
	86	<tp:member-ref>StorageProvider</tp:member-ref>, and are not
	87	interpreted by the AccountManager implementation.
	88	</p>
	89	<p>
	90	As the values in this map may change at any time (due to an external
	91	application manipulating the storage provider directly), this
	92	property should not be cached; it should instead be retrieved each
	93	time it is needed.
	94	</p>
	95
	96	<tp:rationale>
	97	<p>
	98	This can be used to provide additional hints to user interfaces
	99	aware of a specific storage provider, without requiring those user
	100	interfaces to use the
	101	<tp:member-ref>StorageIdentifier</tp:member-ref> to query the
	102	storage provider directly.
	103	</p>
	104	</tp:rationale>
	105	</tp:docstring>
	106	</property>
	107
	108	<property name="StorageRestrictions"
	109	tp:name-for-bindings="Storage_Restrictions" type="u"
	110	tp:type="Storage_Restriction_Flags"
	111	access="read">
	112	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	113	<p>
	114	Bitfield which defines what restrictions this Storage method has.
	115	</p>
	116	<p>
	117	This property cannot change once an Account has been created.
	118	</p>
	119	</tp:docstring>
	120	</property>
	121
	122	<tp:flags name="Storage_Restriction_Flags"
	123	value-prefix="Storage_Restriction_Flag" type="u">
	124	<tp:docstring>
	125	Flags indicating restrictions imposed on an Account by its storage
	126	method.
	127	</tp:docstring>
	128
	129	<tp:flag suffix="Cannot_Set_Parameters" value="1">
	130	<tp:docstring>
	131	The account's <tp:dbus-ref
	132	namespace="org.freedesktop.Telepathy.Account"
	133	>Parameters</tp:dbus-ref> property can't be changed by calling
	134	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Account"
	135	>UpdateParameters</tp:dbus-ref>.
	136	</tp:docstring>
	137	</tp:flag>
	138
	139	<tp:flag suffix="Cannot_Set_Enabled" value="2">
	140	<tp:docstring>
	141	The account can't be enabled/disabled by setting the <tp:dbus-ref
	142	namespace="org.freedesktop.Telepathy.Account"
	143	>Enabled</tp:dbus-ref> property.
	144	</tp:docstring>
	145	</tp:flag>
	146
	147	<tp:flag suffix="Cannot_Set_Presence" value="4">
	148	<tp:docstring>
	149	The account's presence can't be changed by setting the <tp:dbus-ref
	150	namespace="org.freedesktop.Telepathy.Account"
	151	>RequestedPresence</tp:dbus-ref> and <tp:dbus-ref
	152	namespace="org.freedesktop.Telepathy.Account"
	153	>AutomaticPresence</tp:dbus-ref> properties.
	154	</tp:docstring>
	155	</tp:flag>
	156
	157	<tp:flag suffix="Cannot_Set_Service" value="8">
	158	<tp:docstring>
	159	The account's <tp:dbus-ref
	160	namespace="org.freedesktop.Telepathy.Account">Service</tp:dbus-ref>
	161	property cannot be changed.
	162	</tp:docstring>
	163	</tp:flag>
	164	</tp:flags>
	165
	166	</interface>
	167	</node>
	168	<!-- vim:set sw=2 sts=2 et ft=xml: -->

+562

-500

spec/Channel_Interface_Messages.xml less more

0	0	<?xml version="1.0" ?>
1	1	<node name="/Channel_Interface_Messages"
2	2	xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3		<tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
4		<tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
	3	<tp:copyright>Copyright © 2008–2010 Collabora Ltd.</tp:copyright>
	4	<tp:copyright>Copyright © 2008–2010 Nokia Corporation</tp:copyright>
5	5	<tp:license xmlns="http://www.w3.org/1999/xhtml">
6	6	<p>This library is free software; you can redistribute it and/or
7	7	modify it under the terms of the GNU Lesser General Public

24	24	<tp:added version="0.17.16">(as stable API)</tp:added>
25	25
26	26	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
27		<p>This interface extends the Text interface to support more general
28		messages, including:</p>
	27	<p>This interface extends the <tp:dbus-ref
	28	namespace='org.freedesktop.Telepathy.Channel.Type'>Text</tp:dbus-ref>
	29	interface to support more general messages, including:</p>
29	30
30	31	<ul>
31	32	<li>messages with attachments (like MIME multipart/mixed)</li>
32	33	<li>groups of alternatives (like MIME multipart/alternative)</li>
33		<li>delivery reports</li>
	34	<li>delivery reports (which replace <tp:dbus-ref
	35	namespace="org.freedesktop.Telepathy.Channel.Type">Text.SendError</tp:dbus-ref>),
	36	addding support for protocols where the message content is not echoed
	37	back to the sender on failure and for receiving positive
	38	acknowledgements, as well as ensuring that incoming delivery reports
	39	are not lost if no client is handling the channel yet;</li>
34	40	<li>any extra types of message we need in future</li>
35	41	</ul>
36	42
37		<p>Although this specification supports formatted (rich-text)
38		messages with unformatted alternatives, implementations SHOULD NOT
39		attempt to send formatted messages until the Telepathy specification
40		has also been extended to cover capability discovery for message
41		formatting.</p>
	43	<p>Incoming messages, outgoing messages, and delivery reports are all
	44	represented as lists of <tp:type>Message_Part</tp:type> structures,
	45	with a format reminiscent of e-mail. Messages are sent by calling
	46	<tp:member-ref>SendMessage</tp:member-ref>; outgoing messages are
	47	announced to other clients which may be interested in the channel by
	48	the <tp:member-ref>MessageSent</tp:member-ref> signal. Incoming
	49	messages and delivery reports are signalled by
	50	<tp:member-ref>MessageReceived</tp:member-ref>, and are stored in the
	51	the <tp:member-ref>PendingMessages</tp:member-ref> property until
	52	acknowledged by calling <tp:dbus-ref
	53	namespace="org.freedesktop.Telepathy.Channel.Type">Text.AcknowledgePendingMessages</tp:dbus-ref>.
	54	Only the <tp:dbus-ref
	55	namespace="org.freedesktop.Telepathy.Client">Handler</tp:dbus-ref>
	56	for a channel should acknowledge messages; <tp:dbus-ref
	57	namespace="org.freedesktop.Telepathy.Client">Observer</tp:dbus-ref>s
	58	(such as loggers) and <tp:dbus-ref
	59	namespace="org.freedesktop.Telepathy.Client">Approver</tp:dbus-ref>s
	60	for the channel may listen for incoming messages, and send messages of their own, but SHOULD NOT acknowledge messages.</p>
42	61
43	62	<tp:rationale>
44		We intend to expose all rich-text messages as XHTML-IM, but on some
45		protocols, formatting is an extremely limited subset of that format
46		(e.g. there are protocols where foreground/background colours, font
47		and size can be set, but only for entire messages).
48		Until we can tell UIs what controls to offer to the user, it's
49		unfriendly to offer the user controls that may have no effect.
	63	<p>If observers were allowed to acknowledge messages, then messages
	64	might have been acknowledged before the handler even got to see the
	65	channel, and hence could not be shown to the user.</p>
50	66	</tp:rationale>
51
52		<p>This interface also replaces <tp:dbus-ref
53		namespace="org.freedesktop.Telepathy.Channel.Type">Text.SendError</tp:dbus-ref>,
54		adding support for
55		protocols where the message content is not echoed back to the sender on
56		failure, adding support for receiving positive acknowledgements,
57		and using the Messages queue for state-recovery
58		(ensuring that incoming delivery reports are not lost if there is not
59		currently a process handling them).</p>
60	67
61	68	<p>If this interface is present, clients that support it SHOULD
62	69	listen for the <tp:member-ref>MessageSent</tp:member-ref> and

69	76	namespace="org.freedesktop.Telepathy.Channel.Type.Text">Received</tp:dbus-ref>
70	77	signals on the Text interface (which are guaranteed to duplicate
71	78	signals from this interface).</p>
	79
	80	<p>Although this specification supports formatted (rich-text)
	81	messages with unformatted alternatives, implementations SHOULD NOT
	82	attempt to send formatted messages until the Telepathy specification
	83	has also been extended to cover capability discovery for message
	84	formatting.</p>
	85
	86	<tp:rationale>
	87	We intend to expose all rich-text messages as XHTML-IM, but on some
	88	protocols, formatting is an extremely limited subset of that format
	89	(e.g. there are protocols where foreground/background colours, font
	90	and size can be set, but only for entire messages).
	91	Until we can tell UIs what controls to offer to the user, it's
	92	unfriendly to offer the user controls that may have no effect.
	93	</tp:rationale>
72	94	</tp:docstring>
73	95
74	96	<property name="SupportedContentTypes" type="as" access="read"

181	203	array-depth="2">
182	204	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
183	205	<p>Part of a message's content. In practice, this mapping never
184		appears in isolation - messages are represented by a list of
185		<tp:type>Message_Part</tp:type> mappings.</p>
186
187		<p>An example of how a rich-text message, with an embedded image, might
188		look, in a Python-like syntax:</p>
	206	appears in isolation: incoming messages are represented by a list of
	207	<tp:type>Message_Part</tp:type> mappings in the
	208	<tp:member-ref>MessageReceived</tp:member-ref> signal, and outgoing
	209	messages are passed to <tp:member-ref>SendMessage</tp:member-ref> as
	210	a list of these mappings.</p>
	211
	212	<p>The first part of the message contains "headers", which refer
	213	to the entire message. The second and subsequent parts contain the
	214	message's content, including plain text, formatted text and/or
	215	attached files. Well-known keys for the header and body parts are
	216	defined by the <tp:type>Message_Header_Key</tp:type> and
	217	<tp:type>Message_Body_Key</tp:type> types, respectively. It is an
	218	error for a connection manager to put keys referring to the message
	219	as a whole in the second or subsequent Message_Part, or keys intended
	220	for body parts in the first Message_Part; clients MUST recover from
	221	this error by ignoring these mis-placed keys.</p>
	222
	223	<tp:rationale>
	224	<p>Instead of representing messages as aa{sv} where the first
	225	dictionary is special (a dictionary of headers), we could have
	226	used a signature like (a{sv}aa{sv}) to separate out the headers
	227	and the body parts.</p>
	228
	229	<p>However, this would make access to the messages more awkward.
	230	In Python, the syntax for access to a header field would remain
	231	<code>message[0]['message-type']</code>, but access to a body
	232	field in the second body part would change from
	233	<code>message[2]['content'] to message[1][1]['content']</code>. In
	234	GLib, the message would change from being a
	235	<code>GPtrArray(GHashTable)</code> to being a
	236	<code>GValueArray(GHashTable, GPtrArray(GHashTable))</code> which
	237	is rather inconvenient to dereference.</p>
	238	</tp:rationale>
	239
	240	<p>In any group of parts with the same non-empty value for the
	241	<tt>alternative</tt> key (which represent alternative versions of the
	242	same content), more faithful versions of the intended message MUST
	243	come before less faithful versions (note that this order is the
	244	opposite of MIME <tt>multipart/alternative</tt> parts). Clients
	245	SHOULD display the first alternative that they understand.</p>
	246
	247	<tp:rationale>
	248	<p>Specifying the preference order means that if the underlying
	249	protocol doesn't support alternatives, the CM can safely delete
	250	everything apart from the first supported alternative when
	251	sending messages.</p>
	252
	253	<p>The order is the reverse of MIME because MIME's rationale for
	254	placing the "plainest" part first (legibility in pre-MIME UAs)
	255	does not apply to us, and placing the most preferred part
	256	first simplifies display (a client can iterate the message
	257	in order, display the first alternative that it understands,
	258	and skip displaying all subsequent parts with the same
	259	"alternative" key).</p>
	260	</tp:rationale>
	261
	262	<p>Clients SHOULD present all parts that are not redundant
	263	alternatives in the order they appear in this array, possibly
	264	excluding parts that are referenced by another displayed part.
	265	It is implementation-specific how the parts are presented to the
	266	user.</p>
	267
	268	<tp:rationale>
	269	<p>This allows CMs to assume that all parts are actually shown to
	270	the user, even if they are not explicitly referenced - we do
	271	not yet recommend formatted text, and there is no way for
	272	plain text to reference an attachment since it has no concept of
	273	markup or references. This also forces clients to do something
	274	sensible with messages that consist entirely of "attachments",
	275	with no "body" at all.</p>
	276
	277	<p>For instance, when displaying the above example, a client that
	278	understands the HTML part should display the JPEG image once,
	279	between the two lines "Here is a photo of my cat:" and
	280	"Isn't it cute?"; it may additionally present the image in some
	281	way for a second time, after "Isn't it cute?", or may choose
	282	not to.</p>
	283
	284	<p>A client that does not understand HTML, displaying the same
	285	message, should display the plain-text part, followed by the JPEG
	286	image.</p>
	287	</tp:rationale>
	288
	289	<h4>Example messages</h4>
	290
	291	<p>A rich-text message, with an embedded image, might be represented
	292	as:</p>
189	293
190	294	<pre>
191	295	[

214	318	},
215	319	]</pre>
216	320
217		<p>An example of how a non-text message — in particular, a vCard sent
218		via SMS as implemented by telepathy-ring on Nokia's Maemo 5 —
219		looks:</p>
	321	<p>telepathy-ring, Nokia's GSM connection manager, represents vCards
	322	sent via SMS as:</p>
220	323
221	324	<pre>
222	325	[

233	336	},
234	337	]</pre>
235	338
	339	<h3>Delivery reports</h3>
	340
236	341	<div>
237		<p>The first part of the message contains "headers" which refer
238		to the entire message.</p>
239
240		<p>It is an error for a connection manager to put keys referring
241		to the message as a whole in the second or subsequent
242		Message_Part, but clients MUST recover from this error by ignoring
243		these keys in the second and subsequent parts.</p>
244
245		<tp:rationale>
246		<p>Instead of representing messages as aa{sv} where the first
247		dictionary is special (a dictionary of headers), we could have
248		used a signature like (a{sv}aa{sv}) to separate out the headers
249		and the body parts.</p>
250
251		<p>However, this would make access to the messages more awkward.
252		In Python, the syntax for access to a header field would remain
253		<code>message[0]['message-type']</code>, but access to a body
254		field in the second body part would change from
255		message[2]['content'] to message[1][1]['content']. In GLib,
256		the message would change from being a
257		GPtrArray(GHashTable) to being a
258		GValueArray(GHashTable, GPtrArray(GHashTable)) which is rather
259		inconvenient to dereference.</p>
260		</tp:rationale>
261
262		<p>Well-known keys for the message as a whole, and the corresponding
263		value types, include:</p>
264
265		<dl>
266		<dt>message-token (s)</dt>
267		<dd>
268		<p>An opaque, globally-unique identifier for the entire message.
269		This MAY be treated as if it were a MIME Message-ID, e.g. for
270		the mid: and cid: URI schemes. If omitted, there is no suitable
271		token; the protocol-token key SHOULD be provided if the protocol
272		identifies messages in some less unique way.</p>
273		</dd>
274
275		<dt>protocol-token (s - <tp:type>Protocol_Message_Token</tp:type>)</dt>
276		<dd>
277		<p>An opaque token for the entire message, with whatever uniqueness
278		guarantee is provided by the underlying protocol. As described
279		for the Protocol_Message_Token type, this token is <em>not</em>
280		guaranteed to be unique between contacts, or even within the
281		scope of a Channel.</p>
282
283		<tp:rationale>
284		<p>In practice, in most protocols there is no token with the
285		uniqueness guarantees demanded for message-token; the
286		definition of message-token was inappropriate, but must now
287		be preserved for the benefit of clients that rely on it, at
288		least until Telepathy breaks backwards compatibility.</p>
289		</tp:rationale>
290
291		<p>The message-token and protocol-token SHOULD NOT both be present;
292		clients requiring an identifier with the semantics of the
293		protocol-token SHOULD look for the message-token first, falling
294		back to the protocol-token.</p>
295
296		<tp:rationale>
297		<p>This is for compatibility with CMs older than the
298		protocol-token key.</p>
299		</tp:rationale>
300		</dd>
301
302		<dt>message-sent (x - <tp:type>Unix_Timestamp64</tp:type>)</dt>
303		<dd>The time the message was sent (if unavailable, the time
304		it arrived at a central server MAY be used). Omitted if no
305		reasonable approximation is available; SHOULD always be present
306		on outgoing messages.</dd>
307
308		<dt>message-received (x - <tp:type>Unix_Timestamp64</tp:type>)</dt>
309		<dd>The time the message was received locally. SHOULD always
310		be present.</dd>
311
312		<dt>message-sender (u - <tp:type>Contact_Handle</tp:type>)</dt>
313		<dd>The contact who sent the message. If 0 or omitted, the contact
314		who sent the message could not be determined.</dd>
315
316		<dt>sender-nickname (s)</dt>
317		<dd>The nickname chosen by the sender of the message, which can be
318		different for each message in a conversation.</dd>
319
320		<dt>message-type (u - <tp:type>Channel_Text_Message_Type</tp:type>)
321		</dt>
322		<dd>The type of message; if omitted,
323		Channel_Text_Message_Type_Normal MUST be assumed. MAY
324		be omitted for normal chat messages.</dd>
325
326		<dt>pending-message-id (u - <tp:type>Message_ID</tp:type>)</dt>
327		<dd>The incoming message ID. This MUST NOT be present on outgoing
328		messages. Clients SHOULD NOT store this key - it is only valid
329		for as long as the message remains unacknowledged.</dd>
330
331		<dt>interface (s - <tp:type>DBus_Interface</tp:type>)</dt>
332		<dd>This message is specific to the given interface, which is
333		neither Text nor Messages. It SHOULD be ignored if that
334		interface is not supported. (Note that an 'interface' key
335		can also appear on the second and subsequent parts, where
336		it indicates that that part (only) should be ignored if
337		unsupported.)</dd>
338
339		<dt>scrollback (b)</dt>
340		<dd>If present and true, the incoming message was part of a
341		replay of message history (this matches the Scrollback flag in
342		<tp:type>Channel_Text_Message_Flags</tp:type>). This flag
343		does not make sense on outgoing messages and SHOULD NOT
344		appear there.</dd>
345
346		<dt>rescued (b)</dt>
347		<dd>If present and true, the incoming message has been seen in
348		a previous channel during the lifetime of the Connection,
349		but had not been acknowledged when that channel closed, causing
350		an identical channel (in which the message now appears) to open.
351		This matches the Rescued flag in
352		<tp:type>Channel_Text_Message_Flags</tp:type>; it
353		does not make sense on outgoing messages, and SHOULD NOT
354		appear there.</dd>
355		</dl>
356		</div>
357
358		<div>
359		<p>The second and subsequent parts contain the message's
360		content, including plain text, formatted text and/or attached
361		files.</p>
362
363		<p>It is an error for a connection manager to put keys referring
364		to the message body in the first Message_Part;
365		clients MUST recover from this error by ignoring
366		these keys in first part.</p>
367
368		<p>In any group of parts with the same non-empty value for the
369		"alternative" key (which represent alternative versions of the
370		same content), more faithful versions of the intended message MUST
371		come before less faithful versions (note that this order is the
372		opposite of MIME "multipart/alternative" parts). Clients SHOULD
373		display the first alternative that they understand.</p>
374
375		<tp:rationale>
376		<p>Specifying the preference order means that if the underlying
377		protocol doesn't support alternatives, the CM can safely delete
378		everything apart from the first supported alternative when
379		sending messages.</p>
380
381		<p>The order is the reverse of MIME because MIME's rationale for
382		placing the "plainest" part first (legibility in pre-MIME UAs)
383		does not apply to us, and placing the most preferred part
384		first simplifies display (a client can iterate the message
385		in order, display the first alternative that it understands,
386		and skip displaying all subsequent parts with the same
387		"alternative" key).</p>
388		</tp:rationale>
389
390		<p>Clients SHOULD present all parts that are not redundant
391		alternatives in the order they appear in this array, possibly
392		excluding parts that are referenced by another displayed part.
393		It is implementation-specific how the parts are presented to the
394		user.</p>
395
396		<tp:rationale>
397		<p>This allows CMs to assume that all parts are actually shown to
398		the user, even if they are not explicitly referenced - we do
399		not yet recommend formatted text, and there is no way for
400		plain text to reference an attachment since it has no concept of
401		markup or references. This also forces clients to do something
402		sensible with messages that consist entirely of "attachments",
403		with no "body" at all.</p>
404
405		<p>For instance, when displaying the above example, a client that
406		understands the HTML part should display the JPEG image once,
407		between the two lines "Here is a photo of my cat:" and
408		"Isn't it cute?"; it may additionally present the image in some
409		way for a second time, after "Isn't it cute?", or may choose
410		not to.</p>
411
412		<p>A client that does not understand HTML, displaying the same
413		message, should display the plain-text part, followed by the JPEG
414		image.</p>
415		</tp:rationale>
416
417		<p>Well-known keys for the second and subsequent parts, and the
418		corresponding value types, include:</p>
419
420		<dl>
421		<dt>identifier (s)</dt>
422		<dd>An opaque identifier for this part.
423		Parts of a message MAY reference other parts by treating
424		this identifier as if it were a MIME Content-ID and using
425		the cid: URI scheme.</dd>
426
427		<dt>alternative (s)</dt>
428		<dd>
429		<p>If present, this part of the message is an alternative for
430		all other parts with the same value for "alternative".
431		Clients SHOULD only display one of them (this is expected to
432		be used for XHTML messages in a future version of this
433		specification).</p>
434
435		<p>If omitted, this part is not an alternative for any other
436		part.</p>
437
438		<p>Parts of a message MAY reference the group of alternatives
439		as a whole (i.e. a reference to whichever of them is chosen)
440		by treating this identifier as if it were the MIME Content-ID
441		of a multipart/alternative part, and using the cid: URI
442		scheme.</p>
443		</dd>
444
445		<dt>content-type (s)</dt>
446		<dd>
447		<p>The MIME type of this part. See the documentation
448		for ReceivedMessage for notes on the special status of
449		"text/plain" parts.</p>
450
451		<p>Connection managers MUST NOT signal parts without a
452		'content-type' key; if a protocol provides no way to determine
453		the MIME type, the connection manager is responsible for
454		guessing it, but MAY fall back to "text/plain" for text and
455		"application/octet-stream" for non-text.</p>
456
457		<p>Clients MUST ignore parts without a 'content-type' key, which
458		are reserved for future expansion.</p>
459		</dd>
460
461		<dt>lang (s)</dt>
462		<dd>The natural language of this part, identified by a
463		RFC 3066 language tag.
464
465		<tp:rationale>
466		XMPP allows alternative-selection by language as well as
467		by content-type.
468		</tp:rationale>
469		</dd>
470
471		<dt>size (u)</dt>
472		<dd>The size in bytes (if needs-retrieval is true, this MAY be an
473		estimated or approximate size). SHOULD be omitted if 'content'
474		is provided.
475
476		<tp:rationale>
477		There's no point in providing the size if you're already
478		providing all the content.
479		</tp:rationale>
480		</dd>
481
482		<dt>thumbnail (b)</dt>
483		<dd>
484		<p>This part is a thumbnail. To represent an image together with
485		its thumbnail in a single message, there should be one part for
486		the full image followed by a part for the thumbnail (following
487		the “more complete versions first” requirement), with the same
488		'alternative' value. For example:</p>
489
490		<pre>
491		[ ... ,
492		{ 'alternative': 'catphoto',
493		'content-type': 'image/jpeg',
494		'size': 150000,
495		'content': [0xFF, 0xD8, ... 0xFF 0xD9],
496		},
497		{ 'alternative': 'catphoto',
498		'content-type': 'image/jpeg'
499		'size': 1024,
500		'thumbnail': True,
501		'content': [0xFF, 0xD8, ... 0xFF 0xD9],
502		},
503		...
504		]
505		</pre>
506		</dd>
507
508		<dt>needs-retrieval (b)</dt>
509		<dd>If false or omitted, the connection
510		manager already holds this part in memory. If present and true,
511		this part will be retrieved on demand (like MIME's
512		message/external-body), so clients should expect retrieval to
513		take time; if this specification is later extended to provide a
514		streaming version of GetPendingMessageContent, clients should
515		use it for parts with this flag.</dd>
516
517		<dt>truncated (b)</dt>
518		<dd>The content available via the 'content' key or
519		GetPendingMessageContent has been truncated by the server
520		or connection manager (equivalent to
521		Channel_Text_Message_Flag_Truncated in the Text interface).
522		</dd>
523
524		<dt>content (s or ay)</dt>
525		<dd>The part's content, if it is available and
526		sufficiently small to include here (implies that
527		'needs-retrieval' is false or omitted). Otherwise, omitted.
528		If the part is human-readable text or HTML, the value for this
529		key MUST be a UTF-8 string (D-Bus signature 's').
530		If the part is not text, the value MUST be a byte-array
531		(D-Bus signature 'ay'). If the part is a text-based format
532		that is not the main body of the message (e.g. an iCalendar
533		or an attached XML document), the value SHOULD be a UTF-8 string,
534		transcoding from another charset to UTF-8 if necessary, but
535		MAY be a byte-array (of unspecified character set) if
536		transcoding fails or the source charset is not known.</dd>
537
538		<!-- FIXME: "sufficiently small to include" is not currently
539		defined; we should add some API so clients can tell the
540		CM how large a message it should emit in the signal.-->
541
542		<dt>interface (s - <tp:type>DBus_Interface</tp:type>)</dt>
543		<dd>This part is specific to the given interface, which is
544		neither Text nor Messages. It SHOULD be ignored if that
545		interface is not supported. (Note that an 'interface' key
546		can also appear on the first part, where it indicates that the
547		entire message should be ignored if unsupported.)</dd>
548		</dl>
549
550		</div>
551
552
553		<div>
554		<p>Delivery reports are also represented as messages, of type
555		Channel_Text_Message_Type_Delivery_Report, with the
556		Non_Text_Content flag in the Text interface.</p>
557
558		<p>Whenever a message of type
559		Channel_Text_Message_Type_Delivery_Report is signalled for a
560		delivery error report, Channel.Type.Text.SendError SHOULD also
561		be emitted; whenever Channel.Type.Text.SendError is emitted by a
562		channel which supports this interface, a message of type
563		Channel_Text_Message_Type_Delivery_Report MUST also be emitted.</p>
564
565		<p>The corresponding message in the Messages interface MUST contain
566		"headers" for the delivery report, as specified below, in its
567		first Message_Part.</p>
568
569		<dl>
570		<dt>message-sender (u - Contact_Handle as defined above)</dt>
571		<dd>MUST be the intended recipient of the original message, if
572		available (zero or omitted if the intended recipient is
573		unavailable or is not a contact, e.g. a chatroom), even if the
574		delivery report actually came from an intermediate server.</dd>
575
576		<dt>message-type (u - Channel_Text_Message_Type as defined
577		above)</dt>
578		<dd>MUST be Channel_Text_Message_Type_Delivery_Report.</dd>
579
580		<dt>delivery-status (u - Delivery_Status)</dt>
581		<dd>The status of the message. All delivery reports MUST contain
582		this key in the first Message_Part.</dd>
583
584		<dt>delivery-token (s - <tp:type>Protocol_Message_Token</tp:type>)</dt>
585
586		<dd>
587		<p>An identifier for the message to which this delivery report
588		refers. MUST NOT be an empty string. Omitted if not
589		available.</p>
590
591		<p>Clients may match this against the token produced by the
592		SendMessage method and MessageSent signal. A status report
593		with no token could match any sent message, and a sent
594		message with an empty token could match any status report.
595		If multiple sent messages match, clients SHOULD use some
596		reasonable heuristic.</p>
597
598		<tp:rationale>
599		In an ideal world, we could unambiguously match reports
600		against messages; however, deployed protocols are not ideal,
601		and not all reports and messages can be matched.
602		</tp:rationale>
603		</dd>
604
605		<dt>delivery-error (u - Channel_Text_Send_Error)</dt>
606		<dd>
607		The reason for the failure. MUST be omitted if this was a
608		successful delivery; SHOULD be omitted if it would be
609		Channel_Text_Send_Error_Unknown.
610		</dd>
611
612		<dt>delivery-dbus-error (s - DBus_Error_Name)</dt>
613		<dd>
614		The reason for the failure, specified as a (possibly
615		implementation-specific) D-Bus error. MUST be omitted if this was
616		a successful delivery. If set, the 'delivery-error' key SHOULD be
617		set to the closest available value.
618		</dd>
619
620		<dt>delivery-error-message (s)</dt>
621		<dd>
622		Debugging information on why the message could not be delivered.
623		MUST be omitted if this was a successful delivery; MAY always be
624		omitted.
625		</dd>
626
627		<dt>delivery-echo (aa{sv} - Message_Part[])</dt>
628		<dd>
629		<p>The message content, as defined by the Messages interface.
630		Omitted if no content is available. Content MAY have been
631		truncated, message parts MAY have been removed, and message
632		parts MAY have had their content removed (i.e. the message part
633		metadata is present, but the 'content' key is not).</p>
634
635		<tp:rationale>
636		Some protocols, like XMPP, echo the failing message back to
637		the sender. This is sometimes the only way to match it
638		against the sent message, so we include it here.
639		</tp:rationale>
640
641		<p>Unlike in the Messages interface, content not visible
642		in the value for this key cannot be retrieved by another
643		means, so the connection manager SHOULD be more
644		aggressive about including (possibly truncated) message
645		content in the 'content' key.</p>
646
647		<tp:rationale>
648		The Messages interface needs to allow all content to be
649		retrieved, but in this interface, the content we provide is
650		merely a hint; so some is better than none, and it doesn't
651		seem worth providing an API as complex as Messages'
652		GetPendingMessageContent for the echoed message.
653		</tp:rationale>
654		</dd>
655
656		</dl>
657
658		<p>The second and subsequent Message_Part dictionaries, if present,
659		are a human-readable report from the IM service.</p>
660
661		<p>Clients MUST NOT attempt to send delivery reports using the
662		SendMessage method in the Messages API, and connection managers
663		MUST NOT allow this to be done. If support for sending delivery
664		reports is later added, it will be part of this interface.</p>
665
666		<p>Some example delivery reports in a Python-like syntax (in which
667		arrays are indicated by [a, b] and dictionaries by {k1: v1, k2: v2})
668		follow.</p>
	342	<p>Delivery reports are also represented as messages with the
	343	<tt>message-type</tt> header mapping to
	344	<tp:type>Channel_Text_Message_Type</tp:type> Delivery_Report.
	345	Delivery reports SHOULD contain the <tt>message-sender</tt> header,
	346	mapping to the intended recipient of the original message, if
	347	possible; other headers specific to delivery reports are defined by
	348	the <tp:type>Delivery_Report_Header_Key</tp:type> type. The second
	349	and subsequent parts, if present, are a human-readable report from
	350	the IM service.</p>
	351
	352	<p>For backwards- and forwards-compatibility, whenever a delivery
	353	error report is signalled—that is, with <tt>delivery-status</tt>
	354	mapping to <tp:type>Delivery_Status</tp:type> Temporarily_Failed or
	355	Permanently_Failed—<tp:dbus-ref
	356	namespace="org.freedesktop.Telepathy.Channel.Type.Text">SendError</tp:dbus-ref>
	357	SHOULD also be emitted; whenever <tp:dbus-ref
	358	namespace="org.freedesktop.Telepathy.Channel.Type.Text">SendError</tp:dbus-ref>
	359	is emitted, a delivery report MUST also be signalled.
	360	Delivery report messages on this interface MUST be represented in
	361	emissions of <tp:dbus-ref
	362	namespace="org.freedesktop.Telepathy.Channel.Type.Text">Received</tp:dbus-ref>
	363	as messages with the Non_Text_Content
	364	<tp:type>Channel_Text_Message_Flags</tp:type>; clients which
	365	understand this interface SHOULD ignore the SendError signal in
	366	favour of listening for delivery reports, as mentioned in the
	367	introduction.</p>
	368
	369	<p>The result of attempting to send delivery reports using
	370	<tp:member-ref>SendMessage</tp:member-ref> is currently
	371	undefined.</p>
	372
	373	<h4>Example delivery reports</h4>
669	374
670	375	<dl>
671	376	<dt>A minimal delivery report indicating permanent failure of the

681	386	'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4',
682	387	}
683	388	# no body
684		]
685		</pre></dd>
	389	]</pre></dd>
686	390
687	391	<dt>A delivery report where the failed message is echoed back to the
688	392	sender rather than being referenced by ID, and the failure reason

706	410	],
707	411
708	412	# no body
709		]
710		</pre></dd>
	413	]</pre></dd>
711	414
712	415	<dt>A maximally complex delivery report: the server reports a
713	416	bilingual human-readable failure message because the user sent

745	448	'lang': 'de',
746	449	'content', 'Ich habe keinen Kontakt mit diesem Namen',
747	450	}
748		]
749		</pre></dd>
	451	]</pre></dd>
750	452
751	453	<dt>A minimal delivery report indicating successful delivery
752	454	of the sent message whose token was

760	462	'delivery-token': 'b9a991bd-8845-4d7f-a704-215186f43bb4',
761	463	}
762	464	# no body
763		]
764		</pre></dd>
	465	]</pre></dd>
765	466
766	467	</dl>
767	468

770	471
771	472	<tp:member name="Key" type="s">
772	473	<tp:docstring>
773		A key, which SHOULD be one of the well-known keys specified, if
774		possible.
	474	A key, which SHOULD be one of the well-known keys specified by
	475	<tp:type>Message_Header_Key</tp:type>,
	476	<tp:type>Message_Body_Key</tp:type> or
	477	<tp:type>Delivery_Report_Header_Key</tp:type> if possible.
775	478	</tp:docstring>
776	479	</tp:member>
777	480
778	481	<tp:member name="Value" type="v">
779	482	<tp:docstring>
780		The value corresponding to the given key, which must be of one of
781		the types indicated.
	483	The value corresponding to the given key, which SHOULD be one of the
	484	specified types for well-known keys.
782	485	</tp:docstring>
783	486	</tp:member>
784	487	</tp:mapping>
	488
	489	<tp:simple-type type="s" name="Message_Header_Key">
	490	<tp:added version="0.19.8"/>
	491	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	492	<p>Well-known keys for the first <tp:type>Message_Part</tp:type> of a
	493	message, which contains metadata about the message as a whole, along
	494	with the corresponding value types. Some keys make sense for both
	495	incoming and outgoing messages, while others are only meaningful for
	496	one or the other.</p>
	497
	498	<dl>
	499	<dt>message-token (s)</dt>
	500	<dd>
	501	<p>An opaque, globally-unique identifier for the entire message.
	502	This MAY be treated as if it were a MIME Message-ID, e.g. for
	503	the mid: and cid: URI schemes. If omitted, there is no suitable
	504	token; the protocol-token key SHOULD be provided if the protocol
	505	identifies messages in some less unique way.</p>
	506	</dd>
	507
	508	<dt>protocol-token (s - <tp:type>Protocol_Message_Token</tp:type>)</dt>
	509	<dd>
	510	<p>An opaque token for the entire message, with whatever uniqueness
	511	guarantee is provided by the underlying protocol. As described
	512	for the Protocol_Message_Token type, this token is <em>not</em>
	513	guaranteed to be unique between contacts, or even within the
	514	scope of a Channel.</p>
	515
	516	<tp:rationale>
	517	<p>In practice, in most protocols there is no token with the
	518	uniqueness guarantees demanded for message-token; the
	519	definition of message-token was inappropriate, but must now
	520	be preserved for the benefit of clients that rely on it, at
	521	least until Telepathy breaks backwards compatibility.</p>
	522	</tp:rationale>
	523
	524	<p>The message-token and protocol-token SHOULD NOT both be present;
	525	clients requiring an identifier with the semantics of the
	526	protocol-token SHOULD look for the message-token first, falling
	527	back to the protocol-token.</p>
	528
	529	<tp:rationale>
	530	<p>This is for compatibility with CMs older than the
	531	protocol-token key.</p>
	532	</tp:rationale>
	533	</dd>
	534
	535	<dt>message-sent (x - <tp:type>Unix_Timestamp64</tp:type>)</dt>
	536	<dd>The time the message was sent (if unavailable, the time
	537	it arrived at a central server MAY be used). Omitted if no
	538	reasonable approximation is available; SHOULD always be present
	539	on outgoing messages.</dd>
	540
	541	<dt>message-received (x - <tp:type>Unix_Timestamp64</tp:type>)</dt>
	542	<dd>The time the message was received locally. SHOULD always
	543	be present.</dd>
	544
	545	<dt>message-sender (u - <tp:type>Contact_Handle</tp:type>)</dt>
	546	<dd>The contact who sent the message. If 0 or omitted, the contact
	547	who sent the message could not be determined.</dd>
	548
	549	<dt>sender-nickname (s)</dt>
	550	<dd>The nickname chosen by the sender of the message, which can be
	551	different for each message in a conversation.</dd>
	552
	553	<dt>message-type (u - <tp:type>Channel_Text_Message_Type</tp:type>)
	554	</dt>
	555	<dd>The type of message; if omitted,
	556	Channel_Text_Message_Type_Normal MUST be assumed. MAY
	557	be omitted for normal chat messages.</dd>
	558
	559	<dt>pending-message-id (u - <tp:type>Message_ID</tp:type>)</dt>
	560	<dd>The incoming message ID. This MUST NOT be present on outgoing
	561	messages. Clients SHOULD NOT store this key - it is only valid
	562	for as long as the message remains unacknowledged.</dd>
	563
	564	<dt>interface (s - <tp:type>DBus_Interface</tp:type>)</dt>
	565	<dd>This message is specific to the given interface, which is
	566	neither Text nor Messages. It SHOULD be ignored if that
	567	interface is not supported. (Note that an 'interface' key
	568	can also appear on the second and subsequent parts, where
	569	it indicates that that part (only) should be ignored if
	570	unsupported.)</dd>
	571
	572	<dt>scrollback (b)</dt>
	573	<dd>If present and true, the incoming message was part of a
	574	replay of message history (this matches the Scrollback flag in
	575	<tp:type>Channel_Text_Message_Flags</tp:type>). This flag
	576	does not make sense on outgoing messages and SHOULD NOT
	577	appear there.</dd>
	578
	579	<dt>rescued (b)</dt>
	580	<dd>If present and true, the incoming message has been seen in
	581	a previous channel during the lifetime of the Connection,
	582	but had not been acknowledged when that channel closed, causing
	583	an identical channel (in which the message now appears) to open.
	584	This matches the Rescued flag in
	585	<tp:type>Channel_Text_Message_Flags</tp:type>; it
	586	does not make sense on outgoing messages, and SHOULD NOT
	587	appear there.</dd>
	588	</dl>
	589	</tp:docstring>
	590	</tp:simple-type>
	591
	592	<tp:simple-type type="s" name="Message_Body_Key">
	593	<tp:added version="0.19.8"/>
	594	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	595	<p>Well-known keys for the second and subsequent
	596	<tp:type>Message_Part</tp:type>s of a message, which contain the
	597	message content, along with the corresponding value types.</p>
	598
	599	<dl>
	600	<dt>identifier (s —
	601	<tp:type>Protocol_Content_Identifier</tp:type>)</dt>
	602	<dd>An opaque identifier for this part.
	603	Parts of a message MAY reference other parts by treating
	604	this identifier as if it were a MIME Content-ID and using
	605	the cid: URI scheme.</dd>
	606
	607	<dt>alternative (s)</dt>
	608	<dd>
	609	<p>If present, this part of the message is an alternative for
	610	all other parts with the same value for "alternative".
	611	Clients SHOULD only display one of them (this is expected to
	612	be used for XHTML messages in a future version of this
	613	specification).</p>
	614
	615	<p>If omitted, this part is not an alternative for any other
	616	part.</p>
	617
	618	<p>Parts of a message MAY reference the group of alternatives
	619	as a whole (i.e. a reference to whichever of them is chosen)
	620	by treating this identifier as if it were the MIME Content-ID
	621	of a multipart/alternative part, and using the cid: URI
	622	scheme.</p>
	623	</dd>
	624
	625	<dt>content-type (s)</dt>
	626	<dd>
	627	<p>The MIME type of this part. See the documentation
	628	for ReceivedMessage for notes on the special status of
	629	"text/plain" parts.</p>
	630
	631	<p>Connection managers MUST NOT signal parts without a
	632	'content-type' key; if a protocol provides no way to determine
	633	the MIME type, the connection manager is responsible for
	634	guessing it, but MAY fall back to "text/plain" for text and
	635	"application/octet-stream" for non-text.</p>
	636
	637	<p>Clients MUST ignore parts without a 'content-type' key, which
	638	are reserved for future expansion.</p>
	639	</dd>
	640
	641	<dt>lang (s)</dt>
	642	<dd>The natural language of this part, identified by a
	643	RFC 3066 language tag.
	644
	645	<tp:rationale>
	646	XMPP allows alternative-selection by language as well as
	647	by content-type.
	648	</tp:rationale>
	649	</dd>
	650
	651	<dt>size (u)</dt>
	652	<dd>The size in bytes (if needs-retrieval is true, this MAY be an
	653	estimated or approximate size). SHOULD be omitted if 'content'
	654	is provided.
	655
	656	<tp:rationale>
	657	There's no point in providing the size if you're already
	658	providing all the content.
	659	</tp:rationale>
	660	</dd>
	661
	662	<dt>thumbnail (b)</dt>
	663	<dd>
	664	<p>This part is a thumbnail. To represent an image together with
	665	its thumbnail in a single message, there should be one part for
	666	the full image followed by a part for the thumbnail (following
	667	the “more complete versions first” requirement), with the same
	668	'alternative' value. For example:</p>
	669
	670	<pre>
	671	[ ... ,
	672	{ 'alternative': 'catphoto',
	673	'content-type': 'image/jpeg',
	674	'size': 150000,
	675	'content': [0xFF, 0xD8, ... 0xFF 0xD9],
	676	},
	677	{ 'alternative': 'catphoto',
	678	'content-type': 'image/jpeg'
	679	'size': 1024,
	680	'thumbnail': True,
	681	'content': [0xFF, 0xD8, ... 0xFF 0xD9],
	682	},
	683	...
	684	]</pre>
	685	</dd>
	686
	687	<dt>needs-retrieval (b)</dt>
	688	<dd>If false or omitted, the connection
	689	manager already holds this part in memory. If present and true,
	690	this part will be retrieved on demand (like MIME's
	691	message/external-body), so clients should expect retrieval to
	692	take time; if this specification is later extended to provide a
	693	streaming version of GetPendingMessageContent, clients should
	694	use it for parts with this flag.</dd>
	695
	696	<dt>truncated (b)</dt>
	697	<dd>The content available via the 'content' key or
	698	GetPendingMessageContent has been truncated by the server
	699	or connection manager (equivalent to
	700	Channel_Text_Message_Flag_Truncated in the Text interface).
	701	</dd>
	702
	703	<dt>content (s or ay)</dt>
	704	<dd>The part's content, if it is available and
	705	sufficiently small to include here (implies that
	706	'needs-retrieval' is false or omitted). Otherwise, omitted.
	707	If the part is human-readable text or HTML, the value for this
	708	key MUST be a UTF-8 string (D-Bus signature 's').
	709	If the part is not text, the value MUST be a byte-array
	710	(D-Bus signature 'ay'). If the part is a text-based format
	711	that is not the main body of the message (e.g. an iCalendar
	712	or an attached XML document), the value SHOULD be a UTF-8 string,
	713	transcoding from another charset to UTF-8 if necessary, but
	714	MAY be a byte-array (of unspecified character set) if
	715	transcoding fails or the source charset is not known.</dd>
	716
	717	<!-- FIXME: "sufficiently small to include" is not currently
	718	defined; we should add some API so clients can tell the
	719	CM how large a message it should emit in the signal.-->
	720
	721	<dt>interface (s - <tp:type>DBus_Interface</tp:type>)</dt>
	722	<dd>This part is specific to the given interface, which is
	723	neither Text nor Messages. It SHOULD be ignored if that
	724	interface is not supported. (Note that an 'interface' key
	725	can also appear on the first part, where it indicates that the
	726	entire message should be ignored if unsupported.)</dd>
	727	</dl>
	728	</tp:docstring>
	729	</tp:simple-type>
	730
	731	<tp:simple-type type="s" name="Delivery_Report_Header_Key">
	732	<tp:added version="0.19.8"/>
	733	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	734	<p>Well-known keys for the first <tp:type>Message_Part</tp:type> of a
	735	delivery report, along with the corresponding value types. Some of
	736	these are special-cases of headers defined by
	737	<tp:type>Message_Header_Key</tp:type>.</p>
	738
	739	<dl>
	740	<dt>message-sender (u - <tp:type>Contact_Handle</tp:type>, as
	741	defined by <tp:type>Message_Header_Key</tp:type>)</dt>
	742	<dd>MUST be the intended recipient of the original message, if
	743	available (zero or omitted if the intended recipient is
	744	unavailable or is not a contact, e.g. a chatroom), even if the
	745	delivery report actually came from an intermediate server.</dd>
	746
	747	<dt>message-type (u - <tp:type>Channel_Text_Message_Type</tp:type>,
	748	as defined by <tp:type>Message_Header_Key</tp:type>)</dt>
	749	<dd>MUST be Channel_Text_Message_Type_Delivery_Report.</dd>
	750
	751	<dt>delivery-status (u - <tp:type>Delivery_Status</tp:type>)</dt>
	752	<dd>The status of the message. All delivery reports MUST contain
	753	this key in the first Message_Part.</dd>
	754
	755	<dt>delivery-token (s - <tp:type>Protocol_Message_Token</tp:type>)</dt>
	756
	757	<dd>
	758	<p>An identifier for the message to which this delivery report
	759	refers. MUST NOT be an empty string. Omitted if not
	760	available.</p>
	761
	762	<p>Clients may match this against the token produced by the
	763	SendMessage method and MessageSent signal. A status report
	764	with no token could match any sent message, and a sent
	765	message with an empty token could match any status report.
	766	If multiple sent messages match, clients SHOULD use some
	767	reasonable heuristic.</p>
	768
	769	<tp:rationale>
	770	In an ideal world, we could unambiguously match reports
	771	against messages; however, deployed protocols are not ideal,
	772	and not all reports and messages can be matched.
	773	</tp:rationale>
	774	</dd>
	775
	776	<dt>delivery-error (u -
	777	<tp:type>Channel_Text_Send_Error</tp:type>)</dt>
	778	<dd>
	779	The reason for the failure. MUST be omitted if this was a
	780	successful delivery; SHOULD be omitted if it would be
	781	Channel_Text_Send_Error_Unknown.
	782	</dd>
	783
	784	<dt>delivery-dbus-error (s -
	785	<tp:type>DBus_Error_Name</tp:type>)</dt>
	786	<dd>
	787	The reason for the failure, specified as a (possibly
	788	implementation-specific) D-Bus error. MUST be omitted if this was
	789	a successful delivery. If set, the 'delivery-error' key SHOULD be
	790	set to the closest available value.
	791	</dd>
	792
	793	<dt>delivery-error-message (s)</dt>
	794	<dd>
	795	Debugging information on why the message could not be delivered.
	796	MUST be omitted if this was a successful delivery; MAY always be
	797	omitted.
	798	</dd>
	799
	800	<dt>delivery-echo (aa{sv} - <tp:type>Message_Part[]</tp:type>)</dt>
	801	<dd>
	802	<p>The message content, as defined by the Messages interface.
	803	Omitted if no content is available. Content MAY have been
	804	truncated, message parts MAY have been removed, and message
	805	parts MAY have had their content removed (i.e. the message part
	806	metadata is present, but the 'content' key is not).</p>
	807
	808	<tp:rationale>
	809	Some protocols, like XMPP, echo the failing message back to
	810	the sender. This is sometimes the only way to match it
	811	against the sent message, so we include it here.
	812	</tp:rationale>
	813
	814	<p>Unlike in the Messages interface, content not visible
	815	in the value for this key cannot be retrieved by another
	816	means, so the connection manager SHOULD be more
	817	aggressive about including (possibly truncated) message
	818	content in the 'content' key.</p>
	819
	820	<tp:rationale>
	821	The Messages interface needs to allow all content to be
	822	retrieved, but in this interface, the content we provide is
	823	merely a hint; so some is better than none, and it doesn't
	824	seem worth providing an API as complex as Messages'
	825	GetPendingMessageContent for the echoed message.
	826	</tp:rationale>
	827	</dd>
	828
	829	</dl>
	830	</tp:docstring>
	831	</tp:simple-type>
785	832
786	833	<tp:simple-type type="u" name="Message_Part_Index"
787	834	array-name="Message_Part_Index_List">

817	864	</tp:member>
818	865	</tp:mapping>
819	866
820		<tp:simple-type type="s" name="Protocol_Message_Token">
	867	<tp:simple-type type="s" name="Protocol_Message_Token"
	868	array-name="Protocol_Message_Token_List">
821	869	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
822	870	<p>An opaque token used to identify messages in the underlying.
823	871	protocol. As a special case, the empty string indicates that there

838	886	reports to messages, such as matching on message content or
839	887	timestamp (if available), or assuming that the delivery report
840	888	refers to the most recent message with that ID.</p>
	889	</tp:docstring>
	890	</tp:simple-type>
	891
	892	<tp:simple-type name="Protocol_Content_Identifier" type="s">
	893	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	894	<p>A protocol-specific identifier for a blob of content, as used for
	895	the <tt>identifier</tt> key in a <tp:type>Message_Part</tp:type>. The
	896	same identifier MAY be re-used if the same content, byte-for-byte,
	897	appears as a part of several messages.</p>
	898
	899	<tp:rationale>
	900	<p>On XMPP, these identifiers might be Content-IDs for custom
	901	smileys implemented using <a
	902	href="http://xmpp.org/extensions/xep-0231.html">XEP-0232 Bits of
	903	Binary</a>; the same smiley might well appear in multiple
	904	messages.</p>
	905	</tp:rationale>
841	906	</tp:docstring>
842	907	</tp:simple-type>
843	908

932	997	<p>Signals that a message has been submitted for sending. This
933	998	MUST be emitted exactly once per emission of the <tp:dbus-ref
934	999	namespace="org.freedesktop.Telepathy.Channel.Type.Text">Sent</tp:dbus-ref>
935		signal on the Text interface. This SHOULD be emitted as soon as
936		the CM determines it's theoretically possible to send the message
937		(e.g. the parameters are supported and correct).</p>
	1000	signal on the Text interface, for backwards-compatibility; clients
	1001	SHOULD ignore the latter if this interface is present, as mentioned
	1002	in the introduction.</p>
	1003
	1004	<p>This SHOULD be emitted as soon as the CM determines it's
	1005	theoretically possible to send the message (e.g. the parameters are
	1006	supported and correct).</p>
938	1007
939	1008	<tp:rationale>
940	1009	<p>This signal allows a process that is not the caller of
941		SendMessage to log sent messages. The double signal-emission
942		provides compatibility with older clients. Clients supporting
943		Messages should listen for Messages.MessageSent only (if the
944		channel has the Messages interface) or Text.Sent only
945		(otherwise).</p>
	1010	SendMessage to log sent messages.</p>
946	1011	</tp:rationale>
947	1012	</tp:docstring>
948	1013
949	1014	<arg type="aa{sv}" tp:type="Message_Part[]" name="Content">
950	1015	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
951	1016	<p>The message content (see <tp:type>Message_Part</tp:type> for full
952		details). If the message that was passed to SendMessage has a
953		formatted text part that the connection manager recognises, but no
954		text/plain alternative, the CM MUST use the formatted text part to
955		generate a text/plain alternative which is also included in this
956		signal argument.</p>
	1017	details). If the message that was passed to
	1018	<tp:member-ref>SendMessage</tp:member-ref> has a formatted text
	1019	part that the connection manager recognises, but no
	1020	<tt>text/plain</tt> alternative, the CM MUST use the formatted text
	1021	part to generate a <tt>text/plain</tt> alternative which is also
	1022	included in this signal argument.</p>
957	1023
958	1024	<p>If the connection manager can predict that the message will be
959	1025	altered during transmission, this argument SHOULD reflect what

1077	1143	messages queue. This MUST be emitted exactly once per emission of the
1078	1144	<tp:dbus-ref
1079	1145	namespace="org.freedesktop.Telepathy.Channel.Type.Text">Received</tp:dbus-ref>
1080		signal on the Text interface.
1081
1082		<tp:rationale>
1083		The double signal-emission provides compatibility with older
1084		clients. Clients supporting Messages should listen for
1085		Messages.MessageReceived only (if the channel has the Messages
1086		interface) or Text.Received only (otherwise).
1087		</tp:rationale>
	1146	signal on the Text interface, for backwards-compatibility; clients
	1147	SHOULD ignore the latter in favour of this signal if this interface is
	1148	present, as mentioned in the introduction.
1088	1149	</tp:docstring>
1089	1150
1090	1151	<arg type="aa{sv}" tp:type="Message_Part[]" name="Message">

1104	1165	should still be signalled as either Temporarily_Failed
1105	1166	or Permanently_Failed). If additional detail is required (e.g.
1106	1167	distinguishing between the various types of permanent failure) this
1107		will be done using additional keys in the Message_Part.</p>
	1168	will be done using additional
	1169	<tp:type>Delivery_Report_Header_Key</tp:type>s.</p>
1108	1170	</tp:docstring>
1109	1171
1110	1172	<tp:enumvalue suffix="Unknown" value="0">

-3

spec/Channel_Type_Text.xml less more

324	324
325	325	<tp:enumvalue suffix="Delivery_Report" value="4">
326	326	<tp:docstring>
327		This message type MUST NOT appear unless the channel supports the
328		DeliveryReporting interface. The message MUST be as defined by
329		the DeliveryReporting interface.
	327	A delivery report. This message type MUST NOT appear unless the
	328	channel supports the <tp:dbus-ref
	329	namespace="org.freedesktop.Telepathy.Channel.Interface">Messages</tp:dbus-ref>
	330	interface; see <tp:type>Message_Part</tp:type> for the format that
	331	delivery reports must take.
330	332	</tp:docstring>
331	333	</tp:enumvalue>
332	334	</tp:enum>

-0

spec/Connection_Interface_Capabilities.xml less more

19	19	</tp:license>
20	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.Capabilities">
21	21	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
	22	<tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities"/>
22	23
23	24	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
24	25	<p>An interface for connections where it is possible to know what channel

54	55	open chatroom lists or chatrooms). However, this was never very
55	56	well-defined or consistent, and as far as we know it was never
56	57	implemented correctly. This usage is now deprecated.</tp:changed>
	58
	59	<tp:deprecated version="0.19.8">Client implementations SHOULD use <tp:dbus-ref
	60	namespace="org.freedesktop.Telepathy.Connection.Interface">ContactCapabilities</tp:dbus-ref>
	61	instead.</tp:deprecated>
	62	<tp:changed version="0.19.8">Connection managers implementing
	63	Capabilities MUST implement ContactCapabilities too.</tp:changed>
57	64
58	65	<tp:flags name="Connection_Capability_Flags"
59	66	value-prefix="Connection_Capability_Flag" type="u">

+28

-3

spec/Connection_Interface_Cellular.xml less more

20	20	02110-1301, USA.</p>
21	21	</tp:license>
22	22
23		<interface name="org.freedesktop.Telepathy.Connection.Interface.Cellular.DRAFT"
24		tp:causes-havoc="experimental">
25		<tp:added version="0.19.6">(draft version, not API-stable)</tp:added>
	23	<interface name="org.freedesktop.Telepathy.Connection.Interface.Cellular">
	24	<tp:added version="0.19.8">(as stable API)</tp:added>
26	25
27	26	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
28	27	<p>This interface is for various cellular things (GSM and/or CDMA) that

104	103	</arg>
105	104	</signal>
106	105
	106	<property name="MessageReducedCharacterSet"
	107	tp:name-for-bindings="Message_Reduced_Character_Set"
	108	type="b" access="readwrite">
	109	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	110	<p>Determines whether SMSes containing characters that do not fit into
	111	a 7‐bit GSM character set should be sent as UCS‐2, or lossily
	112	recoded. If <code>False</code> (which SHOULD be the default),
	113	messages will be sent with no loss of fidelity (at the potential
	114	financial cost of using twice as many SMSes); if <code>True</code>,
	115	the message will be recoded in an implementation‐specific way to fit
	116	into a country‐specific GSM reduced character set.</p>
	117
	118	<p>Connections with this interface SHOULD provide this property as a
	119	parameter for <tp:dbus-ref namespace="org.freedesktop.Telepathy"
	120	>ConnectionManager.RequestConnection</tp:dbus-ref>, with the
	121	<code>DBus_Property</code> flag.</p>
	122
	123	<p>For connections managed by the <tp:dbus-ref
	124	namespace="org.freedesktop.Telepathy">AccountManager</tp:dbus-ref>,
	125	this property SHOULD be set via the Account Manager, by calling
	126	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	127	>Account.UpdateParameters</tp:dbus-ref>; the AccountManager
	128	provides change‐notification, as long as all other clients cooperate
	129	by using it instead of setting this property directly.</p>
	130	</tp:docstring>
	131	</property>
107	132	</interface>
108	133	</node>
109	134	<!-- vim:set sw=2 sts=2 et ft=xml: -->

+53

-18

spec/Connection_Interface_Contact_Groups.xml less more

20	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactGroups.DRAFT"
21	21	tp:causes-havoc="experimental">
22	22	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
23		<tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.ContactList.DRAFT"/>
	23	<tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.ContactList.DRAFT2"/>
24	24	<tp:added version="0.19.6">(draft 1)</tp:added>
25	25
26	26	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">

57	57	<p>The names of groups of which a contact is a member.</p>
58	58
59	59	<p>Change notification is via
60		<tp:member-ref>GroupsChanged</tp:member-ref>,
	60	<tp:member-ref>GroupsChanged</tp:member-ref>; clients can also
	61	get extra context for group membership changes by receiving
61	62	<tp:member-ref>GroupRenamed</tp:member-ref> and
62	63	<tp:member-ref>GroupsRemoved</tp:member-ref>.</p>
63	64	</tp:docstring>

72	73	empty.</p>
73	74
74	75	<p>Change notification is via
75		<tp:member-ref>GroupsCreated</tp:member-ref>,
76		<tp:member-ref>GroupRenamed</tp:member-ref> and
77		<tp:member-ref>GroupsRemoved</tp:member-ref>.</p>
	76	<tp:member-ref>GroupsCreated</tp:member-ref> and
	77	<tp:member-ref>GroupsRemoved</tp:member-ref>; clients can also
	78	distinguish between a create/remove pair and a renamed group by
	79	receiving <tp:member-ref>GroupRenamed</tp:member-ref>.</p>
	80
	81	<p>This property's value is not meaningful until the initial contact
	82	list has been received, in protocols where this is applicable.
	83	Clients MAY wait for this property to be meaningful by calling
	84	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.ContactList.DRAFT2"
	85	>RequestContactList</tp:dbus-ref>.</p>
78	86	</tp:docstring>
79	87	</property>
80	88

92	100
93	101	<signal name="GroupRenamed" tp:name-for-bindings="Group_Renamed">
94	102	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
95		<p>Emitted when a group is renamed. If the group was not empty,
96		immediately after this signal is emitted,
97		<tp:member-ref>GroupsChanged</tp:member-ref> MUST signal
	103	<p>Emitted when a group is renamed.</p>
	104
	105	<p>Immediately after this signal is emitted,
	106	<tp:member-ref>GroupsCreated</tp:member-ref> MUST signal the
	107	creation of a group with the new name, and
	108	<tp:member-ref>GroupsRemoved</tp:member-ref> MUST signal the
	109	removal of a group with the old name.</p>
	110
	111	<tp:rationale>
	112	<p>Emitting these extra signals, in this order, means that clients
	113	that are interested in the set of groups that exist (but treat a
	114	rename and a create/remove pair identically) to ignore the
	115	GroupRenamed signal entirely.</p>
	116	</tp:rationale>
	117
	118	<p>If the group was not empty, immediately after those signals are
	119	emitted, <tp:member-ref>GroupsChanged</tp:member-ref> MUST signal
98	120	that the members of that group were removed from the old name
99	121	and added to the new name.</p>
100	122
101		<p>On connection managers where groups behave like tags, this signal
102		will probably only be emitted when
103		<tp:member-ref>RenameGroup</tp:member-ref> is called, and renaming a
104		group from another client MAY be signalled as a
105		<tp:member-ref>GroupsChanged</tp:member-ref> signal instead.</p>
	123	<p>On connection managers where groups behave like tags, renaming a
	124	group MAY be signalled as a set of
	125	<tp:member-ref>GroupsCreated</tp:member-ref>,
	126	<tp:member-ref>GroupsRemoved</tp:member-ref> and
	127	<tp:member-ref>GroupsChanged</tp:member-ref> signals, instead of
	128	emitting this signal.</p>
106	129
107	130	<tp:rationale>
108	131	<p>On protocols like XMPP, another resource "renaming a group" is

120	143	</signal>
121	144
122	145	<signal name="GroupsRemoved" tp:name-for-bindings="Groups_Removed">
123		<tp:docstring>
124		Emitted when one or more groups are removed. If they had members at
125		the time that they were removed, then immediately after this signal is
126		emitted, <tp:member-ref>GroupsChanged</tp:member-ref> MUST signal
127		that their members were removed.
	146	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	147	<p>Emitted when one or more groups are removed. If they had members at
	148	the time that they were removed, then immediately after this signal
	149	is emitted, <tp:member-ref>GroupsChanged</tp:member-ref> MUST signal
	150	that their members were removed.</p>
	151
	152	<tp:rationale>
	153	<p>Emitting the signals in this order allows for two modes of
	154	operation. A client interested only in a contact's set of groups
	155	can ignore <tp:member-ref>GroupsRemoved</tp:member-ref> and rely
	156	on the <tp:member-ref>GroupsChanged</tp:member-ref> signal that
	157	will follow; a more elaborate client wishing to distinguish between
	158	all of a group's members being removed, and the group itself
	159	being removed, can additionally watch for
	160	<tp:member-ref>GroupsRemoved</tp:member-ref> and use it to
	161	disambiguate.</p>
	162	</tp:rationale>
128	163	</tp:docstring>
129	164
130	165	<arg name="Names" type="as">

+43

-15

spec/Connection_Interface_Contact_List.xml less more

17	17	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
18	18	USA.</p>
19	19	</tp:license>
20		<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactList.DRAFT"
	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactList.DRAFT2"
21	21	tp:causes-havoc="experimental">
22	22	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
23		<tp:added version="0.19.6">(draft 1)</tp:added>
	23	<tp:added version="0.19.8">(draft 2)</tp:added>
24	24
25	25	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
26	26	<p>An interface for connections that have any concept of a list of

45	45	</tp:rationale>
46	46
47	47	<p>The list of contacts is not exposed as a D-Bus property; it can be
48		fetched using <tp:member-ref>GetContactListAttributes</tp:member-ref>.
	48	fetched using <tp:member-ref>RequestContactList</tp:member-ref>.
49	49	</p>
50	50
51	51	<tp:rationale>
52	52	<p>In some protocols, such as XMPP, the contact list may not be
53	53	available immediately. The
54		<tp:member-ref>GetContactListAttributes</tp:member-ref> method
	54	<tp:member-ref>RequestContactList</tp:member-ref> method
55	55	will wait until the contact list is available before returning.
56	56	Using a method also allows extra attributes to be retrieved at
57	57	the same time.</p>
58	58	</tp:rationale>
59	59	</tp:docstring>
60	60
61		<method name="GetContactListAttributes"
62		tp:name-for-bindings="Get_Contact_List_Attributes">
	61	<method name="RequestContactList"
	62	tp:name-for-bindings="Request_Contact_List">
	63	<tp:changed version="0.19.8">(in draft: renamed from
	64	GetContactListAttributes)</tp:changed>
63	65	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
64	66	<p>Return some contact attributes for a list of contacts somehow
65	67	associated with the user.</p>

132	134	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
133	135	<p>A list of strings indicating which D-Bus interfaces the calling
134	136	process is interested in. Equivalent to the corresponding argument
135		to <tp:dbus-ref
	137	to <tp:dbus-ref
136	138	namespace="org.freedesktop.Telepathy.Connection.Interface.Contacts"
137		>GetContactAttributes</tp:dbus-ref>.</p>
	139	>GetContactAttributes</tp:dbus-ref>,
	140	except that if this list does not contain the ContactList
	141	interface itself, it is treated as though that interface was also
	142	requested.</p>
138	143	</tp:docstring>
139	144	</arg>
140	145
141	146	<arg direction="in" name="Hold" type="b">
142	147	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
143	148	<p>Whether to hold the handles on behalf of the calling process.
144		Equivalent to the corresponding argument to <tp:dbus-ref
	149	Equivalent to the corresponding argument to <tp:dbus-ref
145	150	namespace="org.freedesktop.Telepathy.Connection.Interface.Contacts"
146	151	>GetContactAttributes</tp:dbus-ref>.</p>
147	152

157	162	tp:type="Contact_Attributes_Map">
158	163	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
159	164	<p>A dictionary mapping the contact handles to contact attributes,
160		equivalent to the result of <tp:dbus-ref
	165	equivalent to the result of <tp:dbus-ref
161	166	namespace="org.freedesktop.Telepathy.Connection.Interface.Contacts"
162	167	>GetContactAttributes</tp:dbus-ref>.</p>
163	168

222	227	indefinitely. On other protocols, only contacts who have been
223	228	asked during the current session will ever have Ask status.</p>
224	229	</tp:rationale>
	230
	231	<p>This attribute SHOULD be omitted from the
	232	<tp:type>Contact_Attributes_Map</tp:type> returned by
	233	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Contacts"
	234	>GetContactAttributes</tp:dbus-ref> until the initial contact
	235	list has been received, in protocols where this is applicable.
	236	Clients MAY wait for this by calling
	237	<tp:member-ref>RequestContactList</tp:member-ref>.</p>
225	238	</tp:docstring>
226	239	</tp:contact-attribute>
227	240

255	268	indefinitely. On other protocols, only contacts who have asked
256	269	during the current session will ever have Ask status.</p>
257	270	</tp:rationale>
	271
	272	<p>This attribute SHOULD be omitted from the
	273	<tp:type>Contact_Attributes_Map</tp:type> returned by
	274	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Contacts"
	275	>GetContactAttributes</tp:dbus-ref> until the initial contact
	276	list has been received, in protocols where this is applicable.
	277	Clients MAY wait for this by calling
	278	<tp:member-ref>RequestContactList</tp:member-ref>.</p>
258	279	</tp:docstring>
259	280	</tp:contact-attribute>
260	281

271	292	</tp:rationale>
272	293
273	294	<p>Otherwise, this SHOULD be omitted.</p>
	295
	296	<p>This attribute SHOULD be omitted from the
	297	<tp:type>Contact_Attributes_Map</tp:type> returned by
	298	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Contacts"
	299	>GetContactAttributes</tp:dbus-ref> until the initial contact
	300	list has been received. Clients MAY wait for this by calling
	301	<tp:member-ref>RequestContactList</tp:member-ref>.</p>
274	302	</tp:docstring>
275	303	</tp:contact-attribute>
276	304

471	499	<p>Emitted when the contact list becomes available, when contacts'
472	500	basic stored properties change, when new contacts are added to the
473	501	list that would be returned by
474		<tp:member-ref>GetContactListAttributes</tp:member-ref>,
475		or when contact are removed from that list.</p>
	502	<tp:member-ref>RequestContactList</tp:member-ref>,
	503	or when contacts are removed from that list.</p>
476	504
477	505	<tp:rationale>
478	506	<p>This provides change notification for that list, and for

493	521	<tp:docstring>
494	522	The contacts that have been removed from the list that would be
495	523	returned by
496		<tp:member-ref>GetContactListAttributes</tp:member-ref>.
	524	<tp:member-ref>RequestContactList</tp:member-ref>.
497	525	This also implies that they have subscribe = No and publish = No;
498	526	contacts MUST NOT be listed both here and in Changes.
499	527	</tp:docstring>

537	565	identify the contact in future, and store it using <tp:dbus-ref
538	566	namespace="org.freedesktop.Telepathy.Connection.Interface.Aliasing"
539	567	>SetAliases</tp:dbus-ref>.
540
	568
541	569	The user MAY be
542	570	prompted using the contact's current self-assigned nickname, or
543	571	something derived from the contact's (presumably self-assigned)

716	744	<p>If possible, this method SHOULD set the contacts' subscribe and
717	745	publish attributes to No, remove any stored aliases for those
718	746	contacts, and remove the contacts from the result of
719		<tp:member-ref>GetContactListAttributes</tp:member-ref>.</p>
	747	<tp:member-ref>RequestContactList</tp:member-ref>.</p>
720	748
721	749	<p>This method SHOULD succeed even if it was not possible to carry out
722	750	the request entirely or for all contacts (for instance, if there is an

+10

-0

spec/Connection_Interface_Requests.xml less more

549	549	available to old or minimal clients SHOULD have a channel class
550	550	with the minimum number of Fixed_Properties, and MAY additionally
551	551	have channel classes with extra Fixed_Properties.</p>
	552
	553	<p>Interface designers SHOULD avoid introducing fixed properties
	554	whose types are not serializable in a <code>.manager</code>
	555	file.</p>
	556
	557	<tp:rationale>
	558	<p>Connection managers with a fixed property that is not
	559	serializable cannot have a complete <code>.manager</code>
	560	file.</p>
	561	</tp:rationale>
552	562	</tp:docstring>
553	563	</tp:member>
554	564

+67

-10

spec/Connection_Manager.xml less more

79	79	<li>sip - Session Initiation Protocol (SIP), with or without
80	80	SIMPLE support</li>
81	81	<li>skype - Skype</li>
82		<li>tel - telephony (the PSTN, including GSM, CDMA and fixed-line
83		telephony)</li>
	82	<li>tel - telephony (the
	83	<abbr title="Public Switched Telephone Network">PSTN</abbr>,
	84	including GSM, CDMA and fixed-line telephony)</li>
84	85	<li>trepia - Trepia</li>
85	86	<li>yahoo - YMSG (Yahoo! Messenger)</li>
86	87	<li>yahoojp - Japanese version of YMSG</li>

185	186	</tp:possible-errors>
186	187	</method>
187	188
	189	<tp:mapping name="Protocol_Properties_Map">
	190	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	191	<p>A map from protocol identifiers supported by a connection
	192	manager to the immutable properties of the corresponding
	193	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	194	>Protocol.DRAFT</tp:dbus-ref> objects.</p>
	195	</tp:docstring>
	196
	197	<tp:member name="Protocol" type="s" tp:type="Protocol">
	198	<tp:docstring>A protocol name</tp:docstring>
	199	</tp:member>
	200
	201	<tp:member name="Properties" type="a{sv}"
	202	tp:type="Qualified_Property_Value_Map">
	203	<tp:docstring>The immutable properties of the corresponding
	204	Protocol object</tp:docstring>
	205	</tp:member>
	206	</tp:mapping>
	207
	208	<property name="Protocols" tp:name-for-bindings="Protocols"
	209	access="read" type="a{sa{sv}}" tp:type="Protocol_Properties_Map">
	210	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	211	<p>A map from protocol identifiers supported by this connection
	212	manager to the immutable properties of the corresponding
	213	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	214	>Protocol.DRAFT</tp:dbus-ref> objects.</p>
	215
	216	<tp:rationale>
	217	<p>Providing the immutable properties here means that
	218	when the API of Protocol objects has been finalized,
	219	most clients will only need one D-Bus round trip to interrogate
	220	the ConnectionManager about all its protocols.</p>
	221	</tp:rationale>
	222
	223	<p>If this map is empty or missing, clients SHOULD fall back to
	224	calling <tp:member-ref>ListProtocols</tp:member-ref> and
	225	<tp:member-ref>GetParameters</tp:member-ref>.</p>
	226	</tp:docstring>
	227	</property>
	228
188	229	<method name="ListProtocols" tp:name-for-bindings="List_Protocols">
189	230	<arg direction="out" type="as" tp:type="Protocol[]" name="Protocols">
190	231	<tp:docstring>
191		A array of string protocol identifiers supported by this manager
	232	The keys of the <tp:member-ref>Protocols</tp:member-ref> map.
192	233	</tp:docstring>
193	234	</arg>
194	235	<tp:docstring>

368	409	<p>To be compatible with older connection managers, if retrieving
369	410	this property fails, clients SHOULD assume that its value is
370	411	an empty list.</p>
	412
	413	<p>Connection managers with a non-empty list of Interfaces MUST
	414	represent them in the <code>.manager</code> file, if they have one,
	415	as an <code>Interfaces</code> key in the
	416	group headed <code>[ConnectionManager]</code>, whose value is a list
	417	of strings each followed by a semicolon.</p>
371	418	</tp:docstring>
372	419	<tp:added version="0.17.8"/>
373	420	</property>
374
375		<!-- FIXME: One thing we could perhaps use Interfaces for would be a
376		ConnectionManager.Interface.Capabilities that can give hints regarding
377		the capabilities (in the sense of
378		Connection.Interface.Requests.AvailableChannelClasses and/or
379		Connection.GetInterfaces()) that a Connection from this CM is likely
380		to have -->
381	421
382	422	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
383	423	<p>A D-Bus service which allows connections to be created. The manager

434	474	whose list of protocols can change at any time (for instance, via
435	475	a plugin architecture) should not install a <code>.manager</code>
436	476	file.</p>
	477
	478	<p>The <code>.manager</code> file SHOULD have a group headed
	479	<code>[ConnectionManager]</code>, containing a key
	480	<code>Interfaces</code> representing
	481	<tp:member-ref>Interfaces</tp:member-ref> as a sequence of strings
	482	each followed by a semicolon (the "localestrings" type from the Desktop
	483	Entry Specification).</p>
	484
	485	<p>The <code>[ConnectionManager]</code> group SHOULD NOT contain keys
	486	<code>ObjectPath</code> or <code>BusName</code>. If it does, they MUST
	487	be ignored.</p>
	488
	489	<tp:rationale>
	490	<p>The object path and bus name are derivable from the connection
	491	manager's name, which is part of the filename, so these keys are
	492	redundant. They were required in very old versions of Telepathy.</p>
	493	</tp:rationale>
437	494
438	495	<p>For each protocol name <em>proto</em> that would be returned by
439	496	ListProtocols, the .manager file contains a group

-0

spec/Makefile.am less more

0	0	EXTRA_DIST = \
1	1	Account_Interface_Avatar.xml \
	2	Account_Interface_Storage.xml \
2	3	Account_Manager.xml \
3	4	Account.xml \
4	5	all.xml \

78	79	Media_Session_Handler.xml \
79	80	Media_Stream_Handler.xml \
80	81	Properties_Interface.xml \
	82	Protocol.xml \
	83	Protocol_Interface_Avatars.xml \
	84	Protocol_Interface_Presence.xml \
81	85	template.xml

-0

spec/Makefile.in less more

223	223	top_srcdir = @top_srcdir@
224	224	EXTRA_DIST = \
225	225	Account_Interface_Avatar.xml \
	226	Account_Interface_Storage.xml \
226	227	Account_Manager.xml \
227	228	Account.xml \
228	229	all.xml \

302	303	Media_Session_Handler.xml \
303	304	Media_Stream_Handler.xml \
304	305	Properties_Interface.xml \
	306	Protocol.xml \
	307	Protocol_Interface_Avatars.xml \
	308	Protocol_Interface_Presence.xml \
305	309	template.xml
306	310
307	311	all: all-am

+370

-0

spec/Protocol.xml less more

	0	<?xml version="1.0" ?>
	1	<node name="/Protocol"
	2	xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
	3
	4	<tp:copyright>Copyright © 2009-2010 Collabora Ltd.</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
	19	02110-1301, USA.</p>
	20	</tp:license>
	21
	22	<interface name="org.freedesktop.Telepathy.Protocol.DRAFT"
	23	tp:causes-havoc="experimental">
	24	<tp:added version="0.19.8">(draft 1)</tp:added>
	25
	26	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	27	<p>An object representing a protocol for which this <tp:dbus-ref
	28	namespace="org.freedesktop.Telepathy">ConnectionManager</tp:dbus-ref>
	29	can create <tp:dbus-ref
	30	namespace="org.freedesktop.Telepathy">Connection</tp:dbus-ref>s.</p>
	31
	32	<p>Each Protocol object has the same well-known bus name as its parent
	33	ConnectionManager. Its object path is formed by taking the
	34	ConnectionManager's object path and appending '/', followed by the
	35	<tp:type>Protocol</tp:type> name with any hyphen/minus '-' converted
	36	to underscores '_'.</p>
	37
	38	<tp:rationale>
	39	<p>This is the same as the representation of protocol names
	40	in Account object paths, and in Connection object paths and bus
	41	names. For instance, telepathy-gabble and telepathy-salut would
	42	implement objects at
	43	<code>/org/freedesktop/Telepathy/ConnectionManager/gabble/jabber</code>
	44	and
	45	<code>/org/freedesktop/Telepathy/ConnectionManager/salut/local_xmpp</code>,
	46	respectively.</p>
	47	</tp:rationale>
	48	</tp:docstring>
	49
	50	<property name="Interfaces" tp:name-for-bindings="Interfaces"
	51	access="read" type="as" tp:type="DBus_Interface[]">
	52	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	53	<p>A list of interfaces supported by this Protocol object.</p>
	54
	55	<p>This property is immutable, and should not be confused with
	56	<tp:member-ref>ConnectionInterfaces</tp:member-ref>,
	57	which refers to the interfaces of <em>connections</em> to this
	58	protocol.</p>
	59
	60	<p>Connection managers with a <code>.manager</code> file
	61	(as described as part of the
	62	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	63	>ConnectionManager</tp:dbus-ref> interface) MUST cache this
	64	property in the protocol's section of the <code>.manager</code>
	65	file, using the key <code>Interfaces</code>. The corresponding value
	66	is a list of D-Bus interface names, each followed by a semicolon.</p>
	67	</tp:docstring>
	68	</property>
	69
	70	<property name="Parameters" tp:name-for-bindings="Parameters"
	71	access="read" type="a(susv)" tp:type="Param_Spec[]">
	72	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	73	<p>The parameters which must or may be provided to the
	74	<tp:dbus-ref namespace="org.freedesktop.Telepathy.ConnectionManager"
	75	>RequestConnection</tp:dbus-ref> method when connecting to the
	76	given protocol. This property is immutable.</p>
	77
	78	<p>Connection managers with a <code>.manager</code> file
	79	(as described as part of the
	80	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	81	>ConnectionManager</tp:dbus-ref> interface) MUST cache this
	82	property in the protocol's section of the <code>.manager</code>
	83	file via keys of the form <code>param-<em>p</em></code> and
	84	<code>default-<em>p</em></code>, as documented in the
	85	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	86	>ConnectionManager</tp:dbus-ref> interface.</p>
	87	</tp:docstring>
	88	</property>
	89
	90	<property name="ConnectionInterfaces"
	91	tp:name-for-bindings="Connection_Interfaces"
	92	access="read" type="as" tp:type="DBus_Interface[]">
	93	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	94	<p>A list of interface names which might be in the
	95	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection"
	96	>Interfaces</tp:dbus-ref> property of a
	97	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	98	>Connection</tp:dbus-ref> to this protocol. Whether a Connection
	99	will have all, some or none of these interfaces depends on server
	100	capabilities.</p>
	101
	102	<p>This property is immutable, and should not be confused with
	103	<tp:member-ref>Interfaces</tp:member-ref>.</p>
	104
	105	<p>Connection managers with a <code>.manager</code> file
	106	MUST cache this property in the protocol's section of the
	107	<code>.manager</code> file, using the key
	108	<code>ConnectionInterfaces</code>. The corresponding value
	109	is a list of D-Bus interface names, each followed by a semicolon.</p>
	110	</tp:docstring>
	111	</property>
	112
	113	<property name="RequestableChannelClasses"
	114	tp:name-for-bindings="Requestable_Channel_Classes"
	115	access="read" type="a(a{sv}as)" tp:type="Requestable_Channel_Class[]">
	116	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	117	<p>A list of channel classes which might be requestable from a
	118	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	119	>Connection</tp:dbus-ref> to this protocol (i.e. they will,
	120	or might, appear in the Connection's <tp:dbus-ref
	121	namespace="org.freedesktop.Telepathy.Connection.Interface.Requests"
	122	>RequestableChannelClasses</tp:dbus-ref> property).</p>
	123
	124	<p>Whether a Connection will have all, some or none of these
	125	requestable channel classes depends on server capabilities;
	126	similarly, individual contacts are not guaranteed to support
	127	all of these channel classes.</p>
	128
	129	<p>This property is immutable.</p>
	130
	131	<p>Connection managers with a <code>.manager</code> file
	132	MUST cache this property in the protocol's section of the
	133	<code>.manager</code> file, using the key
	134	<code>RequestableChannelClasses</code>. The corresponding value
	135	is a list of opaque strings, each followed by a semicolon; each
	136	of those strings is the name of a group in the <code>.manager</code>
	137	file which represents a channel class.</p>
	138
	139	<p>Each group representing a channel class has a key
	140	<code>allowed</code> which is a list of D-Bus property names
	141	representing allowed parameters. Any other keys that do not contain
	142	a space MUST be ignored. Any key containing a space represents
	143	a fixed property; the key has the form
	144	"<code><em>propertyname</em> <em>type</em></code>", and the value
	145	is encoded in the same way as for the <code>default-<em>p</em></code>
	146	keys described in the <tp:dbus-ref
	147	namespace="org.freedesktop.Telepathy"
	148	>ConnectionManager</tp:dbus-ref> documentation.</p>
	149
	150	<p>Connection managers that have channel classes whose fixed
	151	properties are not representable in this form SHOULD NOT have
	152	<code>.manager</code> files.</p>
	153
	154	<p>For instance, this <code>.manager</code> file could represent
	155	a simple Text-only connection manager:</p>
	156
	157	<pre>[Protocol jabber]
	158	param-account=s required
	159	param-password=s required
	160	RequestableChannelClasses=text
	161
	162	[text]
	163	org.freedesktop.Telepathy.Channel.ChannelType s=org.freedesktop.Telepathy.Channel.Type.Text
	164	org.freedesktop.Telepathy.Channel.TargetHandleType u=1
	165	allowed=org.freedesktop.Telepathy.Channel.TargetHandle;org.freedesktop.Telepathy.Channel.TargetID;
	166	</pre>
	167	</tp:docstring>
	168	</property>
	169
	170	<property name="VCardField" tp:name-for-bindings="VCard_Field"
	171	access="read" type="s">
	172	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	173	<p>The name of the most common vCard field used for this protocol's
	174	contact identifiers, normalized to lower case, or the empty string
	175	if there is no such field.</p>
	176
	177	<p>For example, this would be <code>x-jabber</code> for
	178	Jabber/XMPP (including Google Talk), or <code>tel</code> for
	179	the <abbr title="Public Switched Telephone Network">PSTN</abbr>.</p>
	180
	181	<tp:rationale>
	182	<p>This is taken from Mission Control profiles as used on Maemo 5.
	183	One valid use of this field is to answer the question: given a
	184	contact's vCard containing an X-JABBER field, how can you
	185	communicate with the contact? By iterating through protocols
	186	looking for an x-jabber VCardField, one can build up a list of
	187	protocols that handle x-jabber, then offer the user a list of
	188	accounts for those protocols and/or the option to create a new
	189	account for one of those protocols.</p>
	190
	191	<p>It is not necessarily valid to interpret contacts' identifiers
	192	as values of this vCard field. For instance, telepathy-sofiasip
	193	supports contacts whose identifiers are of the form
	194	sip:jenny@example.com or tel:8675309, which would not normally
	195	both be represented by any single vCard field. Representing
	196	arbitrary handles/identifiers as vCard fields is a topic for
	197	future work.</p>
	198	</tp:rationale>
	199	</tp:docstring>
	200	</property>
	201
	202	<property name="EnglishName" tp:name-for-bindings="English_Name"
	203	access="read" type="s">
	204	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	205	<p>The name of the protocol in a form suitable for display to users,
	206	such as "AIM" or "Yahoo!", or the empty string if none is
	207	available.</p>
	208
	209	<p>This is effectively in the C locale (international English);
	210	user interfaces requiring a localized protocol name SHOULD look
	211	one up in their own message catalog based on either the Telepathy
	212	<tp:type>Protocol</tp:type> name or this property, but SHOULD use
	213	this English version as a fallback if no translated version can be
	214	found.</p>
	215
	216	<tp:rationale>
	217	<p>Many protocols are named after a company or product which isn't
	218	translated in non-English locales. This also provides a fallback
	219	display name, for UIs with no prior knowledge of a particular
	220	protocol.</p>
	221	</tp:rationale>
	222
	223	<p>If this property's value is empty, clients MAY fall back to using
	224	the Telepathy <tp:type>Protocol</tp:type> name, possibly with its
	225	capitalization adjusted.</p>
	226	</tp:docstring>
	227	</property>
	228
	229	<property name="Icon" tp:name-for-bindings="Icon"
	230	access="read" type="s">
	231	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	232	<p>The name of an icon in the system's icon theme, such as "im-msn", or
	233	the empty string.</p>
	234
	235	<tp:rationale>
	236	<p>This can be used as a default if the <tp:dbus-ref
	237	namespace="org.freedesktop.Telepathy.Account">Icon</tp:dbus-ref>
	238	property is not set on an Account, or used by the <tp:dbus-ref
	239	namespace="org.freedesktop.Telepathy">AccountManager</tp:dbus-ref>
	240	to choose a default icon if none is set during account
	241	creation.</p>
	242	</tp:rationale>
	243
	244	<p>If this property's value is empty, clients MAY fall back to
	245	generating a name based on the <tp:type>Protocol</tp:type> name.</p>
	246	</tp:docstring>
	247	</property>
	248
	249	<method name="IdentifyAccount"
	250	tp:name-for-bindings="Identify_Account">
	251	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	252	<p>Return a string which uniquely identifies the account to which the
	253	given parameters would connect.</p>
	254
	255	<tp:rationale>
	256	<p>For many protocols, this would return the well-known 'account'
	257	parameter. However, for IRC the returned string would be composed
	258	from the 'account' (i.e. nickname) and 'server' parameters.
	259	AccountManager implementations can use this to form the
	260	account-specific part of an Account's object path.</p>
	261	</tp:rationale>
	262	</tp:docstring>
	263
	264	<arg direction="in" name="Parameters"
	265	type="a{sv}" tp:type="String_Variant_Map">
	266	<tp:docstring>
	267	A set of parameters as would be provided to <tp:dbus-ref
	268	namespace="org.freedesktop.Telepathy.ConnectionManager"
	269	>RequestConnection</tp:dbus-ref>
	270	</tp:docstring>
	271	</arg>
	272
	273	<arg direction="out" name="Account_ID" type="s">
	274	<tp:docstring>
	275	<p>An opaque string suitable for use as the account-specific part of
	276	an <tp:dbus-ref namespace="org.freedesktop.Telepathy"
	277	>Account</tp:dbus-ref>'s object path. This is not necessarily
	278	globally unique, but should represent a "best-effort"
	279	identification of the account.</p>
	280
	281	<tp:rationale>
	282	<p>For a pathological case, consider a user signing in as
	283	'me@example.com' with 'server' set to either jabber1.example.com
	284	or jabber2.example.com. Both of these should result in
	285	me@example.com being returned from this method, even if the user
	286	can actually be signed in to those two servers
	287	simultaneously.</p>
	288	</tp:rationale>
	289	</tp:docstring>
	290	</arg>
	291
	292	<tp:possible-errors>
	293	<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
	294	<tp:docstring>
	295	The IdentifyAccount method is not supported by this connection
	296	manager. The caller SHOULD fall back to deriving identification
	297	from the parameters.
	298	</tp:docstring>
	299	</tp:error>
	300	</tp:possible-errors>
	301	</method>
	302
	303	<method name="NormalizeContact"
	304	tp:name-for-bindings="Normalize_Contact">
	305	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	306	<p>Attempt to normalize the given contact ID. Where possible, this
	307	SHOULD return the same thing that would be returned by
	308	InspectHandles(RequestHandles(CONTACT, [Contact_ID])) on a connected
	309	<tp:dbus-ref namespace="org.freedesktop.Telepathy"
	310	>Connection</tp:dbus-ref>.</p>
	311
	312	<p>If full normalization requires network activity or is otherwise
	313	impossible to do without a <tp:dbus-ref
	314	namespace="org.freedesktop.Telepathy">Connection</tp:dbus-ref>,
	315	this method SHOULD perform a best-effort normalization.</p>
	316
	317	<tp:rationale>
	318	<p>One common example of a best-effort offline normalization
	319	differing from the ideal normalization is XMPP.</p>
	320
	321	<p>On XMPP, contacts' JIDs should normally have the resource removed
	322	during normalization, but for contacts in a MUC (chatroom), the
	323	resource is an integral part of the JID - so the contact JID
	324	alice@example.com/Empathy should normalize to alice@example.com,
	325	but the in-MUC JID wonderland@conference.example.com/Alice should
	326	normalize to itself.</p>
	327
	328	<p>While online, the connection manager has enough context to know
	329	which chatrooms the user is in, and can infer from that whether
	330	to remove resources, but the best-effort normalization performed
	331	while offline does not have this context, so the best that can be
	332	done is to remove the resource from all JIDs.</p>
	333	</tp:rationale>
	334
	335	<p>This method MAY simply raise NotImplemented on some protocols.</p>
	336
	337	<tp:rationale>
	338	<p>In link-local XMPP, you can't talk to someone who isn't present
	339	on your local network, so normalizing identifiers in advance is
	340	meaningless.</p>
	341	</tp:rationale>
	342	</tp:docstring>
	343
	344	<arg direction="in" name="Contact_ID" type="s">
	345	<tp:docstring>
	346	The identifier of a contact in this protocol
	347	</tp:docstring>
	348	</arg>
	349
	350	<arg direction="out" name="Normalized_Contact_ID" type="s">
	351	<tp:docstring>
	352	The identifier of a contact in this protocol, normalized as much
	353	as possible
	354	</tp:docstring>
	355	</arg>
	356
	357	<tp:possible-errors>
	358	<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
	359	<tp:docstring>
	360	The NormalizeContact method is not supported by this connection
	361	manager. The caller MAY recover by using the contact ID as-is.
	362	</tp:docstring>
	363	</tp:error>
	364	</tp:possible-errors>
	365	</method>
	366
	367	</interface>
	368	</node>
	369	<!-- vim:set sw=2 sts=2 et ft=xml: -->

+158

-0

spec/Protocol_Interface_Avatars.xml less more

	0	<?xml version="1.0" ?>
	1	<node name="/Protocol_Interface_Avatars"
	2	xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
	3
	4	<tp:copyright>Copyright © 2009-2010 Collabora Ltd.</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
	19	02110-1301, USA.</p>
	20	</tp:license>
	21
	22	<interface name="org.freedesktop.Telepathy.Protocol.Interface.Avatars.DRAFT"
	23	tp:causes-havoc="experimental">
	24	<tp:added version="0.19.8">(draft 1)</tp:added>
	25	<tp:requires interface="org.freedesktop.Telepathy.Protocol.DRAFT"/>
	26
	27	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	28	<p>An interface for protocols where it might be possible to set the
	29	user's avatar, and the expected size limits and supported MIME types
	30	are known before connecting.</p>
	31
	32	<tp:rationale>
	33	<p>If the avatar requirements cannot be discovered while offline,
	34	it's impossible to avoid setting the <tp:dbus-ref
	35	namespace="org.freedesktop.Telepathy"
	36	>Account</tp:dbus-ref>'s <tp:dbus-ref
	37	namespace="org.freedesktop.Telepathy.Account.Interface.Avatar"
	38	>Avatar</tp:dbus-ref> property to an unsupported avatar.</p>
	39	</tp:rationale>
	40
	41	<p>Each property on this interface SHOULD be cached in the
	42	<code>.manager</code> file, using a key of the same name as the
	43	property in the <code>[Protocol <em>proto</em>]</code>
	44	group. All properties are encoded in ASCII decimal in the obvious
	45	way, except for
	46	<tp:member-ref>SupportedAvatarMIMETypes</tp:member-ref> which is
	47	encoded as a sequence of strings each followed by a semicolon
	48	(as for the "localestrings" type in the Desktop Entry
	49	Specification).</p>
	50
	51	<p>For instance, an XMPP connection manager might have this
	52	<code>.manager</code> file:</p>
	53
	54	<pre>[Protocol jabber]
	55	Interfaces=org.freedesktop.Telepathy.Protocol.Interface.Avatars;
	56	param-account=s required
	57	param-password=s required
	58	SupportedAvatarMIMETypes=image/png;image/jpeg;image/gif;
	59	MinimumAvatarHeight=32
	60	RecommendedAvatarHeight=64
	61	MaximumAvatarHeight=96
	62	MinimumAvatarWidth=32
	63	RecommendedAvatarWidth=64
	64	MaximumAvatarWidth=96
	65	MaximumAvatarBytes=8192
	66	</pre>
	67	</tp:docstring>
	68
	69	<property name="SupportedAvatarMIMETypes"
	70	tp:name-for-bindings="Supported_Avatar_MIME_Types"
	71	type="as" access="read">
	72	<tp:docstring>
	73	The expected value of the <tp:dbus-ref
	74	namespace="org.freedesktop.Telepathy"
	75	>Connection.Interface.Avatars.SupportedAvatarMIMETypes</tp:dbus-ref>
	76	property on connections to this protocol.
	77	</tp:docstring>
	78	</property>
	79
	80	<property name="MinimumAvatarHeight"
	81	tp:name-for-bindings="Minimum_Avatar_Height"
	82	type="u" access="read">
	83	<tp:docstring>
	84	The expected value of the <tp:dbus-ref
	85	namespace="org.freedesktop.Telepathy"
	86	>Connection.Interface.Avatars.MinimumAvatarHeight</tp:dbus-ref>
	87	property on connections to this protocol.
	88	</tp:docstring>
	89	</property>
	90
	91	<property name="MinimumAvatarWidth"
	92	tp:name-for-bindings="Minimum_Avatar_Width"
	93	type="u" access="read">
	94	<tp:docstring>
	95	The expected value of the <tp:dbus-ref
	96	namespace="org.freedesktop.Telepathy"
	97	>Connection.Interface.Avatars.MinimumAvatarWidth</tp:dbus-ref>
	98	property on connections to this protocol.
	99	</tp:docstring>
	100	</property>
	101
	102	<property name="RecommendedAvatarHeight"
	103	tp:name-for-bindings="Recommended_Avatar_Height"
	104	type="u" access="read">
	105	<tp:docstring>
	106	The expected value of the <tp:dbus-ref
	107	namespace="org.freedesktop.Telepathy"
	108	>Connection.Interface.Avatars.RecommendedAvatarHeight</tp:dbus-ref>
	109	property on connections to this protocol.
	110	</tp:docstring>
	111	</property>
	112
	113	<property name="RecommendedAvatarWidth"
	114	tp:name-for-bindings="Recommended_Avatar_Width"
	115	type="u" access="read">
	116	<tp:docstring>
	117	The expected value of the <tp:dbus-ref
	118	namespace="org.freedesktop.Telepathy"
	119	>Connection.Interface.Avatars.RecommendedAvatarWidth</tp:dbus-ref>
	120	property on connections to this protocol.
	121	</tp:docstring>
	122	</property>
	123
	124	<property name="MaximumAvatarHeight"
	125	tp:name-for-bindings="Maximum_Avatar_Height"
	126	type="u" access="read">
	127	<tp:docstring>
	128	The expected value of the <tp:dbus-ref
	129	namespace="org.freedesktop.Telepathy"
	130	>Connection.Interface.Avatars.MaximumAvatarHeight</tp:dbus-ref>
	131	property on connections to this protocol.
	132	</tp:docstring>
	133	</property>
	134
	135	<property name="MaximumAvatarWidth"
	136	tp:name-for-bindings="Maximum_Avatar_Width"
	137	type="u" access="read">
	138	<tp:docstring>
	139	The expected value of the <tp:dbus-ref
	140	namespace="org.freedesktop.Telepathy"
	141	>Connection.Interface.Avatars.MaximumAvatarWidth</tp:dbus-ref>
	142	property on connections to this protocol.
	143	</tp:docstring>
	144	</property>
	145
	146	<property name="MaximumAvatarBytes"
	147	tp:name-for-bindings="Maximum_Avatar_Bytes"
	148	type="u" access="read">
	149	<tp:docstring>
	150	The expected value of the <tp:dbus-ref
	151	namespace="org.freedesktop.Telepathy"
	152	>Connection.Interface.Avatars.MaximumAvatarBytes</tp:dbus-ref>
	153	property on connections to this protocol.
	154	</tp:docstring>
	155	</property>
	156	</interface>
	157	</node>

+114

-0

spec/Protocol_Interface_Presence.xml less more

	0	<?xml version="1.0" ?>
	1	<node name="/Protocol_Interface_Presence"
	2	xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
	3
	4	<tp:copyright>Copyright © 2009-2010 Collabora Ltd.</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
	19	02110-1301, USA.</p>
	20	</tp:license>
	21
	22	<interface name="org.freedesktop.Telepathy.Protocol.Interface.Presence.DRAFT"
	23	tp:causes-havoc="experimental">
	24	<tp:added version="0.19.8">(draft 1)</tp:added>
	25	<tp:requires interface="org.freedesktop.Telepathy.Protocol.DRAFT"/>
	26
	27	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	28	<p>An interface for protocols where it might be possible to set the
	29	user's presence, and the supported presence types can be predicted
	30	before connecting.</p>
	31
	32	<tp:rationale>
	33	<p>This allows UIs to show or hide presence types that aren't
	34	always supported, such as "invisible", while not online.</p>
	35	</tp:rationale>
	36
	37	<p>The properties on this interface SHOULD be cached in the
	38	<code>.manager</code> file, in the
	39	<code>[Protocol <em>proto</em>]</code>
	40	group. For each status <em>s</em> in
	41	<tp:member-ref>Statuses</tp:member-ref>, that group should
	42	contain a key of the form <code>status-<em>s</em></code> whose value
	43	is the <tp:type>Connection_Presence_Type</tp:type> as an ASCII
	44	decimal integer, followed by a space-separated sequence of tokens
	45	from the following set:</p>
	46
	47	<dl>
	48	<dt>settable</dt>
	49	<dd>If present, the user can set this status on themselves using
	50	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.SimplePresence"
	51	>SetPresence</tp:dbus-ref>; this corresponds to May_Set_On_Self
	52	in the <tp:type>Simple_Status_Spec</tp:type> struct.</dd>
	53
	54	<dt>message</dt>
	55	<dd>If present, the user can set a non-empty message for this status;
	56	this corresponds to Can_Have_Message in the
	57	<tp:type>Simple_Status_Spec</tp:type> struct.</dd>
	58	</dl>
	59
	60	<p>Unrecognised tokens MUST be ignored.</p>
	61
	62	<p>For instance, an XMPP connection manager might have this
	63	<code>.manager</code> file:</p>
	64
	65	<pre>[Protocol jabber]
	66	Interfaces=org.freedesktop.Telepathy.Protocol.Interface.Presence;
	67	param-account=s required
	68	param-password=s required
	69	status-offline=1
	70	status-unknown=7
	71	status-error=8
	72	status-hidden=5 settable message
	73	status-xa=4 settable message
	74	status-away=3 settable message
	75	status-dnd=6 settable message
	76	status-available=2 settable message
	77	status-chat=2 settable message
	78	</pre>
	79
	80	<p>which corresponds to these property values (using a Python-like
	81	syntax):</p>
	82
	83	<pre>Statuses = {
	84	'offline': (OFFLINE, False, False),
	85	'unknown': (UNKNOWN, False, False),
	86	'error': (ERROR, False, False),
	87	'hidden': (HIDDEN, True, True),
	88	'xa': (EXTENDED_AWAY, True, True),
	89	'away': (AWAY, True, True),
	90	'dnd': (BUSY, True, True),
	91	'available': (AVAILABLE, True, True),
	92	'chat': (AVAILABLE, True, True),
	93	}
	94	</pre>
	95	</tp:docstring>
	96
	97	<property name="Statuses"
	98	tp:name-for-bindings="Statuses"
	99	type="a{s(ubb)}" tp:type="Simple_Status_Spec_Map" access="read">
	100	<tp:docstring>
	101	<p>The statuses that might appear in the <tp:dbus-ref
	102	namespace="org.freedesktop.Telepathy"
	103	>Connection.Interface.SimplePresence.Statuses</tp:dbus-ref>
	104	property on a connection to this protocol that supports
	105	SimplePresence. This property is immutable.</p>
	106
	107	<p>Depending on server capabilities, it is possible that not all
	108	of these will actually appear on the Connection.</p>
	109	</tp:docstring>
	110	</property>
	111
	112	</interface>
	113	</node>

+16

-12

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.19.7</tp:version>
	5	<tp:version>0.19.8</tp:version>
6	6
7	7	<tp:copyright>Copyright © 2005-2010 Collabora Limited</tp:copyright>
8	8	<tp:copyright>Copyright © 2005-2010 Nokia Corporation</tp:copyright>

31	31	</p>
32	32	</tp:docstring>
33	33	<xi:include href="Connection_Manager.xml"/>
	34	<xi:include href="Protocol.xml"/>
	35	<xi:include href="Protocol_Interface_Avatars.xml"/>
	36	<xi:include href="Protocol_Interface_Presence.xml"/>
34	37
35	38	<tp:section name="Connection Object">
36	39	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">

53	56	<xi:include href="Connection_Interface_Contacts.xml"/>
54	57	<xi:include href="Connection_Interface_Forwarding.xml"/>
55	58	<xi:include href="Connection_Interface_Location.xml"/>
56		<xi:include href="Connection_Interface_Service_Point.xml"/>
57	59	<xi:include href="Connection_Interface_Mail_Notification.xml"/>
58	60	<xi:include href="Connection_Interface_Presence.xml"/>
59	61	<xi:include href="Connection_Interface_Renaming.xml"/>
60	62	<xi:include href="Connection_Interface_Requests.xml"/>
	63	<xi:include href="Connection_Interface_Service_Point.xml"/>
61	64	<xi:include href="Connection_Interface_Simple_Presence.xml"/>
62	65	</tp:section>
63	66

85	88	Each Channel implements one of the following types:
86	89	</p>
87	90	</tp:docstring>
	91	<xi:include href="Channel_Type_Call.xml"/>
88	92	<xi:include href="Channel_Type_Contact_List.xml"/>
	93	<xi:include href="Channel_Type_Contact_Search.xml"/>
	94	<xi:include href="Channel_Type_DBus_Tube.xml"/>
	95	<xi:include href="Channel_Type_File_Transfer.xml"/>
	96	<xi:include href="Channel_Type_Room_List.xml"/>
	97	<xi:include href="Channel_Type_Stream_Tube.xml"/>
89	98	<xi:include href="Channel_Type_Streamed_Media.xml"/>
90		<xi:include href="Channel_Type_Room_List.xml"/>
91	99	<xi:include href="Channel_Type_Text.xml"/>
92	100	<xi:include href="Channel_Type_Tubes.xml"/>
93		<xi:include href="Channel_Type_Stream_Tube.xml"/>
94		<xi:include href="Channel_Type_DBus_Tube.xml"/>
95		<xi:include href="Channel_Type_File_Transfer.xml"/>
96		<xi:include href="Channel_Type_Contact_Search.xml"/>
97		<xi:include href="Channel_Type_Call.xml"/>
98	101	</tp:section>
99	102
100	103	<tp:section name="Channel Interfaces">

108	111	<xi:include href="Channel_Interface_Call_State.xml"/>
109	112	<xi:include href="Channel_Interface_Chat_State.xml"/>
110	113	<xi:include href="Channel_Interface_Conference.xml"/>
	114	<xi:include href="Channel_Interface_DTMF.xml"/>
111	115	<xi:include href="Channel_Interface_Destroyable.xml"/>
112		<xi:include href="Channel_Interface_DTMF.xml"/>
113	116	<xi:include href="Channel_Interface_Group.xml"/>
	117	<xi:include href="Channel_Interface_HTML.xml"/>
114	118	<xi:include href="Channel_Interface_Hold.xml"/>
115		<xi:include href="Channel_Interface_HTML.xml"/>
116		<xi:include href="Channel_Interface_Service_Point.xml"/>
117		<xi:include href="Channel_Interface_Password.xml"/>
118	119	<xi:include href="Channel_Interface_Media_Signalling.xml"/>
119	120	<xi:include href="Channel_Interface_Mergeable_Conference.xml"/>
120	121	<xi:include href="Channel_Interface_Messages.xml"/>
	122	<xi:include href="Channel_Interface_Password.xml"/>
	123	<xi:include href="Channel_Interface_Service_Point.xml"/>
121	124	<xi:include href="Channel_Interface_Splittable.xml"/>
122	125	<xi:include href="Channel_Interface_Tube.xml"/>
123	126	</tp:section>

155	158	<xi:include href="Account_Manager.xml"/>
156	159	<xi:include href="Account.xml"/>
157	160	<xi:include href="Account_Interface_Avatar.xml"/>
	161	<xi:include href="Account_Interface_Storage.xml"/>
158	162	</tp:section>
159	163
160	164	<tp:section name="The Channel Dispatcher">

-2

telepathy-glib/Makefile.in less more

566	566	versions/0.11.4.abi \
567	567	versions/0.11.5.abi \
568	568	versions/0.11.6.abi \
569		versions/0.11.7.abi
	569	versions/0.11.7.abi \
	570	versions/0.11.9.abi
570	571
571	572
572	573	# The quoting here is unnecessary but harmless, and has the useful side-effect

1418	1419	$(mkdir_p) _gen
1419	1420	touch $@
1420	1421
1421		_gen/stable-stamp: $(wildcard *.xml) _gen/spec-stamp
	1422	_gen/stable-stamp: $(wildcard $(abs_srcdir)/*.xml) _gen/spec-stamp
1422	1423	touch $@
1423	1424
1424	1425	_gen/stable-spec.xml: stable-interfaces.xml _gen/stable-stamp $(tools_dir)/xincludator.py

-1

telepathy-glib/abi.am less more

41	41	versions/0.11.4.abi \
42	42	versions/0.11.5.abi \
43	43	versions/0.11.6.abi \
44		versions/0.11.7.abi
	44	versions/0.11.7.abi \
	45	versions/0.11.9.abi
45	46
46	47	# The quoting here is unnecessary but harmless, and has the useful side-effect
47	48	# that vim quickfix mode (:make) doesn't interpret the libtool --mode=link

+150

-1

telepathy-glib/account.c less more

109	109	gchar *cm_name;
110	110	gchar *proto_name;
111	111	gchar *icon_name;
	112	gchar *service;
112	113
113	114	gchar *display_name;
114	115

144	145	PROP_ICON_NAME,
145	146	PROP_CONNECT_AUTOMATICALLY,
146	147	PROP_HAS_BEEN_ONLINE,
	148	PROP_SERVICE,
147	149	PROP_VALID,
148	150	PROP_REQUESTED_PRESENCE_TYPE,
149	151	PROP_REQUESTED_STATUS,

515	517	}
516	518	}
517	519
	520	if (g_hash_table_lookup (properties, "Service") != NULL)
	521	{
	522	const gchar *service;
	523	gchar *old = priv->service;
	524
	525	service = tp_asv_get_string (properties, "Service");
	526
	527	if (tp_str_empty (service))
	528	priv->service = g_strdup (priv->proto_name);
	529	else
	530	priv->service = g_strdup (service);
	531
	532	if (tp_strdiff (old, priv->service))
	533	g_object_notify (G_OBJECT (account), "service");
	534
	535	g_free (old);
	536	}
	537
518	538	if (g_hash_table_lookup (properties, "Valid") != NULL)
519	539	{
520	540	gboolean old = priv->valid;

678	698	&(priv->cm_name), &(priv->proto_name), NULL, NULL);
679	699
680	700	priv->icon_name = g_strdup_printf ("im-%s", priv->proto_name);
	701	priv->service = g_strdup (priv->proto_name);
681	702
682	703	g_signal_connect (self, "invalidated",
683	704	G_CALLBACK (_tp_account_invalidated_cb), NULL);

749	770	case PROP_HAS_BEEN_ONLINE:
750	771	g_value_set_boolean (value, self->priv->has_been_online);
751	772	break;
	773	case PROP_SERVICE:
	774	g_value_set_string (value, self->priv->service);
	775	break;
752	776	case PROP_VALID:
753	777	g_value_set_boolean (value, self->priv->valid);
754	778	break;

799	823	g_free (priv->message);
800	824	g_free (priv->requested_status);
801	825	g_free (priv->requested_message);
	826	g_free (priv->error);
802	827
803	828	g_free (priv->nickname);
804	829

806	831	g_free (priv->proto_name);
807	832	g_free (priv->icon_name);
808	833	g_free (priv->display_name);
	834	g_free (priv->service);
809	835
810	836	tp_clear_pointer (&priv->parameters, g_hash_table_unref);
811	837	tp_clear_pointer (&priv->error_details, g_hash_table_unref);

1112	1138	/**
1113	1139	* TpAccount:protocol:
1114	1140	*
1115		* The account's protocol name.
	1141	* The account's machine-readable protocol name, such as "jabber", "msn" or
	1142	* "local-xmpp". Recommended names for most protocols can be found in the
	1143	* Telepathy D-Bus Interface Specification.
1116	1144	*
1117	1145	* Since: 0.9.0
1118	1146	*/

1120	1148	g_param_spec_string ("protocol",
1121	1149	"Protocol",
1122	1150	"The account's protocol name",
	1151	NULL,
	1152	G_PARAM_STATIC_STRINGS \| G_PARAM_READABLE));
	1153
	1154	/**
	1155	* TpAccount:service:
	1156	*
	1157	* A machine-readable name identifying a specific service to which this
	1158	* account connects, or a copy of #TpAccount:protocol if there is no more
	1159	* specific service.
	1160	*
	1161	* Well-known names for various services can be found in the Telepathy D-Bus
	1162	* Interface Specification.
	1163	*
	1164	* For instance, accounts for the "jabber" protocol should have the service
	1165	* names "google-talk", "ovi-chat", "facebook" and "lj-talk" for accounts
	1166	* that connect to Google Talk, Ovi Chat, Facebook and Livejournal,
	1167	* respectively, and this property will be "jabber" for accounts that
	1168	* connect to a generic Jabber server.
	1169	*
	1170	* To change this property, use
	1171	* tp_account_set_service_async().
	1172	*
	1173	* Since: 0.11.9
	1174	*/
	1175	g_object_class_install_property (object_class, PROP_SERVICE,
	1176	g_param_spec_string ("service",
	1177	"Service",
	1178	"The account's service name",
1123	1179	NULL,
1124	1180	G_PARAM_STATIC_STRINGS \| G_PARAM_READABLE));
1125	1181

1569	1625	}
1570	1626
1571	1627	/**
	1628	* tp_account_get_service:
	1629	* @self: an account
	1630	*
	1631	* <!-- -->
	1632	*
	1633	* Returns: the same as the #TpAccount:service property
	1634	*
	1635	* Since: 0.11.9
	1636	*/
	1637	const gchar *
	1638	tp_account_get_service (TpAccount *self)
	1639	{
	1640	g_return_val_if_fail (TP_IS_ACCOUNT (self), NULL);
	1641
	1642	return self->priv->service;
	1643	}
	1644
	1645	/**
1572	1646	* tp_account_get_icon_name:
1573	1647	* @account: a #TpAccount
1574	1648	*

2052	2126
2053	2127	g_return_val_if_fail (g_simple_async_result_is_valid (result,
2054	2128	G_OBJECT (account), tp_account_set_display_name_finish), FALSE);
	2129
	2130	return TRUE;
	2131	}
	2132
	2133	/**
	2134	* tp_account_set_service_async:
	2135	* @self: a #TpAccount
	2136	* @service: a new service name, or %NULL or the empty string to unset the
	2137	* service name (which will result in the #TpAccount:service property
	2138	* becoming the same as #TpAccount:protocol)
	2139	* @callback: a callback to call when the request is satisfied
	2140	* @user_data: data to pass to @callback
	2141	*
	2142	* Requests an asynchronous set of the Service property on @self. When
	2143	* the operation is finished, @callback will be called. You can then call
	2144	* tp_account_set_service_finish() to get the result of the operation.
	2145	*
	2146	* Since: 0.11.9
	2147	*/
	2148	void
	2149	tp_account_set_service_async (TpAccount *self,
	2150	const char *service,
	2151	GAsyncReadyCallback callback,
	2152	gpointer user_data)
	2153	{
	2154	GSimpleAsyncResult *result;
	2155	GValue value = {0, };
	2156
	2157	g_return_if_fail (TP_IS_ACCOUNT (self));
	2158
	2159	if (service == NULL)
	2160	service = "";
	2161
	2162	result = g_simple_async_result_new (G_OBJECT (self), callback,
	2163	user_data, tp_account_set_service_async);
	2164
	2165	g_value_init (&value, G_TYPE_STRING);
	2166	g_value_set_string (&value, service);
	2167
	2168	tp_cli_dbus_properties_call_set (self, -1, TP_IFACE_ACCOUNT,
	2169	"Service", &value, _tp_account_property_set_cb, result, NULL,
	2170	G_OBJECT (self));
	2171
	2172	g_value_unset (&value);
	2173	}
	2174
	2175	/**
	2176	* tp_account_set_service_finish:
	2177	* @self: a #TpAccount
	2178	* @result: a #GAsyncResult
	2179	* @error: a #GError to fill
	2180	*
	2181	* Finishes an async set of the Service parameter.
	2182	*
	2183	* Returns: %TRUE if the operation was successful, otherwise %FALSE
	2184	*
	2185	* Since: 0.11.9
	2186	*/
	2187	gboolean
	2188	tp_account_set_service_finish (TpAccount *self,
	2189	GAsyncResult *result,
	2190	GError **error)
	2191	{
	2192	GSimpleAsyncResult *simple;
	2193
	2194	g_return_val_if_fail (TP_IS_ACCOUNT (self), FALSE);
	2195	g_return_val_if_fail (G_IS_SIMPLE_ASYNC_RESULT (result), FALSE);
	2196
	2197	simple = G_SIMPLE_ASYNC_RESULT (result);
	2198
	2199	if (g_simple_async_result_propagate_error (simple, error))
	2200	return FALSE;
	2201
	2202	g_return_val_if_fail (g_simple_async_result_is_valid (result,
	2203	G_OBJECT (self), tp_account_set_service_async), FALSE);
2055	2204
2056	2205	return TRUE;
2057	2206	}

-0

telepathy-glib/account.h less more

89	89	const gchar tp_account_get_connection_manager (TpAccount account);
90	90
91	91	const gchar tp_account_get_protocol (TpAccount account);
	92	const gchar tp_account_get_service (TpAccount self);
92	93
93	94	const gchar tp_account_get_icon_name (TpAccount account);
94	95

133	134	gpointer user_data);
134	135
135	136	gboolean tp_account_set_icon_name_finish (TpAccount *account,
	137	GAsyncResult result, GError *error);
	138
	139	void tp_account_set_service_async (TpAccount *self,
	140	const gchar *service, GAsyncReadyCallback callback,
	141	gpointer user_data);
	142
	143	gboolean tp_account_set_service_finish (TpAccount *self,
136	144	GAsyncResult result, GError *error);
137	145
138	146	void tp_account_request_presence_async (TpAccount *account,

-0

telepathy-glib/account.xml less more

6	6	<xi:include href="../spec/Account.xml"/>
7	7
8	8	<xi:include href="../spec/Account_Interface_Avatar.xml"/>
	9	<xi:include href="../spec/Account_Interface_Storage.xml"/>
9	10
10	11	</tp:spec>

+15

-10

telepathy-glib/base-client.c less more

714	714	dbus_g_connection_get_connection (
715	715	tp_proxy_get_dbus_connection (self->priv->dbus)));
716	716
717		/* one ref per TpBaseClient, released in tp_base_client_unregister() */
	717	/* one ref per TpBaseClient with CLIENT_IS_HANDLER, released
	718	* in tp_base_client_unregister() */
718	719	if (!dbus_connection_allocate_data_slot (&clients_slot))
719	720	ERROR ("Out of memory");
720	721

2099	2100	tp_base_client_unregister (TpBaseClient *self)
2100	2101	{
2101	2102	GError *error = NULL;
2102		GHashTable *clients;
2103	2103
2104	2104	if (!self->priv->registered)
2105	2105	return;

2115	2115
2116	2116	tp_dbus_daemon_unregister_object (self->priv->dbus, self);
2117	2117
2118		clients = dbus_connection_get_data (self->priv->libdbus, clients_slot);
2119		if (clients != NULL)
2120		g_hash_table_remove (clients, self->priv->object_path);
2121
2122		dbus_connection_unref (self->priv->libdbus);
2123		self->priv->libdbus = NULL;
2124
2125		dbus_connection_free_data_slot (&clients_slot);
	2118	if (self->priv->flags & CLIENT_IS_HANDLER)
	2119	{
	2120	GHashTable *clients;
	2121
	2122	clients = dbus_connection_get_data (self->priv->libdbus, clients_slot);
	2123	if (clients != NULL)
	2124	g_hash_table_remove (clients, self->priv->object_path);
	2125
	2126	dbus_connection_unref (self->priv->libdbus);
	2127	self->priv->libdbus = NULL;
	2128
	2129	dbus_connection_free_data_slot (&clients_slot);
	2130	}
2126	2131
2127	2132	self->priv->registered = FALSE;
2128	2133	}

-1

telepathy-glib/capabilities.c less more

72	72	};
73	73
74	74	/**
75		* tp_capabilities_get_channel_classes (skip):
	75	* tp_capabilities_get_channel_classes: (skip)
76	76	* @self: a #TpCapabilities object
77	77	*
78	78	* <!-- -->

-1

telepathy-glib/codegen.am less more

109	109	$(mkdir_p) _gen
110	110	touch $@
111	111
112		_gen/stable-stamp: $(wildcard *.xml) _gen/spec-stamp
	112	_gen/stable-stamp: $(wildcard $(abs_srcdir)/*.xml) _gen/spec-stamp
113	113	touch $@
114	114
115	115	_gen/stable-spec.xml: stable-interfaces.xml _gen/stable-stamp $(tools_dir)/xincludator.py

-0

telepathy-glib/connection.xml less more

10	10	<xi:include href="../spec/Connection_Interface_Avatars.xml"/>
11	11	<xi:include href="../spec/Connection_Interface_Balance.xml"/>
12	12	<xi:include href="../spec/Connection_Interface_Capabilities.xml"/>
	13	<xi:include href="../spec/Connection_Interface_Cellular.xml"/>
13	14	<xi:include href="../spec/Connection_Interface_Contact_Capabilities.xml"/>
14	15	<xi:include href="../spec/Connection_Interface_Contact_Info.xml"/>
15	16	<xi:include href="../spec/Connection_Interface_Simple_Presence.xml"/>

+12

-0

telepathy-glib/extra-gtkdoc.h less more

746	746	*
747	747	* Since: 0.11.7
748	748	*/
	749
	750	/**
	751	* SECTION:connection-cellular
	752	* @title: Connection Cellular interface
	753	* @short_description: client-side wrappers for the Cellular interface
	754	* @see_also: #TpConnection
	755	*
	756	* An interface for connections to cellular telephony (GSM, CDMA etc.), which
	757	* provides properties and signals that aren't applicable to other protocols.
	758	*
	759	* Since: 0.11.9
	760	*/

+16

-16

telepathy-glib/group-mixin.c less more

1336	1336
1337	1337	static void
1338	1338	local_pending_added (TpGroupMixin *mixin,
1339		TpIntSet *added,
1340		TpHandle actor,
1341		guint reason,
1342		const gchar *message)
	1339	const TpIntSet *added,
	1340	TpHandle actor,
	1341	guint reason,
	1342	const gchar *message)
1343	1343	{
1344	1344	LocalPendingInfo info;
1345	1345	_mixin_and_info data = { mixin, &info };

1513	1513	static gboolean
1514	1514	change_members (GObject *obj,
1515	1515	const gchar *message,
1516		TpIntSet *add,
1517		TpIntSet *del,
1518		TpIntSet *add_local_pending,
1519		TpIntSet *add_remote_pending,
	1516	const TpIntSet *add,
	1517	const TpIntSet *del,
	1518	const TpIntSet *add_local_pending,
	1519	const TpIntSet *add_remote_pending,
1520	1520	TpHandle actor,
1521	1521	TpChannelGroupChangeReason reason,
1522	1522	const GHashTable *details)

1720	1720	gboolean
1721	1721	tp_group_mixin_change_members (GObject *obj,
1722	1722	const gchar *message,
1723		TpIntSet *add,
1724		TpIntSet *del,
1725		TpIntSet *add_local_pending,
1726		TpIntSet *add_remote_pending,
	1723	const TpIntSet *add,
	1724	const TpIntSet *del,
	1725	const TpIntSet *add_local_pending,
	1726	const TpIntSet *add_remote_pending,
1727	1727	TpHandle actor,
1728	1728	TpChannelGroupChangeReason reason)
1729	1729	{

1807	1807	*/
1808	1808	gboolean
1809	1809	tp_group_mixin_change_members_detailed (GObject *obj,
1810		TpIntSet *add,
1811		TpIntSet *del,
1812		TpIntSet *add_local_pending,
1813		TpIntSet *add_remote_pending,
	1810	const TpIntSet *add,
	1811	const TpIntSet *del,
	1812	const TpIntSet *add_local_pending,
	1813	const TpIntSet *add_remote_pending,
1814	1814	const GHashTable *details)
1815	1815	{
1816	1816	const gchar *message;

-5

telepathy-glib/group-mixin.h less more

201	201	void tp_group_mixin_change_flags (GObject *obj,
202	202	TpChannelGroupFlags add, TpChannelGroupFlags del);
203	203	gboolean tp_group_mixin_change_members (GObject *obj,
204		const gchar message, TpIntSet add, TpIntSet *del,
205		TpIntSet add_local_pending, TpIntSet add_remote_pending, TpHandle actor,
206		TpChannelGroupChangeReason reason);
207		gboolean tp_group_mixin_change_members_detailed (GObject obj, TpIntSet add,
208		TpIntSet del, TpIntSet add_local_pending, TpIntSet *add_remote_pending,
	204	const gchar message, const TpIntSet add, const TpIntSet *del,
	205	const TpIntSet add_local_pending, const TpIntSet add_remote_pending,
	206	TpHandle actor, TpChannelGroupChangeReason reason);
	207	gboolean tp_group_mixin_change_members_detailed (GObject *obj,
	208	const TpIntSet add, const TpIntSet del,
	209	const TpIntSet add_local_pending, const TpIntSet add_remote_pending,
209	210	const GHashTable *details);
210	211	void tp_group_mixin_change_self_handle (GObject *obj,
211	212	TpHandle new_self_handle);

-8

telepathy-glib/proxy.c less more

193	193	* automatically add this interface in its constructor
194	194	* @must_have_unique_name: If set %TRUE by a subclass, the #TpProxy
195	195	* constructor will fail if a well-known bus name is given
196		* @_reserved_flags: Reserved for future expansion
197		* @list_features: Defined by subclasses to provide features for
198		* tp_proxy_prepare_async() (currently only usable within telepathy-glib
199		* itself)
200		* @_reserved: Reserved for future expansion
201		* @priv: Opaque pointer for private data
202		*
203		* The class of a #TpProxy.
	196	*
	197	* The class of a #TpProxy. The struct fields not documented here are reserved.
204	198	*
205	199	* Since: 0.7.1
206	200	*/

-0

telepathy-glib/proxy.h less more

86	86	GQuark interface;
87	87
88	88	unsigned int must_have_unique_name:1;
	89	/<private>/
89	90	guint _reserved_flags:31;
90	91
91	92	/* XXX: hide this from the g-i scanner, since vapigen can't cope */

+32

-0

telepathy-glib/util.c less more

1332	1332	*
1333	1333	* Since: 0.11.7
1334	1334	*/
	1335
	1336	/**
	1337	* tp_simple_async_report_success_in_idle:
	1338	* @source: the source object
	1339	* @callback: the callback
	1340	* @user_data: user data for @callback
	1341	* @source_tag: the source tag for the #GSimpleAsyncResult
	1342	*
	1343	* Create a new #GSimpleAsyncResult with no operation result, and call
	1344	* g_simple_async_result_complete_in_idle() on it.
	1345	*
	1346	* This is like a successful version of g_simple_async_report_error_in_idle(),
	1347	* suitable for asynchronous functions that (conceptually) either succeed and
	1348	* return nothing, or raise an error, such as tp_proxy_prepare_async().
	1349	*
	1350	* The corresponding finish function should not call a function that attempts
	1351	* to get a result, such as g_simple_async_result_get_op_res_gpointer().
	1352	*
	1353	* Since: 0.11.9
	1354	*/
	1355	void
	1356	tp_simple_async_report_success_in_idle (GObject *source,
	1357	GAsyncReadyCallback callback,
	1358	gpointer user_data,
	1359	gpointer source_tag)
	1360	{
	1361	GSimpleAsyncResult *simple;
	1362
	1363	simple = g_simple_async_result_new (source, callback, user_data, source_tag);
	1364	g_simple_async_result_complete_in_idle (simple);
	1365	g_object_unref (simple);
	1366	}

-1

telepathy-glib/util.h less more

22	22	#define __TP_UTIL_H__
23	23	#define __TP_IN_UTIL_H__
24	24
25		#include <glib-object.h>
	25	#include <gio/gio.h>
26	26
27	27	#include <telepathy-glib/verify.h>
28	28

137	137	} \
138	138	G_STMT_END
139	139
	140	void tp_simple_async_report_success_in_idle (GObject *source,
	141	GAsyncReadyCallback callback, gpointer user_data, gpointer source_tag);
	142
140	143	G_END_DECLS
141	144
142	145	#undef __TP_IN_UTIL_H__

+14

-0

telepathy-glib/versions/0.11.9.abi less more

	0	Version: TELEPATHY_GLIB_0.11.9
	1	Extends: TELEPATHY_GLIB_0.11.7
	2	Release: 0.11.9
	3
	4	tp_account_get_service
	5	tp_account_set_service_async
	6	tp_account_set_service_finish
	7	tp_cli_connection_interface_cellular_connect_to_imsi_changed
	8	tp_iface_quark_account_interface_storage
	9	tp_iface_quark_connection_interface_cellular
	10	tp_simple_async_report_success_in_idle
	11	tp_svc_account_interface_storage_get_type
	12	tp_svc_connection_interface_cellular_emit_imsi_changed
	13	tp_svc_connection_interface_cellular_get_type

-1

tests/dbus/account.c less more

12	12	#include <telepathy-glib/defs.h>
13	13	#include <telepathy-glib/svc-account.h>
14	14
15		#include "tests/lib/util.h"
16	15	#include "tests/lib/simple-account.h"
17	16	#include "tests/lib/util.h"
18	17

-0

tests/dbus/contacts-slow-path.c less more

520	520	}
521	521
522	522	/* remaining cleanup */
	523	g_hash_table_unref (location_1);
	524	g_hash_table_unref (location_2);
	525	g_hash_table_unref (location_3);
523	526	g_main_loop_unref (result.loop);
524	527	g_ptr_array_free (result.contacts, TRUE);
525	528	g_assert (result.invalid == NULL);

-0

tests/dbus/contacts.c less more

1154	1154	}
1155	1155
1156	1156	/* remaining cleanup */
	1157	g_hash_table_unref (location_1);
	1158	g_hash_table_unref (location_2);
	1159	g_hash_table_unref (location_3);
1157	1160	g_main_loop_unref (result.loop);
1158	1161	}
1159	1162

-1

tests/lib/textchan-null.c less more

333	333
334	334	g_hash_table_unref (self->dbus_property_interfaces_retrieved);
335	335
336		((GObjectClass *) tp_tests_text_channel_null_parent_class)->finalize (object);
	336	((GObjectClass *) tp_tests_props_text_channel_parent_class)->finalize (object);
337	337	}
338	338
339	339	static void

393	393	group_finalize (GObject *self)
394	394	{
395	395	tp_group_mixin_finalize (self);
	396
	397	((GObjectClass *) tp_tests_props_group_text_channel_parent_class)->finalize (self);
396	398	}
397	399
398	400	static gboolean

-1

tests/lib/util.c less more

35	35	GError **error)
36	36	{
37	37	GAsyncResult *result = NULL;
	38	gboolean r;
38	39
39	40	tp_proxy_prepare_async (proxy, features, prepared_cb, &result);
40	41	/* not synchronous */

43	44	while (result == NULL)
44	45	g_main_context_iteration (NULL, TRUE);
45	46
46		return tp_proxy_prepare_finish (proxy, result, error);
	47	r = tp_proxy_prepare_finish (proxy, result, error);
	48	g_object_unref (result);
	49	return r;
47	50	}
48	51
49	52	TpDBusDaemon *

-1

tests/tests.supp less more

5	5	...
6	6	fun:g_type_class_ref
7	7	...
8		fun:test_object_new_static_class
	8	fun:tp_tests_object_new_static_class
9	9	}

+67

-17

tools/telepathy-glib.supp less more

21	21	fun:tp_handle_ensure
22	22	}
23	23
24		{
25		ld.so initialization on glibc 2.9
	24	# default.supp has these for 2.10, but they're too specific
	25	{
	26	Debian libc6 (2.10.x, 2.11.x) stripped dynamic linker
	27	Memcheck:Cond
	28	fun:index
	29	fun:expand_dynamic_string_token
	30	fun:_dl_map_object
	31	fun:map_doit
	32	fun:_dl_catch_error
	33	fun:do_preload
	34	fun:dl_main
	35	fun:_dl_sysdep_start
	36	fun:_dl_start
	37	obj:/lib/ld-*.so
	38	}
	39	{
	40	Debian libc6 (2.9.x - 2.11.x) stripped dynamic linker
26	41	Memcheck:Cond
27	42	fun:_dl_relocate_object
28	43	fun:dl_main
29	44	fun:_dl_sysdep_start
30	45	fun:_dl_start
31		obj:/lib/ld-2.9.so
	46	obj:/lib/ld-*.so
32	47	}
33	48
34	49	{

42	57	obj:/lib/ld-2.9.so
43	58	}
44	59
45		{
46		selinux, we just don't know
47		Memcheck:Leak
48		fun:malloc
49		fun:getdelim
50		obj:/lib/libselinux.so.1
	60	# ======================= libselinux on Debian amd64 =====================
	61
	62	{
	63	I have no idea what SELinux is doing but it's not my problem
	64	Memcheck:Cond
	65	...
	66	obj:/lib/libselinux.so.1
	67	obj:/lib/libselinux.so.1
	68	obj:/lib/libselinux.so.1
	69	}
	70
	71	{
	72	I have no idea what SELinux is doing but it's not my problem
	73	Memcheck:Value8
	74	...
	75	obj:/lib/libselinux.so.1
	76	obj:/lib/libselinux.so.1
	77	obj:/lib/libselinux.so.1
	78	}
	79
	80	{
	81	I have no idea what SELinux is doing but it's not my problem
	82	Memcheck:Leak
	83	...
	84	obj:/lib/libselinux.so.1
	85	obj:/lib/libselinux.so.1
	86	obj:/lib/libselinux.so.1
51	87	}
52	88
53	89	# ============================= GLib ==================================

166	202	fun:g_type_add_interface_static
167	203	}
168	204
	205	{
	206	initialization of interfaces
	207	Memcheck:Leak
	208	...
	209	fun:type_iface_vtable_base_init_Wm
	210	fun:g_type_class_ref
	211	}
	212
169	213	# ============================= GIO ===================================
170	214
171	215	{
	216	GIO init
	217	Memcheck:Leak
	218	...
	219	fun:g_inet_address_class_intern_init
	220	}
	221
	222	{
172	223	g_simple_async_result class
173	224	Memcheck:Leak
174	225	...

178	229	}
179	230
180	231	# ============================= dbus-glib =============================
181
182		{
183		dbus-glib, https://bugs.freedesktop.org/show_bug.cgi?id=14125
184		Memcheck:Addr4
185		fun:g_hash_table_foreach
186		obj:/usr/lib/libdbus-glib-1.so.2.1.0
187		fun:g_object_run_dispose
188		}
189	232
190	233	{
191	234	registering marshallers is permanent

233	276	fun:dbus_g_error_domain_register
234	277	}
235	278
	279	{
	280	DBusGProxy class init
	281	Memcheck:Leak
	282	...
	283	fun:dbus_g_proxy_class_init
	284	}
	285
236	286	# ============================= telepathy-glib ========================
237	287
238	288	{

-0

vala/Makefile.am less more

15	15	--pkg gio-2.0 \
16	16	$< \
17	17	$(NULL)
	18	@mv $@ telepathy-glib.vapi.tmp1
	19	$(AM_V_GEN)sed -e \
	20	's/TelepathyGLib-0.12.h/telepathy-glib\/telepathy-glib.h/' \
	21	< telepathy-glib.vapi.tmp1 > telepathy-glib.vapi.tmp2
	22	$(AM_V_GEN)sed -e \
	23	's/cprefix = "tp"/cprefix = "Tp"/' \
	24	< telepathy-glib.vapi.tmp2 > $@
	25	@rm telepathy-glib.vapi.tmp*
18	26
19	27	CLEANFILES = \
20	28	$(BUILT_SOURCES) \

-0

vala/Makefile.in less more

515	515	--pkg gio-2.0 \
516	516	$< \
517	517	$(NULL)
	518	@mv $@ telepathy-glib.vapi.tmp1
	519	$(AM_V_GEN)sed -e \
	520	's/TelepathyGLib-0.12.h/telepathy-glib\/telepathy-glib.h/' \
	521	< telepathy-glib.vapi.tmp1 > telepathy-glib.vapi.tmp2
	522	$(AM_V_GEN)sed -e \
	523	's/cprefix = "tp"/cprefix = "Tp"/' \
	524	< telepathy-glib.vapi.tmp2 > $@
	525	@rm telepathy-glib.vapi.tmp*
518	526
519	527	# Tell versions [3.59,3.63) of GNU make to not export all variables.
520	528	# Otherwise a system limit (for SysV at least) may be exceeded.