Commit 5a52903f77d67eb0180498c7dc107096446ad084 - telepathy-glib

+219

-0

ChangeLog less more

	0	commit 9b3deb4eaf98c2f594c8d41d4ad1b6629871fddc
	1	Author: Will Thompson <will.thompson@collabora.co.uk>
	2	Date: 2011-03-22 12:55:26 +0000
	3
	4	Add a note about adding API on a stable branch.
	5
	6	commit 869a063a5ce8ff82557d806f253a289f6de5a225
	7	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	8	Date: 2011-03-22 11:17:14 +0100
	9
	10	prepare 0.14.1
	11
	12	commit 3d75d29eaf6c34a017d2274caa6a7df004653c49
	13	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	14	Date: 2011-03-22 11:50:09 +0100
	15
	16	add TpContactBlockingCapabilities to the doc as I meant to
	17
	18	commit 3c11d99746c55f93613d137da13db3dfc6820fbb
	19	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	20	Date: 2011-03-22 10:56:00 +0100
	21
	22	Generate code for Conn.I.ContactBlocking
	23
	24	commit 00c153c57c455ecaa5bd12d0ece2c7afe4d4fec7
	25	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	26	Date: 2011-03-22 10:25:22 +0100
	27
	28	sync to spec 0.22.0
	29
	30	commit b301f12e71ea54b842afe06554ac3f6ea45ec352
	31	Author: Will Thompson <will.thompson@collabora.co.uk>
	32	Date: 2011-03-21 18:09:51 +0000
	33
	34	Bump nano-version to 0.14.0.1
	35
	36	commit 62fb543541710a2443fd692cec9ecb72a9874351
	37	Author: Will Thompson <will.thompson@collabora.co.uk>
	38	Date: 2011-03-21 17:56:35 +0000
	39
	40	version 0.14.0
	41
	42	commit da645737686d92712c2ac622d2b2a888ba07bddd
	43	Author: Will Thompson <will.thompson@collabora.co.uk>
	44	Date: 2011-03-21 17:55:14 +0000
	45
	46	NEWS for 0.14.0
	47
	48	commit 83edfa4ffbddf7ff62432bbd82b446ed3d2e854d
	49	Author: Nicolas Dufresne <nicolas.dufresne@collabora.co.uk>
	50	Date: 2011-03-16 15:27:39 -0400
	51
	52	Fix got_sender_contact_by_id_cb error handling
	53
	54	This bug was introduced by 5cc352873f102b6a43c2a95b71a9a2e5a38526ab
	55
	56	commit 0b86a27be7ecd4401696624b925e4719b9a4f31a
	57	Author: Nicolas Dufresne <nicolas.dufresne@collabora.co.uk>
	58	Date: 2011-03-16 15:27:25 -0400
	59
	60	Fix got_sender_contact_by_handle_cb error handling
	61
	62	This bug was introduced by 5cc352873f102b6a43c2a95b71a9a2e5a38526ab
	63
	64	commit d2708eeced8185c02c61420678f674f71b2bf3be
	65	Author: Will Thompson <will.thompson@collabora.co.uk>
	66	Date: 2011-03-15 20:11:48 +0000
	67
	68	Bump nano-version to 0.13.18.1
	69
	70	commit 4a2637ec606509c1848a293da034abbfbbb0ea18
	71	Author: Will Thompson <will.thompson@collabora.co.uk>
	72	Date: 2011-03-15 19:32:13 +0000
	73
	74	Version 0.13.18
	75
	76	commit 2189991503efd71bd65887c5ab280d4078ae7534
	77	Author: Will Thompson <will.thompson@collabora.co.uk>
	78	Date: 2011-03-15 19:31:45 +0000
	79
	80	News for 0.13.18
	81
	82	commit ca3c4e31c0a93976f7fc4d20323c6995d28c8f7b
	83	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	84	Date: 2011-03-08 16:52:06 +0000
	85
	86	with-session-bus.sh: set DBUS_SESSION_BUS_PID, like dbus-launch does
	87
	88	This isn't directly useful for Telepathy, but is useful if you're
	89	debugging the dbus-daemon itself.
	90
	91	Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
	92
	93	commit e77e5c7c6982e7b0ec167a812d5eae5082193a52
	94	Merge: 64a19c7 6418d8a
	95	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	96	Date: 2011-03-15 18:15:21 +0000
	97
	98	Merge branch 'ldflags'
	99
	100	Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
	101	Bug: https://bugs.freedesktop.org/show_bug.cgi?id=32976
	102
	103	commit 64a19c7d218db2429b49b578e267c24871657774
	104	Merge: a08b10e bc812a8
	105	Author: Will Thompson <will.thompson@collabora.co.uk>
	106	Date: 2011-03-15 18:12:49 +0000
	107
	108	Merge branch 'fd.o-34337-gcc-4.6'
	109
	110	commit bc812a896a33f184d4ddee6fb20f4659ef60f8f8
	111	Author: Will Thompson <will.thompson@collabora.co.uk>
	112	Date: 2011-03-15 18:12:23 +0000
	113
	114	Remove dummy local GType variable.
	115
	116	commit f326c123bf76e685cd5258417b8dfd026fad2d65
	117	Author: Will Thompson <will.thompson@collabora.co.uk>
	118	Date: 2011-02-24 15:04:27 +0000
	119
	120	Implement tp_strdiff using g_strcmp0.
	121
	122	Clang's analyzer, like Coverity before it, isn't smart enough to realise
	123	that the first two conditions between them guarantee that, if you get to
	124	the end, left and right are non-NULL.
	125
	126	But the point is moot, since we can just use a Glib function.
	127
	128	commit 26fdbe81650249fc3566669124ab988ef0248499
	129	Author: Will Thompson <will.thompson@collabora.co.uk>
	130	Date: 2011-02-24 14:59:44 +0000
	131
	132	Fix “Value stored to _ is never read” clang warnings.
	133
	134	commit e5e8579bd16f3b98a0d0c87f9ba3825cd963fac8
	135	Author: Dan Winship <danw@gnome.org>
	136	Date: 2011-02-16 09:22:47 -0500
	137
	138	fix gcc 4.6 "variable is set but not used" warnings
	139
	140	Signed-off-by: Will Thompson <will.thompson@collabora.co.uk>
	141
	142	commit 367d9b96f7bf449ce034684dd4c4a79bd669ac84
	143	Author: Will Thompson <will.thompson@collabora.co.uk>
	144	Date: 2011-02-24 11:18:15 +0000
	145
	146	Make tp_clear_* less NULL-safe.
	147
	148	Previously tp_clear_object (NULL) was permitted. This upsets GCC 4.6,
	149	which (quite reasonably) complained that
	150
	151	if (&object != NULL)
	152
	153	is redundant. The joy of macros. I grepped tp-glib and Gabble, and can't
	154	find any cases where anything other than &variable is passed to these
	155	macros. Since this is an unstable branch, let's just change this.
	156
	157	commit a08b10e66c516bfcbc20428c2657363d035f8ef9
	158	Author: Jonny Lamb <jonny.lamb@collabora.co.uk>
	159	Date: 2011-03-15 11:58:20 +0000
	160
	161	base-connection: document the self object in signal docstrings
	162
	163	Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
	164
	165	commit 83200447e0825af6ee51211111e630bd1f86c2d9
	166	Author: Benjamin Otte <otte@redhat.com>
	167	Date: 2011-03-11 13:11:46 +0000
	168
	169	Don't include TpCMMessage in gir file.
	170
	171	This class is only for use by connection managers, while we only (intend
	172	to) expose client-side API in the gir file.
	173
	174	Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	175	Signed-off-by: Will Thompson <will.thompson@collabora.co.uk>
	176
	177	commit 60e2bac4406fedf8a16014673ade145629ea9b3d
	178	Author: Danielle Madeley <danielle.madeley@collabora.co.uk>
	179	Date: 2011-03-10 15:06:49 +1100
	180
	181	Docs include simple-password-channel, when it's actually called base-password-channel
	182
	183	commit 4b0e1b5b8d149a7b9687b397511dce9cbfb29d12
	184	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	185	Date: 2011-03-09 15:02:23 +0100
	186
	187	start dev of next release
	188
0	189	commit 09b532cbcf7229f4c509ec919f1bc8e8f6028558
1	190	Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
2	191	Date: 2011-03-09 14:45:47 +0100

1075	1264	with-session-bus.sh: only print debug if VERBOSE_TESTS is set
1076	1265
1077	1266	Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
	1267
	1268	commit 6418d8a197b080e116ba209ea8733263e3a4ef24
	1269	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	1270	Date: 2011-01-10 18:54:00 +0000
	1271
	1272	Prefer to use --no-copy-dt-needed-entries, falling back to --no-add-needed
	1273
	1274	commit 0e59dc9d63ad7391863c4e81d06bbfe556984890
	1275	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	1276	Date: 2011-01-10 18:06:22 +0000
	1277
	1278	Add TP_ADD_COMPILER_FLAG, analogous to TP_ADD_LINKER_FLAG
	1279
	1280	commit 371dfac9776b66cb04c449f4f3e5b5a6ddfa4a5e
	1281	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	1282	Date: 2011-01-10 16:43:25 +0000
	1283
	1284	Check for -Wl,--no-add-needed and add it to AM_LDFLAGS everywhere we compile C
	1285
	1286	commit 3e1ed6823ff128c73656239dcf2fe0c4589e9f8a
	1287	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	1288	Date: 2011-01-10 16:42:57 +0000
	1289
	1290	Add TP_LINKER_FLAG, TP_ADD_LINKER_FLAG
	1291
	1292	commit 0b3fd08ed314324ffa5328d0f4b7e68d54f56677
	1293	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	1294	Date: 2011-01-10 16:30:37 +0000
	1295
	1296	abi.am: respect AM_LDFLAGS for main telepathy-glib library
1078	1297
1079	1298	commit fe8dd650a78d535693aabdd5af7116955f65d431
1080	1299	Author: Jonny Lamb <jonny.lamb@collabora.co.uk>

+1

-1

Makefile.in less more

47	47	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
48	48	$(top_srcdir)/m4/tp-compiler-flag.m4 \
49	49	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
50		$(top_srcdir)/configure.ac
	50	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
51	51	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
52	52	$(ACLOCAL_M4)
53	53	am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \

+100

-0

NEWS less more

	0	telepathy-glib 0.14.1 (2011-03-22)
	1	==================================
	2
	3	The “work by the windows” release. This release adds API from version
	4	0.22 of the Telepathy specification which was accidentally omitted from
	5	the previous release. Further releases on this stable branch should not
	6	add any further API.
	7
	8	Enhancements:
	9
	10	• Update to spec 0.22.0 (Guillaume)
	11	· TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES
	12	· generate code for Connection.I.ContactBlocking
	13
	14	telepathy-glib 0.14.0 (2011-03-21)
	15	==================================
	16
	17	The “welded in gridlock” release, starting a 0.14.x stable branch. This
	18	branch corresponds to the 0.22 stable branch of the specification.
	19
	20	Highlights since 0.12.0
	21	-----------------------
	22
	23	• TpBaseContactList, a base class for the ContactList and ContactGroups
	24	connection interfaces, as well as old-style ContactList channels.
	25	While this helper class supports the old 'deny' channel for blocked
	26	contact, it unfortunately does not implement the new ContactBlocking
	27	interface yet.
	28
	29	• CMs implemented using telepathy-glib will now have immortal handles.
	30
	31	• TpContact supports ClientTypes.
	32
	33	• TpClientChannelFactory, TpAutomaticProxyFactory and
	34	TpBasicProxyFactory have been added to help applications construct
	35	particular TpChannel subclasses for channels of different types, with
	36	particular features prepared.
	37
	38	• TpStreamTubeChannel, a high-level client API for stream tubes, has
	39	been added.
	40
	41	• TpBaseProtocol supports the Avatars and Presence interfaces.
	42
	43	• tp_get_bus() is deprecated (again). Please use tp_dbus_daemon_dup(),
	44	followed by tp_dbus_daemon_register_object() if that's what you're
	45	using it for, or tp_proxy_get_dbus_connection() if you really need a
	46	DBusGConnection.
	47
	48	• TpClientMessage and TpSignalledMessage, client-side representations
	49	for multipart messages used by TpTextChannel, have been added.
	50
	51	• The TpContactSearch object has been added. It represents ongoing
	52	searches for contacts.
	53
	54	• Code is now generated to emit and listen for the PropertiesChanged
	55	signal on org.freedesktop.DBus.Properties. Note that
	56	TpDBusPropertiesMixin does not emit this signal on it own, nor does
	57	TpProxy listen for it of its own accord.
	58
	59	• Previously, tp_clear_object (NULL), tp_clear_boxed (type, NULL) and
	60	tp_clear_pointer (NULL) were no-ops. However, this behaviour was not
	61	very useful—these functions are always called as
	62	tp_clear_object (&priv->foo) in practice—and triggered compiler
	63	warnings (because these are actually implemented as macros). Thus,
	64	this usage is no longer supported. (This should not affect anything
	65	except contrived code, but CM authors may wish to check.)
	66
	67	Fixes since 0.13.18
	68	-------------------
	69
	70	• The error handling code paths when looking up the senders of incoming
	71	messages have been fixed. This issue led to TpSignalledMessages not
	72	specifying a sender with CMs that omit sender-id, like telepathy-idle.
	73	(stormer)
	74
	75	telepathy-glib 0.13.18 (2011-03-15)
	76	===================================
	77
	78	The “chilled coconut-chocolate security blanket” release.
	79
	80	Changes:
	81
	82	• Previously, tp_clear_object (NULL), tp_clear_boxed (type, NULL) and
	83	tp_clear_pointer (NULL) were no-ops. However, this behaviour was not
	84	very useful—these functions are always called as
	85	tp_clear_object (&priv->foo) in practice—and triggered compiler
	86	warnings (because these are actually implemented as macros). Thus,
	87	this usage is no longer supported. (This should not affect anything
	88	except contrived code, but CM authors may wish to check.)
	89
	90	Fixes:
	91
	92	• TpCMMessage is no longer included in the .gir file. This class is only
	93	useful in CMs; we only support client-side API in the .gir file.
	94	(Benjamin Otte)
	95
	96	• Correctly include TpBasePasswordChannel documentation. (Danielle)
	97
	98	• Fix GCC 4.6 and Clang analyzer warnings (Dan Winship, Will)
	99
0	100	telepathy-glib 0.13.17 (2011-03-09)
1	101	===================================
2	102

+3

-2

aclocal.m4 less more

155	155	Consider adjusting the PKG_CONFIG_PATH environment variable if you
156	156	installed software in a non-standard prefix.
157	157
158		_PKG_TEXT])dnl
	158	_PKG_TEXT])[]dnl
159	159	])
160	160	elif test $pkg_failed = untried; then
161	161	AC_MSG_RESULT([no])

166	166
167	167	_PKG_TEXT
168	168
169		To get pkg-config, see <http://pkg-config.freedesktop.org/>.])dnl
	169	To get pkg-config, see <http://pkg-config.freedesktop.org/>.])[]dnl
170	170	])
171	171	else
172	172	$1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS

1408	1408	m4_include([m4/lt~obsolete.m4])
1409	1409	m4_include([m4/tp-compiler-flag.m4])
1410	1410	m4_include([m4/tp-compiler-warnings.m4])
	1411	m4_include([m4/tp-linker-flag.m4])

+108

-16

configure less more

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

761	761	# Identity of this package.
762	762	PACKAGE_NAME='Telepathy-GLib'
763	763	PACKAGE_TARNAME='telepathy-glib'
764		PACKAGE_VERSION='0.13.17'
765		PACKAGE_STRING='Telepathy-GLib 0.13.17'
	764	PACKAGE_VERSION='0.14.1'
	765	PACKAGE_STRING='Telepathy-GLib 0.14.1'
766	766	PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=tp-glib'
767	767	PACKAGE_URL=''
768	768

1582	1582	# Omit some internal or obsolete options to make the list less imposing.
1583	1583	# This message is too long to be a string in the A/UX 3.1 sh.
1584	1584	cat <<_ACEOF
1585		\`configure' configures Telepathy-GLib 0.13.17 to adapt to many kinds of systems.
	1585	\`configure' configures Telepathy-GLib 0.14.1 to adapt to many kinds of systems.
1586	1586
1587	1587	Usage: $0 [OPTION]... [VAR=VALUE]...
1588	1588

1652	1652
1653	1653	if test -n "$ac_init_help"; then
1654	1654	case $ac_init_help in
1655		short \| recursive ) echo "Configuration of Telepathy-GLib 0.13.17:";;
	1655	short \| recursive ) echo "Configuration of Telepathy-GLib 0.14.1:";;
1656	1656	esac
1657	1657	cat <<\_ACEOF
1658	1658

1799	1799	test -n "$ac_init_help" && exit $ac_status
1800	1800	if $ac_init_version; then
1801	1801	cat <<\_ACEOF
1802		Telepathy-GLib configure 0.13.17
	1802	Telepathy-GLib configure 0.14.1
1803	1803	generated by GNU Autoconf 2.67
1804	1804
1805	1805	Copyright (C) 2010 Free Software Foundation, Inc.

2289	2289	This file contains any messages produced by compilers while
2290	2290	running configure, to aid debugging if configure makes a mistake.
2291	2291
2292		It was created by Telepathy-GLib $as_me 0.13.17, which was
	2292	It was created by Telepathy-GLib $as_me 0.14.1, which was
2293	2293	generated by GNU Autoconf 2.67. Invocation command line was
2294	2294
2295	2295	$ $0 $@

3107	3107
3108	3108	# Define the identity of the package.
3109	3109	PACKAGE='telepathy-glib'
3110		VERSION='0.13.17'
	3110	VERSION='0.14.1'
3111	3111
3112	3112
3113	3113	cat >>confdefs.h <<_ACEOF

11860	11860
11861	11861
11862	11862
	11863
	11864	# these aren't really error flags but they serve a similar purpose for us -
	11865	# making the toolchain stricter
	11866	if test "x$official_release" = xno; then
	11867
	11868
	11869	{ $as_echo "$as_me:${as_lineno-$LINENO}: checking to see if compiler/linker understand -Wl,--no-copy-dt-needed-entries" >&5
	11870	$as_echo_n "checking to see if compiler/linker understand -Wl,--no-copy-dt-needed-entries... " >&6; }
	11871
	11872	save_LDFLAGS="$LDFLAGS"
	11873	LDFLAGS="$LDFLAGS -Wl,--no-copy-dt-needed-entries"
	11874
	11875	cat confdefs.h - <<_ACEOF >conftest.$ac_ext
	11876	/* end confdefs.h. */
	11877
	11878	int
	11879	main ()
	11880	{
	11881
	11882	;
	11883	return 0;
	11884	}
	11885	_ACEOF
	11886	if ac_fn_c_try_compile "$LINENO"; then :
	11887	flag_ok=yes
	11888	else
	11889	flag_ok=no
	11890	fi
	11891	rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
	11892
	11893	LDFLAGS="$save_LDFLAGS"
	11894
	11895	if test "X$flag_ok" = Xyes ; then
	11896	ERROR_LDFLAGS="$ERROR_LDFLAGS -Wl,--no-copy-dt-needed-entries"
	11897	true
	11898	else
	11899
	11900	true
	11901	fi
	11902	{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $flag_ok" >&5
	11903	$as_echo "$flag_ok" >&6; }
	11904
	11905
	11906
	11907	# --no-copy-dt-needed-entries is the new name for --no-add-needed which
	11908	# is much more widely supported
	11909	case "$ERROR_LDFLAGS" in
	11910	(-Wl,--no-copy-dt-needed-entries)
	11911	;;
	11912	(*)
	11913
	11914
	11915	{ $as_echo "$as_me:${as_lineno-$LINENO}: checking to see if compiler/linker understand -Wl,--no-add-needed" >&5
	11916	$as_echo_n "checking to see if compiler/linker understand -Wl,--no-add-needed... " >&6; }
	11917
	11918	save_LDFLAGS="$LDFLAGS"
	11919	LDFLAGS="$LDFLAGS -Wl,--no-add-needed"
	11920
	11921	cat confdefs.h - <<_ACEOF >conftest.$ac_ext
	11922	/* end confdefs.h. */
	11923
	11924	int
	11925	main ()
	11926	{
	11927
	11928	;
	11929	return 0;
	11930	}
	11931	_ACEOF
	11932	if ac_fn_c_try_compile "$LINENO"; then :
	11933	flag_ok=yes
	11934	else
	11935	flag_ok=no
	11936	fi
	11937	rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
	11938
	11939	LDFLAGS="$save_LDFLAGS"
	11940
	11941	if test "X$flag_ok" = Xyes ; then
	11942	ERROR_LDFLAGS="$ERROR_LDFLAGS -Wl,--no-add-needed"
	11943	true
	11944	else
	11945
	11946	true
	11947	fi
	11948	{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $flag_ok" >&5
	11949	$as_echo "$flag_ok" >&6; }
	11950
	11951
	11952	;;
	11953	esac
	11954	fi
11863	11955
11864	11956	if test "x$official_release" = xyes; then
11865	11957	OFFICIAL_RELEASE_TRUE=

15467	15559	-e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
15468	15560	-e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
15469	15561	-e 's:$: $lt_compiler_flag:'`
15470		(eval echo "\"\$as_me:15471: $lt_compile\"" >&5)
	15562	(eval echo "\"\$as_me:15563: $lt_compile\"" >&5)
15471	15563	(eval "$lt_compile" 2>conftest.err)
15472	15564	ac_status=$?
15473	15565	cat conftest.err >&5
15474		echo "$as_me:15475: \$? = $ac_status" >&5
	15566	echo "$as_me:15567: \$? = $ac_status" >&5
15475	15567	if (exit $ac_status) && test -s "$ac_outfile"; then
15476	15568	# The compiler can only warn and ignore the option if not recognized
15477	15569	# So say no if there are warnings other than the usual output.

15566	15658	-e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
15567	15659	-e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
15568	15660	-e 's:$: $lt_compiler_flag:'`
15569		(eval echo "\"\$as_me:15570: $lt_compile\"" >&5)
	15661	(eval echo "\"\$as_me:15662: $lt_compile\"" >&5)
15570	15662	(eval "$lt_compile" 2>out/conftest.err)
15571	15663	ac_status=$?
15572	15664	cat out/conftest.err >&5
15573		echo "$as_me:15574: \$? = $ac_status" >&5
	15665	echo "$as_me:15666: \$? = $ac_status" >&5
15574	15666	if (exit $ac_status) && test -s out/conftest2.$ac_objext
15575	15667	then
15576	15668	# The compiler can only warn and ignore the option if not recognized

15618	15710	-e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
15619	15711	-e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
15620	15712	-e 's:$: $lt_compiler_flag:'`
15621		(eval echo "\"\$as_me:15622: $lt_compile\"" >&5)
	15713	(eval echo "\"\$as_me:15714: $lt_compile\"" >&5)
15622	15714	(eval "$lt_compile" 2>out/conftest.err)
15623	15715	ac_status=$?
15624	15716	cat out/conftest.err >&5
15625		echo "$as_me:15626: \$? = $ac_status" >&5
	15717	echo "$as_me:15718: \$? = $ac_status" >&5
15626	15718	if (exit $ac_status) && test -s out/conftest2.$ac_objext
15627	15719	then
15628	15720	# The compiler can only warn and ignore the option if not recognized

17196	17288	# report actual input values of CONFIG_FILES etc. instead of their
17197	17289	# values after options handling.
17198	17290	ac_log="
17199		This file was extended by Telepathy-GLib $as_me 0.13.17, which was
	17291	This file was extended by Telepathy-GLib $as_me 0.14.1, which was
17200	17292	generated by GNU Autoconf 2.67. Invocation command line was
17201	17293
17202	17294	CONFIG_FILES = $CONFIG_FILES

17262	17354	cat >>$CONFIG_STATUS <<_ACEOF \|\| ac_write_fail=1
17263	17355	ac_cs_config="`$as_echo "$ac_configure_args" \| sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
17264	17356	ac_cs_version="\\
17265		Telepathy-GLib config.status 0.13.17
	17357	Telepathy-GLib config.status 0.14.1
17266	17358	configured by $0, generated by GNU Autoconf 2.67,
17267	17359	with options \\"\$ac_cs_config\\"
17268	17360

+18

-2

configure.ac less more

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

92	92	[missing-field-initializers \
93	93	unused-parameter])
94	94	AC_SUBST([ERROR_CFLAGS])
	95
	96	# these aren't really error flags but they serve a similar purpose for us -
	97	# making the toolchain stricter
	98	if test "x$official_release" = xno; then
	99	TP_ADD_LINKER_FLAG([ERROR_LDFLAGS], [-Wl,--no-copy-dt-needed-entries])
	100
	101	# --no-copy-dt-needed-entries is the new name for --no-add-needed which
	102	# is much more widely supported
	103	case "$ERROR_LDFLAGS" in
	104	(-Wl,--no-copy-dt-needed-entries)
	105	;;
	106	(*)
	107	TP_ADD_LINKER_FLAG([ERROR_LDFLAGS], [-Wl,--no-add-needed])
	108	;;
	109	esac
	110	fi
95	111
96	112	AM_CONDITIONAL([OFFICIAL_RELEASE], [test "x$official_release" = xyes])
97	113

+1

-1

docs/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

+1

-1

docs/reference/Makefile.in less more

57	57	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
58	58	$(top_srcdir)/m4/tp-compiler-flag.m4 \
59	59	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
60		$(top_srcdir)/configure.ac
	60	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
61	61	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
62	62	$(ACLOCAL_M4)
63	63	mkinstalldirs = $(install_sh) -d

+132

-59

docs/reference/html/TpBaseChannel.html less more

70	70	<pre class="synopsis">
71	71	<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
72	72	+----TpBaseChannel
73		+----TpBasePasswordChannel
	73	+----<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>
74	74	</pre>
75	75	</div>
76	76	<div class="refsect1" title="Implemented Interfaces">

210	210	</p>
211	211	<p>
212	212	</p>
213		<div class="informalexample"><pre class="programlisting">
214		static void
215		my_search_channel_fill_properties (
216		TpBaseChannel *chan,
217		GHashTable *properties)
218		{
219		TpBaseChannelClass *klass = TP_BASE_CHANNEL_CLASS (my_search_channel_parent_class);
220
221		klass->fill_immutable_properties (chan, properties);
222
223		tp_dbus_properties_mixin_fill_properties_hash (
224		G_OBJECT (chan), properties,
225		TP_IFACE_CHANNEL_TYPE_CONTACT_SEARCH, "Limit",
226		TP_IFACE_CHANNEL_TYPE_CONTACT_SEARCH, "AvailableSearchKeys",
227		TP_IFACE_CHANNEL_TYPE_CONTACT_SEARCH, "Server",
228		NULL);
229		}
230		</pre></div>
	213	<div class="informalexample">
	214	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	215	<tbody>
	216	<tr>
	217	<td class="listing_lines" align="right"><pre>1
	218	2
	219	3
	220	4
	221	5
	222	6
	223	7
	224	8
	225	9
	226	10
	227	11
	228	12
	229	13
	230	14
	231	15
	232	16</pre></td>
	233	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	234	<span class="function">my_search_channel_fill_properties</span> <span class="symbol">(</span>
	235	TpBaseChannel <span class="symbol">*</span>chan<span class="symbol">,</span>
	236	GHashTable <span class="symbol">*</span>properties<span class="symbol">)</span>
	237	<span class="symbol">{</span>
	238	TpBaseChannelClass <span class="symbol">*</span>klass <span class="symbol">=</span> <span class="function">TP_BASE_CHANNEL_CLASS</span> <span class="symbol">(</span>my_search_channel_parent_class<span class="symbol">);</span>
	239
	240	klass<span class="symbol">-></span><span class="function">fill_immutable_properties</span> <span class="symbol">(</span>chan<span class="symbol">,</span> properties<span class="symbol">);</span>
	241
	242	<span class="function"><a href="telepathy-glib-dbus-properties-mixin.html#tp-dbus-properties-mixin-fill-properties-hash">tp_dbus_properties_mixin_fill_properties_hash</a></span> <span class="symbol">(</span>
	243	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span> <span class="symbol">(</span>chan<span class="symbol">),</span> properties<span class="symbol">,</span>
	244	TP_IFACE_CHANNEL_TYPE_CONTACT_SEARCH<span class="symbol">,</span> <span class="string">"Limit"</span><span class="symbol">,</span>
	245	TP_IFACE_CHANNEL_TYPE_CONTACT_SEARCH<span class="symbol">,</span> <span class="string">"AvailableSearchKeys"</span><span class="symbol">,</span>
	246	TP_IFACE_CHANNEL_TYPE_CONTACT_SEARCH<span class="symbol">,</span> <span class="string">"Server"</span><span class="symbol">,</span>
	247	NULL<span class="symbol">);</span>
	248	<span class="symbol">}</span></pre></td>
	249	</tr>
	250	</tbody>
	251	</table>
	252	</div>
	253
231	254	<p>
232	255	</p>
233	256	<p>

276	299	</p>
277	300	<p>
278	301	</p>
279		<div class="informalexample"><pre class="programlisting">
280		static void
281		my_channel_close (TpBaseChannel *chan)
282		{
283		MyChannel *self = MY_CHANNEL (chan);
284
285		if (self->priv->closing)
286		return;
287
288		self->priv->closing = TRUE;
289
290		// some hypothetical channel-specific clean-up function:
291		clean_up (self, cleaned_up_cb);
292		}
293
294		static void
295		cleaned_up_cb (MyChannel *self)
296		{
297		// all done, we can finish closing now
298		tp_base_channel_destroyed (TP_BASE_CHANNEL (self));
299		}
300		static void
301		my_channel_class_init (MyChannelClass *klass)
302		{
303		TpBaseChannelClass *base_channel_class = TP_BASE_CHANNEL_CLASS (klass);
304
305		klass->close = my_channel_close;
306		// ...
307		}
308		</pre></div>
	302	<div class="informalexample">
	303	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	304	<tbody>
	305	<tr>
	306	<td class="listing_lines" align="right"><pre>1
	307	2
	308	3
	309	4
	310	5
	311	6
	312	7
	313	8
	314	9
	315	10
	316	11
	317	12
	318	13
	319	14
	320	15
	321	16
	322	17
	323	18
	324	19
	325	20
	326	21
	327	22
	328	23
	329	24
	330	25
	331	26
	332	27
	333	28</pre></td>
	334	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	335	<span class="function">my_channel_close</span> <span class="symbol">(</span>TpBaseChannel <span class="symbol">*</span>chan<span class="symbol">)</span>
	336	<span class="symbol">{</span>
	337	MyChannel <span class="symbol">*</span>self <span class="symbol">=</span> <span class="function">MY_CHANNEL</span> <span class="symbol">(</span>chan<span class="symbol">);</span>
	338
	339	<span class="keyword">if</span> <span class="symbol">(</span>self<span class="symbol">-></span>priv<span class="symbol">-></span>closing<span class="symbol">)</span>
	340	<span class="keyword">return</span><span class="symbol">;</span>
	341
	342	self<span class="symbol">-></span>priv<span class="symbol">-></span>closing <span class="symbol">=</span> TRUE<span class="symbol">;</span>
	343
	344	<span class="gtkdoc slc">// some hypothetical channel-specific clean-up function:</span>
	345	<span class="function">clean_up</span> <span class="symbol">(</span>self<span class="symbol">,</span> cleaned_up_cb<span class="symbol">);</span>
	346	<span class="symbol">}</span>
	347
	348	<span class="gtkdoc kwb">static void</span>
	349	<span class="function">cleaned_up_cb</span> <span class="symbol">(</span>MyChannel <span class="symbol">*</span>self<span class="symbol">)</span>
	350	<span class="symbol">{</span>
	351	<span class="gtkdoc slc">// all done, we can finish closing now</span>
	352	<span class="function"><a href="TpBaseChannel.html#tp-base-channel-destroyed">tp_base_channel_destroyed</a></span> <span class="symbol">(</span><span class="function">TP_BASE_CHANNEL</span> <span class="symbol">(</span>self<span class="symbol">));</span>
	353	<span class="symbol">}</span>
	354	<span class="gtkdoc kwb">static void</span>
	355	<span class="function">my_channel_class_init</span> <span class="symbol">(</span>MyChannelClass <span class="symbol">*</span>klass<span class="symbol">)</span>
	356	<span class="symbol">{</span>
	357	TpBaseChannelClass <span class="symbol">*</span>base_channel_class <span class="symbol">=</span> <span class="function">TP_BASE_CHANNEL_CLASS</span> <span class="symbol">(</span>klass<span class="symbol">);</span>
	358
	359	klass<span class="symbol">-></span>close <span class="symbol">=</span> my_channel_close<span class="symbol">;</span>
	360	<span class="gtkdoc slc">// ...</span>
	361	<span class="symbol">}</span></pre></td>
	362	</tr>
	363	</tbody>
	364	</table>
	365	</div>
	366
309	367	<p>
310	368	</p>
311	369	<p>

315	373	</p>
316	374	<p>
317	375	</p>
318		<div class="informalexample"><pre class="programlisting">
319		static void
320		my_channel_class_init (MyChannelClass *klass)
321		{
322		TpBaseChannelClass *base_channel_class = TP_BASE_CHANNEL_CLASS (klass);
323
324		klass->close = tp_base_channel_destroyed;
325		// ...
326		}
327		</pre></div>
	376	<div class="informalexample">
	377	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	378	<tbody>
	379	<tr>
	380	<td class="listing_lines" align="right"><pre>1
	381	2
	382	3
	383	4
	384	5
	385	6
	386	7
	387	8</pre></td>
	388	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	389	<span class="function">my_channel_class_init</span> <span class="symbol">(</span>MyChannelClass <span class="symbol">*</span>klass<span class="symbol">)</span>
	390	<span class="symbol">{</span>
	391	TpBaseChannelClass <span class="symbol">*</span>base_channel_class <span class="symbol">=</span> <span class="function">TP_BASE_CHANNEL_CLASS</span> <span class="symbol">(</span>klass<span class="symbol">);</span>
	392
	393	klass<span class="symbol">-></span>close <span class="symbol">=</span> tp_base_channel_destroyed<span class="symbol">;</span>
	394	<span class="gtkdoc slc">// ...</span>
	395	<span class="symbol">}</span></pre></td>
	396	</tr>
	397	</tbody>
	398	</table>
	399	</div>
	400
328	401	<p>
329	402	</p>
330	403	<div class="variablelist"><table border="0">

+52

-20

docs/reference/html/TpBaseConnection.html less more

1072	1072	</p>
1073	1073	<p>
1074	1074	</p>
1075		<div class="informalexample"><pre class="programlisting">
1076		TpChannelManagerIter iter;
1077		TpChannelManager *manager;
1078
1079		tp_base_connection_channel_manager_iter_init (&iter, base_conn);
1080		while (tp_base_connection_channel_manager_iter_next (&iter, &manager))
1081		{
1082		...do something with manager...
1083		}
1084		</pre></div>
	1075	<div class="informalexample">
	1076	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	1077	<tbody>
	1078	<tr>
	1079	<td class="listing_lines" align="right"><pre>1
	1080	2
	1081	3
	1082	4
	1083	5
	1084	6
	1085	7
	1086	8</pre></td>
	1087	<td class="listing_code"><pre class="programlisting">TpChannelManagerIter iter<span class="symbol">;</span>
	1088	TpChannelManager <span class="symbol">*</span>manager<span class="symbol">;</span>
	1089
	1090	<span class="function"><a href="TpBaseConnection.html#tp-base-connection-channel-manager-iter-init">tp_base_connection_channel_manager_iter_init</a></span> <span class="symbol">(&</span>iter<span class="symbol">,</span> base_conn<span class="symbol">);</span>
	1091	<span class="keyword">while</span> <span class="symbol">(</span><span class="function"><a href="TpBaseConnection.html#tp-base-connection-channel-manager-iter-next">tp_base_connection_channel_manager_iter_next</a></span> <span class="symbol">(&</span>iter<span class="symbol">, &</span>manager<span class="symbol">))</span>
	1092	<span class="symbol">{</span>
	1093	<span class="symbol">...</span><span class="keyword">do</span> something with manager<span class="symbol">...</span>
	1094	<span class="symbol">}</span></pre></td>
	1095	</tr>
	1096	</tbody>
	1097	</table>
	1098	</div>
	1099
1085	1100	<p>
1086	1101	</p>
1087	1102	<div class="variablelist"><table border="0">

1217	1232	<a name="TpBaseConnection.signal-details"></a><h2>Signal Details</h2>
1218	1233	<div class="refsect2" title='The "clients-interested" signal'>
1219	1234	<a name="TpBaseConnection-clients-interested"></a><h3>The <code class="literal">"clients-interested"</code> signal</h3>
1220		<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *token,
1221		<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg1,
1222		<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
	1235	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection,
	1236	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *token,
	1237	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
1223	1238	<p>
1224	1239	Emitted when a client becomes interested in any token that was added with
1225	1240	<a class="link" href="TpBaseConnection.html#tp-base-connection-add-possible-client-interest" title="tp_base_connection_add_possible_client_interest ()"><code class="function">tp_base_connection_add_possible_client_interest()</code></a>.

1235	1250	<col align="left" valign="top">
1236	1251	<tbody>
1237	1252	<tr>
	1253	<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
	1254	<td>the <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a>
	1255	</td>
	1256	</tr>
	1257	<tr>
1238	1258	<td><p><span class="term"><em class="parameter"><code>token</code></em> :</span></p></td>
1239	1259	<td>the interface or part of an interface in which clients are newly
1240	1260	interested

1250	1270	<hr>
1251	1271	<div class="refsect2" title='The "clients-uninterested" signal'>
1252	1272	<a name="TpBaseConnection-clients-uninterested"></a><h3>The <code class="literal">"clients-uninterested"</code> signal</h3>
1253		<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *token,
1254		<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg1,
1255		<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
	1273	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection,
	1274	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *token,
	1275	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
1256	1276	<p>
1257	1277	Emitted when no more clients are interested in an interface added with
1258	1278	<a class="link" href="TpBaseConnection.html#tp-base-connection-add-possible-client-interest" title="tp_base_connection_add_possible_client_interest ()"><code class="function">tp_base_connection_add_possible_client_interest()</code></a>, for which

1269	1289	<col align="left" valign="top">
1270	1290	<tbody>
1271	1291	<tr>
	1292	<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
	1293	<td>the <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a>
	1294	</td>
	1295	</tr>
	1296	<tr>
1272	1297	<td><p><span class="term"><em class="parameter"><code>token</code></em> :</span></p></td>
1273	1298	<td>the interface or part of an interface in which clients are no
1274	1299	longer interested

1284	1309	<hr>
1285	1310	<div class="refsect2" title='The "shutdown-finished" signal'>
1286	1311	<a name="TpBaseConnection-shutdown-finished"></a><h3>The <code class="literal">"shutdown-finished"</code> signal</h3>
1287		<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *arg0,
1288		<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
	1312	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection,
	1313	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
1289	1314	<p>
1290	1315	Emitted by <a class="link" href="TpBaseConnection.html#tp-base-connection-finish-shutdown" title="tp_base_connection_finish_shutdown ()"><code class="function">tp_base_connection_finish_shutdown()</code></a> when the underlying
1291	1316	network connection has been closed; <a class="link" href="TpBaseConnectionManager.html" title="TpBaseConnectionManager"><span class="type">TpBaseConnectionManager</span></a> listens

1294	1319	</p>
1295	1320	<div class="variablelist"><table border="0">
1296	1321	<col align="left" valign="top">
1297		<tbody><tr>
	1322	<tbody>
	1323	<tr>
	1324	<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
	1325	<td>the <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a>
	1326	</td>
	1327	</tr>
	1328	<tr>
1298	1329	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1299	1330	<td>user data set when the signal handler was connected.</td>
1300		</tr></tbody>
	1331	</tr>
	1332	</tbody>
1301	1333	</table></div>
1302	1334	</div>
1303	1335	</div>

+2

-2

docs/reference/html/TpCMMessage.html less more

6	6	<link rel="home" href="index.html" title="telepathy-glib API Reference Manual">
7	7	<link rel="up" href="ch-service-base.html" title="Service-side implementation">
8	8	<link rel="prev" href="TpMessage.html" title="TpMessage">
9		<link rel="next" href="telepathy-glib-simple-password-manager.html" title="TpSimplePasswordManager">
	9	<link rel="next" href="telepathy-glib-base-password-channel.html" title="TpBasePasswordChannel">
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-service-base.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 API Reference Manual</th>
20		<td><a accesskey="n" href="telepathy-glib-simple-password-manager.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
	20	<td><a accesskey="n" href="telepathy-glib-base-password-channel.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="#TpCMMessage.synopsis" class="shortcut">Top</a>

+1

-1

docs/reference/html/TpChannelIface.html less more

62	62	<a name="TpChannelIface.implementations"></a><h2>Known Implementations</h2>
63	63	<p>
64	64	TpChannelIface is implemented by
65		<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a>, TpBasePasswordChannel, <a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a>, <a class="link" href="telepathy-glib-stream-tube-channel.html#TpStreamTubeChannel">TpStreamTubeChannel</a> and <a class="link" href="telepathy-glib-text-channel.html#TpTextChannel">TpTextChannel</a>.</p>
	65	<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a>, <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>, <a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a>, <a class="link" href="telepathy-glib-stream-tube-channel.html#TpStreamTubeChannel">TpStreamTubeChannel</a> and <a class="link" href="telepathy-glib-text-channel.html#TpTextChannel">TpTextChannel</a>.</p>
66	66	</div>
67	67	<div class="refsect1" title="Properties">
68	68	<a name="TpChannelIface.properties"></a><h2>Properties</h2>

+48

-22

docs/reference/html/TpExportableChannel.html less more

71	71	<a name="TpExportableChannel.implementations"></a><h2>Known Implementations</h2>
72	72	<p>
73	73	TpExportableChannel is implemented by
74		<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a> and TpBasePasswordChannel.</p>
	74	<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a> and <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>.</p>
75	75	</div>
76	76	<div class="refsect1" title="Properties">
77	77	<a name="TpExportableChannel.properties"></a><h2>Properties</h2>

185	185	</p>
186	186	<p>
187	187	</p>
188		<div class="informalexample"><pre class="programlisting">
189		case PROP_CHANNEL_PROPERTIES:
190		g_value_take_boxed (value,
191		tp_dbus_properties_mixin_make_properties_hash (object,
192		// The spec says these properties MUST be included:
193		TP_IFACE_CHANNEL, "TargetHandle",
194		TP_IFACE_CHANNEL, "TargetHandleType",
195		TP_IFACE_CHANNEL, "ChannelType",
196		TP_IFACE_CHANNEL, "TargetID",
197		TP_IFACE_CHANNEL, "Requested",
198		// These aren't mandatory as of spec 0.17.17
199		// (but they should be):
200		TP_IFACE_CHANNEL, "InitiatorHandle",
201		TP_IFACE_CHANNEL, "InitiatorID",
202		TP_IFACE_CHANNEL, "Interfaces",
203		// Perhaps your channel has some other immutable properties:
204		TP_IFACE_CHANNEL_INTERFACE_MESSAGES, "SupportedContentTypes",
205		// etc.
206		NULL));
207		break;
208		</pre></div>
	188	<div class="informalexample">
	189	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	190	<tbody>
	191	<tr>
	192	<td class="listing_lines" align="right"><pre>1
	193	2
	194	3
	195	4
	196	5
	197	6
	198	7
	199	8
	200	9
	201	10
	202	11
	203	12
	204	13
	205	14
	206	15
	207	16
	208	17
	209	18
	210	19</pre></td>
	211	<td class="listing_code"><pre class="programlisting"><span class="keyword">case</span> PROP_CHANNEL_PROPERTIES<span class="symbol">:</span>
	212	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Standard-Parameter-and-Value-Types.html#g-value-take-boxed">g_value_take_boxed</a></span> <span class="symbol">(</span>value<span class="symbol">,</span>
	213	<span class="function"><a href="telepathy-glib-dbus-properties-mixin.html#tp-dbus-properties-mixin-make-properties-hash">tp_dbus_properties_mixin_make_properties_hash</a></span> <span class="symbol">(</span>object<span class="symbol">,</span>
	214	<span class="gtkdoc slc">// The spec says these properties MUST be included:</span>
	215	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"TargetHandle"</span><span class="symbol">,</span>
	216	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"TargetHandleType"</span><span class="symbol">,</span>
	217	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"ChannelType"</span><span class="symbol">,</span>
	218	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"TargetID"</span><span class="symbol">,</span>
	219	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"Requested"</span><span class="symbol">,</span>
	220	<span class="gtkdoc slc">// These aren't mandatory as of spec 0.17.17</span>
	221	<span class="gtkdoc slc">// (but they should be):</span>
	222	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"InitiatorHandle"</span><span class="symbol">,</span>
	223	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"InitiatorID"</span><span class="symbol">,</span>
	224	TP_IFACE_CHANNEL<span class="symbol">,</span> <span class="string">"Interfaces"</span><span class="symbol">,</span>
	225	<span class="gtkdoc slc">// Perhaps your channel has some other immutable properties:</span>
	226	TP_IFACE_CHANNEL_INTERFACE_MESSAGES<span class="symbol">,</span> <span class="string">"SupportedContentTypes"</span><span class="symbol">,</span>
	227	<span class="gtkdoc slc">// etc.</span>
	228	NULL<span class="symbol">));</span>
	229	<span class="keyword">break</span><span class="symbol">;</span></pre></td>
	230	</tr>
	231	</tbody>
	232	</table>
	233	</div>
	234
209	235	<p>
210	236	</p>
211	237	</div>

+3

-1

docs/reference/html/ch-service-base.html less more

76	76	<span class="refentrytitle"><a href="TpCMMessage.html">TpCMMessage</a></span><span class="refpurpose"> — a message in the Telepathy message interface, CM side</span>
77	77	</dt>
78	78	<dt>
	79	<span class="refentrytitle"><a href="telepathy-glib-base-password-channel.html">TpBasePasswordChannel</a></span><span class="refpurpose"> — a simple X-TELEPATHY-PASSWORD channel</span>
	80	</dt>
	81	<dt>
79	82	<span class="refentrytitle"><a href="telepathy-glib-simple-password-manager.html">TpSimplePasswordManager</a></span><span class="refpurpose"> — a simple X-TELEPATHY-PASSWORD channel manager</span>
80	83	</dt>
81	84	<dt>

106	109	<span class="refentrytitle"><a href="telepathy-glib-dtmf.html">DTMF dialstring interpreter</a></span><span class="refpurpose"> — Converts a dialstring into a timed sequence of events</span>
107	110	</dt>
108	111	</dl></div>
109		<span style="color: red"><xi:include></xi:include></span>
110	112	</div>
111	113	<div class="footer">
112	114	<hr>

+4

-1

docs/reference/html/index.html less more

14	14	<div>
15	15	<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">telepathy-glib API Reference Manual</p></th></tr></table></div>
16	16	<div><p class="releaseinfo">
17		This manual documents telepathy-glib version 0.13.17
	17	This manual documents telepathy-glib version 0.14.1
18	18	.
19	19	The latest development version of this documentation can be found here:
20	20	<a class="ulink" href="http://telepathy.freedesktop.org/doc/telepathy-glib/" target="_top">online copy of the telepathy-glib API Reference Manual</a>.

385	385	<span class="refentrytitle"><a href="TpCMMessage.html">TpCMMessage</a></span><span class="refpurpose"> — a message in the Telepathy message interface, CM side</span>
386	386	</dt>
387	387	<dt>
	388	<span class="refentrytitle"><a href="telepathy-glib-base-password-channel.html">TpBasePasswordChannel</a></span><span class="refpurpose"> — a simple X-TELEPATHY-PASSWORD channel</span>
	389	</dt>
	390	<dt>
388	391	<span class="refentrytitle"><a href="telepathy-glib-simple-password-manager.html">TpSimplePasswordManager</a></span><span class="refpurpose"> — a simple X-TELEPATHY-PASSWORD channel manager</span>
389	392	</dt>
390	393	<dt>

+56

-0

docs/reference/html/index.sgml less more

328	328	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-GROUPS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-GROUPS:CAPS">
329	329	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-POWER-SAVING:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-POWER-SAVING:CAPS">
330	330	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-POWER-SAVING:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-POWER-SAVING:CAPS">
	331	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS">
	332	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS">
331	333	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS">
332	334	<ANCHOR id="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-INFO:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-INFO:CAPS">
333	335	<ANCHOR id="TP-IFACE-CONNECTION-INTERFACE-CONTACT-LIST:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-LIST:CAPS">

546	548	<ANCHOR id="TP-PROP-CHANNEL-TYPE-FILE-TRANSFER-URI:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-FILE-TRANSFER-URI:CAPS">
547	549	<ANCHOR id="TP-PROP-CHANNEL-TYPE-ROOM-LIST-SERVER:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-ROOM-LIST-SERVER:CAPS">
548	550	<ANCHOR id="TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-HOSTNAME:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-HOSTNAME:CAPS">
	551	<ANCHOR id="TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-REFERENCE-IDENTITIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-REFERENCE-IDENTITIES:CAPS">
549	552	<ANCHOR id="TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-SERVER-CERTIFICATE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-SERVER-CERTIFICATE:CAPS">
550	553	<ANCHOR id="TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-IMMUTABLE-STREAMS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-IMMUTABLE-STREAMS:CAPS">
551	554	<ANCHOR id="TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-INITIAL-AUDIO:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-INITIAL-AUDIO:CAPS">

581	584	<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">
582	585	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CELLULAR-OVERRIDE-MESSAGE-SERVICE-CENTRE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-OVERRIDE-MESSAGE-SERVICE-CENTRE:CAPS">
583	586	<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">
	587	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACT-BLOCKING-CONTACT-BLOCKING-CAPABILITIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-BLOCKING-CONTACT-BLOCKING-CAPABILITIES:CAPS">
584	588	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-DISJOINT-GROUPS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-DISJOINT-GROUPS:CAPS">
585	589	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS">
586	590	<ANCHOR id="TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUP-STORAGE:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUP-STORAGE:CAPS">

634	638	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-AVATARS-TOKEN:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-AVATARS-TOKEN:CAPS">
635	639	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-CAPABILITIES-CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CAPABILITIES-CAPS">
636	640	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-CLIENT-TYPES-CLIENT-TYPES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CLIENT-TYPES-CLIENT-TYPES:CAPS">
	641	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-CONTACT-BLOCKING-BLOCKED:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-BLOCKING-BLOCKED:CAPS">
637	642	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-CONTACT-CAPABILITIES-CAPABILITIES:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-CAPABILITIES-CAPABILITIES:CAPS">
638	643	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS">
639	644	<ANCHOR id="TP-TOKEN-CONNECTION-INTERFACE-CONTACT-INFO-INFO:CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-INFO-INFO:CAPS">

805	810	<ANCHOR id="NUM-TP-CHANNEL-GROUP-CHANGE-REASONS:CAPS" href="telepathy-glib/telepathy-glib-enums.html#NUM-TP-CHANNEL-GROUP-CHANGE-REASONS:CAPS">
806	811	<ANCHOR id="TpChannelPasswordFlags" href="telepathy-glib/telepathy-glib-enums.html#TpChannelPasswordFlags">
807	812	<ANCHOR id="TP-CHANNEL-PASSWORD-FLAG-PROVIDE:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-CHANNEL-PASSWORD-FLAG-PROVIDE:CAPS">
	813	<ANCHOR id="TpContactBlockingCapabilities" href="telepathy-glib/telepathy-glib-enums.html#TpContactBlockingCapabilities">
	814	<ANCHOR id="TP-CONTACT-BLOCKING-CAPABILITY-CAN-REPORT-ABUSIVE:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-CONTACT-BLOCKING-CAPABILITY-CAN-REPORT-ABUSIVE:CAPS">
808	815	<ANCHOR id="TpDeliveryReportingSupportFlags" href="telepathy-glib/telepathy-glib-enums.html#TpDeliveryReportingSupportFlags">
809	816	<ANCHOR id="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-FAILURES:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-FAILURES:CAPS">
810	817	<ANCHOR id="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-SUCCESSES:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-SUCCESSES:CAPS">

1706	1713	<ANCHOR id="telepathy-glib-connection-contact-list.synopsis" href="telepathy-glib/telepathy-glib-connection-contact-list.html#telepathy-glib-connection-contact-list.synopsis">
1707	1714	<ANCHOR id="telepathy-glib-connection-contact-list.description" href="telepathy-glib/telepathy-glib-connection-contact-list.html#telepathy-glib-connection-contact-list.description">
1708	1715	<ANCHOR id="telepathy-glib-connection-contact-list.details" href="telepathy-glib/telepathy-glib-connection-contact-list.html#telepathy-glib-connection-contact-list.details">
	1716	<ANCHOR id="tp-cli-connection-interface-contact-blocking-call-block-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-block-contacts">
	1717	<ANCHOR id="tp-cli-connection-interface-contact-blocking-call-request-blocked-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-request-blocked-contacts">
	1718	<ANCHOR id="tp-cli-connection-interface-contact-blocking-call-unblock-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-unblock-contacts">
	1719	<ANCHOR id="tp-cli-connection-interface-contact-blocking-callback-for-block-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-block-contacts">
	1720	<ANCHOR id="tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts">
	1721	<ANCHOR id="tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts">
	1722	<ANCHOR id="tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed">
	1723	<ANCHOR id="tp-cli-connection-interface-contact-blocking-run-block-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-block-contacts">
	1724	<ANCHOR id="tp-cli-connection-interface-contact-blocking-run-request-blocked-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-request-blocked-contacts">
	1725	<ANCHOR id="tp-cli-connection-interface-contact-blocking-run-unblock-contacts" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-unblock-contacts">
	1726	<ANCHOR id="tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed">
1709	1727	<ANCHOR id="tp-cli-connection-interface-contact-groups-call-add-to-group" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-add-to-group">
1710	1728	<ANCHOR id="tp-cli-connection-interface-contact-groups-call-remove-from-group" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-remove-from-group">
1711	1729	<ANCHOR id="tp-cli-connection-interface-contact-groups-call-remove-group" href="telepathy-glib/telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-remove-group">

3364	3382	<ANCHOR id="TpSvcConnectionInterfaceContactCapabilities" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities">
3365	3383	<ANCHOR id="TpSvcConnectionInterfaceLocation" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation">
3366	3384	<ANCHOR id="TpSvcConnectionInterfaceContactInfo" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo">
	3385	<ANCHOR id="TpSvcConnectionInterfaceContactBlocking" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking">
3367	3386	<ANCHOR id="TpSvcConnectionInterfaceContactGroups" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups">
3368	3387	<ANCHOR id="TpSvcConnectionInterfaceContactList" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactList">
3369	3388	<ANCHOR id="TpSvcConnectionInterfaceCellular" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceCellular">

3562	3581	<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">
3563	3582	<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">
3564	3583	<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">
	3584	<ANCHOR id="TpSvcConnectionInterfaceContactBlocking-struct" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-struct">
	3585	<ANCHOR id="TpSvcConnectionInterfaceContactBlockingClass" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass">
	3586	<ANCHOR id="tp-svc-connection-interface-contact-blocking-block-contacts-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-block-contacts-impl">
	3587	<ANCHOR id="tp-svc-connection-interface-contact-blocking-emit-blocked-contacts-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-emit-blocked-contacts-changed">
	3588	<ANCHOR id="tp-svc-connection-interface-contact-blocking-implement-block-contacts" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-block-contacts">
	3589	<ANCHOR id="tp-svc-connection-interface-contact-blocking-implement-request-blocked-contacts" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-request-blocked-contacts">
	3590	<ANCHOR id="tp-svc-connection-interface-contact-blocking-implement-unblock-contacts" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-unblock-contacts">
	3591	<ANCHOR id="tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl">
	3592	<ANCHOR id="tp-svc-connection-interface-contact-blocking-return-from-block-contacts" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-block-contacts">
	3593	<ANCHOR id="tp-svc-connection-interface-contact-blocking-return-from-request-blocked-contacts" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-request-blocked-contacts">
	3594	<ANCHOR id="tp-svc-connection-interface-contact-blocking-return-from-unblock-contacts" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-unblock-contacts">
	3595	<ANCHOR id="tp-svc-connection-interface-contact-blocking-unblock-contacts-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-unblock-contacts-impl">
3565	3596	<ANCHOR id="TpSvcConnectionInterfaceContactGroups-struct" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-struct">
3566	3597	<ANCHOR id="TpSvcConnectionInterfaceContactGroupsClass" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroupsClass">
3567	3598	<ANCHOR id="tp-svc-connection-interface-contact-groups-add-to-group-impl" href="telepathy-glib/telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-groups-add-to-group-impl">

3654	3685	<ANCHOR id="TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed">
3655	3686	<ANCHOR id="TpSvcConnectionInterfaceLocation-location-updated" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated">
3656	3687	<ANCHOR id="TpSvcConnectionInterfaceContactInfo-contact-info-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed">
	3688	<ANCHOR id="TpSvcConnectionInterfaceContactBlocking-blocked-contacts-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-blocked-contacts-changed">
3657	3689	<ANCHOR id="TpSvcConnectionInterfaceContactGroups-group-renamed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-group-renamed">
3658	3690	<ANCHOR id="TpSvcConnectionInterfaceContactGroups-groups-changed" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-changed">
3659	3691	<ANCHOR id="TpSvcConnectionInterfaceContactGroups-groups-created" href="telepathy-glib/telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-created">

4514	4546	<ANCHOR id="tp-cm-message-take-message" href="telepathy-glib/TpCMMessage.html#tp-cm-message-take-message">
4515	4547	<ANCHOR id="tp-cm-message-get-sender" href="telepathy-glib/TpCMMessage.html#tp-cm-message-get-sender">
4516	4548	<ANCHOR id="tp-cm-message-set-sender" href="telepathy-glib/TpCMMessage.html#tp-cm-message-set-sender">
	4549	<ANCHOR id="telepathy-glib-base-password-channel" href="telepathy-glib/telepathy-glib-base-password-channel.html">
	4550	<ANCHOR id="telepathy-glib-base-password-channel.synopsis" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.synopsis">
	4551	<ANCHOR id="TpBasePasswordChannel" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel">
	4552	<ANCHOR id="telepathy-glib-base-password-channel.object-hierarchy" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.object-hierarchy">
	4553	<ANCHOR id="telepathy-glib-base-password-channel.implemented-interfaces" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.implemented-interfaces">
	4554	<ANCHOR id="telepathy-glib-base-password-channel.properties" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.properties">
	4555	<ANCHOR id="telepathy-glib-base-password-channel.signals" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.signals">
	4556	<ANCHOR id="telepathy-glib-base-password-channel.description" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.description">
	4557	<ANCHOR id="telepathy-glib-base-password-channel.details" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.details">
	4558	<ANCHOR id="TpBasePasswordChannel-struct" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel-struct">
	4559	<ANCHOR id="telepathy-glib-base-password-channel.property-details" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.property-details">
	4560	<ANCHOR id="TpBasePasswordChannel--authentication-method" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authentication-method">
	4561	<ANCHOR id="TpBasePasswordChannel--authorization-identity" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authorization-identity">
	4562	<ANCHOR id="TpBasePasswordChannel--available-mechanisms" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--available-mechanisms">
	4563	<ANCHOR id="TpBasePasswordChannel--can-try-again" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--can-try-again">
	4564	<ANCHOR id="TpBasePasswordChannel--default-realm" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-realm">
	4565	<ANCHOR id="TpBasePasswordChannel--default-username" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-username">
	4566	<ANCHOR id="TpBasePasswordChannel--has-initial-data" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--has-initial-data">
	4567	<ANCHOR id="TpBasePasswordChannel--may-save-response" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--may-save-response">
	4568	<ANCHOR id="TpBasePasswordChannel--sasl-error" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error">
	4569	<ANCHOR id="TpBasePasswordChannel--sasl-error-details" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error-details">
	4570	<ANCHOR id="TpBasePasswordChannel--sasl-status" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-status">
	4571	<ANCHOR id="telepathy-glib-base-password-channel.signal-details" href="telepathy-glib/telepathy-glib-base-password-channel.html#telepathy-glib-base-password-channel.signal-details">
	4572	<ANCHOR id="TpBasePasswordChannel-finished" href="telepathy-glib/telepathy-glib-base-password-channel.html#TpBasePasswordChannel-finished">
4517	4573	<ANCHOR id="telepathy-glib-simple-password-manager" href="telepathy-glib/telepathy-glib-simple-password-manager.html">
4518	4574	<ANCHOR id="telepathy-glib-simple-password-manager.synopsis" href="telepathy-glib/telepathy-glib-simple-password-manager.html#telepathy-glib-simple-password-manager.synopsis">
4519	4575	<ANCHOR id="TpSimplePasswordManager" href="telepathy-glib/telepathy-glib-simple-password-manager.html#TpSimplePasswordManager">

+26

-8

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

170	170	</p>
171	171	<p>
172	172	</p>
173		<div class="informalexample"><pre class="programlisting">
174		tp_contacts_mixin_class_init ((GObjectClass *) klass,
175		G_STRUCT_OFFSET (SomeObjectClass, contacts_mixin));
176		</pre></div>
	173	<div class="informalexample">
	174	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	175	<tbody>
	176	<tr>
	177	<td class="listing_lines" align="right"><pre>1
	178	2</pre></td>
	179	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-class-init">tp_contacts_mixin_class_init</a></span> <span class="symbol">((</span>GObjectClass <span class="symbol">*)</span> klass<span class="symbol">,</span>
	180	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObjectClass<span class="symbol">,</span> contacts_mixin<span class="symbol">));</span></pre></td>
	181	</tr>
	182	</tbody>
	183	</table>
	184	</div>
	185
177	186	<p>
178	187	</p>
179	188	<div class="variablelist"><table border="0">

250	259	</p>
251	260	<p>
252	261	</p>
253		<div class="informalexample"><pre class="programlisting">
254		tp_contacts_mixin_init ((GObject *) self,
255		G_STRUCT_OFFSET (SomeObject, contacts_mixin));
256		</pre></div>
	262	<div class="informalexample">
	263	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	264	<tbody>
	265	<tr>
	266	<td class="listing_lines" align="right"><pre>1
	267	2</pre></td>
	268	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-init">tp_contacts_mixin_init</a></span> <span class="symbol">((</span>GObject <span class="symbol">*)</span> self<span class="symbol">,</span>
	269	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObject<span class="symbol">,</span> contacts_mixin<span class="symbol">));</span></pre></td>
	270	</tr>
	271	</tbody>
	272	</table>
	273	</div>
	274
257	275	<p>
258	276	</p>
259	277	<div class="variablelist"><table border="0">

+67

-26

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

722	722	</p>
723	723	<p>
724	724	</p>
725		<div class="informalexample"><pre class="programlisting">
726		TpIntsetFastIter iter;
727		guint element;
728
729		tp_intset_fast_iter_init (&iter, intset);
730
731		while (tp_intset_fast_iter_next (&iter, &element))
732		{
733		printf ("%u is in the intset\n", element);
734		}
735		</pre></div>
	725	<div class="informalexample">
	726	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	727	<tbody>
	728	<tr>
	729	<td class="listing_lines" align="right"><pre>1
	730	2
	731	3
	732	4
	733	5
	734	6
	735	7
	736	8
	737	9</pre></td>
	738	<td class="listing_code"><pre class="programlisting">TpIntsetFastIter iter<span class="symbol">;</span>
	739	guint element<span class="symbol">;</span>
	740
	741	<span class="function"><a href="telepathy-glib-TpIntset.html#tp-intset-fast-iter-init">tp_intset_fast_iter_init</a></span> <span class="symbol">(&</span>iter<span class="symbol">,</span> intset<span class="symbol">);</span>
	742
	743	<span class="keyword">while</span> <span class="symbol">(</span><span class="function"><a href="telepathy-glib-TpIntset.html#tp-intset-fast-iter-next">tp_intset_fast_iter_next</a></span> <span class="symbol">(&</span>iter<span class="symbol">, &</span>element<span class="symbol">))</span>
	744	<span class="symbol">{</span>
	745	<span class="function">printf</span> <span class="symbol">(</span><span class="string">"%u is in the intset</span><span class="gtkdoc esc">\n</span><span class="string">"</span><span class="symbol">,</span> element<span class="symbol">);</span>
	746	<span class="symbol">}</span></pre></td>
	747	</tr>
	748	</tbody>
	749	</table>
	750	</div>
	751
736	752	<p>
737	753	</p>
738	754	<p class="since">Since 0.11.6</p>

805	821	</p>
806	822	<p>
807	823	</p>
808		<div class="informalexample"><pre class="programlisting">
809		void
810		do_something (const TpIntset *intset)
811		{
812		TpIntsetIter iter = TP_INTSET_ITER_INIT (intset);
813		/* ... do something with iter ... */
814		}
815		</pre></div>
	824	<div class="informalexample">
	825	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	826	<tbody>
	827	<tr>
	828	<td class="listing_lines" align="right"><pre>1
	829	2
	830	3
	831	4
	832	5
	833	6</pre></td>
	834	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>
	835	<span class="function">do_something</span> <span class="symbol">(</span><span class="gtkdoc kwb">const</span> TpIntset <span class="symbol">*</span>intset<span class="symbol">)</span>
	836	<span class="symbol">{</span>
	837	TpIntsetIter iter <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-TpIntset.html#TP-INTSET-ITER-INIT:CAPS">TP_INTSET_ITER_INIT</a></span> <span class="symbol">(</span>intset<span class="symbol">);</span>
	838	<span class="comment">/* ... do something with iter ... */</span>
	839	<span class="symbol">}</span></pre></td>
	840	</tr>
	841	</tbody>
	842	</table>
	843	</div>
	844
816	845	<p>
817	846	</p>
818	847	<p>

903	932	</p>
904	933	<p>
905	934	</p>
906		<div class="informalexample"><pre class="programlisting">
907		TpIntsetIter iter = TP_INTSET_INIT (intset);
908		while (tp_intset_iter_next (&iter))
909		{
910		printf ("%u is in the intset\n", iter.element);
911		}
912		</pre></div>
	935	<div class="informalexample">
	936	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	937	<tbody>
	938	<tr>
	939	<td class="listing_lines" align="right"><pre>1
	940	2
	941	3
	942	4
	943	5</pre></td>
	944	<td class="listing_code"><pre class="programlisting">TpIntsetIter iter <span class="symbol">=</span> <span class="function">TP_INTSET_INIT</span> <span class="symbol">(</span>intset<span class="symbol">);</span>
	945	<span class="keyword">while</span> <span class="symbol">(</span><span class="function"><a href="telepathy-glib-TpIntset.html#tp-intset-iter-next">tp_intset_iter_next</a></span> <span class="symbol">(&</span>iter<span class="symbol">))</span>
	946	<span class="symbol">{</span>
	947	<span class="function">printf</span> <span class="symbol">(</span><span class="string">"%u is in the intset</span><span class="gtkdoc esc">\n</span><span class="string">"</span><span class="symbol">,</span> iter<span class="symbol">.</span>element<span class="symbol">);</span>
	948	<span class="symbol">}</span></pre></td>
	949	</tr>
	950	</tbody>
	951	</table>
	952	</div>
	953
913	954	<p>
914	955	</p>
915	956	<p>

+32

-11

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

99	99	</p>
100	100	<p>
101	101	</p>
102		<div class="informalexample"><pre class="programlisting">
103		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CHANNEL_TYPE_TEXT,
104		tp_message_mixin_text_iface_init);
105		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CHANNEL_INTERFACE_MESSAGES,
106		tp_message_mixin_messages_iface_init);
107		</pre></div>
	102	<div class="informalexample">
	103	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	104	<tbody>
	105	<tr>
	106	<td class="listing_lines" align="right"><pre>1
	107	2
	108	3
	109	4</pre></td>
	110	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	111	tp_message_mixin_text_iface_init<span class="symbol">);</span>
	112	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CHANNEL_INTERFACE_MESSAGES<span class="symbol">,</span>
	113	tp_message_mixin_messages_iface_init<span class="symbol">);</span></pre></td>
	114	</tr>
	115	</tbody>
	116	</table>
	117	</div>
	118
108	119	<p>
109	120	</p>
110	121	<p>

251	262	</p>
252	263	<p>
253	264	</p>
254		<div class="informalexample"><pre class="programlisting">
255		tp_message_mixin_init ((GObject *) self,
256		G_STRUCT_OFFSET (SomeObject, message_mixin),
257		self->connection);
258		</pre></div>
	265	<div class="informalexample">
	266	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	267	<tbody>
	268	<tr>
	269	<td class="listing_lines" align="right"><pre>1
	270	2
	271	3</pre></td>
	272	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpMessageMixin.html#tp-message-mixin-init">tp_message_mixin_init</a></span> <span class="symbol">((</span>GObject <span class="symbol">*)</span> self<span class="symbol">,</span>
	273	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObject<span class="symbol">,</span> message_mixin<span class="symbol">),</span>
	274	self<span class="symbol">-></span>connection<span class="symbol">);</span></pre></td>
	275	</tr>
	276	</tbody>
	277	</table>
	278	</div>
	279
259	280	<p>
260	281	</p>
261	282	<div class="variablelist"><table border="0">

+76

-29

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

105	105	</p>
106	106	<div class="section" title="Implementing SimplePresence">
107	107	<div class="titlepage"><div><div><h2 class="title" style="clear: both">
108		<a name="id1072529"></a>Implementing SimplePresence</h2></div></div></div>
	108	<a name="id1224837"></a>Implementing SimplePresence</h2></div></div></div>
109	109	<p>
110	110	Since 0.7.13 this mixin supports the entire SimplePresence interface.
111	111	You can implement <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceSimplePresence"><span class="type">TpSvcConnectionInterfaceSimplePresence</span></a> as follows:

117	117	<p>pass <a class="link" href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-simple-presence-iface-init" title="tp_presence_mixin_simple_presence_iface_init ()"><code class="function">tp_presence_mixin_simple_presence_iface_init()</code></a> as an
118	118	argument to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS"><code class="function">G_IMPLEMENT_INTERFACE()</code></a>, like so:
119	119	</p>
120		<div class="informalexample"><pre class="programlisting">
121		G_DEFINE_TYPE_WITH_CODE (MyConnection, my_connection,
122		TP_TYPE_BASE_CONNECTION,
123		// ...
124		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION_INTERFACE_SIMPLE_PRESENCE,
125		tp_presence_mixin_simple_presence_iface_init);
126		// ...
127		)
128		</pre></div>
	120	<div class="informalexample">
	121	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	122	<tbody>
	123	<tr>
	124	<td class="listing_lines" align="right"><pre>1
	125	2
	126	3
	127	4
	128	5
	129	6
	130	7</pre></td>
	131	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-DEFINE-TYPE-WITH-CODE:CAPS">G_DEFINE_TYPE_WITH_CODE</a></span> <span class="symbol">(</span>MyConnection<span class="symbol">,</span> my_connection<span class="symbol">,</span>
	132	TP_TYPE_BASE_CONNECTION<span class="symbol">,</span>
	133	<span class="gtkdoc slc">// ...</span>
	134	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION_INTERFACE_SIMPLE_PRESENCE<span class="symbol">,</span>
	135	tp_presence_mixin_simple_presence_iface_init<span class="symbol">);</span>
	136	<span class="gtkdoc slc">// ...</span>
	137	<span class="symbol">)</span></pre></td>
	138	</tr>
	139	</tbody>
	140	</table>
	141	</div>
	142
129	143	</li>
130	144	<li class="listitem"><p>
131	145	call <a class="link" href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-simple-presence-init-dbus-properties" title="tp_presence_mixin_simple_presence_init_dbus_properties ()"><code class="function">tp_presence_mixin_simple_presence_init_dbus_properties()</code></a> in the

143	157	</p>
144	158	<div class="section" title="Implementing old-style Presence">
145	159	<div class="titlepage"><div><div><h2 class="title" style="clear: both">
146		<a name="id1072660"></a>Implementing old-style Presence</h2></div></div></div>
	160	<a name="id1224966"></a>Implementing old-style Presence</h2></div></div></div>
147	161	<p>
148	162	This mixin also supports a large subset of the deprecated Presence
149	163	interface. It does not support protocols where it is possible to set

157	171	example. The presence mixin implements all of the D-Bus methods in the
158	172	Presence interface.
159	173	</p>
160		<div class="informalexample"><pre class="programlisting">
161		G_DEFINE_TYPE_WITH_CODE (MyConnection, my_connection,
162		TP_TYPE_BASE_CONNECTION,
163		// ...
164		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION_INTERFACE_PRESENCE,
165		tp_presence_mixin_iface_init);
166		// ...
167		)
168		</pre></div>
	174	<div class="informalexample">
	175	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	176	<tbody>
	177	<tr>
	178	<td class="listing_lines" align="right"><pre>1
	179	2
	180	3
	181	4
	182	5
	183	6
	184	7</pre></td>
	185	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-DEFINE-TYPE-WITH-CODE:CAPS">G_DEFINE_TYPE_WITH_CODE</a></span> <span class="symbol">(</span>MyConnection<span class="symbol">,</span> my_connection<span class="symbol">,</span>
	186	TP_TYPE_BASE_CONNECTION<span class="symbol">,</span>
	187	<span class="gtkdoc slc">// ...</span>
	188	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION_INTERFACE_PRESENCE<span class="symbol">,</span>
	189	tp_presence_mixin_iface_init<span class="symbol">);</span>
	190	<span class="gtkdoc slc">// ...</span>
	191	<span class="symbol">)</span></pre></td>
	192	</tr>
	193	</tbody>
	194	</table>
	195	</div>
	196
169	197	<p>
170	198	In telepathy-glib versions older than 0.11.13, every connection
171	199	that used the <a class="link" href="telepathy-glib-TpPresenceMixin.html#TpPresenceMixin" title="TpPresenceMixin"><span class="type">TpPresenceMixin</span></a> was required to implement

557	585	</p>
558	586	<p>
559	587	</p>
560		<div class="informalexample"><pre class="programlisting">
561		tp_presence_mixin_class_init ((GObjectClass *) klass,
562		G_STRUCT_OFFSET (SomeObjectClass,
563		presence_mixin));
564		</pre></div>
	588	<div class="informalexample">
	589	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	590	<tbody>
	591	<tr>
	592	<td class="listing_lines" align="right"><pre>1
	593	2
	594	3</pre></td>
	595	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-class-init">tp_presence_mixin_class_init</a></span> <span class="symbol">((</span>GObjectClass <span class="symbol">*)</span> klass<span class="symbol">,</span>
	596	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObjectClass<span class="symbol">,</span>
	597	presence_mixin<span class="symbol">));</span></pre></td>
	598	</tr>
	599	</tbody>
	600	</table>
	601	</div>
	602
565	603	<p>
566	604	</p>
567	605	<div class="variablelist"><table border="0">

620	658	</p>
621	659	<p>
622	660	</p>
623		<div class="informalexample"><pre class="programlisting">
624		tp_presence_mixin_init ((GObject *) self,
625		G_STRUCT_OFFSET (SomeObject, presence_mixin));
626		</pre></div>
	661	<div class="informalexample">
	662	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	663	<tbody>
	664	<tr>
	665	<td class="listing_lines" align="right"><pre>1
	666	2</pre></td>
	667	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-init">tp_presence_mixin_init</a></span> <span class="symbol">((</span>GObject <span class="symbol">*)</span> self<span class="symbol">,</span>
	668	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObject<span class="symbol">,</span> presence_mixin<span class="symbol">));</span></pre></td>
	669	</tr>
	670	</tbody>
	671	</table>
	672	</div>
	673
627	674	<p>
628	675	</p>
629	676	<div class="variablelist"><table border="0">

+30

-10

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

341	341	</p>
342	342	<p>
343	343	</p>
344		<div class="informalexample"><pre class="programlisting">
345		tp_properties_mixin_class_init ((GObjectClass *) klass,
346		G_STRUCT_OFFSET (SomeObjectClass,
347		properties_mixin));
348		</pre></div>
	344	<div class="informalexample">
	345	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	346	<tbody>
	347	<tr>
	348	<td class="listing_lines" align="right"><pre>1
	349	2
	350	3</pre></td>
	351	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init">tp_properties_mixin_class_init</a></span> <span class="symbol">((</span>GObjectClass <span class="symbol">*)</span> klass<span class="symbol">,</span>
	352	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObjectClass<span class="symbol">,</span>
	353	properties_mixin<span class="symbol">));</span></pre></td>
	354	</tr>
	355	</tbody>
	356	</table>
	357	</div>
	358
349	359	<p>
350	360	</p>
351	361	<div class="variablelist"><table border="0">

391	401	</p>
392	402	<p>
393	403	</p>
394		<div class="informalexample"><pre class="programlisting">
395		tp_properties_mixin_init ((GObject *) self,
396		G_STRUCT_OFFSET (SomeObject, properties_mixin),
397		self->contact_repo);
398		</pre></div>
	404	<div class="informalexample">
	405	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	406	<tbody>
	407	<tr>
	408	<td class="listing_lines" align="right"><pre>1
	409	2
	410	3</pre></td>
	411	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-init">tp_properties_mixin_init</a></span> <span class="symbol">((</span>GObject <span class="symbol">*)</span> self<span class="symbol">,</span>
	412	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObject<span class="symbol">,</span> properties_mixin<span class="symbol">),</span>
	413	self<span class="symbol">-></span>contact_repo<span class="symbol">);</span></pre></td>
	414	</tr>
	415	</tbody>
	416	</table>
	417	</div>
	418
399	419	<p>
400	420	</p>
401	421	<div class="variablelist"><table border="0">

+28

-9

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

178	178	</p>
179	179	<p>
180	180	</p>
181		<div class="informalexample"><pre class="programlisting">
182		tp_text_mixin_class_init ((GObjectClass *) klass,
183		G_STRUCT_OFFSET (SomeObjectClass, text_mixin));
184		</pre></div>
	181	<div class="informalexample">
	182	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	183	<tbody>
	184	<tr>
	185	<td class="listing_lines" align="right"><pre>1
	186	2</pre></td>
	187	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpTextMixin.html#tp-text-mixin-class-init">tp_text_mixin_class_init</a></span> <span class="symbol">((</span>GObjectClass <span class="symbol">*)</span> klass<span class="symbol">,</span>
	188	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObjectClass<span class="symbol">,</span> text_mixin<span class="symbol">));</span></pre></td>
	189	</tr>
	190	</tbody>
	191	</table>
	192	</div>
	193
185	194	<p>
186	195	</p>
187	196	<div class="variablelist"><table border="0">

212	221	</p>
213	222	<p>
214	223	</p>
215		<div class="informalexample"><pre class="programlisting">
216		tp_text_mixin_init ((GObject *) self,
217		G_STRUCT_OFFSET (SomeObject, text_mixin),
218		self->contact_repo);
219		</pre></div>
	224	<div class="informalexample">
	225	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	226	<tbody>
	227	<tr>
	228	<td class="listing_lines" align="right"><pre>1
	229	2
	230	3</pre></td>
	231	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpTextMixin.html#tp-text-mixin-init">tp_text_mixin_init</a></span> <span class="symbol">((</span>GObject <span class="symbol">*)</span> self<span class="symbol">,</span>
	232	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObject<span class="symbol">,</span> text_mixin<span class="symbol">),</span>
	233	self<span class="symbol">-></span>contact_repo<span class="symbol">);</span></pre></td>
	234	</tr>
	235	</tbody>
	236	</table>
	237	</div>
	238
220	239	<p>
221	240	</p>
222	241	<div class="variablelist"><table border="0">

+15

-5

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

423	423	before returning from this function. One could ref every item in the list
424	424	like the following example:
425	425	</p>
426		<div class="informalexample"><pre class="programlisting">
427		GList *accounts;
428		account = tp_account_manager_get_valid_accounts (manager);
429		g_list_foreach (accounts, (GFunc) g_object_ref, NULL);
430		</pre></div>
	426	<div class="informalexample">
	427	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	428	<tbody>
	429	<tr>
	430	<td class="listing_lines" align="right"><pre>1
	431	2
	432	3</pre></td>
	433	<td class="listing_code"><pre class="programlisting">GList <span class="symbol">*</span>accounts<span class="symbol">;</span>
	434	account <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-account-manager.html#tp-account-manager-get-valid-accounts">tp_account_manager_get_valid_accounts</a></span> <span class="symbol">(</span>manager<span class="symbol">);</span>
	435	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-foreach">g_list_foreach</a></span> <span class="symbol">(</span>accounts<span class="symbol">, (</span>GFunc<span class="symbol">)</span> g_object_ref<span class="symbol">,</span> NULL<span class="symbol">);</span></pre></td>
	436	</tr>
	437	</tbody>
	438	</table>
	439	</div>
	440
431	441	<p>
432	442	</p>
433	443	<p>

+44

-14

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

192	192	<p>
193	193	The <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> is synonymous with:
194	194	</p>
195		<div class="informalexample"><pre class="programlisting">
196		GHashTable *asv = g_hash_table_new_full (g_str_hash, g_str_equal,
197		NULL, (GDestroyNotify) tp_g_value_slice_free);
198		</pre></div>
	195	<div class="informalexample">
	196	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	197	<tbody>
	198	<tr>
	199	<td class="listing_lines" align="right"><pre>1
	200	2</pre></td>
	201	<td class="listing_code"><pre class="programlisting">GHashTable <span class="symbol">*</span>asv <span class="symbol">=</span> <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-new-full">g_hash_table_new_full</a></span> <span class="symbol">(</span>g_str_hash<span class="symbol">,</span> g_str_equal<span class="symbol">,</span>
	202	NULL<span class="symbol">, (</span>GDestroyNotify<span class="symbol">)</span> tp_g_value_slice_free<span class="symbol">);</span></pre></td>
	203	</tr>
	204	</tbody>
	205	</table>
	206	</div>
	207
199	208	<p>
200	209	Followed by manual insertion of each of the parameters.
201	210	</p>

207	216	<a class="link" href="telepathy-glib-util.html#tp-g-value-slice-new" title="tp_g_value_slice_new ()"><code class="function">tp_g_value_slice_new()</code></a> and <a class="link" href="telepathy-glib-util.html#tp-g-value-slice-dup" title="tp_g_value_slice_dup ()"><code class="function">tp_g_value_slice_dup()</code></a> may also be used to insert
208	217	into the map if required.
209	218	</p>
210		<div class="informalexample"><pre class="programlisting">
211		g_hash_table_insert (parameters, "account",
212		tp_g_value_slice_new_string ("bob@mcbadgers.com"));
213		</pre></div>
	219	<div class="informalexample">
	220	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	221	<tbody>
	222	<tr>
	223	<td class="listing_lines" align="right"><pre>1
	224	2</pre></td>
	225	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-insert">g_hash_table_insert</a></span> <span class="symbol">(</span>parameters<span class="symbol">,</span> <span class="string">"account"</span><span class="symbol">,</span>
	226	<span class="function"><a href="telepathy-glib-util.html#tp-g-value-slice-new-string">tp_g_value_slice_new_string</a></span> <span class="symbol">(</span><span class="string">"bob@mcbadgers.com"</span><span class="symbol">));</span></pre></td>
	227	</tr>
	228	</tbody>
	229	</table>
	230	</div>
	231
214	232	<p>
215	233	</p>
216	234	<p>
217	235	</p>
218	236	<div class="example">
219		<a name="id483216"></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>
220		<div class="example-contents"><pre class="programlisting">
221		GHashTable *parameters = tp_asv_new (
222		"answer", G_TYPE_INT, 42,
223		"question", G_TYPE_STRING, "We just don't know",
224		NULL);</pre></div>
	237	<a name="id629371"></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	<div class="example-contents">
	239	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	240	<tbody>
	241	<tr>
	242	<td class="listing_lines" align="right"><pre>1
	243	2
	244	3
	245	4</pre></td>
	246	<td class="listing_code"><pre class="programlisting">GHashTable <span class="symbol">*</span>parameters <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	247	<span class="string">"answer"</span><span class="symbol">,</span> G_TYPE_INT<span class="symbol">,</span> <span class="number">42</span><span class="symbol">,</span>
	248	<span class="string">"question"</span><span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span> <span class="string">"We just don't know"</span><span class="symbol">,</span>
	249	NULL<span class="symbol">);</span></pre></td>
	250	</tr>
	251	</tbody>
	252	</table>
	253	</div>
	254
225	255	</div>
226	256	<p><br class="example-break">
227	257	</p>

+69

-27

docs/reference/html/telepathy-glib-base-client.html less more

305	305	</p>
306	306	<p>
307	307	</p>
308		<div class="informalexample"><pre class="programlisting">
309		tp_base_client_take_observer_filter (client,
310		tp_asv_new (
311		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
312		TP_IFACE_CHANNEL_TYPE_TEXT,
313		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT,
314		TP_HANDLE_TYPE_CONTACT,
315		...));
316		</pre></div>
	308	<div class="informalexample">
	309	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	310	<tbody>
	311	<tr>
	312	<td class="listing_lines" align="right"><pre>1
	313	2
	314	3
	315	4
	316	5
	317	6
	318	7</pre></td>
	319	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-observer-filter">tp_base_client_take_observer_filter</a></span> <span class="symbol">(</span>client<span class="symbol">,</span>
	320	<span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	321	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span>
	322	TP_IFACE_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	323	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span>
	324	TP_HANDLE_TYPE_CONTACT<span class="symbol">,</span>
	325	<span class="symbol">...));</span></pre></td>
	326	</tr>
	327	</tbody>
	328	</table>
	329	</div>
	330
317	331	<p>
318	332	</p>
319	333	<div class="variablelist"><table border="0">

563	577	</p>
564	578	<p>
565	579	</p>
566		<div class="informalexample"><pre class="programlisting">
567		tp_base_client_take_approver_filter (client,
568		tp_asv_new (
569		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
570		TP_IFACE_CHANNEL_TYPE_TEXT,
571		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT,
572		TP_HANDLE_TYPE_CONTACT,
573		...));
574		</pre></div>
	580	<div class="informalexample">
	581	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	582	<tbody>
	583	<tr>
	584	<td class="listing_lines" align="right"><pre>1
	585	2
	586	3
	587	4
	588	5
	589	6
	590	7</pre></td>
	591	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-approver-filter">tp_base_client_take_approver_filter</a></span> <span class="symbol">(</span>client<span class="symbol">,</span>
	592	<span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	593	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span>
	594	TP_IFACE_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	595	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span>
	596	TP_HANDLE_TYPE_CONTACT<span class="symbol">,</span>
	597	<span class="symbol">...));</span></pre></td>
	598	</tr>
	599	</tbody>
	600	</table>
	601	</div>
	602
575	603	<p>
576	604	</p>
577	605	<div class="variablelist"><table border="0">

847	875	</p>
848	876	<p>
849	877	</p>
850		<div class="informalexample"><pre class="programlisting">
851		tp_base_client_take_handler_filter (client,
852		tp_asv_new (
853		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
854		TP_IFACE_CHANNEL_TYPE_TEXT,
855		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT,
856		TP_HANDLE_TYPE_CONTACT,
857		...));
858		</pre></div>
	878	<div class="informalexample">
	879	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	880	<tbody>
	881	<tr>
	882	<td class="listing_lines" align="right"><pre>1
	883	2
	884	3
	885	4
	886	5
	887	6
	888	7</pre></td>
	889	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-handler-filter">tp_base_client_take_handler_filter</a></span> <span class="symbol">(</span>client<span class="symbol">,</span>
	890	<span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	891	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span>
	892	TP_IFACE_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	893	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span>
	894	TP_HANDLE_TYPE_CONTACT<span class="symbol">,</span>
	895	<span class="symbol">...));</span></pre></td>
	896	</tr>
	897	</tbody>
	898	</table>
	899	</div>
	900
859	901	<p>
860	902	</p>
861	903	<div class="variablelist"><table border="0">

+248

-0

docs/reference/html/telepathy-glib-base-password-channel.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>TpBasePasswordChannel</title>
	5	<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
	6	<link rel="home" href="index.html" title="telepathy-glib API Reference Manual">
	7	<link rel="up" href="ch-service-base.html" title="Service-side implementation">
	8	<link rel="prev" href="TpCMMessage.html" title="TpCMMessage">
	9	<link rel="next" href="telepathy-glib-simple-password-manager.html" title="TpSimplePasswordManager">
	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="TpCMMessage.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
	17	<td><a accesskey="u" href="ch-service-base.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 API Reference Manual</th>
	20	<td><a accesskey="n" href="telepathy-glib-simple-password-manager.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-base-password-channel.synopsis" class="shortcut">Top</a>
	24	\|
	25	<a href="#telepathy-glib-base-password-channel.description" class="shortcut">Description</a>
	26	\|
	27	<a href="#telepathy-glib-base-password-channel.object-hierarchy" class="shortcut">Object Hierarchy</a>
	28	\|
	29	<a href="#telepathy-glib-base-password-channel.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
	30	\|
	31	<a href="#telepathy-glib-base-password-channel.properties" class="shortcut">Properties</a>
	32	\|
	33	<a href="#telepathy-glib-base-password-channel.signals" class="shortcut">Signals</a>
	34	</td></tr>
	35	</table>
	36	<div class="refentry" title="TpBasePasswordChannel">
	37	<a name="telepathy-glib-base-password-channel"></a><div class="titlepage"></div>
	38	<div class="refnamediv"><table width="100%"><tr>
	39	<td valign="top">
	40	<h2><span class="refentrytitle"><a name="telepathy-glib-base-password-channel.top_of_page"></a>TpBasePasswordChannel</span></h2>
	41	<p>TpBasePasswordChannel — a simple X-TELEPATHY-PASSWORD channel</p>
	42	</td>
	43	<td valign="top" align="right"></td>
	44	</tr></table></div>
	45	<div class="refsynopsisdiv" title="Synopsis">
	46	<a name="telepathy-glib-base-password-channel.synopsis"></a><h2>Synopsis</h2>
	47	<a name="TpBasePasswordChannel"></a><pre class="synopsis">
	48	#include <telepathy-glib/base-password-channel.h>
	49
	50	<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel-struct" title="TpBasePasswordChannel">TpBasePasswordChannel</a>;
	51	</pre>
	52	</div>
	53	<div class="refsect1" title="Object Hierarchy">
	54	<a name="telepathy-glib-base-password-channel.object-hierarchy"></a><h2>Object Hierarchy</h2>
	55	<pre class="synopsis">
	56	<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
	57	+----<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a>
	58	+----TpBasePasswordChannel
	59	</pre>
	60	</div>
	61	<div class="refsect1" title="Implemented Interfaces">
	62	<a name="telepathy-glib-base-password-channel.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
	63	<p>
	64	TpBasePasswordChannel implements
	65	<a class="link" href="telepathy-glib-svc-generic.html#TpSvcDBusProperties">TpSvcDBusProperties</a>, <a class="link" href="telepathy-glib-svc-channel.html#TpSvcChannel">TpSvcChannel</a>, <a class="link" href="TpChannelIface.html" title="TpChannelIface">TpChannelIface</a>, <a class="link" href="TpExportableChannel.html" title="TpExportableChannel">TpExportableChannel</a>, <a class="link" href="telepathy-glib-svc-channel-auth.html#TpSvcChannelTypeServerAuthentication">TpSvcChannelTypeServerAuthentication</a> and <a class="link" href="telepathy-glib-svc-channel-auth.html#TpSvcChannelInterfaceSASLAuthentication">TpSvcChannelInterfaceSASLAuthentication</a>.</p>
	66	</div>
	67	<div class="refsect1" title="Properties">
	68	<a name="telepathy-glib-base-password-channel.properties"></a><h2>Properties</h2>
	69	<pre class="synopsis">
	70	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authentication-method" title='The "authentication-method" property'>authentication-method</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
	71	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authorization-identity" title='The "authorization-identity" property'>authorization-identity</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
	72	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--available-mechanisms" title='The "available-mechanisms" property'>available-mechanisms</a>" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>* : Read
	73	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--can-try-again" title='The "can-try-again" property'>can-try-again</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
	74	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-realm" title='The "default-realm" property'>default-realm</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
	75	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-username" title='The "default-username" property'>default-username</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
	76	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--has-initial-data" title='The "has-initial-data" property'>has-initial-data</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
	77	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--may-save-response" title='The "may-save-response" property'>may-save-response</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct Only
	78	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error" title='The "sasl-error" property'>sasl-error</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
	79	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error-details" title='The "sasl-error-details" property'>sasl-error-details</a>" <span class="type">GHashTable_gchararray+GValue_*</span> : Read
	80	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-status" title='The "sasl-status" property'>sasl-status</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
	81	</pre>
	82	</div>
	83	<div class="refsect1" title="Signals">
	84	<a name="telepathy-glib-base-password-channel.signals"></a><h2>Signals</h2>
	85	<pre class="synopsis">
	86	"<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel-finished" title='The "finished" signal'>finished</a>" : Run Last
	87	</pre>
	88	</div>
	89	<div class="refsect1" title="Description">
	90	<a name="telepathy-glib-base-password-channel.description"></a><h2>Description</h2>
	91	<p>
	92	This class implements a SASL Authentication channel with the
	93	X-TELEPATHY-PASSWORD SASL mechanism. Most of the time, you should not use
	94	or instantiate this class directly. It is used by <span class="type">TpBasePasswordManager</span>
	95	behind the scenes. In some special circumstances (e.g. when the authentication
	96	channel needs to implement additional interfaces), it may be necessary to
	97	create your own custom authentication channels instead of letting
	98	<span class="type">TpBasePasswordManager</span> create them automatically. In this case, you
	99	should derive your channel from this class and then pass the channel as an
	100	argument to <code class="function">tp_base_password_manager_prompt_for_channel_async()</code>.
	101	</p>
	102	</div>
	103	<div class="refsect1" title="Details">
	104	<a name="telepathy-glib-base-password-channel.details"></a><h2>Details</h2>
	105	<div class="refsect2" title="TpBasePasswordChannel">
	106	<a name="TpBasePasswordChannel-struct"></a><h3>TpBasePasswordChannel</h3>
	107	<pre class="programlisting">typedef struct _TpBasePasswordChannel TpBasePasswordChannel;</pre>
	108	<p>
	109	Data structure representing a channel implementing a SASL Authentication
	110	channel with the X-TELEPATHY-PASSWORD SASL mechanism.
	111	</p>
	112	<p class="since">Since 0.13.15</p>
	113	</div>
	114	</div>
	115	<div class="refsect1" title="Property Details">
	116	<a name="telepathy-glib-base-password-channel.property-details"></a><h2>Property Details</h2>
	117	<div class="refsect2" title='The "authentication-method" property'>
	118	<a name="TpBasePasswordChannel--authentication-method"></a><h3>The <code class="literal">"authentication-method"</code> property</h3>
	119	<pre class="programlisting"> "authentication-method" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
	120	<p>Interface of authentication method.</p>
	121	<p>Default value: ""</p>
	122	</div>
	123	<hr>
	124	<div class="refsect2" title='The "authorization-identity" property'>
	125	<a name="TpBasePasswordChannel--authorization-identity"></a><h3>The <code class="literal">"authorization-identity"</code> property</h3>
	126	<pre class="programlisting"> "authorization-identity" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
	127	<p>Authorization identity.</p>
	128	<p>Default value: ""</p>
	129	</div>
	130	<hr>
	131	<div class="refsect2" title='The "available-mechanisms" property'>
	132	<a name="TpBasePasswordChannel--available-mechanisms"></a><h3>The <code class="literal">"available-mechanisms"</code> property</h3>
	133	<pre class="programlisting"> "available-mechanisms" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>* : Read</pre>
	134	<p>The set of mechanisms the server advertised.</p>
	135	</div>
	136	<hr>
	137	<div class="refsect2" title='The "can-try-again" property'>
	138	<a name="TpBasePasswordChannel--can-try-again"></a><h3>The <code class="literal">"can-try-again"</code> property</h3>
	139	<pre class="programlisting"> "can-try-again" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
	140	<p>Whether StartMechanism will work in failed states.</p>
	141	<p>Default value: FALSE</p>
	142	</div>
	143	<hr>
	144	<div class="refsect2" title='The "default-realm" property'>
	145	<a name="TpBasePasswordChannel--default-realm"></a><h3>The <code class="literal">"default-realm"</code> property</h3>
	146	<pre class="programlisting"> "default-realm" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
	147	<p>DefaultRealm.</p>
	148	<p>Default value: ""</p>
	149	</div>
	150	<hr>
	151	<div class="refsect2" title='The "default-username" property'>
	152	<a name="TpBasePasswordChannel--default-username"></a><h3>The <code class="literal">"default-username"</code> property</h3>
	153	<pre class="programlisting"> "default-username" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
	154	<p>DefaultUsername.</p>
	155	<p>Default value: ""</p>
	156	</div>
	157	<hr>
	158	<div class="refsect2" title='The "has-initial-data" property'>
	159	<a name="TpBasePasswordChannel--has-initial-data"></a><h3>The <code class="literal">"has-initial-data"</code> property</h3>
	160	<pre class="programlisting"> "has-initial-data" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
	161	<p>Whether the StartMechanismWithData can be called.</p>
	162	<p>Default value: FALSE</p>
	163	</div>
	164	<hr>
	165	<div class="refsect2" title='The "may-save-response" property'>
	166	<a name="TpBasePasswordChannel--may-save-response"></a><h3>The <code class="literal">"may-save-response"</code> property</h3>
	167	<pre class="programlisting"> "may-save-response" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct Only</pre>
	168	<p>Whether the client may save the authentication response.</p>
	169	<p>Default value: TRUE</p>
	170	</div>
	171	<hr>
	172	<div class="refsect2" title='The "sasl-error" property'>
	173	<a name="TpBasePasswordChannel--sasl-error"></a><h3>The <code class="literal">"sasl-error"</code> property</h3>
	174	<pre class="programlisting"> "sasl-error" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
	175	<p>SASL error.</p>
	176	<p>Default value: ""</p>
	177	</div>
	178	<hr>
	179	<div class="refsect2" title='The "sasl-error-details" property'>
	180	<a name="TpBasePasswordChannel--sasl-error-details"></a><h3>The <code class="literal">"sasl-error-details"</code> property</h3>
	181	<pre class="programlisting"> "sasl-error-details" <span class="type">GHashTable_gchararray+GValue_*</span> : Read</pre>
	182	<p>SASL error details.</p>
	183	</div>
	184	<hr>
	185	<div class="refsect2" title='The "sasl-status" property'>
	186	<a name="TpBasePasswordChannel--sasl-status"></a><h3>The <code class="literal">"sasl-status"</code> property</h3>
	187	<pre class="programlisting"> "sasl-status" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
	188	<p>The status of the current SASL authentication.</p>
	189	<p>Allowed values: <= 7</p>
	190	<p>Default value: 0</p>
	191	</div>
	192	</div>
	193	<div class="refsect1" title="Signal Details">
	194	<a name="telepathy-glib-base-password-channel.signal-details"></a><h2>Signal Details</h2>
	195	<div class="refsect2" title='The "finished" signal'>
	196	<a name="TpBasePasswordChannel-finished"></a><h3>The <code class="literal">"finished"</code> signal</h3>
	197	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> *password,
	198	<a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="type">GString</span></a> *domain,
	199	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> code,
	200	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> message,
	201	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg4,
	202	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last</pre>
	203	<p>
	204	Emitted when either the password has been provided by the user or the
	205	authentication has been aborted.
	206	</p>
	207	<div class="variablelist"><table border="0">
	208	<col align="left" valign="top">
	209	<tbody>
	210	<tr>
	211	<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
	212	<td>the password provided by the user, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the
	213	authentication has been aborted
	214	</td>
	215	</tr>
	216	<tr>
	217	<td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
	218	<td>domain of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> indicating why the authentication has been
	219	aborted, or 0
	220	</td>
	221	</tr>
	222	<tr>
	223	<td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
	224	<td>error code of a GError indicating why the authentication has been
	225	aborted, or 0
	226	</td>
	227	</tr>
	228	<tr>
	229	<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
	230	<td>a message associated with the error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	231	</td>
	232	</tr>
	233	<tr>
	234	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	235	<td>user data set when the signal handler was connected.</td>
	236	</tr>
	237	</tbody>
	238	</table></div>
	239	<p class="since">Since 0.13.15</p>
	240	</div>
	241	</div>
	242	</div>
	243	<div class="footer">
	244	<hr>
	245	Generated by GTK-Doc V1.15</div>
	246	</body>
	247	</html>⏎

+68

-29

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

373	373	Specifically, if this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, a room list channel can be
374	374	requested as follows:
375	375	</p>
376		<div class="informalexample"><pre class="programlisting">
377		GHashTable *request;
378		TpAccountChannelRequest *req;
379
380		request = tp_asv_new (
381		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
382		TP_IFACE_CHANNEL_TYPE_ROOM_LIST,
383		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_NONE,
384		NULL);
385
386		req = tp_account_channel_request_new (account, request,
387		TP_USER_ACTION_TIME_CURRENT_TIME);
388
389		tp_account_channel_request_create_and_handle_channel_async (req, NULL,
390		create_channel_cb, NULL);
391
392		g_object_unref (req);
393		g_hash_table_unref (request);
394		</pre></div>
	376	<div class="informalexample">
	377	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	378	<tbody>
	379	<tr>
	380	<td class="listing_lines" align="right"><pre>1
	381	2
	382	3
	383	4
	384	5
	385	6
	386	7
	387	8
	388	9
	389	10
	390	11
	391	12
	392	13
	393	14
	394	15
	395	16
	396	17</pre></td>
	397	<td class="listing_code"><pre class="programlisting">GHashTable <span class="symbol">*</span>request<span class="symbol">;</span>
	398	TpAccountChannelRequest <span class="symbol">*</span>req<span class="symbol">;</span>
	399
	400	request <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	401	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span>
	402	TP_IFACE_CHANNEL_TYPE_ROOM_LIST<span class="symbol">,</span>
	403	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span> TP_HANDLE_TYPE_NONE<span class="symbol">,</span>
	404	NULL<span class="symbol">);</span>
	405
	406	req <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-account-channel-request.html#tp-account-channel-request-new">tp_account_channel_request_new</a></span> <span class="symbol">(</span>account<span class="symbol">,</span> request<span class="symbol">,</span>
	407	TP_USER_ACTION_TIME_CURRENT_TIME<span class="symbol">);</span>
	408
	409	<span class="function"><a href="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-async">tp_account_channel_request_create_and_handle_channel_async</a></span> <span class="symbol">(</span>req<span class="symbol">,</span> NULL<span class="symbol">,</span>
	410	create_channel_cb<span class="symbol">,</span> NULL<span class="symbol">);</span>
	411
	412	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="symbol">(</span>req<span class="symbol">);</span>
	413	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-unref">g_hash_table_unref</a></span> <span class="symbol">(</span>request<span class="symbol">);</span></pre></td>
	414	</tr>
	415	</tbody>
	416	</table>
	417	</div>
	418
395	419	<p>
396	420	</p>
397	421	<p>
398	422	If <em class="parameter"><code>with_server</code></em> is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, a list of rooms on a particular server can
399	423	be requested as follows:
400	424	</p>
401		<div class="informalexample"><pre class="programlisting">
402		/\* Same code as above but with request defined using: *\/
403		request = tp_asv_new (
404		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
405		TP_IFACE_CHANNEL_TYPE_ROOM_LIST,
406		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_NONE,
407		TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER, G_TYPE_STRING,
408		"characters.shakespeare.lit",
409		NULL);
410		</pre></div>
	425	<div class="informalexample">
	426	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	427	<tbody>
	428	<tr>
	429	<td class="listing_lines" align="right"><pre>1
	430	2
	431	3
	432	4
	433	5
	434	6
	435	7
	436	8</pre></td>
	437	<td class="listing_code"><pre class="programlisting"><span class="symbol">/</span>\<span class="symbol"></span> Same code as above but with request defined <span class="keyword">using</span><span class="symbol">: </span>\<span class="symbol">/</span>
	438	request <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	439	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span>
	440	TP_IFACE_CHANNEL_TYPE_ROOM_LIST<span class="symbol">,</span>
	441	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span> TP_HANDLE_TYPE_NONE<span class="symbol">,</span>
	442	TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span>
	443	<span class="string">"characters.shakespeare.lit"</span><span class="symbol">,</span>
	444	NULL<span class="symbol">);</span></pre></td>
	445	</tr>
	446	</tbody>
	447	</table>
	448	</div>
	449
411	450	<p>
412	451	</p>
413	452	<div class="variablelist"><table border="0">

+2

-2

docs/reference/html/telepathy-glib-channel-dispatch-operation.html less more

1168	1168	<p>
1169	1169	If an X server timestamp for the user action causing this method call is
1170	1170	available, <em class="parameter"><code>user_action_time</code></em> should be this timestamp (for instance, the
1171		result of <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#gdk-event-get-time"><code class="function">gdk_event_get_time()</code></a> if it is not <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>). Otherwise, it
	1171	result of <a href="/usr/share/gtk-doc/html/gdk/gdk-Events.html#gdk-event-get-time"><code class="function">gdk_event_get_time()</code></a> if it is not <a href="/usr/share/gtk-doc/html/gdk/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>). Otherwise, it
1172	1172	may be <a class="link" href="telepathy-glib-defs.html#TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS" title="TP_USER_ACTION_TIME_NOT_USER_ACTION"><code class="literal">TP_USER_ACTION_TIME_NOT_USER_ACTION</code></a> to behave as if there was no
1173	1173	user action or it happened a long time ago, or
1174	1174	<a class="link" href="telepathy-glib-defs.html#TP-USER-ACTION-TIME-CURRENT-TIME:CAPS" title="TP_USER_ACTION_TIME_CURRENT_TIME"><code class="literal">TP_USER_ACTION_TIME_CURRENT_TIME</code></a> to have the Handler behave as though the
1175	1175	user action had just happened (resembling, but not numerically equal to,
1176		<a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>).
	1176	<a href="/usr/share/gtk-doc/html/gdk/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>).
1177	1177	</p>
1178	1178	<p>
1179	1179	This method has been introduced in telepathy-mission-control 5.5.0.

+859

-131

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

40	40	<pre class="synopsis">
41	41	#include <telepathy-glib/connection.h>
42	42
	43	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-block-contacts" title="tp_cli_connection_interface_contact_blocking_call_block_contacts ()">tp_cli_connection_interface_contact_blocking_call_block_contacts</a>
	44	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	45	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	46	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	47	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Report_Abusive</code></em>,
	48	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-block-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()"><span class="type">tp_cli_connection_interface_contact_blocking_callback_for_block_contacts</span></a> callback</code></em>,
	49	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	50	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	51	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	52	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-request-blocked-contacts" title="tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts ()">tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts</a>
	53	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	54	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	55	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()"><span class="type">tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts</span></a> callback</code></em>,
	56	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	57	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	58	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	59	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-unblock-contacts" title="tp_cli_connection_interface_contact_blocking_call_unblock_contacts ()">tp_cli_connection_interface_contact_blocking_call_unblock_contacts</a>
	60	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	61	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	62	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	63	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()"><span class="type">tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts</span></a> callback</code></em>,
	64	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	65	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	66	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	67	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-block-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()">*tp_cli_connection_interface_contact_blocking_callback_for_block_contacts</a>)
	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>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
	70	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	71	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	72	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()">*tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts</a>)
	73	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	74	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Contacts</code></em>,
	75	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
	76	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	77	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	78	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()">*tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts</a>)
	79	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	80	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
	81	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	82	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
	83	<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed" title="tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ()">tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed</a>
	84	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	85	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed" title="tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()"><span class="type">tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed</span></a> callback</code></em>,
	86	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	87	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	88	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
	89	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
	90	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-block-contacts" title="tp_cli_connection_interface_contact_blocking_run_block_contacts ()">tp_cli_connection_interface_contact_blocking_run_block_contacts</a>
	91	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	92	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	93	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	94	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Report_Abusive</code></em>,
	95	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
	96	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
	97	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-request-blocked-contacts" title="tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts ()">tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts</a>
	98	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	99	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	100	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **out_Contacts</code></em>,
	101	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
	102	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
	103	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-unblock-contacts" title="tp_cli_connection_interface_contact_blocking_run_unblock_contacts ()">tp_cli_connection_interface_contact_blocking_run_unblock_contacts</a>
	104	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	105	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	106	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	107	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
	108	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
	109	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed" title="tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()">*tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed</a>)
	110	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	111	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Blocked_Contacts</code></em>,
	112	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Unblocked_Contacts</code></em>,
	113	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	114	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
43	115	<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-add-to-group" title="tp_cli_connection_interface_contact_groups_call_add_to_group ()">tp_cli_connection_interface_contact_groups_call_add_to_group</a>
44	116	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
45	117	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,

294	366	</div>
295	367	<div class="refsect1" title="Details">
296	368	<a name="telepathy-glib-connection-contact-list.details"></a><h2>Details</h2>
297		<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_add_to_group ()">
298		<a name="tp-cli-connection-interface-contact-groups-call-add-to-group"></a><h3>tp_cli_connection_interface_contact_groups_call_add_to_group ()</h3>
299		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_add_to_group
300		(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
301		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
302		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
303		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Members</code></em>,
304		<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-add-to-group" title="tp_cli_connection_interface_contact_groups_callback_for_add_to_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_add_to_group</span></a> callback</code></em>,
305		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
306		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
307		<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
308		<p>
309		Start a AddToGroup method call.
310		</p>
311		<p>
312		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Add the given members to the given group, creating it if necessary.</p> <p>If <tp:member-ref>DisjointGroups</tp:member-ref> is true, this will also remove each member from their previous group.</p> <tp:rationale> <p>This is good for user interfaces in which you can edit groups via drag-and-drop.</p> </tp:rationale> <p>Any <tp:member-ref>GroupsCreated</tp:member-ref>, <tp:member-ref>GroupsChanged</tp:member-ref> and <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	369	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_call_block_contacts ()">
	370	<a name="tp-cli-connection-interface-contact-blocking-call-block-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_call_block_contacts ()</h3>
	371	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_blocking_call_block_contacts
	372	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	373	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	374	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	375	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Report_Abusive</code></em>,
	376	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-block-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()"><span class="type">tp_cli_connection_interface_contact_blocking_callback_for_block_contacts</span></a> callback</code></em>,
	377	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	378	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	379	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	380	<p>
	381	Start a BlockContacts method call.
	382	</p>
	383	<p>
	384	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Direct the server to block some contacts. The precise effect is protocol-dependent, but SHOULD include ignoring all current and subsequent communications from the given contacts, avoiding sending presence to them in future, and if they were already receiving the local user's presence, behaving as if the local user went offline.</p>
313	385	</p>
314	386	<div class="variablelist"><table border="0">
315	387	<col align="left" valign="top">

326	398	</td>
327	399	</tr>
328	400	<tr>
329		<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
330		<td>Used to pass an 'in' argument: The group to alter.
331		</td>
332		</tr>
333		<tr>
334		<td><p><span class="term"><em class="parameter"><code>in_Members</code></em> :</span></p></td>
335		<td>Used to pass an 'in' argument: The set of members to include in the group.
	401	<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
	402	<td>Used to pass an 'in' argument: Some contacts to block. If some of the contacts in this list are already blocked, the connection manager MUST act as if they were not specified in this list.
	403	</td>
	404	</tr>
	405	<tr>
	406	<td><p><span class="term"><em class="parameter"><code>in_Report_Abusive</code></em> :</span></p></td>
	407	<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>In addition to blocking, report these contacts as abusive to the server administrators.</p> <p>Clients can determine whether this capability is available by checking the <tp:member-ref>ContactBlockingCapabilities</tp:member-ref> property. If this argument is set to <code>True</code> by a client despite <tp:member-ref>ContactBlockingCapabilities</tp:member-ref> not containing the <code>Can_Report_Abusive</code> flag, the connection manager SHOULD act as if it were <code>False</code> and simply block the supplied contacts.</p> <tp:rationale> <p>A correct user interface shouldn't get this far without knowing that reporting abusive contacts is not supported. If it does, then the user has expressed their intention to block these contacts. Returning an error would leave the UI with three options:</p> <ul> <li>Ignore the error, leaving the contacts not actually blocked;</li> <li>Display an error to the user;</li> <li>Call this method again, passing <code>False</code> for this argument.</li> </ul> <p>None of these seem preferable to the CM just ignoring this flag if it doesn't support it: that way, the contacts will be blocked, as the user requested, and UIs have fewer ways to mess up entirely.</p> </tp:rationale>
336	408	</td>
337	409	</tr>
338	410	<tr>

375	447	</table></div>
376	448	</div>
377	449	<hr>
378		<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_remove_from_group ()">
379		<a name="tp-cli-connection-interface-contact-groups-call-remove-from-group"></a><h3>tp_cli_connection_interface_contact_groups_call_remove_from_group ()</h3>
380		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_remove_from_group
381		(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
382		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
383		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
384		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Members</code></em>,
385		<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-remove-from-group" title="tp_cli_connection_interface_contact_groups_callback_for_remove_from_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_remove_from_group</span></a> callback</code></em>,
386		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
387		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
388		<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
389		<p>
390		Start a RemoveFromGroup method call.
391		</p>
392		<p>
393		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Remove the given members from the given group.</p> <tp:rationale> <p>This is good for user interfaces in which you can edit groups via drag-and-drop.</p> </tp:rationale> <p>Any <tp:member-ref>GroupsChanged</tp:member-ref> or <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	450	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts ()">
	451	<a name="tp-cli-connection-interface-contact-blocking-call-request-blocked-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts ()</h3>
	452	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts
	453	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	454	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	455	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()"><span class="type">tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts</span></a> callback</code></em>,
	456	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	457	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	458	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	459	<p>
	460	Start a RequestBlockedContacts method call.
	461	</p>
	462	<p>
	463	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>List the contacts that are blocked.</p> <p>Clients SHOULD allow a relatively long timeout for calls to this method, since on some protocols contact blocking is part of the contact list, which can take a significant time to retrieve.</p>
394	464	</p>
395	465	<div class="variablelist"><table border="0">
396	466	<col align="left" valign="top">

404	474	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
405	475	<td>the timeout in milliseconds, or -1 to use the
406	476	default
407		</td>
408		</tr>
409		<tr>
410		<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
411		<td>Used to pass an 'in' argument: The group to alter. If it does not exist, then it has no members by definition, so this method SHOULD return successfully.
412		</td>
413		</tr>
414		<tr>
415		<td><p><span class="term"><em class="parameter"><code>in_Members</code></em> :</span></p></td>
416		<td>Used to pass an 'in' argument: The set of members to remove from the group. It is not an error to remove members who are already not in the group. If there are no members left in the group afterwards, the group MAY itself be removed.
417	477	</td>
418	478	</tr>
419	479	<tr>

456	516	</table></div>
457	517	</div>
458	518	<hr>
459		<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_remove_group ()">
460		<a name="tp-cli-connection-interface-contact-groups-call-remove-group"></a><h3>tp_cli_connection_interface_contact_groups_call_remove_group ()</h3>
461		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_remove_group
462		(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
463		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
464		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
465		<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-remove-group" title="tp_cli_connection_interface_contact_groups_callback_for_remove_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_remove_group</span></a> callback</code></em>,
466		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
467		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
468		<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
469		<p>
470		Start a RemoveGroup method call.
471		</p>
472		<p>
473		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Remove all members from the given group, then remove the group itself. If the group already does not exist, this method SHOULD return successfully.</p> <p>Any <tp:member-ref>GroupsChanged</tp:member-ref> or <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	519	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_call_unblock_contacts ()">
	520	<a name="tp-cli-connection-interface-contact-blocking-call-unblock-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_call_unblock_contacts ()</h3>
	521	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_blocking_call_unblock_contacts
	522	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	523	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	524	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	525	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts" title="tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()"><span class="type">tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts</span></a> callback</code></em>,
	526	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	527	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	528	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	529	<p>
	530	Start a UnblockContacts method call.
	531	</p>
	532	<p>
	533	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Direct the server to unblock some contacts.</p>
474	534	</p>
475	535	<div class="variablelist"><table border="0">
476	536	<col align="left" valign="top">

487	547	</td>
488	548	</tr>
489	549	<tr>
490		<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
491		<td>Used to pass an 'in' argument: The group to remove.
	550	<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
	551	<td>Used to pass an 'in' argument: Some contacts to unblock. If some of the contacts in this list are not currently blocked, the connection manager MUST act as if they were not specified in this list.
492	552	</td>
493	553	</tr>
494	554	<tr>

531	591	</table></div>
532	592	</div>
533	593	<hr>
534		<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_rename_group ()">
535		<a name="tp-cli-connection-interface-contact-groups-call-rename-group"></a><h3>tp_cli_connection_interface_contact_groups_call_rename_group ()</h3>
536		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_rename_group
537		(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
538		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
539		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Old_Name</code></em>,
540		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_New_Name</code></em>,
541		<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-rename-group" title="tp_cli_connection_interface_contact_groups_callback_for_rename_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_rename_group</span></a> callback</code></em>,
542		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
543		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
544		<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
545		<p>
546		Start a RenameGroup method call.
547		</p>
548		<p>
549		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Rename the given group.</p> <p>On protocols where groups behave like tags, this is an API short-cut for adding all of the group's members to a group with the new name, then removing the old group.</p> <tp:rationale> <p>Otherwise, clients can't perform this operation atomically, even if the connection could.</p> </tp:rationale> <p>Any <tp:member-ref>GroupRenamed</tp:member-ref> or <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	594	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()">
	595	<a name="tp-cli-connection-interface-contact-blocking-callback-for-block-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()</h3>
	596	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_blocking_callback_for_block_contacts)
	597	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	598	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
	599	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	600	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	601	<p>
	602	Signature of the callback called when a BlockContacts method call
	603	succeeds or fails.
	604	</p>
	605	<div class="variablelist"><table border="0">
	606	<col align="left" valign="top">
	607	<tbody>
	608	<tr>
	609	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	610	<td>the proxy on which the call was made
	611	</td>
	612	</tr>
	613	<tr>
	614	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	615	<td>
	616	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
	617	</td>
	618	</tr>
	619	<tr>
	620	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	621	<td>user-supplied data
	622	</td>
	623	</tr>
	624	<tr>
	625	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	626	<td>user-supplied object
	627	</td>
	628	</tr>
	629	</tbody>
	630	</table></div>
	631	</div>
	632	<hr>
	633	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()">
	634	<a name="tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()</h3>
	635	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts)
	636	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	637	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Contacts</code></em>,
	638	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
	639	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	640	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	641	<p>
	642	Signature of the callback called when a RequestBlockedContacts method call
	643	succeeds or fails.
	644	</p>
	645	<div class="variablelist"><table border="0">
	646	<col align="left" valign="top">
	647	<tbody>
	648	<tr>
	649	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	650	<td>the proxy on which the call was made
	651	</td>
	652	</tr>
	653	<tr>
	654	<td><p><span class="term"><em class="parameter"><code>out_Contacts</code></em> :</span></p></td>
	655	<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The blocked contacts’ handles, together with their identifiers.
	656	</td>
	657	</tr>
	658	<tr>
	659	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	660	<td>
	661	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
	662	</td>
	663	</tr>
	664	<tr>
	665	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	666	<td>user-supplied data
	667	</td>
	668	</tr>
	669	<tr>
	670	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	671	<td>user-supplied object
	672	</td>
	673	</tr>
	674	</tbody>
	675	</table></div>
	676	</div>
	677	<hr>
	678	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()">
	679	<a name="tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()</h3>
	680	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts)
	681	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	682	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
	683	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	684	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	685	<p>
	686	Signature of the callback called when a UnblockContacts method call
	687	succeeds or fails.
	688	</p>
	689	<div class="variablelist"><table border="0">
	690	<col align="left" valign="top">
	691	<tbody>
	692	<tr>
	693	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	694	<td>the proxy on which the call was made
	695	</td>
	696	</tr>
	697	<tr>
	698	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	699	<td>
	700	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
	701	</td>
	702	</tr>
	703	<tr>
	704	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	705	<td>user-supplied data
	706	</td>
	707	</tr>
	708	<tr>
	709	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	710	<td>user-supplied object
	711	</td>
	712	</tr>
	713	</tbody>
	714	</table></div>
	715	</div>
	716	<hr>
	717	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ()">
	718	<a name="tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed"></a><h3>tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ()</h3>
	719	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed
	720	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	721	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed" title="tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()"><span class="type">tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed</span></a> callback</code></em>,
	722	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	723	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	724	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
	725	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
	726	<p>
	727	Connect a handler to the signal BlockedContactsChanged.
	728	</p>
	729	<p>
	730	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when the list of blocked contacts is first retrieved (before returning from any pending calls to <tp:member-ref>RequestBlockedContacts</tp:member-ref>), and whenever the list of blocked contacts subsequently changes.</p>
	731	</p>
	732	<div class="variablelist"><table border="0">
	733	<col align="left" valign="top">
	734	<tbody>
	735	<tr>
	736	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	737	<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
	738	</td>
	739	</tr>
	740	<tr>
	741	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	742	<td>Callback to be called when the signal is
	743	received
	744	</td>
	745	</tr>
	746	<tr>
	747	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	748	<td>User-supplied data for the callback
	749	</td>
	750	</tr>
	751	<tr>
	752	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	753	<td>Destructor for the user-supplied data, which
	754	will be called when this signal is disconnected, or
	755	before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	756	</td>
	757	</tr>
	758	<tr>
	759	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	760	<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
	761	if it is destroyed, this callback will automatically be
	762	disconnected
	763	</td>
	764	</tr>
	765	<tr>
	766	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	767	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
	768	returned
	769	</td>
	770	</tr>
	771	<tr>
	772	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	773	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
	774	above, which can be used to disconnect the signal; or
	775	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
	776	or has become invalid.
	777	</td>
	778	</tr>
	779	</tbody>
	780	</table></div>
	781	</div>
	782	<hr>
	783	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_run_block_contacts ()">
	784	<a name="tp-cli-connection-interface-contact-blocking-run-block-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_run_block_contacts ()</h3>
	785	<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_connection_interface_contact_blocking_run_block_contacts
	786	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	787	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	788	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	789	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Report_Abusive</code></em>,
	790	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
	791	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
	792	<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
	793	<h3 class="title">Warning</h3>
	794	<p><code class="literal">tp_cli_connection_interface_contact_blocking_run_block_contacts</code> is deprecated and should not be used in newly-written code.</p>
	795	</div>
	796	<p>
	797	Call the method BlockContacts and run the main loop
	798	until it returns. Before calling this method, you must
	799	add a reference to any borrowed objects you need to keep,
	800	and generally ensure that everything is in a consistent
	801	state.
	802	</p>
	803	<p>
	804	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Direct the server to block some contacts. The precise effect is protocol-dependent, but SHOULD include ignoring all current and subsequent communications from the given contacts, avoiding sending presence to them in future, and if they were already receiving the local user's presence, behaving as if the local user went offline.</p>
	805	</p>
	806	<div class="variablelist"><table border="0">
	807	<col align="left" valign="top">
	808	<tbody>
	809	<tr>
	810	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	811	<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
	812	</td>
	813	</tr>
	814	<tr>
	815	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	816	<td>Timeout in milliseconds, or -1 for default
	817	</td>
	818	</tr>
	819	<tr>
	820	<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
	821	<td>Used to pass an 'in' argument: Some contacts to block. If some of the contacts in this list are already blocked, the connection manager MUST act as if they were not specified in this list.
	822	</td>
	823	</tr>
	824	<tr>
	825	<td><p><span class="term"><em class="parameter"><code>in_Report_Abusive</code></em> :</span></p></td>
	826	<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>In addition to blocking, report these contacts as abusive to the server administrators.</p> <p>Clients can determine whether this capability is available by checking the <tp:member-ref>ContactBlockingCapabilities</tp:member-ref> property. If this argument is set to <code>True</code> by a client despite <tp:member-ref>ContactBlockingCapabilities</tp:member-ref> not containing the <code>Can_Report_Abusive</code> flag, the connection manager SHOULD act as if it were <code>False</code> and simply block the supplied contacts.</p> <tp:rationale> <p>A correct user interface shouldn't get this far without knowing that reporting abusive contacts is not supported. If it does, then the user has expressed their intention to block these contacts. Returning an error would leave the UI with three options:</p> <ul> <li>Ignore the error, leaving the contacts not actually blocked;</li> <li>Display an error to the user;</li> <li>Call this method again, passing <code>False</code> for this argument.</li> </ul> <p>None of these seem preferable to the CM just ignoring this flag if it doesn't support it: that way, the contacts will be blocked, as the user requested, and UIs have fewer ways to mess up entirely.</p> </tp:rationale>
	827	</td>
	828	</tr>
	829	<tr>
	830	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	831	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
	832	is returned
	833	</td>
	834	</tr>
	835	<tr>
	836	<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
	837	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
	838	the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
	839	which can be used to cancel this call with
	840	<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
	841	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
	842	</td>
	843	</tr>
	844	<tr>
	845	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	846	<td> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error
	847	</td>
	848	</tr>
	849	</tbody>
	850	</table></div>
	851	</div>
	852	<hr>
	853	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts ()">
	854	<a name="tp-cli-connection-interface-contact-blocking-run-request-blocked-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts ()</h3>
	855	<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts
	856	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	857	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	858	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **out_Contacts</code></em>,
	859	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
	860	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
	861	<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
	862	<h3 class="title">Warning</h3>
	863	<p><code class="literal">tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts</code> is deprecated and should not be used in newly-written code.</p>
	864	</div>
	865	<p>
	866	Call the method RequestBlockedContacts and run the main loop
	867	until it returns. Before calling this method, you must
	868	add a reference to any borrowed objects you need to keep,
	869	and generally ensure that everything is in a consistent
	870	state.
	871	</p>
	872	<p>
	873	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>List the contacts that are blocked.</p> <p>Clients SHOULD allow a relatively long timeout for calls to this method, since on some protocols contact blocking is part of the contact list, which can take a significant time to retrieve.</p>
	874	</p>
	875	<div class="variablelist"><table border="0">
	876	<col align="left" valign="top">
	877	<tbody>
	878	<tr>
	879	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	880	<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
	881	</td>
	882	</tr>
	883	<tr>
	884	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	885	<td>Timeout in milliseconds, or -1 for default
	886	</td>
	887	</tr>
	888	<tr>
	889	<td><p><span class="term"><em class="parameter"><code>out_Contacts</code></em> :</span></p></td>
	890	<td>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The blocked contacts’ handles, together with their identifiers.
	891	</td>
	892	</tr>
	893	<tr>
	894	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	895	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
	896	is returned
	897	</td>
	898	</tr>
	899	<tr>
	900	<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
	901	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
	902	the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
	903	which can be used to cancel this call with
	904	<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
	905	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
	906	</td>
	907	</tr>
	908	<tr>
	909	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	910	<td> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error
	911	</td>
	912	</tr>
	913	</tbody>
	914	</table></div>
	915	</div>
	916	<hr>
	917	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_run_unblock_contacts ()">
	918	<a name="tp-cli-connection-interface-contact-blocking-run-unblock-contacts"></a><h3>tp_cli_connection_interface_contact_blocking_run_unblock_contacts ()</h3>
	919	<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_connection_interface_contact_blocking_run_unblock_contacts
	920	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	921	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	922	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	923	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
	924	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
	925	<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
	926	<h3 class="title">Warning</h3>
	927	<p><code class="literal">tp_cli_connection_interface_contact_blocking_run_unblock_contacts</code> is deprecated and should not be used in newly-written code.</p>
	928	</div>
	929	<p>
	930	Call the method UnblockContacts and run the main loop
	931	until it returns. Before calling this method, you must
	932	add a reference to any borrowed objects you need to keep,
	933	and generally ensure that everything is in a consistent
	934	state.
	935	</p>
	936	<p>
	937	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Direct the server to unblock some contacts.</p>
	938	</p>
	939	<div class="variablelist"><table border="0">
	940	<col align="left" valign="top">
	941	<tbody>
	942	<tr>
	943	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	944	<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
	945	</td>
	946	</tr>
	947	<tr>
	948	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	949	<td>Timeout in milliseconds, or -1 for default
	950	</td>
	951	</tr>
	952	<tr>
	953	<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
	954	<td>Used to pass an 'in' argument: Some contacts to unblock. If some of the contacts in this list are not currently blocked, the connection manager MUST act as if they were not specified in this list.
	955	</td>
	956	</tr>
	957	<tr>
	958	<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
	959	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
	960	is returned
	961	</td>
	962	</tr>
	963	<tr>
	964	<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
	965	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
	966	the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
	967	which can be used to cancel this call with
	968	<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
	969	<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
	970	</td>
	971	</tr>
	972	<tr>
	973	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	974	<td> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error
	975	</td>
	976	</tr>
	977	</tbody>
	978	</table></div>
	979	</div>
	980	<hr>
	981	<div class="refsect2" title="tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()">
	982	<a name="tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed"></a><h3>tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()</h3>
	983	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed)
	984	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	985	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Blocked_Contacts</code></em>,
	986	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Unblocked_Contacts</code></em>,
	987	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	988	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	989	<p>
	990	Represents the signature of a callback for the signal BlockedContactsChanged.
	991	</p>
	992	<div class="variablelist"><table border="0">
	993	<col align="left" valign="top">
	994	<tbody>
	995	<tr>
	996	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	997	<td>The proxy on which <a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed" title="tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ()"><code class="function">tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed()</code></a>
	998	was called
	999	</td>
	1000	</tr>
	1001	<tr>
	1002	<td><p><span class="term"><em class="parameter"><code>arg_Blocked_Contacts</code></em> :</span></p></td>
	1003	<td>Contacts added to the result of <tp:member-ref>RequestBlockedContacts</tp:member-ref>.
	1004	</td>
	1005	</tr>
	1006	<tr>
	1007	<td><p><span class="term"><em class="parameter"><code>arg_Unblocked_Contacts</code></em> :</span></p></td>
	1008	<td>Contacts removed from the result of <tp:member-ref>RequestBlockedContacts</tp:member-ref>.
	1009	</td>
	1010	</tr>
	1011	<tr>
	1012	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	1013	<td>User-supplied data
	1014	</td>
	1015	</tr>
	1016	<tr>
	1017	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	1018	<td>User-supplied weakly referenced object
	1019	</td>
	1020	</tr>
	1021	</tbody>
	1022	</table></div>
	1023	</div>
	1024	<hr>
	1025	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_add_to_group ()">
	1026	<a name="tp-cli-connection-interface-contact-groups-call-add-to-group"></a><h3>tp_cli_connection_interface_contact_groups_call_add_to_group ()</h3>
	1027	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_add_to_group
	1028	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	1029	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	1030	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
	1031	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Members</code></em>,
	1032	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-add-to-group" title="tp_cli_connection_interface_contact_groups_callback_for_add_to_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_add_to_group</span></a> callback</code></em>,
	1033	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1034	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	1035	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	1036	<p>
	1037	Start a AddToGroup method call.
	1038	</p>
	1039	<p>
	1040	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Add the given members to the given group, creating it if necessary.</p> <p>If <tp:member-ref>DisjointGroups</tp:member-ref> is true, this will also remove each member from their previous group.</p> <tp:rationale> <p>This is good for user interfaces in which you can edit groups via drag-and-drop.</p> </tp:rationale> <p>Any <tp:member-ref>GroupsCreated</tp:member-ref>, <tp:member-ref>GroupsChanged</tp:member-ref> and <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
550	1041	</p>
551	1042	<div class="variablelist"><table border="0">
552	1043	<col align="left" valign="top">

563	1054	</td>
564	1055	</tr>
565	1056	<tr>
566		<td><p><span class="term"><em class="parameter"><code>in_Old_Name</code></em> :</span></p></td>
567		<td>Used to pass an 'in' argument: The group to rename.
568		</td>
569		</tr>
570		<tr>
571		<td><p><span class="term"><em class="parameter"><code>in_New_Name</code></em> :</span></p></td>
572		<td>Used to pass an 'in' argument: The new name for the group.
	1057	<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
	1058	<td>Used to pass an 'in' argument: The group to alter.
	1059	</td>
	1060	</tr>
	1061	<tr>
	1062	<td><p><span class="term"><em class="parameter"><code>in_Members</code></em> :</span></p></td>
	1063	<td>Used to pass an 'in' argument: The set of members to include in the group.
573	1064	</td>
574	1065	</tr>
575	1066	<tr>

612	1103	</table></div>
613	1104	</div>
614	1105	<hr>
615		<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_set_contact_groups ()">
616		<a name="tp-cli-connection-interface-contact-groups-call-set-contact-groups"></a><h3>tp_cli_connection_interface_contact_groups_call_set_contact_groups ()</h3>
617		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_set_contact_groups
618		(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
619		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
620		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
621		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Groups</code></em>,
622		<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-set-contact-groups" title="tp_cli_connection_interface_contact_groups_callback_for_set_contact_groups ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_set_contact_groups</span></a> callback</code></em>,
623		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
624		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
625		<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
626		<p>
627		Start a SetContactGroups method call.
628		</p>
629		<p>
630		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Add the given contact to the given groups (creating new groups if necessary), and remove them from all other groups.</p> <tp:rationale> <p>This is the easiest and most correct way to implement user interfaces that display a single contact with a list of groups, resulting in a user expectation that when they apply the changes, the contact's set of groups will become exactly what was displayed.</p> </tp:rationale> <p>If the user is removed from a group of which they were the only member, the group MAY be removed automatically.</p> <tp:rationale> <p>In protocols like XMPP where groups behave like tags, a group with no members has no protocol representation.</p> </tp:rationale> <p>Any <tp:member-ref>GroupsCreated</tp:member-ref>, <tp:member-ref>GroupsChanged</tp:member-ref> and <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	1106	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_remove_from_group ()">
	1107	<a name="tp-cli-connection-interface-contact-groups-call-remove-from-group"></a><h3>tp_cli_connection_interface_contact_groups_call_remove_from_group ()</h3>
	1108	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_remove_from_group
	1109	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	1110	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	1111	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
	1112	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Members</code></em>,
	1113	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-remove-from-group" title="tp_cli_connection_interface_contact_groups_callback_for_remove_from_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_remove_from_group</span></a> callback</code></em>,
	1114	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1115	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	1116	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	1117	<p>
	1118	Start a RemoveFromGroup method call.
	1119	</p>
	1120	<p>
	1121	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Remove the given members from the given group.</p> <tp:rationale> <p>This is good for user interfaces in which you can edit groups via drag-and-drop.</p> </tp:rationale> <p>Any <tp:member-ref>GroupsChanged</tp:member-ref> or <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
631	1122	</p>
632	1123	<div class="variablelist"><table border="0">
633	1124	<col align="left" valign="top">

644	1135	</td>
645	1136	</tr>
646	1137	<tr>
647		<td><p><span class="term"><em class="parameter"><code>in_Contact</code></em> :</span></p></td>
648		<td>Used to pass an 'in' argument: The contact to alter.
649		</td>
650		</tr>
651		<tr>
652		<td><p><span class="term"><em class="parameter"><code>in_Groups</code></em> :</span></p></td>
653		<td>Used to pass an 'in' argument: The set of groups which the contact should be in.
	1138	<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
	1139	<td>Used to pass an 'in' argument: The group to alter. If it does not exist, then it has no members by definition, so this method SHOULD return successfully.
	1140	</td>
	1141	</tr>
	1142	<tr>
	1143	<td><p><span class="term"><em class="parameter"><code>in_Members</code></em> :</span></p></td>
	1144	<td>Used to pass an 'in' argument: The set of members to remove from the group. It is not an error to remove members who are already not in the group. If there are no members left in the group afterwards, the group MAY itself be removed.
654	1145	</td>
655	1146	</tr>
656	1147	<tr>

693	1184	</table></div>
694	1185	</div>
695	1186	<hr>
696		<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_set_group_members ()">
697		<a name="tp-cli-connection-interface-contact-groups-call-set-group-members"></a><h3>tp_cli_connection_interface_contact_groups_call_set_group_members ()</h3>
698		<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_set_group_members
	1187	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_remove_group ()">
	1188	<a name="tp-cli-connection-interface-contact-groups-call-remove-group"></a><h3>tp_cli_connection_interface_contact_groups_call_remove_group ()</h3>
	1189	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_remove_group
699	1190	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
700	1191	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
701	1192	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
702		<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Members</code></em>,
703		<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-set-group-members" title="tp_cli_connection_interface_contact_groups_callback_for_set_group_members ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_set_group_members</span></a> callback</code></em>,
704		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
705		<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
706		<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
707		<p>
708		Start a SetGroupMembers method call.
709		</p>
710		<p>
711		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Add the given members to the given group (creating it if necessary), and remove all other members.</p> <tp:rationale> <p>This is the easiest and most correct way to implement user interfaces that display a single group with a list of contacts, resulting in a user expectation that when they apply the changes, the groups's set of members will become exactly what was displayed.</p> </tp:rationale> <p>If <tp:member-ref>DisjointGroups</tp:member-ref> is true, this will also remove each member from their previous group.</p> <p>If the user is removed from a group of which they were the only member, the group MAY be removed automatically.</p> <p>Any <tp:member-ref>GroupsCreated</tp:member-ref>, <tp:member-ref>GroupsChanged</tp:member-ref> and <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	1193	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-remove-group" title="tp_cli_connection_interface_contact_groups_callback_for_remove_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_remove_group</span></a> callback</code></em>,
	1194	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1195	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	1196	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	1197	<p>
	1198	Start a RemoveGroup method call.
	1199	</p>
	1200	<p>
	1201	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Remove all members from the given group, then remove the group itself. If the group already does not exist, this method SHOULD return successfully.</p> <p>Any <tp:member-ref>GroupsChanged</tp:member-ref> or <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
712	1202	</p>
713	1203	<div class="variablelist"><table border="0">
714	1204	<col align="left" valign="top">

726	1216	</tr>
727	1217	<tr>
728	1218	<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
729		<td>Used to pass an 'in' argument: The group to alter.
730		</td>
731		</tr>
732		<tr>
733		<td><p><span class="term"><em class="parameter"><code>in_Members</code></em> :</span></p></td>
734		<td>Used to pass an 'in' argument: The set of members for the group. If this set is empty, this method MAY remove the group.
	1219	<td>Used to pass an 'in' argument: The group to remove.
735	1220	</td>
736	1221	</tr>
737	1222	<tr>

774	1259	</table></div>
775	1260	</div>
776	1261	<hr>
	1262	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_rename_group ()">
	1263	<a name="tp-cli-connection-interface-contact-groups-call-rename-group"></a><h3>tp_cli_connection_interface_contact_groups_call_rename_group ()</h3>
	1264	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_rename_group
	1265	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	1266	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	1267	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Old_Name</code></em>,
	1268	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_New_Name</code></em>,
	1269	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-rename-group" title="tp_cli_connection_interface_contact_groups_callback_for_rename_group ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_rename_group</span></a> callback</code></em>,
	1270	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1271	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	1272	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	1273	<p>
	1274	Start a RenameGroup method call.
	1275	</p>
	1276	<p>
	1277	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Rename the given group.</p> <p>On protocols where groups behave like tags, this is an API short-cut for adding all of the group's members to a group with the new name, then removing the old group.</p> <tp:rationale> <p>Otherwise, clients can't perform this operation atomically, even if the connection could.</p> </tp:rationale> <p>Any <tp:member-ref>GroupRenamed</tp:member-ref> or <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	1278	</p>
	1279	<div class="variablelist"><table border="0">
	1280	<col align="left" valign="top">
	1281	<tbody>
	1282	<tr>
	1283	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	1284	<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
	1285	</td>
	1286	</tr>
	1287	<tr>
	1288	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	1289	<td>the timeout in milliseconds, or -1 to use the
	1290	default
	1291	</td>
	1292	</tr>
	1293	<tr>
	1294	<td><p><span class="term"><em class="parameter"><code>in_Old_Name</code></em> :</span></p></td>
	1295	<td>Used to pass an 'in' argument: The group to rename.
	1296	</td>
	1297	</tr>
	1298	<tr>
	1299	<td><p><span class="term"><em class="parameter"><code>in_New_Name</code></em> :</span></p></td>
	1300	<td>Used to pass an 'in' argument: The new name for the group.
	1301	</td>
	1302	</tr>
	1303	<tr>
	1304	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	1305	<td>called when the method call succeeds or fails;
	1306	may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
	1307	reply tracking
	1308	</td>
	1309	</tr>
	1310	<tr>
	1311	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	1312	<td>user-supplied data passed to the callback;
	1313	must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1314	</td>
	1315	</tr>
	1316	<tr>
	1317	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	1318	<td>called with the user_data as argument, after the
	1319	call has succeeded, failed or been cancelled;
	1320	must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1321	</td>
	1322	</tr>
	1323	<tr>
	1324	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	1325	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
	1326	weakly referenced; if it is destroyed, this call
	1327	will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
	1328	<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1329	</td>
	1330	</tr>
	1331	<tr>
	1332	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	1333	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
	1334	progress. It is borrowed from the object, and will become
	1335	invalid when the callback is called, the call is
	1336	cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
	1337	</td>
	1338	</tr>
	1339	</tbody>
	1340	</table></div>
	1341	</div>
	1342	<hr>
	1343	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_set_contact_groups ()">
	1344	<a name="tp-cli-connection-interface-contact-groups-call-set-contact-groups"></a><h3>tp_cli_connection_interface_contact_groups_call_set_contact_groups ()</h3>
	1345	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_set_contact_groups
	1346	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	1347	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	1348	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
	1349	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Groups</code></em>,
	1350	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-set-contact-groups" title="tp_cli_connection_interface_contact_groups_callback_for_set_contact_groups ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_set_contact_groups</span></a> callback</code></em>,
	1351	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1352	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	1353	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	1354	<p>
	1355	Start a SetContactGroups method call.
	1356	</p>
	1357	<p>
	1358	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Add the given contact to the given groups (creating new groups if necessary), and remove them from all other groups.</p> <tp:rationale> <p>This is the easiest and most correct way to implement user interfaces that display a single contact with a list of groups, resulting in a user expectation that when they apply the changes, the contact's set of groups will become exactly what was displayed.</p> </tp:rationale> <p>If the user is removed from a group of which they were the only member, the group MAY be removed automatically.</p> <tp:rationale> <p>In protocols like XMPP where groups behave like tags, a group with no members has no protocol representation.</p> </tp:rationale> <p>Any <tp:member-ref>GroupsCreated</tp:member-ref>, <tp:member-ref>GroupsChanged</tp:member-ref> and <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	1359	</p>
	1360	<div class="variablelist"><table border="0">
	1361	<col align="left" valign="top">
	1362	<tbody>
	1363	<tr>
	1364	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	1365	<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
	1366	</td>
	1367	</tr>
	1368	<tr>
	1369	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	1370	<td>the timeout in milliseconds, or -1 to use the
	1371	default
	1372	</td>
	1373	</tr>
	1374	<tr>
	1375	<td><p><span class="term"><em class="parameter"><code>in_Contact</code></em> :</span></p></td>
	1376	<td>Used to pass an 'in' argument: The contact to alter.
	1377	</td>
	1378	</tr>
	1379	<tr>
	1380	<td><p><span class="term"><em class="parameter"><code>in_Groups</code></em> :</span></p></td>
	1381	<td>Used to pass an 'in' argument: The set of groups which the contact should be in.
	1382	</td>
	1383	</tr>
	1384	<tr>
	1385	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	1386	<td>called when the method call succeeds or fails;
	1387	may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
	1388	reply tracking
	1389	</td>
	1390	</tr>
	1391	<tr>
	1392	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	1393	<td>user-supplied data passed to the callback;
	1394	must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1395	</td>
	1396	</tr>
	1397	<tr>
	1398	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	1399	<td>called with the user_data as argument, after the
	1400	call has succeeded, failed or been cancelled;
	1401	must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1402	</td>
	1403	</tr>
	1404	<tr>
	1405	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	1406	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
	1407	weakly referenced; if it is destroyed, this call
	1408	will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
	1409	<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1410	</td>
	1411	</tr>
	1412	<tr>
	1413	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	1414	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
	1415	progress. It is borrowed from the object, and will become
	1416	invalid when the callback is called, the call is
	1417	cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
	1418	</td>
	1419	</tr>
	1420	</tbody>
	1421	</table></div>
	1422	</div>
	1423	<hr>
	1424	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_call_set_group_members ()">
	1425	<a name="tp-cli-connection-interface-contact-groups-call-set-group-members"></a><h3>tp_cli_connection_interface_contact_groups_call_set_group_members ()</h3>
	1426	<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_groups_call_set_group_members
	1427	(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
	1428	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
	1429	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Group</code></em>,
	1430	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Members</code></em>,
	1431	<em class="parameter"><code><a class="link" href="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-callback-for-set-group-members" title="tp_cli_connection_interface_contact_groups_callback_for_set_group_members ()"><span class="type">tp_cli_connection_interface_contact_groups_callback_for_set_group_members</span></a> callback</code></em>,
	1432	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
	1433	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
	1434	<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
	1435	<p>
	1436	Start a SetGroupMembers method call.
	1437	</p>
	1438	<p>
	1439	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Add the given members to the given group (creating it if necessary), and remove all other members.</p> <tp:rationale> <p>This is the easiest and most correct way to implement user interfaces that display a single group with a list of contacts, resulting in a user expectation that when they apply the changes, the groups's set of members will become exactly what was displayed.</p> </tp:rationale> <p>If <tp:member-ref>DisjointGroups</tp:member-ref> is true, this will also remove each member from their previous group.</p> <p>If the user is removed from a group of which they were the only member, the group MAY be removed automatically.</p> <p>Any <tp:member-ref>GroupsCreated</tp:member-ref>, <tp:member-ref>GroupsChanged</tp:member-ref> and <tp:member-ref>GroupsRemoved</tp:member-ref> signals that result from this method call MUST be emitted before the method returns.</p> <p>This method SHOULD NOT be called until the <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">ContactListState</tp:dbus-ref> changes to Success. If the ContactListState is Failure, this method SHOULD raise the same error as <tp:dbus-ref namespace="ofdT.Connection.Interface.ContactList">GetContactListAttributes</tp:dbus-ref>.</p>
	1440	</p>
	1441	<div class="variablelist"><table border="0">
	1442	<col align="left" valign="top">
	1443	<tbody>
	1444	<tr>
	1445	<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
	1446	<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
	1447	</td>
	1448	</tr>
	1449	<tr>
	1450	<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
	1451	<td>the timeout in milliseconds, or -1 to use the
	1452	default
	1453	</td>
	1454	</tr>
	1455	<tr>
	1456	<td><p><span class="term"><em class="parameter"><code>in_Group</code></em> :</span></p></td>
	1457	<td>Used to pass an 'in' argument: The group to alter.
	1458	</td>
	1459	</tr>
	1460	<tr>
	1461	<td><p><span class="term"><em class="parameter"><code>in_Members</code></em> :</span></p></td>
	1462	<td>Used to pass an 'in' argument: The set of members for the group. If this set is empty, this method MAY remove the group.
	1463	</td>
	1464	</tr>
	1465	<tr>
	1466	<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
	1467	<td>called when the method call succeeds or fails;
	1468	may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
	1469	reply tracking
	1470	</td>
	1471	</tr>
	1472	<tr>
	1473	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	1474	<td>user-supplied data passed to the callback;
	1475	must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1476	</td>
	1477	</tr>
	1478	<tr>
	1479	<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
	1480	<td>called with the user_data as argument, after the
	1481	call has succeeded, failed or been cancelled;
	1482	must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1483	</td>
	1484	</tr>
	1485	<tr>
	1486	<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
	1487	<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
	1488	weakly referenced; if it is destroyed, this call
	1489	will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
	1490	<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1491	</td>
	1492	</tr>
	1493	<tr>
	1494	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
	1495	<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
	1496	progress. It is borrowed from the object, and will become
	1497	invalid when the callback is called, the call is
	1498	cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
	1499	</td>
	1500	</tr>
	1501	</tbody>
	1502	</table></div>
	1503	</div>
	1504	<hr>
777	1505	<div class="refsect2" title="tp_cli_connection_interface_contact_groups_callback_for_add_to_group ()">
778	1506	<a name="tp-cli-connection-interface-contact-groups-callback-for-add-to-group"></a><h3>tp_cli_connection_interface_contact_groups_callback_for_add_to_group ()</h3>
779	1507	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_groups_callback_for_add_to_group)

+1

-1

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

5457	5457	</tr>
5458	5458	<tr>
5459	5459	<td><p><span class="term"><em class="parameter"><code>arg_Details</code></em> :</span></p></td>
5460		<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Additional information about the error, which may include the following well-known keys:</p> <dl> <dt>debug-message (s)</dt> <dd>Debugging information on the change, corresponding to the message part of a D-Bus error message, which SHOULD NOT be displayed to users under normal circumstances</dd> <dt>user-requested (b), expected-hostname (s), certificate-hostname (s)</dt> <dd>The same details defined in <tp:type>TLS_Certificate_Rejection</tp:type>.</dd> </dl>
	5460	<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Additional information about the error, which may include the following well-known keys:</p> <dl> <dt>debug-message (s)</dt> <dd>Debugging information on the change, corresponding to the message part of a D-Bus error message, which SHOULD NOT be displayed to users under normal circumstances</dd> <dt>server-message (s)</dt> <dd>A human-readable message from the server explaining what happened. This may be in the user's native language, or in the server operator's native language, or even in Lojban.</dd> <dt>user-requested (b), expected-hostname (s), certificate-hostname (s)</dt> <dd>The same details defined in <tp:type>TLS_Certificate_Rejection</tp:type>.</dd> </dl>
5461	5461	</td>
5462	5462	</tr>
5463	5463	<tr>

+3

-3

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

862	862	</tr>
863	863	<tr>
864	864	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
865		<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-dbus-gobject.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is a copy
	865	<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is a copy
866	866	of <em class="parameter"><code>path</code></em>, to be freed with <a class="link" href="telepathy-glib-util.html#tp-g-value-slice-free" title="tp_g_value_slice_free ()"><code class="function">tp_g_value_slice_free()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a>
867	867
868	868	</td>

891	891	</tr>
892	892	<tr>
893	893	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
894		<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-dbus-gobject.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is <em class="parameter"><code>path</code></em>,
	894	<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is <em class="parameter"><code>path</code></em>,
895	895	to be freed with <a class="link" href="telepathy-glib-util.html#tp-g-value-slice-free" title="tp_g_value_slice_free ()"><code class="function">tp_g_value_slice_free()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a>
896	896
897	897	</td>

922	922	</tr>
923	923	<tr>
924	924	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
925		<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-dbus-gobject.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is <em class="parameter"><code>path</code></em>,
	925	<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is <em class="parameter"><code>path</code></em>,
926	926	to be freed with <a class="link" href="telepathy-glib-util.html#tp-g-value-slice-free" title="tp_g_value_slice_free ()"><code class="function">tp_g_value_slice_free()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a>
927	927
928	928	</td>

+37

-16

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

335	335	<p>
336	336	An example of its usage, taking in mind the notes above, follows:
337	337	</p>
338		<div class="informalexample"><pre class="programlisting">
339		/* Create a main loop and debug sender */
340		GMainLoop *loop = g_main_loop_new (NULL, FALSE);
341		TpDebugSender *sender = tp_debug_sender_dup ();
342
343		/* Set the default handler */
344		g_log_set_default_handler (tp_debug_sender_log_handler, G_LOG_DOMAIN);
345
346		/* Run the main loop, but keeping a ref on the TpDebugSender from
347		* the beginning of this code sample. */
348		g_main_loop_run (loop);
349
350		/* g_main_loop_quit was called, so only now can we clean up the
351		* TpDebugSender. */
352		g_object_unref (sender);
353		</pre></div>
	338	<div class="informalexample">
	339	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	340	<tbody>
	341	<tr>
	342	<td class="listing_lines" align="right"><pre>1
	343	2
	344	3
	345	4
	346	5
	347	6
	348	7
	349	8
	350	9
	351	10
	352	11
	353	12
	354	13
	355	14</pre></td>
	356	<td class="listing_code"><pre class="programlisting"><span class="comment">/* Create a main loop and debug sender */</span>
	357	GMainLoop <span class="symbol">*</span>loop <span class="symbol">=</span> <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-new">g_main_loop_new</a></span> <span class="symbol">(</span>NULL<span class="symbol">,</span> FALSE<span class="symbol">);</span>
	358	TpDebugSender <span class="symbol">*</span>sender <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-debug-sender.html#tp-debug-sender-dup">tp_debug_sender_dup</a></span> <span class="symbol">();</span>
	359
	360	<span class="comment">/* Set the default handler */</span>
	361	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-set-default-handler">g_log_set_default_handler</a></span> <span class="symbol">(</span>tp_debug_sender_log_handler<span class="symbol">,</span> G_LOG_DOMAIN<span class="symbol">);</span>
	362
	363	<span class="comment">/* Run the main loop, but keeping a ref on the TpDebugSender from</span>
	364	<span class="comment"> * the beginning of this code sample. */</span>
	365	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-run">g_main_loop_run</a></span> <span class="symbol">(</span>loop<span class="symbol">);</span>
	366
	367	<span class="comment">/* g_main_loop_quit was called, so only now can we clean up the</span>
	368	<span class="comment"> * TpDebugSender. */</span>
	369	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> <span class="symbol">(</span>sender<span class="symbol">);</span></pre></td>
	370	</tr>
	371	</tbody>
	372	</table>
	373	</div>
	374
354	375	<p>
355	376	</p>
356	377	<p>

+13

-3

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

206	206	</p>
207	207	<p>
208	208	</p>
209		<div class="informalexample"><pre class="programlisting">if (g_getenv ("MYPROG_TIMING") != NULL)
210		g_log_set_default_handler (tp_debug_timestamped_log_handler, NULL);
211		</pre></div>
	209	<div class="informalexample">
	210	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	211	<tbody>
	212	<tr>
	213	<td class="listing_lines" align="right"><pre>1
	214	2</pre></td>
	215	<td class="listing_code"><pre class="programlisting"><span class="keyword">if</span> <span class="symbol">(</span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-getenv">g_getenv</a></span> <span class="symbol">(</span><span class="string">"MYPROG_TIMING"</span><span class="symbol">) !=</span> NULL<span class="symbol">)</span>
	216	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-log-set-default-handler">g_log_set_default_handler</a></span> <span class="symbol">(</span>tp_debug_timestamped_log_handler<span class="symbol">,</span> NULL<span class="symbol">);</span></pre></td>
	217	</tr>
	218	</tbody>
	219	</table>
	220	</div>
	221
212	222	<p>
213	223	</p>
214	224	<p>

+1

-1

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

198	198	The "user action time" used by methods like
199	199	<a class="link" href="telepathy-glib-account-channel-request.html#tp-account-channel-request-new" title="tp_account_channel_request_new ()"><code class="function">tp_account_channel_request_new()</code></a> to represent channel requests that should
200	200	be treated as though they happened at the current time. This is the same
201		concept as <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a> in Gdk (but note that the numerical value used
	201	concept as <a href="/usr/share/gtk-doc/html/gdk/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a> in Gdk (but note that the numerical value used
202	202	in Telepathy is not the same).
203	203	</p>
204	204	<p>

+20

-0

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

72	72	enum <a class="link" href="telepathy-glib-enums.html#TpChannelGroupChangeReason" title="enum TpChannelGroupChangeReason">TpChannelGroupChangeReason</a>;
73	73	#define <a class="link" href="telepathy-glib-enums.html#NUM-TP-CHANNEL-GROUP-CHANGE-REASONS:CAPS" title="NUM_TP_CHANNEL_GROUP_CHANGE_REASONS">NUM_TP_CHANNEL_GROUP_CHANGE_REASONS</a>
74	74	enum <a class="link" href="telepathy-glib-enums.html#TpChannelPasswordFlags" title="enum TpChannelPasswordFlags">TpChannelPasswordFlags</a>;
	75	enum <a class="link" href="telepathy-glib-enums.html#TpContactBlockingCapabilities" title="enum TpContactBlockingCapabilities">TpContactBlockingCapabilities</a>;
75	76	enum <a class="link" href="telepathy-glib-enums.html#TpDeliveryReportingSupportFlags" title="enum TpDeliveryReportingSupportFlags">TpDeliveryReportingSupportFlags</a>;
76	77	enum <a class="link" href="telepathy-glib-enums.html#TpDeliveryStatus" title="enum TpDeliveryStatus">TpDeliveryStatus</a>;
77	78	#define <a class="link" href="telepathy-glib-enums.html#NUM-TP-DELIVERY-STATUSES:CAPS" title="NUM_TP_DELIVERY_STATUSES">NUM_TP_DELIVERY_STATUSES</a>

1335	1336	</table></div>
1336	1337	</div>
1337	1338	<hr>
	1339	<div class="refsect2" title="enum TpContactBlockingCapabilities">
	1340	<a name="TpContactBlockingCapabilities"></a><h3>enum TpContactBlockingCapabilities</h3>
	1341	<pre class="programlisting">typedef enum /< flags >/ {
	1342	TP_CONTACT_BLOCKING_CAPABILITY_CAN_REPORT_ABUSIVE = 1,
	1343	} TpContactBlockingCapabilities;
	1344	</pre>
	1345	<p>
	1346	Bitfield/set of flags generated from the Telepathy specification.
	1347	</p>
	1348	<div class="variablelist"><table border="0">
	1349	<col align="left" valign="top">
	1350	<tbody><tr>
	1351	<td><p><a name="TP-CONTACT-BLOCKING-CAPABILITY-CAN-REPORT-ABUSIVE:CAPS"></a><span class="term"><code class="literal">TP_CONTACT_BLOCKING_CAPABILITY_CAN_REPORT_ABUSIVE</code></span></p></td>
	1352	<td> When calling BlockContacts, the contacts may be reporting as abusive to the server administrators by setting Report_Abusive to True.
	1353	</td>
	1354	</tr></tbody>
	1355	</table></div>
	1356	</div>
	1357	<hr>
1338	1358	<div class="refsect2" title="enum TpDeliveryReportingSupportFlags">
1339	1359	<a name="TpDeliveryReportingSupportFlags"></a><h3>enum TpDeliveryReportingSupportFlags</h3>
1340	1360	<pre class="programlisting">typedef enum /< flags >/ {

+45

-0

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

92	92	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-GROUPS:CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_GROUPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_GROUPS</a>
93	93	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-POWER-SAVING:CAPS" title="TP_IFACE_CONNECTION_INTERFACE_POWER_SAVING">TP_IFACE_CONNECTION_INTERFACE_POWER_SAVING</a>
94	94	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-POWER-SAVING:CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_POWER_SAVING">TP_IFACE_QUARK_CONNECTION_INTERFACE_POWER_SAVING</a>
	95	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING">TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING</a>
	96	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING</a>
95	97	#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>
96	98	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-INFO:CAPS" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_INFO">TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_INFO</a>
97	99	#define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-LIST:CAPS" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_LIST">TP_IFACE_CONNECTION_INTERFACE_CONTACT_LIST</a>

310	312	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-FILE-TRANSFER-URI:CAPS" title="TP_PROP_CHANNEL_TYPE_FILE_TRANSFER_URI">TP_PROP_CHANNEL_TYPE_FILE_TRANSFER_URI</a>
311	313	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-ROOM-LIST-SERVER:CAPS" title="TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER">TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER</a>
312	314	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-HOSTNAME:CAPS" title="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_HOSTNAME">TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_HOSTNAME</a>
	315	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-REFERENCE-IDENTITIES:CAPS" title="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES">TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES</a>
313	316	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-SERVER-CERTIFICATE:CAPS" title="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE">TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE</a>
314	317	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-IMMUTABLE-STREAMS:CAPS" title="TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_IMMUTABLE_STREAMS">TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_IMMUTABLE_STREAMS</a>
315	318	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-INITIAL-AUDIO:CAPS" title="TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO">TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO</a>

345	348	#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>
346	349	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-OVERRIDE-MESSAGE-SERVICE-CENTRE:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CELLULAR_OVERRIDE_MESSAGE_SERVICE_CENTRE">TP_PROP_CONNECTION_INTERFACE_CELLULAR_OVERRIDE_MESSAGE_SERVICE_CENTRE</a>
347	350	#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>
	351	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-BLOCKING-CONTACT-BLOCKING-CAPABILITIES:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES">TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES</a>
348	352	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-DISJOINT-GROUPS:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS">TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS</a>
349	353	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS">TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS</a>
350	354	#define <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUP-STORAGE:CAPS" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUP_STORAGE">TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUP_STORAGE</a>

398	402	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-AVATARS-TOKEN:CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_AVATARS_TOKEN">TP_TOKEN_CONNECTION_INTERFACE_AVATARS_TOKEN</a>
399	403	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CAPABILITIES-CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_CAPABILITIES_CAPS">TP_TOKEN_CONNECTION_INTERFACE_CAPABILITIES_CAPS</a>
400	404	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CLIENT-TYPES-CLIENT-TYPES:CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_CLIENT_TYPES_CLIENT_TYPES">TP_TOKEN_CONNECTION_INTERFACE_CLIENT_TYPES_CLIENT_TYPES</a>
	405	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-BLOCKING-BLOCKED:CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED">TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED</a>
401	406	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-CAPABILITIES-CAPABILITIES:CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES">TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES</a>
402	407	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS">TP_TOKEN_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS</a>
403	408	#define <a class="link" href="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-INFO-INFO:CAPS" title="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_INFO_INFO">TP_TOKEN_CONNECTION_INTERFACE_CONTACT_INFO_INFO</a>

859	864	</p>
860	865	</div>
861	866	<hr>
	867	<div class="refsect2" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING">
	868	<a name="TP-IFACE-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS"></a><h3>TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING</h3>
	869	<pre class="programlisting">#define TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING</pre>
	870	<p>
	871	The interface name "org.freedesktop.Telepathy.Connection.Interface.ContactBlocking"
	872	</p>
	873	</div>
	874	<hr>
	875	<div class="refsect2" title="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING">
	876	<a name="TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS"></a><h3>TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING</h3>
	877	<pre class="programlisting">#define TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING</pre>
	878	<p>
	879	Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Connection.Interface.ContactBlocking"
	880	</p>
	881	</div>
	882	<hr>
862	883	<div class="refsect2" title="TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO">
863	884	<a name="TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"></a><h3>TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO</h3>
864	885	<pre class="programlisting">#define TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO</pre>

2603	2624	</p>
2604	2625	</div>
2605	2626	<hr>
	2627	<div class="refsect2" title="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES">
	2628	<a name="TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-REFERENCE-IDENTITIES:CAPS"></a><h3>TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES</h3>
	2629	<pre class="programlisting">#define TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES</pre>
	2630	<p>
	2631	The fully-qualified property name "org.freedesktop.Telepathy.Channel.Type.ServerTLSConnection.ReferenceIdentities"
	2632	</p>
	2633	</div>
	2634	<hr>
2606	2635	<div class="refsect2" title="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE">
2607	2636	<a name="TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-SERVER-CERTIFICATE:CAPS"></a><h3>TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE</h3>
2608	2637	<pre class="programlisting">#define TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE</pre>

2883	2912	</p>
2884	2913	</div>
2885	2914	<hr>
	2915	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES">
	2916	<a name="TP-PROP-CONNECTION-INTERFACE-CONTACT-BLOCKING-CONTACT-BLOCKING-CAPABILITIES:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES</h3>
	2917	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES</pre>
	2918	<p>
	2919	The fully-qualified property name "org.freedesktop.Telepathy.Connection.Interface.ContactBlocking.ContactBlockingCapabilities"
	2920	</p>
	2921	</div>
	2922	<hr>
2886	2923	<div class="refsect2" title="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS">
2887	2924	<a name="TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-DISJOINT-GROUPS:CAPS"></a><h3>TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS</h3>
2888	2925	<pre class="programlisting">#define TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS</pre>

3307	3344	</p>
3308	3345	</div>
3309	3346	<hr>
	3347	<div class="refsect2" title="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED">
	3348	<a name="TP-TOKEN-CONNECTION-INTERFACE-CONTACT-BLOCKING-BLOCKED:CAPS"></a><h3>TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED</h3>
	3349	<pre class="programlisting">#define TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED</pre>
	3350	<p>
	3351	The fully-qualified contact attribute token name "org.freedesktop.Telepathy.Connection.Interface.ContactBlocking/blocked"
	3352	</p>
	3353	</div>
	3354	<hr>
3310	3355	<div class="refsect2" title="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES">
3311	3356	<a name="TP-TOKEN-CONNECTION-INTERFACE-CONTACT-CAPABILITIES-CAPABILITIES:CAPS"></a><h3>TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES</h3>
3312	3357	<pre class="programlisting">#define TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES</pre>

+32

-11

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

351	351	</p>
352	352	<p>
353	353	</p>
354		<div class="informalexample"><pre class="programlisting">
355		TpChannel *channel = ...;
356
357		tp_proxy_prepare_async (channel, NULL, callback, user_data);
358		</pre></div>
	354	<div class="informalexample">
	355	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	356	<tbody>
	357	<tr>
	358	<td class="listing_lines" align="right"><pre>1
	359	2
	360	3</pre></td>
	361	<td class="listing_code"><pre class="programlisting">TpChannel <span class="symbol">*</span>channel <span class="symbol">= ...;</span>
	362
	363	<span class="function"><a href="telepathy-glib-proxy.html#tp-proxy-prepare-async">tp_proxy_prepare_async</a></span> <span class="symbol">(</span>channel<span class="symbol">,</span> NULL<span class="symbol">,</span> callback<span class="symbol">,</span> user_data<span class="symbol">);</span></pre></td>
	364	</tr>
	365	</tbody>
	366	</table>
	367	</div>
	368
359	369	<p>
360	370	</p>
361	371	<p>

363	373	</p>
364	374	<p>
365	375	</p>
366		<div class="informalexample"><pre class="programlisting">
367		TpChannel *channel = ...;
368		GQuark features[] = { TP_CHANNEL_FEATURE_CORE, 0 };
369
370		tp_proxy_prepare_async (channel, features, callback, user_data);
371		</pre></div>
	376	<div class="informalexample">
	377	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	378	<tbody>
	379	<tr>
	380	<td class="listing_lines" align="right"><pre>1
	381	2
	382	3
	383	4</pre></td>
	384	<td class="listing_code"><pre class="programlisting">TpChannel <span class="symbol">*</span>channel <span class="symbol">= ...;</span>
	385	GQuark features<span class="symbol">[] = {</span> TP_CHANNEL_FEATURE_CORE<span class="symbol">,</span> <span class="number">0</span> <span class="symbol">};</span>
	386
	387	<span class="function"><a href="telepathy-glib-proxy.html#tp-proxy-prepare-async">tp_proxy_prepare_async</a></span> <span class="symbol">(</span>channel<span class="symbol">,</span> features<span class="symbol">,</span> callback<span class="symbol">,</span> user_data<span class="symbol">);</span></pre></td>
	388	</tr>
	389	</tbody>
	390	</table>
	391	</div>
	392
372	393	<p>
373	394	</p>
374	395	<p>

+57

-26

docs/reference/html/telepathy-glib-simple-approver.html less more

100	100	<p>
101	101	A typical simple approver would look liks this:
102	102	</p>
103		<div class="informalexample"><pre class="programlisting">
104		static void
105		my_add_dispatch_operation (TpSimpleApprover *approver,
106		TpAccount *account,
107		TpConnection *connection,
108		GList *channels,
109		TpChannelDispatchOperation *dispatch_operation,
110		TpAddDispatchOperationContext *context,
111		gpointer user_data)
112		{
113		/* call tp_channel_dispatch_operation_handle_with_async()
114		if wanting to approve the channels */
115
116		tp_add_dispatch_operation_context_accept (context);
117		}
118
119		client = tp_simple_approver_new (dbus, "MyApprover", FALSE,
120		my_add_dispatch_operation, user_data);
121
122		tp_base_client_take_approver_filter (client, tp_asv_new (
123		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING, TP_IFACE_CHANNEL_TYPE_TEXT,
124		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_CONTACT,
125		NULL));
126
127		tp_base_client_register (client, NULL);
128		</pre></div>
	103	<div class="informalexample">
	104	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	105	<tbody>
	106	<tr>
	107	<td class="listing_lines" align="right"><pre>1
	108	2
	109	3
	110	4
	111	5
	112	6
	113	7
	114	8
	115	9
	116	10
	117	11
	118	12
	119	13
	120	14
	121	15
	122	16
	123	17
	124	18
	125	19
	126	20
	127	21
	128	22
	129	23
	130	24</pre></td>
	131	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	132	<span class="function">my_add_dispatch_operation</span> <span class="symbol">(</span>TpSimpleApprover <span class="symbol">*</span>approver<span class="symbol">,</span>
	133	TpAccount <span class="symbol">*</span>account<span class="symbol">,</span>
	134	TpConnection <span class="symbol">*</span>connection<span class="symbol">,</span>
	135	GList <span class="symbol">*</span>channels<span class="symbol">,</span>
	136	TpChannelDispatchOperation <span class="symbol">*</span>dispatch_operation<span class="symbol">,</span>
	137	TpAddDispatchOperationContext <span class="symbol">*</span>context<span class="symbol">,</span>
	138	gpointer user_data<span class="symbol">)</span>
	139	<span class="symbol">{</span>
	140	<span class="comment">/* call tp_channel_dispatch_operation_handle_with_async()</span>
	141	<span class="comment"> if wanting to approve the channels */</span>
	142
	143	<span class="function"><a href="telepathy-glib-add-dispatch-operation-context.html#tp-add-dispatch-operation-context-accept">tp_add_dispatch_operation_context_accept</a></span> <span class="symbol">(</span>context<span class="symbol">);</span>
	144	<span class="symbol">}</span>
	145
	146	client <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-simple-approver.html#tp-simple-approver-new">tp_simple_approver_new</a></span> <span class="symbol">(</span>dbus<span class="symbol">,</span> <span class="string">"MyApprover"</span><span class="symbol">,</span> FALSE<span class="symbol">,</span>
	147	my_add_dispatch_operation<span class="symbol">,</span> user_data<span class="symbol">);</span>
	148
	149	<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-approver-filter">tp_base_client_take_approver_filter</a></span> <span class="symbol">(</span>client<span class="symbol">,</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	150	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span> TP_IFACE_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	151	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span> TP_HANDLE_TYPE_CONTACT<span class="symbol">,</span>
	152	NULL<span class="symbol">));</span>
	153
	154	<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-register">tp_base_client_register</a></span> <span class="symbol">(</span>client<span class="symbol">,</span> NULL<span class="symbol">);</span></pre></td>
	155	</tr>
	156	</tbody>
	157	</table>
	158	</div>
	159
129	160	<p>
130	161	</p>
131	162	<p>

+59

-27

docs/reference/html/telepathy-glib-simple-handler.html less more

107	107	<p>
108	108	A typical simple handler would look liks this:
109	109	</p>
110		<div class="informalexample"><pre class="programlisting">
111		static void
112		my_handle_channels (TpSimpleHandler *handler,
113		TpAccount *account,
114		TpConnection *connection,
115		GList *channels,
116		GList *requests_satisfied,
117		gint64 user_action_time,
118		GList *requests,
119		TpHandleChannelsContext *context,
120		gpointer user_data)
121		{
122		/* start handling the channels here */
123
124		tp_handle_channels_context_accept (context);
125		}
126
127		client = tp_simple_handler_new (dbus, FALSE, FALSE, "MyHandler", FALSE,
128		my_handle_channels, user_data);
129
130		tp_base_client_take_handler_filter (client, tp_asv_new (
131		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING, TP_IFACE_CHANNEL_TYPE_TEXT,
132		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_CONTACT,
133		NULL));
134
135		tp_base_client_register (client, NULL);
136		</pre></div>
	110	<div class="informalexample">
	111	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	112	<tbody>
	113	<tr>
	114	<td class="listing_lines" align="right"><pre>1
	115	2
	116	3
	117	4
	118	5
	119	6
	120	7
	121	8
	122	9
	123	10
	124	11
	125	12
	126	13
	127	14
	128	15
	129	16
	130	17
	131	18
	132	19
	133	20
	134	21
	135	22
	136	23
	137	24
	138	25</pre></td>
	139	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	140	<span class="function">my_handle_channels</span> <span class="symbol">(</span>TpSimpleHandler <span class="symbol">*</span>handler<span class="symbol">,</span>
	141	TpAccount <span class="symbol">*</span>account<span class="symbol">,</span>
	142	TpConnection <span class="symbol">*</span>connection<span class="symbol">,</span>
	143	GList <span class="symbol">*</span>channels<span class="symbol">,</span>
	144	GList <span class="symbol">*</span>requests_satisfied<span class="symbol">,</span>
	145	gint64 user_action_time<span class="symbol">,</span>
	146	GList <span class="symbol">*</span>requests<span class="symbol">,</span>
	147	TpHandleChannelsContext <span class="symbol">*</span>context<span class="symbol">,</span>
	148	gpointer user_data<span class="symbol">)</span>
	149	<span class="symbol">{</span>
	150	<span class="comment">/* start handling the channels here */</span>
	151
	152	<span class="function"><a href="telepathy-glib-handle-channels-context.html#tp-handle-channels-context-accept">tp_handle_channels_context_accept</a></span> <span class="symbol">(</span>context<span class="symbol">);</span>
	153	<span class="symbol">}</span>
	154
	155	client <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-simple-handler.html#tp-simple-handler-new">tp_simple_handler_new</a></span> <span class="symbol">(</span>dbus<span class="symbol">,</span> FALSE<span class="symbol">,</span> FALSE<span class="symbol">,</span> <span class="string">"MyHandler"</span><span class="symbol">,</span> FALSE<span class="symbol">,</span>
	156	my_handle_channels<span class="symbol">,</span> user_data<span class="symbol">);</span>
	157
	158	<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-handler-filter">tp_base_client_take_handler_filter</a></span> <span class="symbol">(</span>client<span class="symbol">,</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	159	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span> TP_IFACE_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	160	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span> TP_HANDLE_TYPE_CONTACT<span class="symbol">,</span>
	161	NULL<span class="symbol">));</span>
	162
	163	<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-register">tp_base_client_register</a></span> <span class="symbol">(</span>client<span class="symbol">,</span> NULL<span class="symbol">);</span></pre></td>
	164	</tr>
	165	</tbody>
	166	</table>
	167	</div>
	168
137	169	<p>
138	170	</p>
139	171	<p>

+57

-26

docs/reference/html/telepathy-glib-simple-observer.html less more

104	104	<p>
105	105	A typical simple observer would look liks this:
106	106	</p>
107		<div class="informalexample"><pre class="programlisting">
108		static void
109		my_observe_channels (TpSimpleObserver *observer,
110		TpAccount *account,
111		TpConnection *connection,
112		GList *channels,
113		TpChannelDispatchOperation *dispatch_operation,
114		GList *requests,
115		TpObserveChannelsContext *context,
116		gpointer user_data)
117		{
118		/* do something useful with the channels here */
119
120		tp_observe_channels_context_accept (context);
121		}
122
123		client = tp_simple_observer_new (dbus, TRUE, "MyObserver", FALSE,
124		my_observe_channels, user_data);
125
126		tp_base_client_take_observer_filter (client, tp_asv_new (
127		TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING, TP_IFACE_CHANNEL_TYPE_TEXT,
128		TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_CONTACT,
129		NULL));
130
131		tp_base_client_register (client, NULL);
132		</pre></div>
	107	<div class="informalexample">
	108	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	109	<tbody>
	110	<tr>
	111	<td class="listing_lines" align="right"><pre>1
	112	2
	113	3
	114	4
	115	5
	116	6
	117	7
	118	8
	119	9
	120	10
	121	11
	122	12
	123	13
	124	14
	125	15
	126	16
	127	17
	128	18
	129	19
	130	20
	131	21
	132	22
	133	23
	134	24</pre></td>
	135	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	136	<span class="function">my_observe_channels</span> <span class="symbol">(</span>TpSimpleObserver <span class="symbol">*</span>observer<span class="symbol">,</span>
	137	TpAccount <span class="symbol">*</span>account<span class="symbol">,</span>
	138	TpConnection <span class="symbol">*</span>connection<span class="symbol">,</span>
	139	GList <span class="symbol">*</span>channels<span class="symbol">,</span>
	140	TpChannelDispatchOperation <span class="symbol">*</span>dispatch_operation<span class="symbol">,</span>
	141	GList <span class="symbol">*</span>requests<span class="symbol">,</span>
	142	TpObserveChannelsContext <span class="symbol">*</span>context<span class="symbol">,</span>
	143	gpointer user_data<span class="symbol">)</span>
	144	<span class="symbol">{</span>
	145	<span class="comment">/* do something useful with the channels here */</span>
	146
	147	<span class="function"><a href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-accept">tp_observe_channels_context_accept</a></span> <span class="symbol">(</span>context<span class="symbol">);</span>
	148	<span class="symbol">}</span>
	149
	150	client <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-simple-observer.html#tp-simple-observer-new">tp_simple_observer_new</a></span> <span class="symbol">(</span>dbus<span class="symbol">,</span> TRUE<span class="symbol">,</span> <span class="string">"MyObserver"</span><span class="symbol">,</span> FALSE<span class="symbol">,</span>
	151	my_observe_channels<span class="symbol">,</span> user_data<span class="symbol">);</span>
	152
	153	<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-observer-filter">tp_base_client_take_observer_filter</a></span> <span class="symbol">(</span>client<span class="symbol">,</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="symbol">(</span>
	154	TP_PROP_CHANNEL_CHANNEL_TYPE<span class="symbol">,</span> G_TYPE_STRING<span class="symbol">,</span> TP_IFACE_CHANNEL_TYPE_TEXT<span class="symbol">,</span>
	155	TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="symbol">,</span> G_TYPE_UINT<span class="symbol">,</span> TP_HANDLE_TYPE_CONTACT<span class="symbol">,</span>
	156	NULL<span class="symbol">));</span>
	157
	158	<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-register">tp_base_client_register</a></span> <span class="symbol">(</span>client<span class="symbol">,</span> NULL<span class="symbol">);</span></pre></td>
	159	</tr>
	160	</tbody>
	161	</table>
	162	</div>
	163
133	164	<p>
134	165	</p>
135	166	<p>

+7

-7

docs/reference/html/telepathy-glib-simple-password-manager.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 API Reference Manual">
7	7	<link rel="up" href="ch-service-base.html" title="Service-side implementation">
8		<link rel="prev" href="TpCMMessage.html" title="TpCMMessage">
	8	<link rel="prev" href="telepathy-glib-base-password-channel.html" title="TpBasePasswordChannel">
9	9	<link rel="next" href="telepathy-glib-base-client.html" title="TpBaseClient">
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="TpCMMessage.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
	16	<td><a accesskey="p" href="telepathy-glib-base-password-channel.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17	17	<td><a accesskey="u" href="ch-service-base.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 API Reference Manual</th>

59	59	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
60	60	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()">tp_simple_password_manager_prompt_for_channel_async</a>
61	61	(<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
62		<em class="parameter"><code><span class="type">TpBasePasswordChannel</span> *channel</code></em>,
	62	<em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> *channel</code></em>,
63	63	<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
64	64	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
65	65	const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> * <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-finish" title="tp_simple_password_manager_prompt_for_channel_finish ()">tp_simple_password_manager_prompt_for_channel_finish</a>
66	66	(<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
67	67	<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
68		<em class="parameter"><code><span class="type">TpBasePasswordChannel</span> **channel</code></em>,
	68	<em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> **channel</code></em>,
69	69	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
70	70	</pre>
71	71	</div>

246	246	<a name="tp-simple-password-manager-prompt-for-channel-async"></a><h3>tp_simple_password_manager_prompt_for_channel_async ()</h3>
247	247	<pre class="programlisting"><span class="returnvalue">void</span> tp_simple_password_manager_prompt_for_channel_async
248	248	(<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
249		<em class="parameter"><code><span class="type">TpBasePasswordChannel</span> *channel</code></em>,
	249	<em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> *channel</code></em>,
250	250	<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
251	251	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
252	252	<p>

276	276	</tr>
277	277	<tr>
278	278	<td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
279		<td>a <span class="type">TpBasePasswordChannel</span>
	279	<td>a <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a>
280	280	</td>
281	281	</tr>
282	282	<tr>

299	299	<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> * tp_simple_password_manager_prompt_for_channel_finish
300	300	(<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
301	301	<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
302		<em class="parameter"><code><span class="type">TpBasePasswordChannel</span> **channel</code></em>,
	302	<em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> **channel</code></em>,
303	303	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
304	304	<p>
305	305	Retrieve the value of the request begun with

+2

-2

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

306	306	<div class="refsect2" title='The "account-removed" signal'>
307	307	<a name="TpSvcAccountManager-account-removed"></a><h3>The <code class="literal">"account-removed"</code> signal</h3>
308	308	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager"><span class="type">TpSvcAccountManager</span></a> *self,
309		<span class="type">DBusGObjectPath</span> *arg_Account,
	309	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Account,
310	310	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
311	311	<p>
312	312	The AccountRemoved D-Bus signal is emitted whenever this GObject signal is.

335	335	<div class="refsect2" title='The "account-validity-changed" signal'>
336	336	<a name="TpSvcAccountManager-account-validity-changed"></a><h3>The <code class="literal">"account-validity-changed"</code> signal</h3>
337	337	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager"><span class="type">TpSvcAccountManager</span></a> *self,
338		<span class="type">DBusGObjectPath</span> *arg_Account,
	338	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Account,
339	339	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_Valid,
340	340	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
341	341	<p>

+2

-2

docs/reference/html/telepathy-glib-svc-channel-auth.html less more

121	121	<a name="telepathy-glib-svc-channel-auth.implementations"></a><h2>Known Implementations</h2>
122	122	<p>
123	123	TpSvcChannelTypeServerAuthentication is implemented by
124		TpBasePasswordChannel.</p>
	124	<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>.</p>
125	125	<p>
126	126	TpSvcChannelInterfaceSASLAuthentication is implemented by
127		TpBasePasswordChannel.</p>
	127	<a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>.</p>
128	128	</div>
129	129	<div class="refsect1" title="Signals">
130	130	<a name="telepathy-glib-svc-channel-auth.signals"></a><h2>Signals</h2>

+1

-1

docs/reference/html/telepathy-glib-svc-channel-dispatch-operation.html less more

441	441	<div class="refsect2" title='The "channel-lost" signal'>
442	442	<a name="TpSvcChannelDispatchOperation-channel-lost"></a><h3>The <code class="literal">"channel-lost"</code> signal</h3>
443	443	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation"><span class="type">TpSvcChannelDispatchOperation</span></a> *self,
444		<span class="type">DBusGObjectPath</span> *arg_Channel,
	444	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Channel,
445	445	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Error,
446	446	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Message,
447	447	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>

+2

-2

docs/reference/html/telepathy-glib-svc-channel-dispatcher.html less more

695	695	<div class="refsect2" title='The "dispatch-operation-finished" signal'>
696	696	<a name="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished"></a><h3>The <code class="literal">"dispatch-operation-finished"</code> signal</h3>
697	697	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList"><span class="type">TpSvcChannelDispatcherInterfaceOperationList</span></a> *self,
698		<span class="type">DBusGObjectPath</span> *arg_Dispatch_Operation,
	698	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Dispatch_Operation,
699	699	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
700	700	<p>
701	701	The DispatchOperationFinished D-Bus signal is emitted whenever this GObject signal is.

724	724	<div class="refsect2" title='The "new-dispatch-operation" signal'>
725	725	<a name="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation"></a><h3>The <code class="literal">"new-dispatch-operation"</code> signal</h3>
726	726	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList"><span class="type">TpSvcChannelDispatcherInterfaceOperationList</span></a> *self,
727		<span class="type">DBusGObjectPath</span> *arg_Dispatch_Operation,
	727	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Dispatch_Operation,
728	728	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
729	729	<p>
730	730	The NewDispatchOperation D-Bus signal is emitted whenever this GObject signal is.

+2

-2

docs/reference/html/telepathy-glib-svc-channel-group.html less more

1720	1720	<div class="refsect2" title='The "channel-merged" signal'>
1721	1721	<a name="TpSvcChannelInterfaceConference-channel-merged"></a><h3>The <code class="literal">"channel-merged"</code> signal</h3>
1722	1722	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-group.html#TpSvcChannelInterfaceConference"><span class="type">TpSvcChannelInterfaceConference</span></a> *self,
1723		<span class="type">DBusGObjectPath</span> *arg_Channel,
	1723	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Channel,
1724	1724	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Channel_Specific_Handle,
1725	1725	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
1726	1726	<p>

1760	1760	<div class="refsect2" title='The "channel-removed" signal'>
1761	1761	<a name="TpSvcChannelInterfaceConference-channel-removed"></a><h3>The <code class="literal">"channel-removed"</code> signal</h3>
1762	1762	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-group.html#TpSvcChannelInterfaceConference"><span class="type">TpSvcChannelInterfaceConference</span></a> *self,
1763		<span class="type">DBusGObjectPath</span> *arg_Channel,
	1763	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Channel,
1764	1764	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
1765	1765	<p>
1766	1766	The ChannelRemoved D-Bus signal is emitted whenever this GObject signal is.

+1

-1

docs/reference/html/telepathy-glib-svc-channel-media.html less more

2055	2055	<div class="refsect2" title='The "new-session-handler" signal'>
2056	2056	<a name="TpSvcChannelInterfaceMediaSignalling-new-session-handler"></a><h3>The <code class="literal">"new-session-handler"</code> signal</h3>
2057	2057	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-media.html#TpSvcChannelInterfaceMediaSignalling"><span class="type">TpSvcChannelInterfaceMediaSignalling</span></a> *self,
2058		<span class="type">DBusGObjectPath</span> *arg_Session_Handler,
	2058	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Session_Handler,
2059	2059	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Session_Type,
2060	2060	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
2061	2061	<p>

+2

-2

docs/reference/html/telepathy-glib-svc-channel-request.html less more

440	440	<div class="refsect2" title='The "succeeded-with-channel" signal'>
441	441	<a name="TpSvcChannelRequest-succeeded-with-channel"></a><h3>The <code class="literal">"succeeded-with-channel"</code> signal</h3>
442	442	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest"><span class="type">TpSvcChannelRequest</span></a> *self,
443		<span class="type">DBusGObjectPath</span> *arg_Connection,
444		<span class="type">DBusGObjectPath</span> *arg_Channel,
	443	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Connection,
	444	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Channel,
445	445	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
446	446	<p>
447	447	The SucceededWithChannel D-Bus signal is emitted whenever this GObject signal is.

+1

-1

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

115	115	<a name="telepathy-glib-svc-channel.implementations"></a><h2>Known Implementations</h2>
116	116	<p>
117	117	TpSvcChannel is implemented by
118		<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a> and TpBasePasswordChannel.</p>
	118	<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a> and <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>.</p>
119	119	</div>
120	120	<div class="refsect1" title="Signals">
121	121	<a name="telepathy-glib-svc-channel.signals"></a><h2>Signals</h2>

+1

-1

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

459	459	<a name="TpSvcConnectionManager-new-connection"></a><h3>The <code class="literal">"new-connection"</code> signal</h3>
460	460	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-connection-manager.html#TpSvcConnectionManager"><span class="type">TpSvcConnectionManager</span></a> *self,
461	461	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Bus_Name,
462		<span class="type">DBusGObjectPath</span> *arg_Object_Path,
	462	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Object_Path,
463	463	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Protocol,
464	464	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
465	465	<p>

+385

-3

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><a name="TpSvcConnectionInterfaceContactGroups"></a><a name="TpSvcConnectionInterfaceContactList"></a><a name="TpSvcConnectionInterfaceCellular"></a><a name="TpSvcConnectionInterfaceClientTypes"></a><a name="TpSvcConnectionInterfaceMailNotification"></a><a name="TpSvcConnectionInterfacePowerSaving"></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="TpSvcConnectionInterfaceContactBlocking"></a><a name="TpSvcConnectionInterfaceContactGroups"></a><a name="TpSvcConnectionInterfaceContactList"></a><a name="TpSvcConnectionInterfaceCellular"></a><a name="TpSvcConnectionInterfaceClientTypes"></a><a name="TpSvcConnectionInterfaceMailNotification"></a><a name="TpSvcConnectionInterfacePowerSaving"></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>;

630	630	<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>);
631	631
632	632
	633	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-struct" title="TpSvcConnectionInterfaceContactBlocking">TpSvcConnectionInterfaceContactBlocking</a>;
	634	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass">TpSvcConnectionInterfaceContactBlockingClass</a>;
	635	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-block-contacts-impl" title="tp_svc_connection_interface_contact_blocking_block_contacts_impl ()">*tp_svc_connection_interface_contact_blocking_block_contacts_impl</a>)
	636	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self</code></em>,
	637	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	638	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Report_Abusive</code></em>,
	639	<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>);
	640	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-emit-blocked-contacts-changed" title="tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed ()">tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed</a>
	641	(<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
	642	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Blocked_Contacts</code></em>,
	643	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Unblocked_Contacts</code></em>);
	644	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-block-contacts" title="tp_svc_connection_interface_contact_blocking_implement_block_contacts ()">tp_svc_connection_interface_contact_blocking_implement_block_contacts</a>
	645	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass"><span class="type">TpSvcConnectionInterfaceContactBlockingClass</span></a> *klass</code></em>,
	646	<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-block-contacts-impl" title="tp_svc_connection_interface_contact_blocking_block_contacts_impl ()"><span class="type">tp_svc_connection_interface_contact_blocking_block_contacts_impl</span></a> impl</code></em>);
	647	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-request-blocked-contacts" title="tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts ()">tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts</a>
	648	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass"><span class="type">TpSvcConnectionInterfaceContactBlockingClass</span></a> *klass</code></em>,
	649	<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl" title="tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()"><span class="type">tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl</span></a> impl</code></em>);
	650	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-unblock-contacts" title="tp_svc_connection_interface_contact_blocking_implement_unblock_contacts ()">tp_svc_connection_interface_contact_blocking_implement_unblock_contacts</a>
	651	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass"><span class="type">TpSvcConnectionInterfaceContactBlockingClass</span></a> *klass</code></em>,
	652	<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-unblock-contacts-impl" title="tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()"><span class="type">tp_svc_connection_interface_contact_blocking_unblock_contacts_impl</span></a> impl</code></em>);
	653	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl" title="tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()">*tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl</a>)
	654	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self</code></em>,
	655	<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>);
	656	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-block-contacts" title="tp_svc_connection_interface_contact_blocking_return_from_block_contacts ()">tp_svc_connection_interface_contact_blocking_return_from_block_contacts</a>
	657	(<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>);
	658	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-request-blocked-contacts" title="tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts ()">tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts</a>
	659	(<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>,
	660	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Contacts</code></em>);
	661	<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-unblock-contacts" title="tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts ()">tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts</a>
	662	(<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>);
	663	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-unblock-contacts-impl" title="tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()">*tp_svc_connection_interface_contact_blocking_unblock_contacts_impl</a>)
	664	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self</code></em>,
	665	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	666	<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>);
633	667	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-struct" title="TpSvcConnectionInterfaceContactGroups">TpSvcConnectionInterfaceContactGroups</a>;
634	668	<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroupsClass" title="TpSvcConnectionInterfaceContactGroupsClass">TpSvcConnectionInterfaceContactGroupsClass</a>;
635	669	<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-groups-add-to-group-impl" title="tp_svc_connection_interface_contact_groups_add_to_group_impl ()">*tp_svc_connection_interface_contact_groups_add_to_group_impl</a>)

914	948	</pre>
915	949	<pre class="synopsis">
916	950	GInterface
	951	+----TpSvcConnectionInterfaceContactBlocking
	952	</pre>
	953	<pre class="synopsis">
	954	GInterface
917	955	+----TpSvcConnectionInterfaceContactGroups
918	956	</pre>
919	957	<pre class="synopsis">

965	1003	"<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
966	1004	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated" title='The "location-updated" signal'>location-updated</a>" : Run Last / Has Details
967	1005	"<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
	1006	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-blocked-contacts-changed" title='The "blocked-contacts-changed" signal'>blocked-contacts-changed</a>" : Run Last / Has Details
968	1007	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-group-renamed" title='The "group-renamed" signal'>group-renamed</a>" : Run Last / Has Details
969	1008	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-changed" title='The "groups-changed" signal'>groups-changed</a>" : Run Last / Has Details
970	1009	"<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-created" title='The "groups-created" signal'>groups-created</a>" : Run Last / Has Details

6005	6044	</table></div>
6006	6045	</div>
6007	6046	<hr>
	6047	<div class="refsect2" title="TpSvcConnectionInterfaceContactBlocking">
	6048	<a name="TpSvcConnectionInterfaceContactBlocking-struct"></a><h3>TpSvcConnectionInterfaceContactBlocking</h3>
	6049	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceContactBlocking TpSvcConnectionInterfaceContactBlocking;</pre>
	6050	<p>
	6051	Dummy typedef representing any implementation of this interface.
	6052	</p>
	6053	</div>
	6054	<hr>
	6055	<div class="refsect2" title="TpSvcConnectionInterfaceContactBlockingClass">
	6056	<a name="TpSvcConnectionInterfaceContactBlockingClass"></a><h3>TpSvcConnectionInterfaceContactBlockingClass</h3>
	6057	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceContactBlockingClass TpSvcConnectionInterfaceContactBlockingClass;</pre>
	6058	<p>
	6059	The class of TpSvcConnectionInterfaceContactBlocking.
	6060	</p>
	6061	<p>
	6062	In a full implementation of this interface (i.e. all
	6063	methods implemented), the interface initialization
	6064	function used in <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS"><code class="function">G_IMPLEMENT_INTERFACE()</code></a> would
	6065	typically look like this:
	6066	</p>
	6067	<p>
	6068	</p>
	6069	<pre class="programlisting">
	6070	static void
	6071	implement_connection_interface_contact_blocking (gpointer klass,
	6072	gpointer unused G_GNUC_UNUSED)
	6073	{
	6074	#define IMPLEMENT(x) tp_svc_connection_interface_contact_blocking_implement_##x (\
	6075	klass, my_object_##x)
	6076	IMPLEMENT (block_contacts);
	6077	IMPLEMENT (unblock_contacts);
	6078	IMPLEMENT (request_blocked_contacts);
	6079	#undef IMPLEMENT
	6080	}
	6081	</pre>
	6082	<p>
	6083	</p>
	6084	</div>
	6085	<hr>
	6086	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_block_contacts_impl ()">
	6087	<a name="tp-svc-connection-interface-contact-blocking-block-contacts-impl"></a><h3>tp_svc_connection_interface_contact_blocking_block_contacts_impl ()</h3>
	6088	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_svc_connection_interface_contact_blocking_block_contacts_impl)
	6089	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self</code></em>,
	6090	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	6091	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Report_Abusive</code></em>,
	6092	<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>);</pre>
	6093	<p>
	6094	The signature of an implementation of the D-Bus method
	6095	BlockContacts on interface org.freedesktop.Telepathy.Connection.Interface.ContactBlocking.
	6096	</p>
	6097	<div class="variablelist"><table border="0">
	6098	<col align="left" valign="top">
	6099	<tbody>
	6100	<tr>
	6101	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	6102	<td>The object implementing this interface
	6103	</td>
	6104	</tr>
	6105	<tr>
	6106	<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
	6107	<td>const GArray * (FIXME, generate documentation)
	6108	</td>
	6109	</tr>
	6110	<tr>
	6111	<td><p><span class="term"><em class="parameter"><code>in_Report_Abusive</code></em> :</span></p></td>
	6112	<td>gboolean (FIXME, generate documentation)
	6113	</td>
	6114	</tr>
	6115	<tr>
	6116	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	6117	<td>Used to return values or throw an error
	6118	</td>
	6119	</tr>
	6120	</tbody>
	6121	</table></div>
	6122	</div>
	6123	<hr>
	6124	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed ()">
	6125	<a name="tp-svc-connection-interface-contact-blocking-emit-blocked-contacts-changed"></a><h3>tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed ()</h3>
	6126	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed
	6127	(<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
	6128	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Blocked_Contacts</code></em>,
	6129	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Unblocked_Contacts</code></em>);</pre>
	6130	<p>
	6131	Type-safe wrapper around g_signal_emit to emit the
	6132	BlockedContactsChanged signal on interface org.freedesktop.Telepathy.Connection.Interface.ContactBlocking.
	6133	</p>
	6134	<div class="variablelist"><table border="0">
	6135	<col align="left" valign="top">
	6136	<tbody>
	6137	<tr>
	6138	<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
	6139	<td>The object implementing this interface
	6140	</td>
	6141	</tr>
	6142	<tr>
	6143	<td><p><span class="term"><em class="parameter"><code>arg_Blocked_Contacts</code></em> :</span></p></td>
	6144	<td>GHashTable * (FIXME, generate documentation)
	6145	</td>
	6146	</tr>
	6147	<tr>
	6148	<td><p><span class="term"><em class="parameter"><code>arg_Unblocked_Contacts</code></em> :</span></p></td>
	6149	<td>GHashTable * (FIXME, generate documentation)
	6150	</td>
	6151	</tr>
	6152	</tbody>
	6153	</table></div>
	6154	</div>
	6155	<hr>
	6156	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_implement_block_contacts ()">
	6157	<a name="tp-svc-connection-interface-contact-blocking-implement-block-contacts"></a><h3>tp_svc_connection_interface_contact_blocking_implement_block_contacts ()</h3>
	6158	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_implement_block_contacts
	6159	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass"><span class="type">TpSvcConnectionInterfaceContactBlockingClass</span></a> *klass</code></em>,
	6160	<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-block-contacts-impl" title="tp_svc_connection_interface_contact_blocking_block_contacts_impl ()"><span class="type">tp_svc_connection_interface_contact_blocking_block_contacts_impl</span></a> impl</code></em>);</pre>
	6161	<p>
	6162	Register an implementation for the BlockContacts method in the vtable
	6163	of an implementation of this interface. To be called from
	6164	the interface init function.
	6165	</p>
	6166	<div class="variablelist"><table border="0">
	6167	<col align="left" valign="top">
	6168	<tbody>
	6169	<tr>
	6170	<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
	6171	<td>A class whose instances implement this interface
	6172	</td>
	6173	</tr>
	6174	<tr>
	6175	<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
	6176	<td>A callback used to implement the BlockContacts D-Bus method
	6177	</td>
	6178	</tr>
	6179	</tbody>
	6180	</table></div>
	6181	</div>
	6182	<hr>
	6183	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts ()">
	6184	<a name="tp-svc-connection-interface-contact-blocking-implement-request-blocked-contacts"></a><h3>tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts ()</h3>
	6185	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts
	6186	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass"><span class="type">TpSvcConnectionInterfaceContactBlockingClass</span></a> *klass</code></em>,
	6187	<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl" title="tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()"><span class="type">tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl</span></a> impl</code></em>);</pre>
	6188	<p>
	6189	Register an implementation for the RequestBlockedContacts method in the vtable
	6190	of an implementation of this interface. To be called from
	6191	the interface init function.
	6192	</p>
	6193	<div class="variablelist"><table border="0">
	6194	<col align="left" valign="top">
	6195	<tbody>
	6196	<tr>
	6197	<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
	6198	<td>A class whose instances implement this interface
	6199	</td>
	6200	</tr>
	6201	<tr>
	6202	<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
	6203	<td>A callback used to implement the RequestBlockedContacts D-Bus method
	6204	</td>
	6205	</tr>
	6206	</tbody>
	6207	</table></div>
	6208	</div>
	6209	<hr>
	6210	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_implement_unblock_contacts ()">
	6211	<a name="tp-svc-connection-interface-contact-blocking-implement-unblock-contacts"></a><h3>tp_svc_connection_interface_contact_blocking_implement_unblock_contacts ()</h3>
	6212	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_implement_unblock_contacts
	6213	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass" title="TpSvcConnectionInterfaceContactBlockingClass"><span class="type">TpSvcConnectionInterfaceContactBlockingClass</span></a> *klass</code></em>,
	6214	<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-unblock-contacts-impl" title="tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()"><span class="type">tp_svc_connection_interface_contact_blocking_unblock_contacts_impl</span></a> impl</code></em>);</pre>
	6215	<p>
	6216	Register an implementation for the UnblockContacts method in the vtable
	6217	of an implementation of this interface. To be called from
	6218	the interface init function.
	6219	</p>
	6220	<div class="variablelist"><table border="0">
	6221	<col align="left" valign="top">
	6222	<tbody>
	6223	<tr>
	6224	<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
	6225	<td>A class whose instances implement this interface
	6226	</td>
	6227	</tr>
	6228	<tr>
	6229	<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
	6230	<td>A callback used to implement the UnblockContacts D-Bus method
	6231	</td>
	6232	</tr>
	6233	</tbody>
	6234	</table></div>
	6235	</div>
	6236	<hr>
	6237	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()">
	6238	<a name="tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl"></a><h3>tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()</h3>
	6239	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl)
	6240	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self</code></em>,
	6241	<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>);</pre>
	6242	<p>
	6243	The signature of an implementation of the D-Bus method
	6244	RequestBlockedContacts on interface org.freedesktop.Telepathy.Connection.Interface.ContactBlocking.
	6245	</p>
	6246	<div class="variablelist"><table border="0">
	6247	<col align="left" valign="top">
	6248	<tbody>
	6249	<tr>
	6250	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	6251	<td>The object implementing this interface
	6252	</td>
	6253	</tr>
	6254	<tr>
	6255	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	6256	<td>Used to return values or throw an error
	6257	</td>
	6258	</tr>
	6259	</tbody>
	6260	</table></div>
	6261	</div>
	6262	<hr>
	6263	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_return_from_block_contacts ()">
	6264	<a name="tp-svc-connection-interface-contact-blocking-return-from-block-contacts"></a><h3>tp_svc_connection_interface_contact_blocking_return_from_block_contacts ()</h3>
	6265	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_return_from_block_contacts
	6266	(<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>);</pre>
	6267	<p>
	6268	Return successfully by calling <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"><code class="function">dbus_g_method_return()</code></a>.
	6269	This inline function exists only to provide type-safety.
	6270	</p>
	6271	<div class="variablelist"><table border="0">
	6272	<col align="left" valign="top">
	6273	<tbody><tr>
	6274	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	6275	<td>The D-Bus method invocation context
	6276	</td>
	6277	</tr></tbody>
	6278	</table></div>
	6279	</div>
	6280	<hr>
	6281	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts ()">
	6282	<a name="tp-svc-connection-interface-contact-blocking-return-from-request-blocked-contacts"></a><h3>tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts ()</h3>
	6283	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts
	6284	(<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>,
	6285	<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Contacts</code></em>);</pre>
	6286	<p>
	6287	Return successfully by calling <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"><code class="function">dbus_g_method_return()</code></a>.
	6288	This inline function exists only to provide type-safety.
	6289	</p>
	6290	<div class="variablelist"><table border="0">
	6291	<col align="left" valign="top">
	6292	<tbody>
	6293	<tr>
	6294	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	6295	<td>The D-Bus method invocation context
	6296	</td>
	6297	</tr>
	6298	<tr>
	6299	<td><p><span class="term"><em class="parameter"><code>out_Contacts</code></em> :</span></p></td>
	6300	<td>GHashTable * (FIXME, generate documentation)
	6301	</td>
	6302	</tr>
	6303	</tbody>
	6304	</table></div>
	6305	</div>
	6306	<hr>
	6307	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts ()">
	6308	<a name="tp-svc-connection-interface-contact-blocking-return-from-unblock-contacts"></a><h3>tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts ()</h3>
	6309	<pre class="programlisting"><span class="returnvalue">void</span> tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts
	6310	(<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>);</pre>
	6311	<p>
	6312	Return successfully by calling <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"><code class="function">dbus_g_method_return()</code></a>.
	6313	This inline function exists only to provide type-safety.
	6314	</p>
	6315	<div class="variablelist"><table border="0">
	6316	<col align="left" valign="top">
	6317	<tbody><tr>
	6318	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	6319	<td>The D-Bus method invocation context
	6320	</td>
	6321	</tr></tbody>
	6322	</table></div>
	6323	</div>
	6324	<hr>
	6325	<div class="refsect2" title="tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()">
	6326	<a name="tp-svc-connection-interface-contact-blocking-unblock-contacts-impl"></a><h3>tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()</h3>
	6327	<pre class="programlisting"><span class="returnvalue">void</span> (*tp_svc_connection_interface_contact_blocking_unblock_contacts_impl)
	6328	(<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self</code></em>,
	6329	<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
	6330	<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>);</pre>
	6331	<p>
	6332	The signature of an implementation of the D-Bus method
	6333	UnblockContacts on interface org.freedesktop.Telepathy.Connection.Interface.ContactBlocking.
	6334	</p>
	6335	<div class="variablelist"><table border="0">
	6336	<col align="left" valign="top">
	6337	<tbody>
	6338	<tr>
	6339	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	6340	<td>The object implementing this interface
	6341	</td>
	6342	</tr>
	6343	<tr>
	6344	<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
	6345	<td>const GArray * (FIXME, generate documentation)
	6346	</td>
	6347	</tr>
	6348	<tr>
	6349	<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
	6350	<td>Used to return values or throw an error
	6351	</td>
	6352	</tr>
	6353	</tbody>
	6354	</table></div>
	6355	</div>
	6356	<hr>
6008	6357	<div class="refsect2" title="TpSvcConnectionInterfaceContactGroups">
6009	6358	<a name="TpSvcConnectionInterfaceContactGroups-struct"></a><h3>TpSvcConnectionInterfaceContactGroups</h3>
6010	6359	<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceContactGroups TpSvcConnectionInterfaceContactGroups;</pre>

8018	8367	<div class="refsect2" title='The "new-channel" signal'>
8019	8368	<a name="TpSvcConnection-new-channel"></a><h3>The <code class="literal">"new-channel"</code> signal</h3>
8020	8369	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnection"><span class="type">TpSvcConnection</span></a> *self,
8021		<span class="type">DBusGObjectPath</span> *arg_Object_Path,
	8370	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Object_Path,
8022	8371	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Channel_Type,
8023	8372	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Handle_Type,
8024	8373	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Handle,

8135	8484	<div class="refsect2" title='The "channel-closed" signal'>
8136	8485	<a name="TpSvcConnectionInterfaceRequests-channel-closed"></a><h3>The <code class="literal">"channel-closed"</code> signal</h3>
8137	8486	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceRequests"><span class="type">TpSvcConnectionInterfaceRequests</span></a> *self,
8138		<span class="type">DBusGObjectPath</span> *arg_Removed,
	8487	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Removed,
8139	8488	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
8140	8489	<p>
8141	8490	The ChannelClosed D-Bus signal is emitted whenever this GObject signal is.

8507	8856	</table></div>
8508	8857	</div>
8509	8858	<hr>
	8859	<div class="refsect2" title='The "blocked-contacts-changed" signal'>
	8860	<a name="TpSvcConnectionInterfaceContactBlocking-blocked-contacts-changed"></a><h3>The <code class="literal">"blocked-contacts-changed"</code> signal</h3>
	8861	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking"><span class="type">TpSvcConnectionInterfaceContactBlocking</span></a> *self,
	8862	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
	8863	<p>
	8864	The BlockedContactsChanged D-Bus signal is emitted whenever this GObject signal is.
	8865	</p>
	8866	<div class="variablelist"><table border="0">
	8867	<col align="left" valign="top">
	8868	<tbody>
	8869	<tr>
	8870	<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
	8871	<td>an object
	8872	</td>
	8873	</tr>
	8874	<tr>
	8875	<td><p><span class="term"><em class="parameter"><code>arg_Blocked_Contacts</code></em> :</span></p></td>
	8876	<td>GHashTable * (FIXME, generate documentation)
	8877	</td>
	8878	</tr>
	8879	<tr>
	8880	<td><p><span class="term"><em class="parameter"><code>arg_Unblocked_Contacts</code></em> :</span></p></td>
	8881	<td>GHashTable * (FIXME, generate documentation)
	8882	</td>
	8883	</tr>
	8884	<tr>
	8885	<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
	8886	<td>user data set when the signal handler was connected.</td>
	8887	</tr>
	8888	</tbody>
	8889	</table></div>
	8890	</div>
	8891	<hr>
8510	8892	<div class="refsect2" title='The "group-renamed" signal'>
8511	8893	<a name="TpSvcConnectionInterfaceContactGroups-group-renamed"></a><h3>The <code class="literal">"group-renamed"</code> signal</h3>
8512	8894	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups"><span class="type">TpSvcConnectionInterfaceContactGroups</span></a> *self,

+1

-1

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

151	151	<a name="telepathy-glib-svc-generic.implementations"></a><h2>Known Implementations</h2>
152	152	<p>
153	153	TpSvcDBusProperties is implemented by
154		<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a>, <a class="link" href="telepathy-glib-base-client.html#TpBaseClient">TpBaseClient</a>, <a class="link" href="TpBaseConnection.html" title="TpBaseConnection">TpBaseConnection</a>, <a class="link" href="TpBaseConnectionManager.html" title="TpBaseConnectionManager">TpBaseConnectionManager</a>, TpBasePasswordChannel, <a class="link" href="telepathy-glib-base-protocol.html#TpBaseProtocol">TpBaseProtocol</a>, <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender">TpDebugSender</a>, <a class="link" href="telepathy-glib-simple-approver.html#TpSimpleApprover">TpSimpleApprover</a>, <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler">TpSimpleHandler</a> and <a class="link" href="telepathy-glib-simple-observer.html#TpSimpleObserver">TpSimpleObserver</a>.</p>
	154	<a class="link" href="TpBaseChannel.html" title="TpBaseChannel">TpBaseChannel</a>, <a class="link" href="telepathy-glib-base-client.html#TpBaseClient">TpBaseClient</a>, <a class="link" href="TpBaseConnection.html" title="TpBaseConnection">TpBaseConnection</a>, <a class="link" href="TpBaseConnectionManager.html" title="TpBaseConnectionManager">TpBaseConnectionManager</a>, <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel">TpBasePasswordChannel</a>, <a class="link" href="telepathy-glib-base-protocol.html#TpBaseProtocol">TpBaseProtocol</a>, <a class="link" href="telepathy-glib-debug-sender.html#TpDebugSender">TpDebugSender</a>, <a class="link" href="telepathy-glib-simple-approver.html#TpSimpleApprover">TpSimpleApprover</a>, <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler">TpSimpleHandler</a> and <a class="link" href="telepathy-glib-simple-observer.html#TpSimpleObserver">TpSimpleObserver</a>.</p>
155	155	</div>
156	156	<div class="refsect1" title="Signals">
157	157	<a name="telepathy-glib-svc-generic.signals"></a><h2>Signals</h2>

+1

-1

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

1932	1932	<div class="refsect2" title='The "new-stream-handler" signal'>
1933	1933	<a name="TpSvcMediaSessionHandler-new-stream-handler"></a><h3>The <code class="literal">"new-stream-handler"</code> signal</h3>
1934	1934	<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="telepathy-glib-svc-media-interfaces.html#TpSvcMediaSessionHandler"><span class="type">TpSvcMediaSessionHandler</span></a> *self,
1935		<span class="type">DBusGObjectPath</span> *arg_Stream_Handler,
	1935	<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"><span class="type">DBusGObjectPath</span></a> *arg_Stream_Handler,
1936	1936	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_ID,
1937	1937	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Media_Type,
1938	1938	<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Direction,

+232

-96

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

47	47	and define the type you'll be using, declaring it to implement the
48	48	media stream handler interface:
49	49	</p>
50		<div class="informalexample"><pre class="programlisting">
51		static void stream_handler_iface_init (gpointer, gpointer);
52
53		G_DEFINE_TYPE_WITH_CODE(GabbleMediaStream,
54		gabble_media_stream,
55		G_TYPE_OBJECT,
56		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_MEDIA_STREAM_HANDLER,
57		stream_handler_iface_init)
58		)
59		</pre></div>
	50	<div class="informalexample">
	51	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	52	<tbody>
	53	<tr>
	54	<td class="listing_lines" align="right"><pre>1
	55	2
	56	3
	57	4
	58	5
	59	6
	60	7
	61	8</pre></td>
	62	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span> <span class="function">stream_handler_iface_init</span> <span class="symbol">(</span>gpointer<span class="symbol">,</span> gpointer<span class="symbol">);</span>
	63
	64	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-DEFINE-TYPE-WITH-CODE:CAPS">G_DEFINE_TYPE_WITH_CODE</a></span><span class="symbol">(</span>GabbleMediaStream<span class="symbol">,</span>
	65	gabble_media_stream<span class="symbol">,</span>
	66	G_TYPE_OBJECT<span class="symbol">,</span>
	67	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_MEDIA_STREAM_HANDLER<span class="symbol">,</span>
	68	stream_handler_iface_init<span class="symbol">)</span>
	69	<span class="symbol">)</span></pre></td>
	70	</tr>
	71	</tbody>
	72	</table>
	73	</div>
	74
60	75	<p>
61	76	Here we're using a subclass of G_TYPE_OBJECT. You can of course subclass
62	77	any type.

68	83	if you want to separate off chunks of functionality into a different
69	84	.c file. For instance, here's GabbleConnection:
70	85	</p>
71		<div class="informalexample"><pre class="programlisting">
72		/* in header files */
73		void conn_aliasing_iface_init (gpointer, gpointer);
74		void conn_avatars_iface_init (gpointer, gpointer);
75		void conn_presence_iface_init (gpointer, gpointer);
76
77		/* in gabble-connection.c */
78		static void conn_iface_init (gpointer, gpointer);
79		static void capabilities_iface_init (gpointer, gpointer);
80
81		G_DEFINE_TYPE_WITH_CODE(GabbleConnection,
82		gabble_connection,
83		TP_TYPE_BASE_CONNECTION,
84		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION,
85		conn_iface_init);
86		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION_INTERFACE_ALIASING,
87		conn_aliasing_iface_init);
88		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION_INTERFACE_AVATARS,
89		conn_avatars_iface_init);
90		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION_INTERFACE_CAPABILITIES,
91		capabilities_init);
92		G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CONNECTION_INTERFACE_PRESENCE,
93		conn_presence_iface_init);
94		)
95		</pre></div>
	86	<div class="informalexample">
	87	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	88	<tbody>
	89	<tr>
	90	<td class="listing_lines" align="right"><pre>1
	91	2
	92	3
	93	4
	94	5
	95	6
	96	7
	97	8
	98	9
	99	10
	100	11
	101	12
	102	13
	103	14
	104	15
	105	16
	106	17
	107	18
	108	19
	109	20
	110	21
	111	22
	112	23</pre></td>
	113	<td class="listing_code"><pre class="programlisting"><span class="comment">/* in header files */</span>
	114	<span class="gtkdoc kwb">void</span> <span class="function">conn_aliasing_iface_init</span> <span class="symbol">(</span>gpointer<span class="symbol">,</span> gpointer<span class="symbol">);</span>
	115	<span class="gtkdoc kwb">void</span> <span class="function">conn_avatars_iface_init</span> <span class="symbol">(</span>gpointer<span class="symbol">,</span> gpointer<span class="symbol">);</span>
	116	<span class="gtkdoc kwb">void</span> <span class="function">conn_presence_iface_init</span> <span class="symbol">(</span>gpointer<span class="symbol">,</span> gpointer<span class="symbol">);</span>
	117
	118	<span class="comment">/* in gabble-connection.c */</span>
	119	<span class="gtkdoc kwb">static void</span> <span class="function">conn_iface_init</span> <span class="symbol">(</span>gpointer<span class="symbol">,</span> gpointer<span class="symbol">);</span>
	120	<span class="gtkdoc kwb">static void</span> <span class="function">capabilities_iface_init</span> <span class="symbol">(</span>gpointer<span class="symbol">,</span> gpointer<span class="symbol">);</span>
	121
	122	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-DEFINE-TYPE-WITH-CODE:CAPS">G_DEFINE_TYPE_WITH_CODE</a></span><span class="symbol">(</span>GabbleConnection<span class="symbol">,</span>
	123	gabble_connection<span class="symbol">,</span>
	124	TP_TYPE_BASE_CONNECTION<span class="symbol">,</span>
	125	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION<span class="symbol">,</span>
	126	conn_iface_init<span class="symbol">);</span>
	127	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION_INTERFACE_ALIASING<span class="symbol">,</span>
	128	conn_aliasing_iface_init<span class="symbol">);</span>
	129	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION_INTERFACE_AVATARS<span class="symbol">,</span>
	130	conn_avatars_iface_init<span class="symbol">);</span>
	131	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION_INTERFACE_CAPABILITIES<span class="symbol">,</span>
	132	capabilities_init<span class="symbol">);</span>
	133	<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a></span> <span class="symbol">(</span>TP_TYPE_SVC_CONNECTION_INTERFACE_PRESENCE<span class="symbol">,</span>
	134	conn_presence_iface_init<span class="symbol">);</span>
	135	<span class="symbol">)</span></pre></td>
	136	</tr>
	137	</tbody>
	138	</table>
	139	</div>
	140
96	141	<p>
97	142	The _class_init, _init etc. functions are just like normal, so I
98	143	won't describe them here. One thing to note, though, is that for

106	151	For example, here's the signature for the Error method on the
107	152	media session handler interface:
108	153	</p>
109		<div class="informalexample"><pre class="programlisting">
110		void (*tp_svc_media_session_handler_error_impl)
111		(TpSvcMediaSessionHandler self, guint errno, const char message,
112		DBusGMethodInvocation *context);
113		</pre></div>
	154	<div class="informalexample">
	155	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	156	<tbody>
	157	<tr>
	158	<td class="listing_lines" align="right"><pre>1
	159	2
	160	3</pre></td>
	161	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span> <span class="symbol">(*</span>tp_svc_media_session_handler_error_impl<span class="symbol">)</span>
	162	<span class="symbol">(</span>TpSvcMediaSessionHandler <span class="symbol"></span>self<span class="symbol">,</span> guint errno<span class="symbol">,</span> <span class="gtkdoc kwb">const char</span> <span class="symbol"></span>message<span class="symbol">,</span>
	163	DBusGMethodInvocation <span class="symbol">*</span>context<span class="symbol">);</span></pre></td>
	164	</tr>
	165	</tbody>
	166	</table>
	167	</div>
	168
114	169	<p>
115	170	and here's the beginning of the corresponding implementation:
116	171	</p>
117		<div class="informalexample"><pre class="programlisting">
118		static void
119		gabble_media_session_error (TpSvcMediaSessionHandler *iface,
120		guint errno,
121		const char *message,
122		DBusGMethodInvocation *context)
123		{
124		GabbleMediaSession *self = GABBLE_MEDIA_SESSION (iface);
125
126		/* do stuff with self here */
127		</pre></div>
	172	<div class="informalexample">
	173	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	174	<tbody>
	175	<tr>
	176	<td class="listing_lines" align="right"><pre>1
	177	2
	178	3
	179	4
	180	5
	181	6
	182	7
	183	8
	184	9</pre></td>
	185	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	186	<span class="function">gabble_media_session_error</span> <span class="symbol">(</span>TpSvcMediaSessionHandler <span class="symbol">*</span>iface<span class="symbol">,</span>
	187	guint errno<span class="symbol">,</span>
	188	<span class="gtkdoc kwb">const char</span> <span class="symbol">*</span>message<span class="symbol">,</span>
	189	DBusGMethodInvocation <span class="symbol">*</span>context<span class="symbol">)</span>
	190	<span class="symbol">{</span>
	191	GabbleMediaSession <span class="symbol">*</span>self <span class="symbol">=</span> <span class="function">GABBLE_MEDIA_SESSION</span> <span class="symbol">(</span>iface<span class="symbol">);</span>
	192
	193	<span class="comment">/* do stuff with self here */</span></pre></td>
	194	</tr>
	195	</tbody>
	196	</table>
	197	</div>
	198
128	199	<p>
129	200	All service methods in telepathy-glib are asynchronous - you can of
130	201	course implement them synchronously if you like, but you have to return

146	217	tp_svc_media_session_handler_return_from_error() doesn't take any
147	218	parameters apart from the DBusGMethodInvocation:
148	219	</p>
149		<div class="informalexample"><pre class="programlisting">
150		static void
151		gabble_media_session_error (TpSvcMediaSessionHandler *iface,
152		guint errno,
153		const char *message,
154		DBusGMethodInvocation *context)
155		{
156		GabbleMediaSession *self = GABBLE_MEDIA_SESSION (iface);
157
158		/* do stuff with self here */
159
160		tp_svc_media_session_handler_return_from_error (context);
161		}
162		</pre></div>
	220	<div class="informalexample">
	221	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	222	<tbody>
	223	<tr>
	224	<td class="listing_lines" align="right"><pre>1
	225	2
	226	3
	227	4
	228	5
	229	6
	230	7
	231	8
	232	9
	233	10
	234	11
	235	12</pre></td>
	236	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	237	<span class="function">gabble_media_session_error</span> <span class="symbol">(</span>TpSvcMediaSessionHandler <span class="symbol">*</span>iface<span class="symbol">,</span>
	238	guint errno<span class="symbol">,</span>
	239	<span class="gtkdoc kwb">const char</span> <span class="symbol">*</span>message<span class="symbol">,</span>
	240	DBusGMethodInvocation <span class="symbol">*</span>context<span class="symbol">)</span>
	241	<span class="symbol">{</span>
	242	GabbleMediaSession <span class="symbol">*</span>self <span class="symbol">=</span> <span class="function">GABBLE_MEDIA_SESSION</span> <span class="symbol">(</span>iface<span class="symbol">);</span>
	243
	244	<span class="comment">/* do stuff with self here */</span>
	245
	246	<span class="function"><a href="telepathy-glib-svc-media-interfaces.html#tp-svc-media-session-handler-return-from-error">tp_svc_media_session_handler_return_from_error</a></span> <span class="symbol">(</span>context<span class="symbol">);</span>
	247	<span class="symbol">}</span></pre></td>
	248	</tr>
	249	</tbody>
	250	</table>
	251	</div>
	252
163	253	<p>
164	254	</p>
165	255	<p>

172	262	function whose name contains _emit_. This is prototyped to take
173	263	the correct arguments for the signal, and emits it efficiently:
174	264	</p>
175		<div class="informalexample"><pre class="programlisting">
176		tp_svc_media_session_handler_emit_new_stream_handler (session,
177		object_path, id, media_type, TP_MEDIA_STREAM_DIRECTION_BIDIRECTIONAL);
178		</pre></div>
	265	<div class="informalexample">
	266	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	267	<tbody>
	268	<tr>
	269	<td class="listing_lines" align="right"><pre>1
	270	2</pre></td>
	271	<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-svc-media-interfaces.html#tp-svc-media-session-handler-emit-new-stream-handler">tp_svc_media_session_handler_emit_new_stream_handler</a></span> <span class="symbol">(</span>session<span class="symbol">,</span>
	272	object_path<span class="symbol">,</span> id<span class="symbol">,</span> media_type<span class="symbol">,</span> TP_MEDIA_STREAM_DIRECTION_BIDIRECTIONAL<span class="symbol">);</span></pre></td>
	273	</tr>
	274	</tbody>
	275	</table>
	276	</div>
	277
179	278	<p>
180	279	</p>
181	280	<p>

186	285	to an interface. Instead, you call functions, with pointers to your
187	286	method implementations as a parameter:
188	287	</p>
189		<div class="informalexample"><pre class="programlisting">
190		static void
191		session_handler_iface_init (gpointer g_iface, gpointer iface_data)
192		{
193		TpSvcMediaSessionHandlerClass *klass =
194		(TpSvcMediaSessionHandlerClass *)g_iface;
195
196		tp_svc_media_session_handler_implement_error (klass,
197		gabble_media_session_error);
198		tp_svc_media_session_handler_implement_ready (klass,
199		gabble_media_session_ready);
200		}
201		</pre></div>
	288	<div class="informalexample">
	289	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	290	<tbody>
	291	<tr>
	292	<td class="listing_lines" align="right"><pre>1
	293	2
	294	3
	295	4
	296	5
	297	6
	298	7
	299	8
	300	9
	301	10
	302	11</pre></td>
	303	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	304	<span class="function">session_handler_iface_init</span> <span class="symbol">(</span>gpointer g_iface<span class="symbol">,</span> gpointer iface_data<span class="symbol">)</span>
	305	<span class="symbol">{</span>
	306	TpSvcMediaSessionHandlerClass <span class="symbol">*</span>klass <span class="symbol">=</span>
	307	<span class="symbol">(</span>TpSvcMediaSessionHandlerClass <span class="symbol">*)</span>g_iface<span class="symbol">;</span>
	308
	309	<span class="function"><a href="telepathy-glib-svc-media-interfaces.html#tp-svc-media-session-handler-implement-error">tp_svc_media_session_handler_implement_error</a></span> <span class="symbol">(</span>klass<span class="symbol">,</span>
	310	gabble_media_session_error<span class="symbol">);</span>
	311	<span class="function"><a href="telepathy-glib-svc-media-interfaces.html#tp-svc-media-session-handler-implement-ready">tp_svc_media_session_handler_implement_ready</a></span> <span class="symbol">(</span>klass<span class="symbol">,</span>
	312	gabble_media_session_ready<span class="symbol">);</span>
	313	<span class="symbol">}</span></pre></td>
	314	</tr>
	315	</tbody>
	316	</table>
	317	</div>
	318
202	319	<p>
203	320	This is obviously quite repetitive if there are a lot of methods, so
204	321	the convention I've used in telepathy-glib, Gabble and
205	322	telepathy-sofiasip is to define a temporary macro called IMPLEMENT:
206	323	</p>
207		<div class="informalexample"><pre class="programlisting">
208		static void
209		session_handler_iface_init (gpointer g_iface, gpointer iface_data)
210		{
211		TpSvcMediaSessionHandlerClass *klass =
212		(TpSvcMediaSessionHandlerClass *)g_iface;
213
214		#define IMPLEMENT(x) tp_svc_media_session_handler_implement_##x (\
215		klass, gabble_media_session_##x)
216		IMPLEMENT(error);
217		IMPLEMENT(ready);
218		#undef IMPLEMENT
219		}
220		</pre></div>
	324	<div class="informalexample">
	325	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	326	<tbody>
	327	<tr>
	328	<td class="listing_lines" align="right"><pre>1
	329	2
	330	3
	331	4
	332	5
	333	6
	334	7
	335	8
	336	9
	337	10
	338	11
	339	12</pre></td>
	340	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
	341	<span class="function">session_handler_iface_init</span> <span class="symbol">(</span>gpointer g_iface<span class="symbol">,</span> gpointer iface_data<span class="symbol">)</span>
	342	<span class="symbol">{</span>
	343	TpSvcMediaSessionHandlerClass <span class="symbol">*</span>klass <span class="symbol">=</span>
	344	<span class="symbol">(</span>TpSvcMediaSessionHandlerClass <span class="symbol">*)</span>g_iface<span class="symbol">;</span>
	345
	346	<span class="preproc">#define IMPLEMENT(x) tp_svc_media_session_handler_implement_##x (\</span>
	347	<span class="preproc"> klass, gabble_media_session_##x)</span>
	348	<span class="function">IMPLEMENT</span><span class="symbol">(</span>error<span class="symbol">);</span>
	349	<span class="function">IMPLEMENT</span><span class="symbol">(</span>ready<span class="symbol">);</span>
	350	<span class="preproc">#undef IMPLEMENT</span>
	351	<span class="symbol">}</span></pre></td>
	352	</tr>
	353	</tbody>
	354	</table>
	355	</div>
	356
221	357	<p>
222	358	</p>
223	359	<p>

+83

-41

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

1160	1160	<p>
1161	1161	</p>
1162	1162	<div class="example">
1163		<a name="id1155167"></a><p class="title"><b>Example 2. using tp_value_array_build</b></p>
1164		<div class="example-contents"><pre class="programlisting">
1165		GValueArray *array = tp_value_array_build (2,
1166		G_TYPE_STRING, host,
1167		G_TYPE_UINT, port,
1168		G_TYPE_INVALID);
1169		</pre></div>
	1163	<a name="id1308589"></a><p class="title"><b>Example 2. using tp_value_array_build</b></p>
	1164	<div class="example-contents">
	1165	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	1166	<tbody>
	1167	<tr>
	1168	<td class="listing_lines" align="right"><pre>1
	1169	2
	1170	3
	1171	4</pre></td>
	1172	<td class="listing_code"><pre class="programlisting">GValueArray <span class="symbol">*</span>array <span class="symbol">=</span> <span class="function"><a href="telepathy-glib-util.html#tp-value-array-build">tp_value_array_build</a></span> <span class="symbol">(</span><span class="number">2</span><span class="symbol">,</span>
	1173	G_TYPE_STRING<span class="symbol">,</span> host<span class="symbol">,</span>
	1174	G_TYPE_UINT<span class="symbol">,</span> port<span class="symbol">,</span>
	1175	G_TYPE_INVALID<span class="symbol">);</span></pre></td>
	1176	</tr>
	1177	</tbody>
	1178	</table>
	1179	</div>
	1180
1170	1181	</div>
1171	1182	<p><br class="example-break">
1172	1183	</p>

1215	1226	<p>
1216	1227	</p>
1217	1228	<div class="example">
1218		<a name="id1155346"></a><p class="title"><b>Example 3. using tp_value_array_unpack</b></p>
1219		<div class="example-contents"><pre class="programlisting">
1220		const gchar *host;
1221		guint port;
1222
1223		tp_value_array_unpack (array, 2,
1224		&host,
1225		&port);
1226		</pre></div>
	1229	<a name="id1308768"></a><p class="title"><b>Example 3. using tp_value_array_unpack</b></p>
	1230	<div class="example-contents">
	1231	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	1232	<tbody>
	1233	<tr>
	1234	<td class="listing_lines" align="right"><pre>1
	1235	2
	1236	3
	1237	4
	1238	5
	1239	6</pre></td>
	1240	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">const</span> gchar <span class="symbol">*</span>host<span class="symbol">;</span>
	1241	guint port<span class="symbol">;</span>
	1242
	1243	<span class="function"><a href="telepathy-glib-util.html#tp-value-array-unpack">tp_value_array_unpack</a></span> <span class="symbol">(</span>array<span class="symbol">,</span> <span class="number">2</span><span class="symbol">,</span>
	1244	<span class="symbol">&</span>host<span class="symbol">,</span>
	1245	<span class="symbol">&</span>port<span class="symbol">);</span></pre></td>
	1246	</tr>
	1247	</tbody>
	1248	</table>
	1249	</div>
	1250
1227	1251	</div>
1228	1252	<p><br class="example-break">
1229	1253	</p>

1389	1413	unref or destroy the object it previously pointed to with <em class="parameter"><code>destroy</code></em>.
1390	1414	</p>
1391	1415	<p>
1392		More precisely, if both <em class="parameter"><code>pp</code></em> and <em class="parameter"><code>pp</code></em> are non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set <em class="parameter"><code>pp</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
	1416	More precisely, if <em class="parameter"><code>pp</code></em> is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set <em class="parameter"><code>pp</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
1393	1417	call <em class="parameter"><code>destroy</code></em> on the object that *<em class="parameter"><code>pp</code></em> previously pointed to.
1394	1418	</p>
1395	1419	<p>

1401	1425	</p>
1402	1426	<p>
1403	1427	</p>
1404		<div class="informalexample"><pre class="programlisting">
1405		typedef struct {
1406		TpConnection *conn;
1407		GError *error;
1408		GHashTable *table;
1409		MyStruct *misc;
1410		} Foo;
1411		Foo *foo;
1412
1413		...
1414
1415		tp_clear_object (&foo->conn);
1416		g_clear_error (&foo->error);
1417		tp_clear_boxed (G_TYPE_HASH_TABLE, &foo->table);
1418		tp_clear_pointer (&foo->misc, my_struct_destroy);
1419		</pre></div>
	1428	<div class="informalexample">
	1429	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
	1430	<tbody>
	1431	<tr>
	1432	<td class="listing_lines" align="right"><pre>1
	1433	2
	1434	3
	1435	4
	1436	5
	1437	6
	1438	7
	1439	8
	1440	9
	1441	10
	1442	11
	1443	12
	1444	13
	1445	14</pre></td>
	1446	<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">struct</span> <span class="symbol">{</span>
	1447	TpConnection <span class="symbol">*</span>conn<span class="symbol">;</span>
	1448	GError <span class="symbol">*</span>error<span class="symbol">;</span>
	1449	GHashTable <span class="symbol">*</span>table<span class="symbol">;</span>
	1450	MyStruct <span class="symbol">*</span>misc<span class="symbol">;</span>
	1451	<span class="symbol">}</span> Foo<span class="symbol">;</span>
	1452	Foo <span class="symbol">*</span>foo<span class="symbol">;</span>
	1453
	1454	<span class="symbol">...</span>
	1455
	1456	<span class="function"><a href="telepathy-glib-util.html#tp-clear-object">tp_clear_object</a></span> <span class="symbol">(&</span>foo<span class="symbol">-></span>conn<span class="symbol">);</span>
	1457	<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#g-clear-error">g_clear_error</a></span> <span class="symbol">(&</span>foo<span class="symbol">-></span>error<span class="symbol">);</span>
	1458	<span class="function"><a href="telepathy-glib-util.html#tp-clear-boxed">tp_clear_boxed</a></span> <span class="symbol">(</span>G_TYPE_HASH_TABLE<span class="symbol">, &</span>foo<span class="symbol">-></span>table<span class="symbol">);</span>
	1459	<span class="function"><a href="telepathy-glib-util.html#tp-clear-pointer">tp_clear_pointer</a></span> <span class="symbol">(&</span>foo<span class="symbol">-></span>misc<span class="symbol">,</span> my_struct_destroy<span class="symbol">);</span></pre></td>
	1460	</tr>
	1461	</tbody>
	1462	</table>
	1463	</div>
	1464
1420	1465	<p>
1421	1466	</p>
1422	1467	<div class="variablelist"><table border="0">

1424	1469	<tbody>
1425	1470	<tr>
1426	1471	<td><p><span class="term"><em class="parameter"><code>pp</code></em> :</span></p></td>
1427		<td> a pointer to a variable, struct member etc. holding a
1428		pointer. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
	1472	<td>a pointer to a variable, struct member etc. holding a pointer
1429	1473	</td>
1430	1474	</tr>
1431	1475	<tr>

1456	1500	<col align="left" valign="top">
1457	1501	<tbody><tr>
1458	1502	<td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
1459		<td> a pointer to a variable, struct member etc. holding a
1460		<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
	1503	<td>a pointer to a variable, struct member etc. holding a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
1461	1504	</td>
1462	1505	</tr></tbody>
1463	1506	</table></div>

1473	1516	<em class="parameter"><code>gtype</code></em>.
1474	1517	</p>
1475	1518	<p>
1476		More precisely, if both <em class="parameter"><code>pp</code></em> and <em class="parameter"><code>pp</code></em> are non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set <em class="parameter"><code>pp</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
	1519	More precisely, if <em class="parameter"><code>pp</code></em> is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set <em class="parameter"><code>pp</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
1477	1520	call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#g-boxed-free"><code class="function">g_boxed_free()</code></a> on the object that *<em class="parameter"><code>pp</code></em> previously pointed to.
1478	1521	</p>
1479	1522	<p>

1490	1533	</tr>
1491	1534	<tr>
1492	1535	<td><p><span class="term"><em class="parameter"><code>pp</code></em> :</span></p></td>
1493		<td> a pointer to a variable, struct member etc. holding a
1494		boxed object. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
	1536	<td>a pointer to a variable, struct member etc. holding a boxed object
1495	1537	</td>
1496	1538	</tr>
1497	1539	</tbody>

1584	1626	<p>
1585	1627	Interpret a Telepathy user action time to decide whether a Handler should
1586	1628	attempt to gain focus. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned, it would be appropriate to
1587		call <a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html#gtk-window-present-with-time"><code class="function">gtk_window_present_with_time()</code></a> using <em class="parameter"><code>x11_time</code></em> as input, for instance.
	1629	call <a href="/usr/share/gtk-doc/html/gtk/GtkWindow.html#gtk-window-present-with-time"><code class="function">gtk_window_present_with_time()</code></a> using <em class="parameter"><code>x11_time</code></em> as input, for instance.
1588	1630	</p>
1589	1631	<p>
1590	1632	<em class="parameter"><code>x11_time</code></em> is used to return a timestamp in the right format for X11,

+44

-0

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

117	117	<sub name="TpMessageMixin" link="telepathy-glib-TpMessageMixin.html"/>
118	118	<sub name="TpMessage" link="TpMessage.html"/>
119	119	<sub name="TpCMMessage" link="TpCMMessage.html"/>
	120	<sub name="TpBasePasswordChannel" link="telepathy-glib-base-password-channel.html"/>
120	121	<sub name="TpSimplePasswordManager" link="telepathy-glib-simple-password-manager.html"/>
121	122	<sub name="TpBaseClient" link="telepathy-glib-base-client.html"/>
122	123	<sub name="TpObserveChannelsContext" link="telepathy-glib-observe-channels-context.html"/>

413	414	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_GROUPS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-GROUPS:CAPS"/>
414	415	<function name="TP_IFACE_CONNECTION_INTERFACE_POWER_SAVING" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-POWER-SAVING:CAPS"/>
415	416	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_POWER_SAVING" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-POWER-SAVING:CAPS"/>
	417	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS"/>
	418	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS"/>
416	419	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"/>
417	420	<function name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_INFO" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"/>
418	421	<function name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_LIST" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-LIST:CAPS"/>

631	634	<function name="TP_PROP_CHANNEL_TYPE_FILE_TRANSFER_URI" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-FILE-TRANSFER-URI:CAPS"/>
632	635	<function name="TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-ROOM-LIST-SERVER:CAPS"/>
633	636	<function name="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_HOSTNAME" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-HOSTNAME:CAPS"/>
	637	<function name="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-REFERENCE-IDENTITIES:CAPS"/>
634	638	<function name="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-SERVER-CERTIFICATE:CAPS"/>
635	639	<function name="TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_IMMUTABLE_STREAMS" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-IMMUTABLE-STREAMS:CAPS"/>
636	640	<function name="TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-INITIAL-AUDIO:CAPS"/>

666	670	<function name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-MESSAGE-VALIDITY-PERIOD:CAPS"/>
667	671	<function name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_OVERRIDE_MESSAGE_SERVICE_CENTRE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-OVERRIDE-MESSAGE-SERVICE-CENTRE:CAPS"/>
668	672	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACTS-CONTACT-ATTRIBUTE-INTERFACES:CAPS"/>
	673	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-BLOCKING-CONTACT-BLOCKING-CAPABILITIES:CAPS"/>
669	674	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-DISJOINT-GROUPS:CAPS"/>
670	675	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS"/>
671	676	<function name="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUP_STORAGE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUP-STORAGE:CAPS"/>

719	724	<function name="TP_TOKEN_CONNECTION_INTERFACE_AVATARS_TOKEN" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-AVATARS-TOKEN:CAPS"/>
720	725	<function name="TP_TOKEN_CONNECTION_INTERFACE_CAPABILITIES_CAPS" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CAPABILITIES-CAPS"/>
721	726	<function name="TP_TOKEN_CONNECTION_INTERFACE_CLIENT_TYPES_CLIENT_TYPES" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CLIENT-TYPES-CLIENT-TYPES:CAPS"/>
	727	<function name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-BLOCKING-BLOCKED:CAPS"/>
722	728	<function name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-CAPABILITIES-CAPABILITIES:CAPS"/>
723	729	<function name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS"/>
724	730	<function name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_INFO_INFO" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-INFO-INFO:CAPS"/>

764	770	<function name="enum TpChannelGroupChangeReason" link="telepathy-glib-enums.html#TpChannelGroupChangeReason"/>
765	771	<function name="NUM_TP_CHANNEL_GROUP_CHANGE_REASONS" link="telepathy-glib-enums.html#NUM-TP-CHANNEL-GROUP-CHANGE-REASONS:CAPS"/>
766	772	<function name="enum TpChannelPasswordFlags" link="telepathy-glib-enums.html#TpChannelPasswordFlags"/>
	773	<function name="enum TpContactBlockingCapabilities" link="telepathy-glib-enums.html#TpContactBlockingCapabilities"/>
767	774	<function name="enum TpDeliveryReportingSupportFlags" link="telepathy-glib-enums.html#TpDeliveryReportingSupportFlags"/>
768	775	<function name="enum TpDeliveryStatus" link="telepathy-glib-enums.html#TpDeliveryStatus"/>
769	776	<function name="NUM_TP_DELIVERY_STATUSES" link="telepathy-glib-enums.html#NUM-TP-DELIVERY-STATUSES:CAPS"/>

1348	1355	<function name="tp_cli_connection_interface_contact_info_run_request_contact_info ()" link="telepathy-glib-connection-contact-info.html#tp-cli-connection-interface-contact-info-run-request-contact-info"/>
1349	1356	<function name="tp_cli_connection_interface_contact_info_run_set_contact_info ()" link="telepathy-glib-connection-contact-info.html#tp-cli-connection-interface-contact-info-run-set-contact-info"/>
1350	1357	<function name="tp_cli_connection_interface_contact_info_signal_callback_contact_info_changed ()" link="telepathy-glib-connection-contact-info.html#tp-cli-connection-interface-contact-info-signal-callback-contact-info-changed"/>
	1358	<function name="tp_cli_connection_interface_contact_blocking_call_block_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-block-contacts"/>
	1359	<function name="tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-request-blocked-contacts"/>
	1360	<function name="tp_cli_connection_interface_contact_blocking_call_unblock_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-unblock-contacts"/>
	1361	<function name="tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-block-contacts"/>
	1362	<function name="tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts"/>
	1363	<function name="tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts"/>
	1364	<function name="tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed"/>
	1365	<function name="tp_cli_connection_interface_contact_blocking_run_block_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-block-contacts"/>
	1366	<function name="tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-request-blocked-contacts"/>
	1367	<function name="tp_cli_connection_interface_contact_blocking_run_unblock_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-unblock-contacts"/>
	1368	<function name="tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed"/>
1351	1369	<function name="tp_cli_connection_interface_contact_groups_call_add_to_group ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-add-to-group"/>
1352	1370	<function name="tp_cli_connection_interface_contact_groups_call_remove_from_group ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-remove-from-group"/>
1353	1371	<function name="tp_cli_connection_interface_contact_groups_call_remove_group ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-remove-group"/>

2779	2797	<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"/>
2780	2798	<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"/>
2781	2799	<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"/>
	2800	<function name="TpSvcConnectionInterfaceContactBlocking" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-struct"/>
	2801	<function name="TpSvcConnectionInterfaceContactBlockingClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass"/>
	2802	<function name="tp_svc_connection_interface_contact_blocking_block_contacts_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-block-contacts-impl"/>
	2803	<function name="tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-emit-blocked-contacts-changed"/>
	2804	<function name="tp_svc_connection_interface_contact_blocking_implement_block_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-block-contacts"/>
	2805	<function name="tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-request-blocked-contacts"/>
	2806	<function name="tp_svc_connection_interface_contact_blocking_implement_unblock_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-unblock-contacts"/>
	2807	<function name="tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl"/>
	2808	<function name="tp_svc_connection_interface_contact_blocking_return_from_block_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-block-contacts"/>
	2809	<function name="tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-request-blocked-contacts"/>
	2810	<function name="tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-unblock-contacts"/>
	2811	<function name="tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-unblock-contacts-impl"/>
2782	2812	<function name="TpSvcConnectionInterfaceContactGroups" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-struct"/>
2783	2813	<function name="TpSvcConnectionInterfaceContactGroupsClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroupsClass"/>
2784	2814	<function name="tp_svc_connection_interface_contact_groups_add_to_group_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-groups-add-to-group-impl"/>

2870	2900	<function name="The "contact-capabilities-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed"/>
2871	2901	<function name="The "location-updated" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated"/>
2872	2902	<function name="The "contact-info-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed"/>
	2903	<function name="The "blocked-contacts-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-blocked-contacts-changed"/>
2873	2904	<function name="The "group-renamed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-group-renamed"/>
2874	2905	<function name="The "groups-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-changed"/>
2875	2906	<function name="The "groups-created" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-created"/>

3501	3532	<function name="tp_cm_message_take_message ()" link="TpCMMessage.html#tp-cm-message-take-message"/>
3502	3533	<function name="tp_cm_message_get_sender ()" link="TpCMMessage.html#tp-cm-message-get-sender"/>
3503	3534	<function name="tp_cm_message_set_sender ()" link="TpCMMessage.html#tp-cm-message-set-sender"/>
	3535	<function name="TpBasePasswordChannel" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel-struct"/>
	3536	<function name="The "authentication-method" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authentication-method"/>
	3537	<function name="The "authorization-identity" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authorization-identity"/>
	3538	<function name="The "available-mechanisms" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--available-mechanisms"/>
	3539	<function name="The "can-try-again" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--can-try-again"/>
	3540	<function name="The "default-realm" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-realm"/>
	3541	<function name="The "default-username" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-username"/>
	3542	<function name="The "has-initial-data" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--has-initial-data"/>
	3543	<function name="The "may-save-response" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--may-save-response"/>
	3544	<function name="The "sasl-error" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error"/>
	3545	<function name="The "sasl-error-details" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error-details"/>
	3546	<function name="The "sasl-status" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-status"/>
	3547	<function name="The "finished" signal" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel-finished"/>
3504	3548	<function name="TpSimplePasswordManager" link="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager-struct"/>
3505	3549	<function name="tp_simple_password_manager_new ()" link="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-new"/>
3506	3550	<function name="tp_simple_password_manager_prompt_async ()" link="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async"/>

+45

-0

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

117	117	<sub name="TpMessageMixin" link="telepathy-glib-TpMessageMixin.html"/>
118	118	<sub name="TpMessage" link="TpMessage.html"/>
119	119	<sub name="TpCMMessage" link="TpCMMessage.html"/>
	120	<sub name="TpBasePasswordChannel" link="telepathy-glib-base-password-channel.html"/>
120	121	<sub name="TpSimplePasswordManager" link="telepathy-glib-simple-password-manager.html"/>
121	122	<sub name="TpBaseClient" link="telepathy-glib-base-client.html"/>
122	123	<sub name="TpObserveChannelsContext" link="telepathy-glib-observe-channels-context.html"/>

413	414	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_GROUPS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-GROUPS:CAPS"/>
414	415	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_POWER_SAVING" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-POWER-SAVING:CAPS"/>
415	416	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_POWER_SAVING" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-POWER-SAVING:CAPS"/>
	417	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS"/>
	418	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-BLOCKING:CAPS"/>
416	419	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"/>
417	420	<keyword type="macro" name="TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_INFO" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CONNECTION-INTERFACE-CONTACT-INFO:CAPS"/>
418	421	<keyword type="macro" name="TP_IFACE_CONNECTION_INTERFACE_CONTACT_LIST" link="telepathy-glib-interfaces.html#TP-IFACE-CONNECTION-INTERFACE-CONTACT-LIST:CAPS"/>

631	634	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_FILE_TRANSFER_URI" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-FILE-TRANSFER-URI:CAPS"/>
632	635	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-ROOM-LIST-SERVER:CAPS"/>
633	636	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_HOSTNAME" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-HOSTNAME:CAPS"/>
	637	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-REFERENCE-IDENTITIES:CAPS"/>
634	638	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-SERVER-TLS-CONNECTION-SERVER-CERTIFICATE:CAPS"/>
635	639	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_IMMUTABLE_STREAMS" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-IMMUTABLE-STREAMS:CAPS"/>
636	640	<keyword type="macro" name="TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO" link="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAMED-MEDIA-INITIAL-AUDIO:CAPS"/>

666	670	<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"/>
667	671	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CELLULAR_OVERRIDE_MESSAGE_SERVICE_CENTRE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CELLULAR-OVERRIDE-MESSAGE-SERVICE-CENTRE:CAPS"/>
668	672	<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"/>
	673	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-BLOCKING-CONTACT-BLOCKING-CAPABILITIES:CAPS"/>
669	674	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-DISJOINT-GROUPS:CAPS"/>
670	675	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS"/>
671	676	<keyword type="macro" name="TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUP_STORAGE" link="telepathy-glib-interfaces.html#TP-PROP-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUP-STORAGE:CAPS"/>

719	724	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_AVATARS_TOKEN" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-AVATARS-TOKEN:CAPS"/>
720	725	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_CAPABILITIES_CAPS" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CAPABILITIES-CAPS"/>
721	726	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_CLIENT_TYPES_CLIENT_TYPES" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CLIENT-TYPES-CLIENT-TYPES:CAPS"/>
	727	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-BLOCKING-BLOCKED:CAPS"/>
722	728	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-CAPABILITIES-CAPABILITIES:CAPS"/>
723	729	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-GROUPS-GROUPS:CAPS"/>
724	730	<keyword type="macro" name="TP_TOKEN_CONNECTION_INTERFACE_CONTACT_INFO_INFO" link="telepathy-glib-interfaces.html#TP-TOKEN-CONNECTION-INTERFACE-CONTACT-INFO-INFO:CAPS"/>

764	770	<keyword type="enum" name="enum TpChannelGroupChangeReason" link="telepathy-glib-enums.html#TpChannelGroupChangeReason"/>
765	771	<keyword type="macro" name="NUM_TP_CHANNEL_GROUP_CHANGE_REASONS" link="telepathy-glib-enums.html#NUM-TP-CHANNEL-GROUP-CHANGE-REASONS:CAPS"/>
766	772	<keyword type="enum" name="enum TpChannelPasswordFlags" link="telepathy-glib-enums.html#TpChannelPasswordFlags"/>
	773	<keyword type="enum" name="enum TpContactBlockingCapabilities" link="telepathy-glib-enums.html#TpContactBlockingCapabilities"/>
767	774	<keyword type="enum" name="enum TpDeliveryReportingSupportFlags" link="telepathy-glib-enums.html#TpDeliveryReportingSupportFlags"/>
768	775	<keyword type="enum" name="enum TpDeliveryStatus" link="telepathy-glib-enums.html#TpDeliveryStatus"/>
769	776	<keyword type="macro" name="NUM_TP_DELIVERY_STATUSES" link="telepathy-glib-enums.html#NUM-TP-DELIVERY-STATUSES:CAPS"/>

1348	1355	<keyword type="function" name="tp_cli_connection_interface_contact_info_run_request_contact_info ()" link="telepathy-glib-connection-contact-info.html#tp-cli-connection-interface-contact-info-run-request-contact-info" deprecated=""/>
1349	1356	<keyword type="function" name="tp_cli_connection_interface_contact_info_run_set_contact_info ()" link="telepathy-glib-connection-contact-info.html#tp-cli-connection-interface-contact-info-run-set-contact-info" deprecated=""/>
1350	1357	<keyword type="function" name="tp_cli_connection_interface_contact_info_signal_callback_contact_info_changed ()" link="telepathy-glib-connection-contact-info.html#tp-cli-connection-interface-contact-info-signal-callback-contact-info-changed"/>
	1358	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_call_block_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-block-contacts"/>
	1359	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-request-blocked-contacts"/>
	1360	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_call_unblock_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-call-unblock-contacts"/>
	1361	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-block-contacts"/>
	1362	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-request-blocked-contacts"/>
	1363	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-callback-for-unblock-contacts"/>
	1364	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-connect-to-blocked-contacts-changed"/>
	1365	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_run_block_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-block-contacts" deprecated=""/>
	1366	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-request-blocked-contacts" deprecated=""/>
	1367	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_run_unblock_contacts ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-run-unblock-contacts" deprecated=""/>
	1368	<keyword type="function" name="tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-blocking-signal-callback-blocked-contacts-changed"/>
1351	1369	<keyword type="function" name="tp_cli_connection_interface_contact_groups_call_add_to_group ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-add-to-group"/>
1352	1370	<keyword type="function" name="tp_cli_connection_interface_contact_groups_call_remove_from_group ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-remove-from-group"/>
1353	1371	<keyword type="function" name="tp_cli_connection_interface_contact_groups_call_remove_group ()" link="telepathy-glib-connection-contact-list.html#tp-cli-connection-interface-contact-groups-call-remove-group"/>

2779	2797	<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"/>
2780	2798	<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"/>
2781	2799	<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"/>
	2800	<keyword type="struct" name="TpSvcConnectionInterfaceContactBlocking" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-struct"/>
	2801	<keyword type="struct" name="TpSvcConnectionInterfaceContactBlockingClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlockingClass"/>
	2802	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_block_contacts_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-block-contacts-impl"/>
	2803	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-emit-blocked-contacts-changed"/>
	2804	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_implement_block_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-block-contacts"/>
	2805	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-request-blocked-contacts"/>
	2806	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_implement_unblock_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-implement-unblock-contacts"/>
	2807	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-request-blocked-contacts-impl"/>
	2808	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_return_from_block_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-block-contacts"/>
	2809	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-request-blocked-contacts"/>
	2810	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-return-from-unblock-contacts"/>
	2811	<keyword type="function" name="tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-blocking-unblock-contacts-impl"/>
2782	2812	<keyword type="struct" name="TpSvcConnectionInterfaceContactGroups" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-struct"/>
2783	2813	<keyword type="struct" name="TpSvcConnectionInterfaceContactGroupsClass" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroupsClass"/>
2784	2814	<keyword type="function" name="tp_svc_connection_interface_contact_groups_add_to_group_impl ()" link="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-groups-add-to-group-impl"/>

2870	2900	<keyword type="signal" name="The "contact-capabilities-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactCapabilities-contact-capabilities-changed"/>
2871	2901	<keyword type="signal" name="The "location-updated" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceLocation-location-updated"/>
2872	2902	<keyword type="signal" name="The "contact-info-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactInfo-contact-info-changed"/>
	2903	<keyword type="signal" name="The "blocked-contacts-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactBlocking-blocked-contacts-changed"/>
2873	2904	<keyword type="signal" name="The "group-renamed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-group-renamed"/>
2874	2905	<keyword type="signal" name="The "groups-changed" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-changed"/>
2875	2906	<keyword type="signal" name="The "groups-created" signal" link="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactGroups-groups-created"/>

3501	3532	<keyword type="function" name="tp_cm_message_take_message ()" link="TpCMMessage.html#tp-cm-message-take-message" since="0.13.9"/>
3502	3533	<keyword type="function" name="tp_cm_message_get_sender ()" link="TpCMMessage.html#tp-cm-message-get-sender" since="0.13.9"/>
3503	3534	<keyword type="function" name="tp_cm_message_set_sender ()" link="TpCMMessage.html#tp-cm-message-set-sender" since="0.13.9"/>
	3535	<keyword type="struct" name="TpBasePasswordChannel" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel-struct"/>
	3536	<keyword type="property" name="The "authentication-method" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authentication-method"/>
	3537	<keyword type="property" name="The "authorization-identity" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--authorization-identity"/>
	3538	<keyword type="property" name="The "available-mechanisms" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--available-mechanisms"/>
	3539	<keyword type="property" name="The "can-try-again" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--can-try-again"/>
	3540	<keyword type="property" name="The "default-realm" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-realm"/>
	3541	<keyword type="property" name="The "default-username" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--default-username"/>
	3542	<keyword type="property" name="The "has-initial-data" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--has-initial-data"/>
	3543	<keyword type="property" name="The "may-save-response" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--may-save-response"/>
	3544	<keyword type="property" name="The "sasl-error" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error"/>
	3545	<keyword type="property" name="The "sasl-error-details" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-error-details"/>
	3546	<keyword type="property" name="The "sasl-status" property" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel--sasl-status"/>
	3547	<keyword type="signal" name="The "finished" signal" link="telepathy-glib-base-password-channel.html#TpBasePasswordChannel-finished"/>
3504	3548	<keyword type="struct" name="TpSimplePasswordManager" link="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager-struct"/>
3505	3549	<keyword type="function" name="tp_simple_password_manager_new ()" link="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-new"/>
3506	3550	<keyword type="function" name="tp_simple_password_manager_prompt_async ()" link="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" since="0.13.8"/>

3970	4014	<keyword type="constant" name="TP_CHANNEL_GROUP_CHANGE_REASON_PERMISSION_DENIED" link="telepathy-glib-enums.html#TP-CHANNEL-GROUP-CHANGE-REASON-PERMISSION-DENIED:CAPS"/>
3971	4015	<keyword type="constant" name="TP_CHANNEL_GROUP_CHANGE_REASON_SEPARATED" link="telepathy-glib-enums.html#TP-CHANNEL-GROUP-CHANGE-REASON-SEPARATED:CAPS"/>
3972	4016	<keyword type="constant" name="TP_CHANNEL_PASSWORD_FLAG_PROVIDE" link="telepathy-glib-enums.html#TP-CHANNEL-PASSWORD-FLAG-PROVIDE:CAPS"/>
	4017	<keyword type="constant" name="TP_CONTACT_BLOCKING_CAPABILITY_CAN_REPORT_ABUSIVE" link="telepathy-glib-enums.html#TP-CONTACT-BLOCKING-CAPABILITY-CAN-REPORT-ABUSIVE:CAPS"/>
3973	4018	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_FAILURES" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-FAILURES:CAPS"/>
3974	4019	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_SUCCESSES" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-SUCCESSES:CAPS"/>
3975	4020	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_READ" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-READ:CAPS"/>

+1

-1

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

134	134	<xi:include href="xml/message-mixin.xml"/>
135	135	<xi:include href="xml/message.xml"/>
136	136	<xi:include href="xml/cm-message.xml"/>
137		<xi:include href="xml/simple-password-channel.xml"/>
	137	<xi:include href="xml/base-password-channel.xml"/>
138	138	<xi:include href="xml/simple-password-manager.xml"/>
139	139	<xi:include href="xml/base-client.xml"/>
140	140	<xi:include href="xml/observe-channels-context.xml"/>

+35

-0

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

1115	1115	TP_SVC_CONNECTION_INTERFACE_CONTACT_INFO_GET_CLASS
1116	1116	TP_TYPE_SVC_CONNECTION_INTERFACE_CONTACT_INFO
1117	1117	<SUBSECTION>
	1118	TpSvcConnectionInterfaceContactBlocking
	1119	TpSvcConnectionInterfaceContactBlockingClass
	1120	tp_svc_connection_interface_contact_blocking_block_contacts_impl
	1121	tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed
	1122	tp_svc_connection_interface_contact_blocking_implement_block_contacts
	1123	tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts
	1124	tp_svc_connection_interface_contact_blocking_implement_unblock_contacts
	1125	tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl
	1126	tp_svc_connection_interface_contact_blocking_return_from_block_contacts
	1127	tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts
	1128	tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts
	1129	tp_svc_connection_interface_contact_blocking_unblock_contacts_impl
1118	1130	TpSvcConnectionInterfaceContactGroups
1119	1131	TpSvcConnectionInterfaceContactGroupsClass
1120	1132	tp_svc_connection_interface_contact_groups_add_to_group_impl

1163	1175	tp_svc_connection_interface_contact_list_unpublish_impl
1164	1176	tp_svc_connection_interface_contact_list_unsubscribe_impl
1165	1177	<SUBSECTION Standard>
	1178	tp_svc_connection_interface_contact_blocking_get_type
1166	1179	tp_svc_connection_interface_contact_list_get_type
1167	1180	tp_svc_connection_interface_contact_groups_get_type
	1181	TP_IS_SVC_CONNECTION_INTERFACE_CONTACT_BLOCKING
1168	1182	TP_IS_SVC_CONNECTION_INTERFACE_CONTACT_GROUPS
1169	1183	TP_IS_SVC_CONNECTION_INTERFACE_CONTACT_LIST
	1184	TP_SVC_CONNECTION_INTERFACE_CONTACT_BLOCKING
	1185	TP_SVC_CONNECTION_INTERFACE_CONTACT_BLOCKING_GET_CLASS
1170	1186	TP_SVC_CONNECTION_INTERFACE_CONTACT_GROUPS
1171	1187	TP_SVC_CONNECTION_INTERFACE_CONTACT_GROUPS_GET_CLASS
1172	1188	TP_SVC_CONNECTION_INTERFACE_CONTACT_LIST
1173	1189	TP_SVC_CONNECTION_INTERFACE_CONTACT_LIST_GET_CLASS
	1190	TP_TYPE_SVC_CONNECTION_INTERFACE_CONTACT_BLOCKING
1174	1191	TP_TYPE_SVC_CONNECTION_INTERFACE_CONTACT_GROUPS
1175	1192	TP_TYPE_SVC_CONNECTION_INTERFACE_CONTACT_LIST
1176	1193	<SUBSECTION>

2365	2382	TpChannelGroupChangeReason
2366	2383	NUM_TP_CHANNEL_GROUP_CHANGE_REASONS
2367	2384	TpChannelPasswordFlags
	2385	TpContactBlockingCapabilities
2368	2386	TpDeliveryReportingSupportFlags
2369	2387	TpDeliveryStatus
2370	2388	NUM_TP_DELIVERY_STATUSES

2504	2522	TP_IFACE_QUARK_CONNECTION_INTERFACE_CLIENT_TYPES
2505	2523	TP_IFACE_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
2506	2524	TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_CAPABILITIES
	2525	TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING
	2526	TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING
2507	2527	TP_IFACE_CONNECTION_INTERFACE_CONTACT_GROUPS
2508	2528	TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_GROUPS
2509	2529	TP_IFACE_CONNECTION_INTERFACE_CONTACT_INFO

2724	2744	TP_PROP_CHANNEL_TYPE_FILE_TRANSFER_URI
2725	2745	TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER
2726	2746	TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_HOSTNAME
	2747	TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES
2727	2748	TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE
2728	2749	TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_IMMUTABLE_STREAMS
2729	2750	TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO

2759	2780	TP_PROP_CONNECTION_INTERFACE_CELLULAR_MESSAGE_VALIDITY_PERIOD
2760	2781	TP_PROP_CONNECTION_INTERFACE_CELLULAR_OVERRIDE_MESSAGE_SERVICE_CENTRE
2761	2782	TP_PROP_CONNECTION_INTERFACE_CONTACTS_CONTACT_ATTRIBUTE_INTERFACES
	2783	TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES
2762	2784	TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS
2763	2785	TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS
2764	2786	TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUP_STORAGE

2812	2834	TP_TOKEN_CONNECTION_INTERFACE_AVATARS_TOKEN
2813	2835	TP_TOKEN_CONNECTION_INTERFACE_CAPABILITIES_CAPS
2814	2836	TP_TOKEN_CONNECTION_INTERFACE_CLIENT_TYPES_CLIENT_TYPES
	2837	TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED
2815	2838	TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES
2816	2839	TP_TOKEN_CONNECTION_INTERFACE_CONTACT_GROUPS_GROUPS
2817	2840	TP_TOKEN_CONNECTION_INTERFACE_CONTACT_INFO_INFO

2876	2899	tp_iface_quark_connection_interface_cellular
2877	2900	tp_iface_quark_connection_interface_client_types
2878	2901	tp_iface_quark_connection_interface_contacts
	2902	tp_iface_quark_connection_interface_contact_blocking
2879	2903	tp_iface_quark_connection_interface_contact_capabilities
2880	2904	tp_iface_quark_connection_interface_contact_groups
2881	2905	tp_iface_quark_connection_interface_contact_info

3625	3649	<FILE>connection-contact-list</FILE>
3626	3650	<TITLE>connection-contact-list</TITLE>
3627	3651	<INCLUDE>telepathy-glib/connection.h</INCLUDE>
	3652	tp_cli_connection_interface_contact_blocking_call_block_contacts
	3653	tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts
	3654	tp_cli_connection_interface_contact_blocking_call_unblock_contacts
	3655	tp_cli_connection_interface_contact_blocking_callback_for_block_contacts
	3656	tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts
	3657	tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts
	3658	tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed
	3659	tp_cli_connection_interface_contact_blocking_run_block_contacts
	3660	tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts
	3661	tp_cli_connection_interface_contact_blocking_run_unblock_contacts
	3662	tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed
3628	3663	tp_cli_connection_interface_contact_groups_call_add_to_group
3629	3664	tp_cli_connection_interface_contact_groups_call_remove_from_group
3630	3665	tp_cli_connection_interface_contact_groups_call_remove_group

+1

-0

docs/reference/telepathy-glib.types less more

118	118	tp_svc_connection_interface_capabilities_get_type
119	119	tp_svc_connection_interface_cellular_get_type
120	120	tp_svc_connection_interface_client_types_get_type
	121	tp_svc_connection_interface_contact_blocking_get_type
121	122	tp_svc_connection_interface_contact_capabilities_get_type
122	123	tp_svc_connection_interface_contact_groups_get_type
123	124	tp_svc_connection_interface_contact_info_get_type

+145

-0

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

17	17
18	18
19	19	<!-- ##### SECTION Image ##### -->
	20
	21
	22	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_call_block_contacts ##### -->
	23	<para>
	24
	25	</para>
	26
	27	@proxy:
	28	@timeout_ms:
	29	@in_Contacts:
	30	@in_Report_Abusive:
	31	@callback:
	32	@user_data:
	33	@destroy:
	34	@weak_object:
	35	@Returns:
	36
	37
	38	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts ##### -->
	39	<para>
	40
	41	</para>
	42
	43	@proxy:
	44	@timeout_ms:
	45	@callback:
	46	@user_data:
	47	@destroy:
	48	@weak_object:
	49	@Returns:
	50
	51
	52	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_call_unblock_contacts ##### -->
	53	<para>
	54
	55	</para>
	56
	57	@proxy:
	58	@timeout_ms:
	59	@in_Contacts:
	60	@callback:
	61	@user_data:
	62	@destroy:
	63	@weak_object:
	64	@Returns:
	65
	66
	67	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_blocking_callback_for_block_contacts ##### -->
	68	<para>
	69
	70	</para>
	71
	72	@proxy:
	73	@error:
	74	@user_data:
	75	@weak_object:
	76
	77
	78	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_blocking_callback_for_request_blocked_contacts ##### -->
	79	<para>
	80
	81	</para>
	82
	83	@proxy:
	84	@out_Contacts:
	85	@error:
	86	@user_data:
	87	@weak_object:
	88
	89
	90	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_blocking_callback_for_unblock_contacts ##### -->
	91	<para>
	92
	93	</para>
	94
	95	@proxy:
	96	@error:
	97	@user_data:
	98	@weak_object:
	99
	100
	101	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed ##### -->
	102	<para>
	103
	104	</para>
	105
	106	@proxy:
	107	@callback:
	108	@user_data:
	109	@destroy:
	110	@weak_object:
	111	@error:
	112	@Returns:
	113
	114
	115	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_run_block_contacts ##### -->
	116	<para>
	117
	118	</para>
	119
	120	@proxy:
	121	@timeout_ms:
	122	@in_Contacts:
	123	@in_Report_Abusive:
	124	@error:
	125	@loop:
	126	@Returns:
	127
	128
	129	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts ##### -->
	130	<para>
	131
	132	</para>
	133
	134	@proxy:
	135	@timeout_ms:
	136	@out_Contacts:
	137	@error:
	138	@loop:
	139	@Returns:
	140
	141
	142	<!-- ##### FUNCTION tp_cli_connection_interface_contact_blocking_run_unblock_contacts ##### -->
	143	<para>
	144
	145	</para>
	146
	147	@proxy:
	148	@timeout_ms:
	149	@in_Contacts:
	150	@error:
	151	@loop:
	152	@Returns:
	153
	154
	155	<!-- ##### USER_FUNCTION tp_cli_connection_interface_contact_blocking_signal_callback_blocked_contacts_changed ##### -->
	156	<para>
	157
	158	</para>
	159
	160	@proxy:
	161	@arg_Blocked_Contacts:
	162	@arg_Unblocked_Contacts:
	163	@user_data:
	164	@weak_object:
20	165
21	166
22	167	<!-- ##### FUNCTION tp_cli_connection_interface_contact_groups_call_add_to_group ##### -->

+7

-0

docs/reference/tmpl/enums.sgml less more

354	354
355	355	@TP_CHANNEL_PASSWORD_FLAG_PROVIDE:
356	356
	357	<!-- ##### ENUM TpContactBlockingCapabilities ##### -->
	358	<para>
	359
	360	</para>
	361
	362	@TP_CONTACT_BLOCKING_CAPABILITY_CAN_REPORT_ABUSIVE:
	363
357	364	<!-- ##### ENUM TpDeliveryReportingSupportFlags ##### -->
358	365	<para>
359	366

+35

-0

docs/reference/tmpl/interfaces.sgml less more

509	509
510	510
511	511
	512	<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACT_BLOCKING ##### -->
	513	<para>
	514
	515	</para>
	516
	517
	518
	519	<!-- ##### MACRO TP_IFACE_QUARK_CONNECTION_INTERFACE_CONTACT_BLOCKING ##### -->
	520	<para>
	521
	522	</para>
	523
	524
	525
512	526	<!-- ##### MACRO TP_IFACE_CONNECTION_INTERFACE_CONTACT_GROUPS ##### -->
513	527	<para>
514	528

2049	2063
2050	2064
2051	2065
	2066	<!-- ##### MACRO TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_REFERENCE_IDENTITIES ##### -->
	2067	<para>
	2068
	2069	</para>
	2070
	2071
	2072
2052	2073	<!-- ##### MACRO TP_PROP_CHANNEL_TYPE_SERVER_TLS_CONNECTION_SERVER_CERTIFICATE ##### -->
2053	2074	<para>
2054	2075

2294	2315
2295	2316
2296	2317
	2318	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_BLOCKING_CONTACT_BLOCKING_CAPABILITIES ##### -->
	2319	<para>
	2320
	2321	</para>
	2322
	2323
	2324
2297	2325	<!-- ##### MACRO TP_PROP_CONNECTION_INTERFACE_CONTACT_GROUPS_DISJOINT_GROUPS ##### -->
2298	2326	<para>
2299	2327

2665	2693
2666	2694
2667	2695
	2696	<!-- ##### MACRO TP_TOKEN_CONNECTION_INTERFACE_CONTACT_BLOCKING_BLOCKED ##### -->
	2697	<para>
	2698
	2699	</para>
	2700
	2701
	2702
2668	2703	<!-- ##### MACRO TP_TOKEN_CONNECTION_INTERFACE_CONTACT_CAPABILITIES_CAPABILITIES ##### -->
2669	2704	<para>
2670	2705

+111

-0

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

1811	1811	@context:
1812	1812
1813	1813
	1814	<!-- ##### STRUCT TpSvcConnectionInterfaceContactBlocking ##### -->
	1815	<para>
	1816
	1817	</para>
	1818
	1819
	1820	<!-- ##### SIGNAL TpSvcConnectionInterfaceContactBlocking::blocked-contacts-changed ##### -->
	1821	<para>
	1822
	1823	</para>
	1824
	1825	@tpsvcconnectioninterfacecontactblocking: the object which received the signal.
	1826
	1827	<!-- ##### STRUCT TpSvcConnectionInterfaceContactBlockingClass ##### -->
	1828	<para>
	1829
	1830	</para>
	1831
	1832
	1833	<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_blocking_block_contacts_impl ##### -->
	1834	<para>
	1835
	1836	</para>
	1837
	1838	@self:
	1839	@in_Contacts:
	1840	@in_Report_Abusive:
	1841	@context:
	1842
	1843
	1844	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed ##### -->
	1845	<para>
	1846
	1847	</para>
	1848
	1849	@instance:
	1850	@arg_Blocked_Contacts:
	1851	@arg_Unblocked_Contacts:
	1852
	1853
	1854	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_implement_block_contacts ##### -->
	1855	<para>
	1856
	1857	</para>
	1858
	1859	@klass:
	1860	@impl:
	1861
	1862
	1863	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts ##### -->
	1864	<para>
	1865
	1866	</para>
	1867
	1868	@klass:
	1869	@impl:
	1870
	1871
	1872	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_implement_unblock_contacts ##### -->
	1873	<para>
	1874
	1875	</para>
	1876
	1877	@klass:
	1878	@impl:
	1879
	1880
	1881	<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_blocking_request_blocked_contacts_impl ##### -->
	1882	<para>
	1883
	1884	</para>
	1885
	1886	@self:
	1887	@context:
	1888
	1889
	1890	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_return_from_block_contacts ##### -->
	1891	<para>
	1892
	1893	</para>
	1894
	1895	@context:
	1896
	1897
	1898	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_return_from_request_blocked_contacts ##### -->
	1899	<para>
	1900
	1901	</para>
	1902
	1903	@context:
	1904	@out_Contacts:
	1905
	1906
	1907	<!-- ##### FUNCTION tp_svc_connection_interface_contact_blocking_return_from_unblock_contacts ##### -->
	1908	<para>
	1909
	1910	</para>
	1911
	1912	@context:
	1913
	1914
	1915	<!-- ##### USER_FUNCTION tp_svc_connection_interface_contact_blocking_unblock_contacts_impl ##### -->
	1916	<para>
	1917
	1918	</para>
	1919
	1920	@self:
	1921	@in_Contacts:
	1922	@context:
	1923
	1924
1814	1925	<!-- ##### STRUCT TpSvcConnectionInterfaceContactGroups ##### -->
1815	1926	<para>
1816	1927

+7

-0

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

	0	<!-- ##### FUNCTION tp_base_contact_list_mixin_blocking_iface_init ##### -->
	1	<para>
	2
	3	</para>
	4
	5	@klass:
	6

+1

-1

examples/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

+3

-0

examples/client/Makefile.am less more

58	58	$(NULL)
59	59
60	60	AM_CFLAGS = $(ERROR_CFLAGS)
	61	AM_LDFLAGS = \
	62	$(ERROR_LDFLAGS) \
	63	$(NULL)

+5

-1

examples/client/Makefile.in less more

45	45	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
46	46	$(top_srcdir)/m4/tp-compiler-flag.m4 \
47	47	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
48		$(top_srcdir)/configure.ac
	48	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
49	49	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
50	50	$(ACLOCAL_M4)
51	51	mkinstalldirs = $(install_sh) -d

435	435	$(NULL)
436	436
437	437	AM_CFLAGS = $(ERROR_CFLAGS)
	438	AM_LDFLAGS = \
	439	$(ERROR_LDFLAGS) \
	440	$(NULL)
	441
438	442	all: all-recursive
439	443
440	444	.SUFFIXES:

+1

-1

examples/client/python/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

+3

-0

examples/client/stream-tubes/Makefile.am less more

17	17	@DBUS_CFLAGS@ \
18	18	@GLIB_CFLAGS@ \
19	19	@TP_GLIB_CFLAGS@
	20	AM_LDFLAGS = \
	21	$(ERROR_LDFLAGS) \
	22	$(NULL)

+5

-1

examples/client/stream-tubes/Makefile.in less more

44	44	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
45	45	$(top_srcdir)/m4/tp-compiler-flag.m4 \
46	46	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
47		$(top_srcdir)/configure.ac
	47	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
48	48	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
49	49	$(ACLOCAL_M4)
50	50	mkinstalldirs = $(install_sh) -d

272	272	@GLIB_CFLAGS@ \
273	273	@TP_GLIB_CFLAGS@
274	274
	275	AM_LDFLAGS = \
	276	$(ERROR_LDFLAGS) \
	277	$(NULL)
	278
275	279	all: all-am
276	280
277	281	.SUFFIXES:

+1

-1

examples/cm/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

+3

-0

examples/cm/callable/Makefile.am less more

65	65	$(NULL)
66	66
67	67	AM_CFLAGS = $(ERROR_CFLAGS)
	68	AM_LDFLAGS = \
	69	$(ERROR_LDFLAGS) \
	70	$(NULL)

+5

-1

examples/cm/callable/Makefile.in less more

50	50	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
51	51	$(top_srcdir)/m4/tp-compiler-flag.m4 \
52	52	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
53		$(top_srcdir)/configure.ac
	53	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
54	54	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
55	55	$(ACLOCAL_M4)
56	56	mkinstalldirs = $(install_sh) -d

341	341	$(NULL)
342	342
343	343	AM_CFLAGS = $(ERROR_CFLAGS)
	344	AM_LDFLAGS = \
	345	$(ERROR_LDFLAGS) \
	346	$(NULL)
	347
344	348	all: all-am
345	349
346	350	.SUFFIXES:

+3

-0

examples/cm/channelspecific/Makefile.am less more

64	64	$(NULL)
65	65
66	66	AM_CFLAGS = $(ERROR_CFLAGS)
	67	AM_LDFLAGS = \
	68	$(ERROR_LDFLAGS) \
	69	$(NULL)

+5

-1

examples/cm/channelspecific/Makefile.in less more

51	51	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
52	52	$(top_srcdir)/m4/tp-compiler-flag.m4 \
53	53	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
54		$(top_srcdir)/configure.ac
	54	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
55	55	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
56	56	$(ACLOCAL_M4)
57	57	mkinstalldirs = $(install_sh) -d

339	339	$(NULL)
340	340
341	341	AM_CFLAGS = $(ERROR_CFLAGS)
	342	AM_LDFLAGS = \
	343	$(ERROR_LDFLAGS) \
	344	$(NULL)
	345
342	346	all: all-am
343	347
344	348	.SUFFIXES:

+1

-1

examples/cm/contactlist/Makefile.in less more

50	50	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
51	51	$(top_srcdir)/m4/tp-compiler-flag.m4 \
52	52	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
53		$(top_srcdir)/configure.ac
	53	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
54	54	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
55	55	$(ACLOCAL_M4)
56	56	mkinstalldirs = $(install_sh) -d

+3

-0

examples/cm/echo-message-parts/Makefile.am less more

60	60	$(NULL)
61	61
62	62	AM_CFLAGS = $(ERROR_CFLAGS)
	63	AM_LDFLAGS = \
	64	$(ERROR_LDFLAGS) \
	65	$(NULL)

+5

-1

examples/cm/echo-message-parts/Makefile.in less more

48	48	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
49	49	$(top_srcdir)/m4/tp-compiler-flag.m4 \
50	50	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
51		$(top_srcdir)/configure.ac
	51	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
52	52	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
53	53	$(ACLOCAL_M4)
54	54	mkinstalldirs = $(install_sh) -d

337	337	$(NULL)
338	338
339	339	AM_CFLAGS = $(ERROR_CFLAGS)
	340	AM_LDFLAGS = \
	341	$(ERROR_LDFLAGS) \
	342	$(NULL)
	343
340	344	all: all-am
341	345
342	346	.SUFFIXES:

+3

-0

examples/cm/extended/Makefile.am less more

49	49	$(NULL)
50	50
51	51	AM_CFLAGS = $(ERROR_CFLAGS)
	52	AM_LDFLAGS = \
	53	$(ERROR_LDFLAGS) \
	54	$(NULL)

+5

-1

examples/cm/extended/Makefile.in less more

47	47	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
48	48	$(top_srcdir)/m4/tp-compiler-flag.m4 \
49	49	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
50		$(top_srcdir)/configure.ac
	50	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
51	51	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
52	52	$(ACLOCAL_M4)
53	53	mkinstalldirs = $(install_sh) -d

320	320	$(NULL)
321	321
322	322	AM_CFLAGS = $(ERROR_CFLAGS)
	323	AM_LDFLAGS = \
	324	$(ERROR_LDFLAGS) \
	325	$(NULL)
	326
323	327	all: all-am
324	328
325	329	.SUFFIXES:

+3

-0

examples/cm/no-protocols/Makefile.am less more

44	44	$(NULL)
45	45
46	46	AM_CFLAGS = $(ERROR_CFLAGS)
	47	AM_LDFLAGS = \
	48	$(ERROR_LDFLAGS) \
	49	$(NULL)

+5

-1

examples/cm/no-protocols/Makefile.in less more

47	47	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
48	48	$(top_srcdir)/m4/tp-compiler-flag.m4 \
49	49	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
50		$(top_srcdir)/configure.ac
	50	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
51	51	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
52	52	$(ACLOCAL_M4)
53	53	mkinstalldirs = $(install_sh) -d

314	314	$(NULL)
315	315
316	316	AM_CFLAGS = $(ERROR_CFLAGS)
	317	AM_LDFLAGS = \
	318	$(ERROR_LDFLAGS) \
	319	$(NULL)
	320
317	321	all: all-am
318	322
319	323	.SUFFIXES:

+3

-0

examples/extensions/Makefile.am less more

13	13	$(DBUS_CFLAGS) \
14	14	$(GLIB_CFLAGS) \
15	15	$(TP_GLIB_CFLAGS)
	16	AM_LDFLAGS = \
	17	$(ERROR_LDFLAGS) \
	18	$(NULL)
16	19
17	20	EXTRA_DIST = \
18	21	all.xml \

+5

-1

examples/extensions/Makefile.in less more

52	52	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
53	53	$(top_srcdir)/m4/tp-compiler-flag.m4 \
54	54	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
55		$(top_srcdir)/configure.ac
	55	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
56	56	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
57	57	$(ACLOCAL_M4)
58	58	mkinstalldirs = $(install_sh) -d

272	272	$(GLIB_CFLAGS) \
273	273	$(TP_GLIB_CFLAGS)
274	274
	275	AM_LDFLAGS = \
	276	$(ERROR_LDFLAGS) \
	277	$(NULL)
	278
275	279	EXTRA_DIST = \
276	280	all.xml \
277	281	connection.xml \

+1

-1

examples/future/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

+3

-0

examples/future/call-cm/Makefile.am less more

66	66	$(GLIB_CFLAGS) \
67	67	$(DBUS_CFLAGS) \
68	68	$(NULL)
	69	AM_LDFLAGS = \
	70	$(ERROR_LDFLAGS) \
	71	$(NULL)
69	72
70	73	AM_CFLAGS = $(ERROR_CFLAGS)
71	74

+5

-1

examples/future/call-cm/Makefile.in less more

50	50	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
51	51	$(top_srcdir)/m4/tp-compiler-flag.m4 \
52	52	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
53		$(top_srcdir)/configure.ac
	53	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
54	54	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
55	55	$(ACLOCAL_M4)
56	56	mkinstalldirs = $(install_sh) -d

343	343	$(DBUS_CFLAGS) \
344	344	$(NULL)
345	345
	346	AM_LDFLAGS = \
	347	$(ERROR_LDFLAGS) \
	348	$(NULL)
	349
346	350	AM_CFLAGS = $(ERROR_CFLAGS)
347	351	all: all-am
348	352

+3

-0

extensions/Makefile.am less more

8	8	$(DBUS_CFLAGS) \
9	9	$(GLIB_CFLAGS) \
10	10	$(TP_GLIB_CFLAGS)
	11	AM_LDFLAGS = \
	12	$(ERROR_LDFLAGS) \
	13	$(NULL)
11	14
12	15	EXTRA_DIST = \
13	16	all.xml \

+5

-1

extensions/Makefile.in less more

47	47	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
48	48	$(top_srcdir)/m4/tp-compiler-flag.m4 \
49	49	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
50		$(top_srcdir)/configure.ac
	50	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
51	51	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
52	52	$(ACLOCAL_M4)
53	53	mkinstalldirs = $(install_sh) -d

269	269	$(GLIB_CFLAGS) \
270	270	$(TP_GLIB_CFLAGS)
271	271
	272	AM_LDFLAGS = \
	273	$(ERROR_LDFLAGS) \
	274	$(NULL)
	275
272	276	EXTRA_DIST = \
273	277	all.xml \
274	278	call-content.xml \

+2

-2

ltmain.sh less more

64	64	# compiler: $LTCC
65	65	# compiler flags: $LTCFLAGS
66	66	# linker: $LD (gnu? $with_gnu_ld)
67		# $progname: (GNU libtool) 2.2.6b Debian-2.2.6b-2ubuntu1
	67	# $progname: (GNU libtool) 2.2.6b Debian-2.2.6b-2
68	68	# automake: $automake_version
69	69	# autoconf: $autoconf_version
70	70	#

72	72
73	73	PROGRAM=ltmain.sh
74	74	PACKAGE=libtool
75		VERSION="2.2.6b Debian-2.2.6b-2ubuntu1"
	75	VERSION="2.2.6b Debian-2.2.6b-2"
76	76	TIMESTAMP=""
77	77	package_revision=1.3017
78	78

+1

-1

m4/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

+7

-0

m4/tp-compiler-flag.m4 less more

33	33	fi
34	34	AC_MSG_RESULT([$flag_ok])
35	35	])
	36
	37	dnl TP_ADD_COMPILER_FLAG(VARIABLE, CFLAGS)
	38	dnl Append CFLAGS to VARIABLE if the compiler supports them.
	39	AC_DEFUN([TP_ADD_COMPILER_FLAG],
	40	[
	41	TP_COMPILER_FLAG([$2], [$1="[$]$1 $2"])
	42	])

+44

-0

m4/tp-linker-flag.m4 less more

	0	dnl A version of AS_COMPILER_FLAG that supports linker flags
	1	dnl Based on:
	2
	3	dnl as-compiler-flag.m4 0.1.0
	4	dnl autostars m4 macro for detection of compiler flags
	5	dnl David Schleef <ds@schleef.org>
	6	dnl $Id: as-compiler-flag.m4,v 1.1 2005/06/18 18:02:46 burgerman Exp $
	7
	8	dnl TP_LINKER_FLAG(LDFLAGS, ACTION-IF-ACCEPTED, [ACTION-IF-NOT-ACCEPTED])
	9	dnl Tries to compile with the given LDFLAGS.
	10	dnl
	11	dnl Runs ACTION-IF-ACCEPTED if the compiler/linker for the currently selected
	12	dnl AC_LANG can compile with the flags, and ACTION-IF-NOT-ACCEPTED otherwise.
	13	dnl
	14	dnl Note that LDFLAGS are passed to the linker via the compiler, so you
	15	dnl should check for -Wl,--no-add-needed rather than --no-add-needed.
	16
	17	AC_DEFUN([TP_LINKER_FLAG],
	18	[
	19	AC_MSG_CHECKING([to see if compiler/linker understand $1])
	20
	21	save_LDFLAGS="$LDFLAGS"
	22	LDFLAGS="$LDFLAGS $1"
	23
	24	AC_COMPILE_IFELSE(AC_LANG_PROGRAM([], []), [flag_ok=yes], [flag_ok=no])
	25
	26	LDFLAGS="$save_LDFLAGS"
	27
	28	if test "X$flag_ok" = Xyes ; then
	29	$2
	30	true
	31	else
	32	$3
	33	true
	34	fi
	35	AC_MSG_RESULT([$flag_ok])
	36	])
	37
	38	dnl TP_ADD_LINKER_FLAG(VARIABLE, LDFLAGS)
	39	dnl Append LDFLAGS to VARIABLE if the linker supports them.
	40	AC_DEFUN([TP_ADD_LINKER_FLAG],
	41	[
	42	TP_LINKER_FLAG([$2], [$1="[$]$1 $2"])
	43	])

+12

-6

spec/Account_Interface_External_Password_Storage.xml less more

26	26
27	27	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
28	28	<p>An interface for Accounts whose passwords are stored externally and
29		SHOULD NOT be stored by either the <tp:dbus-ref
30		namespace="org.freedesktop.Telepathy">AccountManager</tp:dbus-ref> nor
31		any <tp:dbus-ref
32		namespace="org.freedesktop.Telepathy.Channel.Type">ServerAuthentication</tp:dbus-ref>
	29	SHOULD NOT be stored by either the
	30	<tp:dbus-ref namespace="ofdT">AccountManager</tp:dbus-ref> nor any
	31	<tp:dbus-ref namespace="ofdT.Channel.Type">ServerAuthentication</tp:dbus-ref>
33	32	handler.</p>
	33
	34	<p>This interface SHOULD only appear on accounts for which the
	35	related Connection Manager implements
	36	<tp:dbus-ref namespace="ofdT">ConnectionManager.Interface.AccountStorage.DRAFT</tp:dbus-ref>.</p>
34	37	</tp:docstring>
35	38
36	39	<method name="ForgetPassword" tp:name-for-bindings="Forget_Password">
37	40	<tp:docstring>
38		<p>Clears any saved password associated with this account.</p>
	41	Clears any saved password associated with this account.
39	42	</tp:docstring>
40	43	</method>
41	44
42	45	<property name="PasswordSaved"
43	46	tp:name-for-bindings="Password_Saved"
44	47	type="b" access="read">
45		<tp:docstring>
	48	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
46	49	<p>Indicates whether the account has a saved password or not.</p>
	50
	51	<p>Change notification for this property is provided by the
	52	standard D-Bus <code>PropertiesChanged</code> signal.</p>
47	53	</tp:docstring>
48	54	</property>
49	55

+54

-6

spec/Channel_Type_Server_TLS_Connection.xml less more

43	43	</tp:docstring>
44	44
45	45	<property name="ServerCertificate" type="o" access="read"
46		tp:name-for-bindings="Server_Certificate">
	46	tp:name-for-bindings="Server_Certificate"
	47	tp:immutable='yeah'>
47	48	<tp:docstring>
48	49	<p>A <tp:dbus-ref
49	50	namespace="org.freedesktop.Telepathy.Authentication">TLSCertificate</tp:dbus-ref>
50	51	containing the certificate chain as sent by the server,
51	52	and other relevant information.</p>
52		<p>This property is immutable.</p>
53	53	</tp:docstring>
54	54	</property>
55	55
56	56	<property name="Hostname" type="s" access="read"
57		tp:name-for-bindings="Hostname">
	57	tp:name-for-bindings="Hostname"
	58	tp:immutable='sharks'>
58	59	<tp:added version="0.19.12"/>
59	60	<tp:docstring>
60		The hostname of the server we expect <tp:member-ref>ServerCertificate</tp:member-ref>
61		to certify; clients SHOULD verify <tp:member-ref>ServerCertificate</tp:member-ref> against
62		this hostname when checking its validity.
	61	<p>The hostname or domain that the user expects to connect to. Clients
	62	SHOULD use the <tp:member-ref>ReferenceIdentities</tp:member-ref>
	63	property to verify the identity of the certificate. Clients MAY display
	64	this hostname to the user as the expected identity. Clients SHOULD use
	65	this property to lookup pinned certificates or other user preferences
	66	for the connection.</p>
	67	</tp:docstring>
	68	</property>
	69
	70	<property name="ReferenceIdentities" type="as" access="read"
	71	tp:name-for-bindings="Reference_Identities"
	72	tp:immutable='plz'>
	73	<tp:added version="0.21.10">
	74	If this property is not present, clients SHOULD use the
	75	<tp:member-ref>Hostname</tp:member-ref> property as the reference
	76	identity to validate server certificates against.
	77	</tp:added>
	78
	79	<tp:docstring>
	80	<p>The identities of the server we expect
	81	<tp:member-ref>ServerCertificate</tp:member-ref> to certify; clients
	82	SHOULD verify that <tp:member-ref>ServerCertificate</tp:member-ref>
	83	matches one of these identities when checking its validity.</p>
	84
	85	<p>This property MUST NOT be the empty list; it MUST
	86	contain the value of the <tp:member-ref>Hostname</tp:member-ref>
	87	property. All other identities included in this property MUST be derived from
	88	explicit user input or choices, such as <tp:dbus-ref
	89	namespace='ofdT.Account'>Parameters</tp:dbus-ref> passed to
	90	<tp:dbus-ref
	91	namespace='ofdT.ConnectionManager'>RequestConnection</tp:dbus-ref>.</p>
	92
	93	<tp:rationale>
	94	<p>The primary use for this property is for XMPP services hosted by
	95	<a href='http://www.google.com/apps/intl/en/business/gmail.html'>Google
	96	Apps</a>. When connecting to Google Talk using an
	97	<tt>@gmail.com</tt> JID, the server correctly presents a
	98	certificate for <tt>gmail.com</tt>; however, for domains hosted via
	99	Google Apps, a certificate for <tt>talk.google.com</tt> is
	100	offered, due to unresolved technical limitations.</p>
	101
	102	<p>If the user has explicitly chosen to create a <q>Google Talk</q>
	103	account, then trusting a certificate for <tt>talk.google.com</tt>
	104	is reasonable. To handle this case, the connection manager may add
	105	the values of any or all of the <tt>server</tt>,
	106	<tt>fallback-server</tt> and <tt>extra-identities</tt> parameters;
	107	the Google Talk account creation user interface may set these
	108	parameters appropriately, or the user may set them for accounts
	109	with other services.</p>
	110	</tp:rationale>
63	111	</tp:docstring>
64	112	</property>
65	113

+6

-0

spec/Connection.xml less more

1032	1032	<dd>Debugging information on the change, corresponding to the
1033	1033	message part of a D-Bus error message, which SHOULD NOT be
1034	1034	displayed to users under normal circumstances</dd>
	1035
	1036	<dt>server-message (s)</dt>
	1037	<dd>A human-readable message from the server explaining what
	1038	happened. This may be in the user's native language, or in the
	1039	server operator's native language, or even in Lojban.</dd>
	1040
1035	1041	<dt>user-requested (b), expected-hostname (s), certificate-hostname (s)</dt>
1036	1042	<dd>The same details defined in <tp:type>TLS_Certificate_Rejection</tp:type>.</dd>
1037	1043	</dl>

+207

-0

spec/Connection_Interface_Contact_Blocking.xml less more

	0	<?xml version="1.0" ?>
	1	<node name="/Connection_Interface_Contact_Blocking" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
	2	<tp:copyright>Copyright © 2009–2011 Collabora Ltd.</tp:copyright>
	3	<tp:copyright>Copyright © 2009 Nokia Corporation</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,
	18	USA.</p>
	19	</tp:license>
	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactBlocking">
	21	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
	22	<tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.ContactList"/>
	23	<tp:added version='0.21.13'>Changes from the draft:
	24	methods and signals now return <tp:type>Handle_Identifier_Map</tp:type>
	25	(<code>a{us}</code>) rather than bare lists of contact handles
	26	(<code>au</code>)</tp:added>
	27
	28	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	29	<p>An interface for connections where contacts can be blocked from
	30	communicating with this user and receiving this user's presence.
	31	Clients may retrieve a list of currently-blocked contacts using
	32	<tp:member-ref>RequestBlockedContacts</tp:member-ref>, and listen for
	33	<tp:member-ref>BlockedContactsChanged</tp:member-ref> to be notified
	34	when contacts are blocked and unblocked. The
	35	<tp:member-ref>BlockContacts</tp:member-ref> and
	36	<tp:member-ref>UnblockContacts</tp:member-ref> methods do what they say
	37	on the tin; depending on the value of the
	38	<tp:member-ref>ContactBlockingCapabilities</tp:member-ref> property,
	39	contacts may be reported for spam or other abuse when calling
	40	<tp:member-ref>BlockContacts</tp:member-ref>.</p>
	41
	42	<p>This interface is intended for protocols where blocking contacts
	43	persists on the server between connections; connection managers for
	44	protocols with no server-side support for blocking contacts MAY choose
	45	to implement this interface using an on-disk file of blocked
	46	contacts or some other means to store blocked contacts between
	47	connections.</p>
	48
	49	<p>This interface is intended to replace the
	50	<tp:dbus-ref namespace="ofdT.Channel.Type">ContactList</tp:dbus-ref>
	51	channel with <tp:dbus-ref
	52	namespace='ofdT.Channel'>TargetHandleType</tp:dbus-ref>
	53	<code>List</code> and <tp:dbus-ref
	54	namespace='ofdT.Channel'>TargetID</tp:dbus-ref> <code>"deny"</code>
	55	(along with the <tp:dbus-ref
	56	namespace='ofdT.Connection.Interface'>ContactList</tp:dbus-ref> and
	57	<tp:dbus-ref
	58	namespace='ofdT.Connection.Interface'>ContactGroups</tp:dbus-ref>
	59	interfaces replacing other channels with <tp:dbus-ref
	60	namespace='ofdT.Channel'>TargetHandleType</tp:dbus-ref>
	61	<code>List</code> and <tp:dbus-ref
	62	namespace='ofdT.Channel'>TargetHandleType</tp:dbus-ref>
	63	<code>Group</code>, respectively).</p>
	64	</tp:docstring>
	65
	66	<method name="BlockContacts" tp:name-for-bindings="Block_Contacts">
	67	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	68	<p>Direct the server to block some contacts. The precise effect is
	69	protocol-dependent, but SHOULD include ignoring all current and
	70	subsequent communications from the given contacts, avoiding sending
	71	presence to them in future, and if they were already receiving the
	72	local user's presence, behaving as if the local user went
	73	offline.</p>
	74	</tp:docstring>
	75
	76	<arg name="Contacts" type="au" direction="in" tp:type="Contact_Handle[]">
	77	<tp:docstring>Some contacts to block. If some of the contacts in this
	78	list are already blocked, the connection manager MUST act as if they
	79	were not specified in this list.</tp:docstring>
	80	</arg>
	81
	82	<arg name="Report_Abusive" type="b" direction="in">
	83	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	84	<p>In addition to blocking, report these contacts as abusive to the
	85	server administrators.</p>
	86
	87	<p>Clients can determine whether this capability is available by
	88	checking the
	89	<tp:member-ref>ContactBlockingCapabilities</tp:member-ref>
	90	property. If this argument is set to <code>True</code> by a client
	91	despite <tp:member-ref>ContactBlockingCapabilities</tp:member-ref>
	92	not containing the <code>Can_Report_Abusive</code> flag, the
	93	connection manager SHOULD act as if it were <code>False</code> and
	94	simply block the supplied contacts.</p>
	95
	96	<tp:rationale>
	97	<p>A correct user interface shouldn't get this far without knowing
	98	that reporting abusive contacts is not supported. If it does,
	99	then the user has expressed their intention to block these
	100	contacts. Returning an error would leave the UI with three
	101	options:</p>
	102
	103	<ul>
	104	<li>Ignore the error, leaving the contacts not actually blocked;</li>
	105	<li>Display an error to the user;</li>
	106	<li>Call this method again, passing <code>False</code> for this
	107	argument.</li>
	108	</ul>
	109
	110	<p>None of these seem preferable to the CM just ignoring this flag
	111	if it doesn't support it: that way, the contacts will be blocked,
	112	as the user requested, and UIs have fewer ways to mess up
	113	entirely.</p>
	114	</tp:rationale>
	115	</tp:docstring>
	116	</arg>
	117	</method>
	118
	119	<method name="UnblockContacts" tp:name-for-bindings="Unblock_Contacts">
	120	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	121	<p>Direct the server to unblock some contacts.</p>
	122	</tp:docstring>
	123
	124	<arg name="Contacts" type="au" direction="in" tp:type="Contact_Handle[]">
	125	<tp:docstring>Some contacts to unblock. If some of the contacts in this
	126	list are not currently blocked, the connection manager MUST act as if
	127	they were not specified in this list.</tp:docstring>
	128	</arg>
	129	</method>
	130
	131	<method name="RequestBlockedContacts"
	132	tp:name-for-bindings="Request_Blocked_Contacts">
	133	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	134	<p>List the contacts that are blocked.</p>
	135
	136	<p>Clients SHOULD allow a relatively long timeout for calls to this
	137	method, since on some protocols contact blocking is part of the
	138	contact list, which can take a significant time to retrieve.</p>
	139	</tp:docstring>
	140
	141	<arg name="Contacts" type="a{us}" direction="out"
	142	tp:type="Handle_Identifier_Map">
	143	<tp:docstring>The blocked contacts’ handles, together with their
	144	identifiers.</tp:docstring>
	145	</arg>
	146	</method>
	147
	148	<signal name="BlockedContactsChanged"
	149	tp:name-for-bindings="Blocked_Contacts_Changed">
	150	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	151	<p>Emitted when the list of blocked contacts is first retrieved
	152	(before returning from any pending calls to
	153	<tp:member-ref>RequestBlockedContacts</tp:member-ref>), and
	154	whenever the list of blocked contacts subsequently changes.</p>
	155	</tp:docstring>
	156
	157	<arg name="Blocked_Contacts" type="a{us}" tp:type="Handle_Identifier_Map">
	158	<tp:docstring>Contacts added to the result of
	159	<tp:member-ref>RequestBlockedContacts</tp:member-ref>.</tp:docstring>
	160	</arg>
	161
	162	<arg name="Unblocked_Contacts" type="a{us}"
	163	tp:type="Handle_Identifier_Map">
	164	<tp:docstring>Contacts removed from the result of
	165	<tp:member-ref>RequestBlockedContacts</tp:member-ref>.</tp:docstring>
	166	</arg>
	167	</signal>
	168
	169	<tp:contact-attribute name="blocked" type="b">
	170	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	171	<p><code>True</code> if the contact would be in the result of
	172	<tp:member-ref>RequestBlockedContacts</tp:member-ref>;
	173	<code>False</code> or omitted if the contact is not blocked, or if it
	174	is unknown whether the contact is blocked.</p>
	175	</tp:docstring>
	176	</tp:contact-attribute>
	177
	178	<property name="ContactBlockingCapabilities"
	179	tp:name-for-bindings="Contact_Blocking_Capabilities"
	180	tp:type="Contact_Blocking_Capabilities" type="u" access="read"
	181	tp:immutable="yes">
	182	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	183	<p>Additional capabilities for contact blocking; currently, this is
	184	limited to whether contacts may be reported as abusive.</p>
	185
	186	<p>Note that there is no capability for supporting blocking itself:
	187	the presence of this interface on a <tp:dbus-ref
	188	namespace='ofdT'>Connection</tp:dbus-ref> indicates that blocking
	189	contacts is supported.</p>
	190	</tp:docstring>
	191	</property>
	192
	193	<tp:flags name="Contact_Blocking_Capabilities" type="u"
	194	value-prefix="Contact_Blocking_Capability">
	195	<tp:flag suffix="Can_Report_Abusive" value="1">
	196	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	197	When calling <tp:member-ref>BlockContacts</tp:member-ref>, the
	198	contacts may be reporting as abusive to the server administrators by
	199	setting <var>Report_Abusive</var> to <code>True</code>.
	200	</tp:docstring>
	201	</tp:flag>
	202	</tp:flags>
	203
	204	</interface>
	205	</node>
	206	<!-- vim:set sw=2 sts=2 et ft=xml: -->

+16

-13

spec/Connection_Manager_Interface_Account_Storage.xml less more

28	28	<p>An interface for connection managers that store account details
29	29	internally. At the moment this consists only of storing an account's
30	30	credentials, but other functionality may be added in the future.</p>
31		<p><tp:dbus-ref
32		namespace="org.freedesktop.Telepathy">Account</tp:dbus-ref> objects
	31
	32	<p><tp:dbus-ref namespace="ofdT">Account</tp:dbus-ref> objects
33	33	representing accounts on a connection manager that implements this
34		interface should implement the <tp:dbus-ref
35		namespace="org.freedesktop.Telepathy.Account.Interface">ExternalPasswordStorage.DRAFT</tp:dbus-ref>
	34	interface should implement the
	35	<tp:dbus-ref namespace="ofdT.Account.Interface">ExternalPasswordStorage.DRAFT</tp:dbus-ref>
36	36	interface.</p>
37
38	37	</tp:docstring>
39	38
40	39	<tp:flags name="Account_Flags" value-prefix="Account_Flag" type="u">
41	40	<tp:docstring>
42		A set of flags representing the status of the Account stored in the Connection Manager.
	41	A set of flags representing the status of the Account stored in the
	42	Connection Manager.
43	43	</tp:docstring>
44	44
45	45	<tp:flag suffix="Credentials_Stored" value="1">

60	60	<property name="Accounts"
61	61	tp:name-for-bindings="Accounts"
62	62	type="a{su}" tp:type="Account_Flags_Map" access="read">
63		<tp:docstring>
64		The set of Accounts stored in this connection manager, and flags
65		indicating their status.
	63	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	64	<p>The set of Accounts stored in this Connection Manager, and flags
	65	indicating their status.</p>
	66
	67	<p>Change notification for this property is provided by the standard
	68	D-Bus <code>PropertiesChanged</code> signal.</p>
66	69	</tp:docstring>
67	70	</property>
68	71

75	78	<arg direction="in" name="Account_Id"
76	79	type="s">
77	80	<tp:docstring>
78		An account id as returned from <tp:dbus-ref
79		namespace="org.freedesktop.Telepathy">Protocol.IdentifyAccount</tp:dbus-ref>.
	81	An account id as returned from
	82	<tp:dbus-ref namespace="ofdT">Protocol.IdentifyAccount</tp:dbus-ref>.
80	83	</tp:docstring>
81	84	</arg>
82	85

98	101	<arg direction="in" name="Account_Id"
99	102	type="s">
100	103	<tp:docstring>
101		An account id as returned from <tp:dbus-ref
102		namespace="org.freedesktop.Telepathy">Protocol.IdentifyAccount</tp:dbus-ref>.
	104	An account id as returned from
	105	<tp:dbus-ref namespace="ofdT">Protocol.IdentifyAccount</tp:dbus-ref>.
103	106	</tp:docstring>
104	107	</arg>
105	108

+1

-0

spec/Makefile.am less more

74	74	Connection_Interface_Cellular.xml \
75	75	Connection_Interface_Client_Types.xml \
76	76	Connection_Interface_Communication_Policy.xml \
	77	Connection_Interface_Contact_Blocking.xml \
77	78	Connection_Interface_Contact_Capabilities.xml \
78	79	Connection_Interface_Contact_Groups.xml \
79	80	Connection_Interface_Contact_Info.xml \

+2

-1

spec/Makefile.in less more

42	42	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
43	43	$(top_srcdir)/m4/tp-compiler-flag.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
45		$(top_srcdir)/configure.ac
	45	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
46	46	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
47	47	$(ACLOCAL_M4)
48	48	mkinstalldirs = $(install_sh) -d

295	295	Connection_Interface_Cellular.xml \
296	296	Connection_Interface_Client_Types.xml \
297	297	Connection_Interface_Communication_Policy.xml \
	298	Connection_Interface_Contact_Blocking.xml \
298	299	Connection_Interface_Contact_Capabilities.xml \
299	300	Connection_Interface_Contact_Groups.xml \
300	301	Connection_Interface_Contact_Info.xml \

+8

-6

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.21.12</tp:version>
6
7		<tp:copyright>Copyright © 2005-2010 Collabora Limited</tp:copyright>
8		<tp:copyright>Copyright © 2005-2010 Nokia Corporation</tp:copyright>
	5	<tp:version>0.22.0</tp:version>
	6
	7	<tp:copyright>Copyright © 2005-2011 Collabora Limited</tp:copyright>
	8	<tp:copyright>Copyright © 2005-2011 Nokia Corporation</tp:copyright>
9	9	<tp:copyright>Copyright © 2006 INdT</tp:copyright>
10	10
11	11	<tp:license xmlns="http://www.w3.org/1999/xhtml">

55	55	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
56	56	<p>
57	57	On protocols that support contact lists, these interface expose the user's
58		contact lists, along with presence subscription information and contact
59		list groups (if supported).
	58	contact lists, along with presence subscription information, contact
	59	list groups (if supported), and the ability to block and unblock contacts
	60	(if supported).
60	61	</p>
61	62	</tp:docstring>
62	63
63	64	<xi:include href="Connection_Interface_Contact_List.xml"/>
64	65	<xi:include href="Connection_Interface_Contact_Groups.xml"/>
	66	<xi:include href="Connection_Interface_Contact_Blocking.xml"/>
65	67	</tp:section>
66	68
67	69	<tp:section name="Contact metadata interfaces">

+3

-0

telepathy-glib/Makefile.am less more

248	248	@GLIB_CFLAGS@ \
249	249	-I$(top_builddir) \
250	250	-I$(top_srcdir)
	251	AM_LDFLAGS = \
	252	$(ERROR_LDFLAGS) \
	253	$(NULL)
251	254
252	255	ALL_LIBS = \
253	256	@DBUS_LIBS@ \

+7

-3

telepathy-glib/Makefile.in less more

67	67	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
68	68	$(top_srcdir)/m4/tp-compiler-flag.m4 \
69	69	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
70		$(top_srcdir)/configure.ac
	70	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
71	71	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
72	72	$(ACLOCAL_M4)
73	73	mkinstalldirs = $(install_sh) -d

582	582	-I$(top_builddir) \
583	583	-I$(top_srcdir)
584	584
	585	AM_LDFLAGS = \
	586	$(ERROR_LDFLAGS) \
	587	$(NULL)
	588
585	589	ALL_LIBS = \
586	590	@DBUS_LIBS@ \
587	591	@GLIB_LIBS@

652	656	versions/0.13.14.abi \
653	657	versions/0.13.15.abi \
654	658	versions/0.13.16.abi \
	659	versions/0.14.1.abi \
655	660	$(NULL)
656	661
657	662
658	663	# The quoting here is unnecessary but harmless, and has the useful side-effect
659	664	# that vim quickfix mode (:make) doesn't interpret the libtool --mode=link
660	665	# command as an error message in a bizarrely named file
661		libtelepathy_glib_la_LDFLAGS = -version-info \
	666	libtelepathy_glib_la_LDFLAGS = $(AM_LDFLAGS) -version-info \
662	667	"$(LT_CURRENT)":"$(LT_REVISION)":"$(LT_AGE)" $(am__append_3) \
663	668	$(am__append_4)
664	669	libtelepathy_glib_la_LIBADD = libtelepathy-glib-internal.la

833	838	@HAVE_INTROSPECTION_TRUE@ $(srcdir)/stream-tube-connection.c $(srcdir)/stream-tube-connection.h \
834	839	@HAVE_INTROSPECTION_TRUE@ $(srcdir)/text-channel.c $(srcdir)/text-channel.h \
835	840	@HAVE_INTROSPECTION_TRUE@ $(srcdir)/client-message.c $(srcdir)/client-message.h \
836		@HAVE_INTROSPECTION_TRUE@ $(srcdir)/cm-message.c $(srcdir)/cm-message.h \
837	841	@HAVE_INTROSPECTION_TRUE@ $(srcdir)/message.c $(srcdir)/message.h \
838	842	@HAVE_INTROSPECTION_TRUE@ $(srcdir)/signalled-message.c $(srcdir)/signalled-message.h \
839	843	@HAVE_INTROSPECTION_TRUE@ $(srcdir)/errors.c $(srcdir)/errors.h \

+2

-0

telepathy-glib/abi.am less more

65	65	versions/0.13.14.abi \
66	66	versions/0.13.15.abi \
67	67	versions/0.13.16.abi \
	68	versions/0.14.1.abi \
68	69	$(NULL)
69	70
70	71	# The quoting here is unnecessary but harmless, and has the useful side-effect
71	72	# that vim quickfix mode (:make) doesn't interpret the libtool --mode=link
72	73	# command as an error message in a bizarrely named file
73	74	libtelepathy_glib_la_LDFLAGS = \
	75	$(AM_LDFLAGS) \
74	76	-version-info "$(LT_CURRENT)":"$(LT_REVISION)":"$(LT_AGE)"
75	77	libtelepathy_glib_la_LIBADD = libtelepathy-glib-internal.la
76	78	nodist_libtelepathy_glib_la_SOURCES =

+0

-3

telepathy-glib/account.c less more

2214	2214	GAsyncReadyCallback callback,
2215	2215	gpointer user_data)
2216	2216	{
2217		TpAccountPrivate *priv;
2218	2217	GValue value = {0, };
2219	2218	GSimpleAsyncResult *result;
2220	2219
2221	2220	g_return_if_fail (TP_IS_ACCOUNT (account));
2222
2223		priv = account->priv;
2224	2221
2225	2222	result = g_simple_async_result_new (G_OBJECT (account),
2226	2223	callback, user_data, tp_account_set_enabled_finish);

+1

-1

telepathy-glib/base-client.c less more

776	776	const gchar *first_token, ...)
777	777	{
778	778	va_list ap;
779		const gchar *token = first_token;
	779	const gchar *token;
780	780
781	781	g_return_if_fail (TP_IS_BASE_CLIENT (self));
782	782	g_return_if_fail (!self->priv->registered);

+3

-0

telepathy-glib/base-connection.c less more

1639	1639
1640	1640	/**
1641	1641	* TpBaseConnection::shutdown-finished: (skip)
	1642	* @connection: the #TpBaseConnection
1642	1643	*
1643	1644	* Emitted by tp_base_connection_finish_shutdown() when the underlying
1644	1645	* network connection has been closed; #TpBaseConnectionManager listens

1656	1657
1657	1658	/**
1658	1659	* TpBaseConnection::clients-interested:
	1660	* @connection: the #TpBaseConnection
1659	1661	* @token: the interface or part of an interface in which clients are newly
1660	1662	* interested
1661	1663	*

1679	1681
1680	1682	/**
1681	1683	* TpBaseConnection::clients-uninterested:
	1684	* @connection: the #TpBaseConnection
1682	1685	* @token: the interface or part of an interface in which clients are no
1683	1686	* longer interested
1684	1687	*

+0

-12

telepathy-glib/base-contact-list.c less more

4980	4980	TpBaseContactList *self = _tp_base_connection_find_channel_manager (
4981	4981	(TpBaseConnection *) conn, TP_TYPE_BASE_CONTACT_LIST);
4982	4982	ListProp p = GPOINTER_TO_INT (data);
4983		TpBaseContactListClass *cls;
4984	4983
4985	4984	g_return_if_fail (TP_IS_BASE_CONTACT_LIST (self));
4986	4985	g_return_if_fail (self->priv->conn != NULL);
4987
4988		cls = TP_BASE_CONTACT_LIST_GET_CLASS (self);
4989	4986
4990	4987	switch (p)
4991	4988	{

5024	5021	{
5025	5022	TpBaseContactList *self = _tp_base_connection_find_channel_manager (
5026	5023	(TpBaseConnection *) obj, TP_TYPE_BASE_CONTACT_LIST);
5027		TpBaseContactListClass *cls;
5028	5024	guint i;
5029	5025
5030	5026	g_return_if_fail (TP_IS_BASE_CONTACT_LIST (self));

5033	5029	/* just omit the attributes if the contact list hasn't come in yet */
5034	5030	if (self->priv->state != TP_CONTACT_LIST_STATE_SUCCESS)
5035	5031	return;
5036
5037		cls = TP_BASE_CONTACT_LIST_GET_CLASS (self);
5038	5032
5039	5033	for (i = 0; i < contacts->len; i++)
5040	5034	{

5506	5500	TpBaseContactList *self = _tp_base_connection_find_channel_manager (
5507	5501	(TpBaseConnection *) conn, TP_TYPE_BASE_CONTACT_LIST);
5508	5502	GroupProp p = GPOINTER_TO_INT (data);
5509		TpBaseContactListClass *cls;
5510	5503
5511	5504	g_return_if_fail (TP_IS_BASE_CONTACT_LIST (self));
5512	5505	g_return_if_fail (TP_IS_CONTACT_GROUP_LIST (self));
5513	5506	g_return_if_fail (self->priv->conn != NULL);
5514
5515		cls = TP_BASE_CONTACT_LIST_GET_CLASS (self);
5516	5507
5517	5508	switch (p)
5518	5509	{

5547	5538	{
5548	5539	TpBaseContactList *self = _tp_base_connection_find_channel_manager (
5549	5540	(TpBaseConnection *) obj, TP_TYPE_BASE_CONTACT_LIST);
5550		TpBaseContactListClass *cls;
5551	5541	guint i;
5552	5542
5553	5543	g_return_if_fail (TP_IS_BASE_CONTACT_LIST (self));

5557	5547	/* just omit the attributes if the contact list hasn't come in yet */
5558	5548	if (self->priv->state != TP_CONTACT_LIST_STATE_SUCCESS)
5559	5549	return;
5560
5561		cls = TP_BASE_CONTACT_LIST_GET_CLASS (self);
5562	5550
5563	5551	for (i = 0; i < contacts->len; i++)
5564	5552	{

+0

-4

telepathy-glib/cm-message.c less more

144	144	const gchar *key,
145	145	TpMessage *message)
146	146	{
147		TpCMMessage *cm_message;
148
149	147	g_return_if_fail (self != NULL);
150	148	g_return_if_fail (part < self->parts->len);
151	149	g_return_if_fail (key != NULL);

154	152	g_return_if_fail (TP_IS_CM_MESSAGE (self));
155	153	g_return_if_fail (TP_IS_CM_MESSAGE (message));
156	154
157		cm_message = (TpCMMessage *) message;
158
159	155	g_return_if_fail (TP_CM_MESSAGE (self)->priv->connection ==
160	156	TP_CM_MESSAGE (message)->priv->connection);
161	157

+1

-0

telepathy-glib/connection.xml less more

12	12	<xi:include href="../spec/Connection_Interface_Capabilities.xml"/>
13	13	<xi:include href="../spec/Connection_Interface_Cellular.xml"/>
14	14	<xi:include href="../spec/Connection_Interface_Client_Types.xml"/>
	15	<xi:include href="../spec/Connection_Interface_Contact_Blocking.xml"/>
15	16	<xi:include href="../spec/Connection_Interface_Contact_Capabilities.xml"/>
16	17	<xi:include href="../spec/Connection_Interface_Contact_Groups.xml"/>
17	18	<xi:include href="../spec/Connection_Interface_Contact_Info.xml"/>

+1

-2

telepathy-glib/gnio-util.c less more

378	378	gint nscm;
379	379	GSocket *_socket;
380	380	gint n;
381		volatile GType credentials_message_gtype;
382	381	gssize num_bytes_read;
383	382	#ifdef __linux__
384	383	gboolean turn_off_so_passcreds;

454	453	vector.size = 1;
455	454
456	455	/* ensure the type of GUnixCredentialsMessage has been registered with the type system */
457		credentials_message_gtype = G_TYPE_UNIX_CREDENTIALS_MESSAGE;
	456	(void) (G_TYPE_UNIX_CREDENTIALS_MESSAGE);
458	457	num_bytes_read = g_socket_receive_message (_socket,
459	458	NULL, /* GSocketAddress *address /
460	459	&vector,

+0

-1

telepathy-glib/introspection.am less more

50	50	$(srcdir)/stream-tube-connection.c $(srcdir)/stream-tube-connection.h \
51	51	$(srcdir)/text-channel.c $(srcdir)/text-channel.h \
52	52	$(srcdir)/client-message.c $(srcdir)/client-message.h \
53		$(srcdir)/cm-message.c $(srcdir)/cm-message.h \
54	53	$(srcdir)/message.c $(srcdir)/message.h \
55	54	$(srcdir)/signalled-message.c $(srcdir)/signalled-message.h \
56	55	$(srcdir)/errors.c $(srcdir)/errors.h \

+1

-1

telepathy-glib/proxy.c less more

912	912	n_params, params));
913	913	TpProxyClass *klass = TP_PROXY_GET_CLASS (self);
914	914	TpProxyInterfaceAddLink *iter;
915		GType ancestor_type = type;
916	915	GType proxy_parent_type = G_TYPE_FROM_CLASS (tp_proxy_parent_class);
	916	GType ancestor_type;
917	917	GArray *core_features;
918	918
919	919	_tp_register_dbus_glib_marshallers ();

+12

-10

telepathy-glib/text-channel.c less more

373	373	else if (n_failed > 0)
374	374	{
375	375	DEBUG ("Failed to prepare TpContact (InvalidHandle)");
376
	376	}
	377	else if (n_contacts > 0)
	378	{
377	379	sender = contacts[0];
378	380	}
379	381	else
380	382	{
381		DEBUG ("TpContact of the sender hasn't be prepared");
	383	DEBUG ("TpContact of the sender hasn't been prepared");
382	384	}
383	385
384	386	add_message_received (self, parts, sender, TRUE);

403	405	{
404	406	DEBUG ("Failed to prepare TpContact: %s", error->message);
405	407	}
406		else if (n_contacts != 1)
407		{
	408	else if (n_contacts > 0)
	409	{
	410	sender = contacts[0];
	411	}
	412	else
	413	{
	414	DEBUG ("TpContact of the sender hasn't be prepared");
	415
408	416	if (DEBUGGING)
409	417	{
410	418	GHashTableIter iter;

417	425	(const gchar ) key, ((GError ) value)->message);
418	426	}
419	427	}
420
421		sender = contacts[0];
422		}
423		else
424		{
425		DEBUG ("TpContact of the sender hasn't be prepared");
426	428	}
427	429
428	430	add_message_received (self, parts, sender, TRUE);

+6

-16

telepathy-glib/util.c less more

557	557	gboolean
558	558	tp_strdiff (const gchar left, const gchar right)
559	559	{
560		if ((NULL == left) != (NULL == right))
561		return TRUE;
562
563		else if (left == right)
564		return FALSE;
565
566		else
567		return (0 != strcmp (left, right));
	560	return g_strcmp0 (left, right) != 0;
568	561	}
569	562
570	563

1283	1276
1284	1277	/**
1285	1278	* tp_clear_object: (skip)
1286		* @op: (allow-none): a pointer to a variable, struct member etc. holding a
1287		* #GObject
	1279	* @op: a pointer to a variable, struct member etc. holding a #GObject
1288	1280	*
1289	1281	* Set a variable holding a #GObject to %NULL. If it was not already %NULL,
1290	1282	* unref the object it previously pointed to.

1297	1289
1298	1290	/**
1299	1291	* tp_clear_pointer: (skip)
1300		* @pp: (allow-none): a pointer to a variable, struct member etc. holding a
1301		* pointer
	1292	* @pp: a pointer to a variable, struct member etc. holding a pointer
1302	1293	* @destroy: a function to which a gpointer can be passed, to destroy *@pp
1303	1294	* (if calling this macro from C++, explicitly casting the function to
1304	1295	* #GDestroyNotify may be necessary)

1306	1297	* Set a variable holding a pointer to %NULL. If it was not already %NULL,
1307	1298	* unref or destroy the object it previously pointed to with @destroy.
1308	1299	*
1309		* More precisely, if both @pp and @pp are non-%NULL, set @pp to %NULL, then
	1300	* More precisely, if @pp is non-%NULL, set @pp to %NULL, then
1310	1301	* call @destroy on the object that *@pp previously pointed to.
1311	1302	*
1312	1303	* This is analogous to g_clear_error() for non-error objects, but also

1337	1328	/**
1338	1329	* tp_clear_boxed: (skip)
1339	1330	* @gtype: (type GObject.Type): the #GType of *@pp, e.g. %G_TYPE_HASH_TABLE
1340		* @pp: (allow-none): a pointer to a variable, struct member etc. holding a
1341		* boxed object
	1331	* @pp: a pointer to a variable, struct member etc. holding a boxed object
1342	1332	*
1343	1333	* Set a variable holding a boxed object to %NULL. If it was not already %NULL,
1344	1334	* destroy the boxed object it previously pointed to, as appropriate for
1345	1335	* @gtype.
1346	1336	*
1347		* More precisely, if both @pp and @pp are non-%NULL, set @pp to %NULL, then
	1337	* More precisely, if @pp is non-%NULL, set @pp to %NULL, then
1348	1338	* call g_boxed_free() on the object that *@pp previously pointed to.
1349	1339	*
1350	1340	* This is similar to tp_clear_pointer(); see that function's documentation

+14

-18

telepathy-glib/util.h less more

108	108	#define tp_clear_pointer(pp, destroy) \
109	109	G_STMT_START \
110	110	{ \
111		if (pp != NULL) \
112		{ \
113		gpointer _tp_clear_pointer_tmp = *(pp); \
114		\
115		*(pp) = NULL; \
116		\
117		if (_tp_clear_pointer_tmp != NULL) \
118		(destroy) (_tp_clear_pointer_tmp); \
119		} \
	111	gpointer _tp_clear_pointer_tmp; \
	112	\
	113	_tp_clear_pointer_tmp = *(pp); \
	114	*(pp) = NULL; \
	115	\
	116	if (_tp_clear_pointer_tmp != NULL) \
	117	(destroy) (_tp_clear_pointer_tmp); \
120	118	} \
121	119	G_STMT_END
122	120

125	123	#define tp_clear_boxed(gtype, pp) \
126	124	G_STMT_START \
127	125	{ \
128		if (pp != NULL) \
129		{ \
130		gpointer _tp_clear_boxed_tmp = *(pp); \
131		\
132		*(pp) = NULL; \
133		\
134		if (_tp_clear_boxed_tmp != NULL) \
135		g_boxed_free (gtype, _tp_clear_boxed_tmp); \
136		} \
	126	gpointer _tp_clear_boxed_tmp; \
	127	\
	128	_tp_clear_boxed_tmp = *(pp); \
	129	*(pp) = NULL; \
	130	\
	131	if (_tp_clear_boxed_tmp != NULL) \
	132	g_boxed_free (gtype, _tp_clear_boxed_tmp); \
137	133	} \
138	134	G_STMT_END
139	135

+17

-0

telepathy-glib/versions/0.14.1.abi less more

	0	Version: TELEPATHY_GLIB_0.14.2
	1	Extends: TELEPATHY_GLIB_0.13.16
	2	Release: 0.14.2
	3
	4	tp_cli_connection_interface_contact_blocking_connect_to_blocked_contacts_changed
	5	tp_svc_connection_interface_contact_blocking_emit_blocked_contacts_changed
	6	tp_svc_connection_interface_contact_blocking_implement_block_contacts
	7	tp_cli_connection_interface_contact_blocking_call_request_blocked_contacts
	8	tp_cli_connection_interface_contact_blocking_run_block_contacts
	9	tp_iface_quark_connection_interface_contact_blocking
	10	tp_cli_connection_interface_contact_blocking_call_unblock_contacts
	11	tp_svc_connection_interface_contact_blocking_get_type
	12	tp_svc_connection_interface_contact_blocking_implement_request_blocked_contacts
	13	tp_cli_connection_interface_contact_blocking_call_block_contacts
	14	tp_cli_connection_interface_contact_blocking_run_request_blocked_contacts
	15	tp_cli_connection_interface_contact_blocking_run_unblock_contacts
	16	tp_svc_connection_interface_contact_blocking_implement_unblock_contacts

+3

-0

tests/Makefile.am less more

128	128	$(GLIB_CFLAGS) \
129	129	$(DBUS_CFLAGS) \
130	130	$(NULL)
	131	AM_LDFLAGS = \
	132	$(ERROR_LDFLAGS) \
	133	$(NULL)
131	134
132	135	AM_CFLAGS = $(ERROR_CFLAGS)
133	136	AM_CXXFLAGS = $(ERROR_CXXFLAGS)

+5

-1

tests/Makefile.in less more

55	55	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
56	56	$(top_srcdir)/m4/tp-compiler-flag.m4 \
57	57	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
58		$(top_srcdir)/configure.ac
	58	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
59	59	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
60	60	$(ACLOCAL_M4)
61	61	mkinstalldirs = $(install_sh) -d

535	535	$(DBUS_CFLAGS) \
536	536	$(NULL)
537	537
	538	AM_LDFLAGS = \
	539	$(ERROR_LDFLAGS) \
	540	$(NULL)
	541
538	542	AM_CFLAGS = $(ERROR_CFLAGS)
539	543	AM_CXXFLAGS = $(ERROR_CXXFLAGS)
540	544	@HAVE_CXX_TRUE@test_util_cxx_SOURCES = util-cxx.cpp

+3

-0

tests/dbus/Makefile.am less more

217	217	$(GLIB_CFLAGS) \
218	218	$(DBUS_CFLAGS) \
219	219	$(NULL)
	220	AM_LDFLAGS = \
	221	$(ERROR_LDFLAGS) \
	222	$(NULL)
220	223
221	224	AM_CFLAGS = $(ERROR_CFLAGS)
222	225

+5

-1

tests/dbus/Makefile.in less more

80	80	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
81	81	$(top_srcdir)/m4/tp-compiler-flag.m4 \
82	82	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
83		$(top_srcdir)/configure.ac
	83	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
84	84	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
85	85	$(ACLOCAL_M4)
86	86	mkinstalldirs = $(install_sh) -d

872	872	$(DBUS_CFLAGS) \
873	873	$(NULL)
874	874
	875	AM_LDFLAGS = \
	876	$(ERROR_LDFLAGS) \
	877	$(NULL)
	878
875	879	AM_CFLAGS = $(ERROR_CFLAGS)
876	880	TESTS_ENVIRONMENT = \
877	881	abs_top_builddir=@abs_top_builddir@ \

+1

-2

tests/dbus/contacts.c less more

264	264	TpHandleRepoIface *service_repo = tp_base_connection_get_handles (
265	265	(TpBaseConnection *) service_conn, TP_HANDLE_TYPE_CONTACT);
266	266	TpContactFeature features[] = { TP_CONTACT_FEATURE_CONTACT_INFO };
267		TpContact *self_contact;
268	267	TpContact *contact;
269	268	TpHandle handle;
270	269	const gchar *field_value[] = { "Foo", NULL };

307	306	&result, finish, NULL);
308	307	g_main_loop_run (result.loop);
309	308	g_assert_no_error (result.error);
310		self_contact = g_object_ref (g_ptr_array_index (result.contacts, 0));
	309	g_object_ref (g_ptr_array_index (result.contacts, 0));
311	310	reset_result (&result);
312	311
313	312	tp_connection_set_contact_info_async (client_conn, info_list,

+1

-2

tests/dbus/group-mixin.c less more

156	156	{
157	157	GHashTable *props = NULL;
158	158	GArray *members;
159		TpHandle h;
160	159	gboolean valid;
161	160	GError *error = NULL;
162	161	TpChannelGroupFlags flags;

179	178	MYASSERT (members != NULL, ": LocalPendingMembers should be defined"); \
180	179	MYASSERT (members->len == 0, ": LocalPendingMembers should be empty initally");
181	180
182		h = tp_asv_get_uint32 (props, "SelfHandle", &valid);
	181	tp_asv_get_uint32 (props, "SelfHandle", &valid);
183	182	MYASSERT (valid, ": SelfHandle property should be defined");
184	183
185	184	flags = tp_asv_get_uint32 (props, "GroupFlags", &valid);

+1

-0

tests/dbus/text-channel.c less more

61	61	g_assert_no_error (test->error);
62	62
63	63	alf_handle = tp_handle_ensure (test->contact_repo, "alf", NULL, &test->error);
	64	g_assert (alf_handle);
64	65	g_assert_no_error (test->error);
65	66
66	67	test->chan_service = g_object_new (

+3

-0

tests/lib/Makefile.am less more

56	56	$(DBUS_CFLAGS) \
57	57	$(GLIB_CFLAGS) \
58	58	$(TP_GLIB_CFLAGS)
	59	AM_LDFLAGS = \
	60	$(ERROR_LDFLAGS) \
	61	$(NULL)
59	62
60	63	libtp_glib_tests_la_LIBADD = \
61	64	$(DBUS_LIBS) \

+5

-1

tests/lib/Makefile.in less more

44	44	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
45	45	$(top_srcdir)/m4/tp-compiler-flag.m4 \
46	46	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
47		$(top_srcdir)/configure.ac
	47	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
48	48	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
49	49	$(ACLOCAL_M4)
50	50	mkinstalldirs = $(install_sh) -d

316	316	$(GLIB_CFLAGS) \
317	317	$(TP_GLIB_CFLAGS)
318	318
	319	AM_LDFLAGS = \
	320	$(ERROR_LDFLAGS) \
	321	$(NULL)
	322
319	323	libtp_glib_tests_la_LIBADD = \
320	324	$(DBUS_LIBS) \
321	325	$(GLIB_LIBS) \

+1

-1

tests/tools/Makefile.in less more

44	44	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
45	45	$(top_srcdir)/m4/tp-compiler-flag.m4 \
46	46	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
47		$(top_srcdir)/configure.ac
	47	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
48	48	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
49	49	$(ACLOCAL_M4)
50	50	mkinstalldirs = $(install_sh) -d

+1

-1

tools/Makefile.in less more

43	43	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
44	44	$(top_srcdir)/m4/tp-compiler-flag.m4 \
45	45	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
46		$(top_srcdir)/configure.ac
	46	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
47	47	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
48	48	$(ACLOCAL_M4)
49	49	mkinstalldirs = $(install_sh) -d

+2

-0

tools/with-session-bus.sh less more

78	78	e=0
79	79	DBUS_SESSION_BUS_ADDRESS="`cat $me-$$.address`"
80	80	export DBUS_SESSION_BUS_ADDRESS
	81	DBUS_SESSION_BUS_PID="`cat $me-$$.pid`"
	82	export DBUS_SESSION_BUS_PID
81	83
82	84	if [ -n "$WITH_SESSION_BUS_FORK_DBUS_MONITOR" ] ; then
83	85	echo -n "Forking dbus-monitor $WITH_SESSION_BUS_FORK_DBUS_MONITOR_OPT" >&2

+1

-1

vala/Makefile.in less more

44	44	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
45	45	$(top_srcdir)/m4/tp-compiler-flag.m4 \
46	46	$(top_srcdir)/m4/tp-compiler-warnings.m4 \
47		$(top_srcdir)/configure.ac
	47	$(top_srcdir)/m4/tp-linker-flag.m4 $(top_srcdir)/configure.ac
48	48	am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
49	49	$(ACLOCAL_M4)
50	50	mkinstalldirs = $(install_sh) -d