Commit 004bb875e0518ea521c95355a829218ee4a089d2 - telepathy-glib

+108

-3

ChangeLog less more

0		commit 5d34ae4e1627b9c30780a1b40a50b7a4ee581ea0
1		Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2		Date: 2010-07-02 16:31:45 +0100
	0	commit df9104ff6b1e86d5b237682283444746da404dde
	1	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	2	Date: 2010-07-12 19:36:44 +0100
	3
	4	Prepare release 0.11.10
	5
	6	commit 5ef97be1cb1773ab90427f625416fa671cb2b8b0
	7	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	8	Date: 2010-07-12 19:41:43 +0100
	9
	10	tp_contact_request_contact_info_async: don't fail to finish if there's no cancellable
	11
	12	The previous logic didn't allow for data->cancellable potentially being
	13	NULL, in which case cancelled_id would be 0 anyway, leading to not
	14	finishing.
	15
	16	commit be5b5df1cfc61a7b8a0c2533f4ff9b11d275735f
	17	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	18	Date: 2010-07-12 18:51:40 +0100
	19
	20	contact_info_request_cancelled_cb: don't g_assert() with a side-effect
	21
	22	Reviewed-by: Travis Reitter <travis.reitter@collabora.co.uk>
	23
	24	commit 6929c72f8a02a0ff365d589bf04adb41749ec185
	25	Merge: cc2d22d cfc6aa5
	26	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	27	Date: 2010-07-12 10:43:22 -0700
	28
	29	Merge branch 'gi-fixes4'
	30
	31	commit cc2d22d8a23465dbb3a5b7eacea452c76c8722ec
	32	Author: Will Thompson <will.thompson@collabora.co.uk>
	33	Date: 2010-07-12 18:30:01 +0100
	34
	35	Update to spec 0.19.9.
	36
	37	commit cfc6aa5796037efbc159344f59467d691f2c4cc7
	38	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	39	Date: 2010-07-12 09:35:02 -0700
	40
	41	Annotate HashTable element types for tp_asv_get_*
	42
	43	commit 30ec2c8ba262d191d168488cb79a83d3bb691fbc
	44	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	45	Date: 2010-07-09 09:49:52 -0700
	46
	47	Un-blacklist the tp_asv_get_* utility functions for g-i.
	48
	49	commit 3054dace56c8357a1c6bc25a2a55c267d647c2bf
	50	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	51	Date: 2010-07-09 09:37:52 -0700
	52
	53	Annotate the return value of Capabilities.get_channel_classes() as unowned by the caller.
	54
	55	commit db296094c9a9e6590c9d283f33cc25735ead867e
	56	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	57	Date: 2010-07-09 09:37:16 -0700
	58
	59	Bump Vala version requirement.
	60
	61	This fixes callback and async function signatures for the Vala bindings.
	62
	63	commit 45b856e591b61e8c45a3e0ab271c05d1d2703da9
	64	Author: Travis Reitter <travis.reitter@collabora.co.uk>
	65	Date: 2010-07-09 08:59:24 -0700
	66
	67	Annotate that TpCapabilities getter functions don't transfer ownership
	68
	69	commit 003a34cce0822f7ae8376f782f5c829e824b87bb
	70	Author: Jonny Lamb <jonny.lamb@collabora.co.uk>
	71	Date: 2010-07-08 15:19:09 +0100
	72
	73	channel-manager: fix typo in documentation
	74
	75	The signal is called request-already-satisfied, not already-satisfied.
	76
	77	Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
	78
	79	commit c62ac0fe02db9ce1a0ccee8fdb668d28d2cdb49f
	80	Author: Philip Withnall <philip.withnall@collabora.co.uk>
	81	Date: 2010-07-05 17:11:34 +0100
	82
	83	Rework cancellable handling in tp_contact_request_contact_info_async()
	84
	85	The call to
	86	tp_cli_connection_interface_contact_info_call_request_contact_info() returns
	87	synchronously in the error condition, meaning the cancellable connection is
	88	redundant.
	89
	90	Disconnecting the cancellable from within the cancelled callback has been
	91	changed to use g_signal_handler_disconnect() rather than an idle callback to
	92	avoid deadlock.
	93
	94	Also make the async operation complete in an idle callback rather than
	95	synchronously in this case.
	96
	97	Fixes: bfo#28920
	98
	99	commit e7fa7ce4f5320a4ab251389f95f2ca2d39fb40a6
	100	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	101	Date: 2010-07-02 17:45:32 +0100
	102
	103	Nano version
	104
	105	commit aeb9b43e4674b6d88b432f6dac46825eec14a896
	106	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	107	Date: 2010-07-02 17:21:23 +0100
3	108
4	109	Prepare version 0.11.9
5	110

+20

-0

NEWS less more

	0	telepathy-glib 0.11.10 (2010-07-12)
	1	===================================
	2
	3	The “as many fossils as last year” release.
	4
	5	Enhancements:
	6
	7	❱ Updated spec to 0.19.9 (wjt):
	8	❭ added support for Read and Deleted delivery reports
	9
	10	Fixes:
	11
	12	❱ Improved GObject-Introspection annotations to be sufficient for
	13	libfolks (treitter)
	14
	15	❱ Fixed a typo in the documentation (jonny)
	16
	17	❱ fd.o #28920: fixed tp_contact_request_contact_info_async cancellation
	18	handling when dealing with synchronous errors (pwithnall)
	19
0	20	telepathy-glib 0.11.9 (2010-07-02)
1	21	==================================
2	22

+20

-20

configure less more

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

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

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

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

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

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

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

11447	11447
11448	11448
11449	11449	LT_CURRENT=39
11450		LT_REVISION=1
	11450	LT_REVISION=2
11451	11451	LT_AGE=39
11452	11452
11453	11453

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

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

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

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

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

+3

-3

configure.ac less more

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

26	26	# never seen in a release).
27	27
28	28	m4_define([tp_glib_lt_current], [39])
29		m4_define([tp_glib_lt_revision], [1])
	29	m4_define([tp_glib_lt_revision], [2])
30	30	m4_define([tp_glib_lt_age], [39])
31	31
32	32	# Some magic

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

+1

-1

docs/reference/html/TpChannelManager.html less more

273	273	it matches a channel class handled by this manager. If so, they should
274	274	return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to accept responsibility for the request, and ultimately emit
275	275	exactly one of the <a class="link" href="TpChannelManager.html#TpChannelManager-new-channels" title='The "new-channels" signal'><span class="type">"new-channels"</span></a>,
276		<span class="type">"already-satisfied"</span> and
	276	<a class="link" href="TpChannelManager.html#TpChannelManager-request-already-satisfied" title='The "request-already-satisfied" signal'><span class="type">"request-already-satisfied"</span></a> and
277	277	<a class="link" href="TpChannelManager.html#TpChannelManager-request-failed" title='The "request-failed" signal'><span class="type">"request-failed"</span></a> signals (including <em class="parameter"><code>request_token</code></em> in
278	278	the appropriate argument).
279	279	</p>

+6

-0

docs/reference/html/index.sgml less more

689	689	<ANCHOR id="TpDeliveryReportingSupportFlags" href="telepathy-glib/telepathy-glib-enums.html#TpDeliveryReportingSupportFlags">
690	690	<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">
691	691	<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">
	692	<ANCHOR id="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-READ:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-READ:CAPS">
	693	<ANCHOR id="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-DELETED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-DELETED:CAPS">
692	694	<ANCHOR id="TpDeliveryStatus" href="telepathy-glib/telepathy-glib-enums.html#TpDeliveryStatus">
693	695	<ANCHOR id="TP-DELIVERY-STATUS-UNKNOWN:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-UNKNOWN:CAPS">
694	696	<ANCHOR id="TP-DELIVERY-STATUS-DELIVERED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-DELIVERED:CAPS">
695	697	<ANCHOR id="TP-DELIVERY-STATUS-TEMPORARILY-FAILED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-TEMPORARILY-FAILED:CAPS">
696	698	<ANCHOR id="TP-DELIVERY-STATUS-PERMANENTLY-FAILED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-PERMANENTLY-FAILED:CAPS">
697	699	<ANCHOR id="TP-DELIVERY-STATUS-ACCEPTED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-ACCEPTED:CAPS">
	700	<ANCHOR id="TP-DELIVERY-STATUS-READ:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-READ:CAPS">
	701	<ANCHOR id="TP-DELIVERY-STATUS-DELETED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-DELIVERY-STATUS-DELETED:CAPS">
698	702	<ANCHOR id="NUM-TP-DELIVERY-STATUSES:CAPS" href="telepathy-glib/telepathy-glib-enums.html#NUM-TP-DELIVERY-STATUSES:CAPS">
699	703	<ANCHOR id="TpMediaStreamError" href="telepathy-glib/telepathy-glib-enums.html#TpMediaStreamError">
700	704	<ANCHOR id="TP-MEDIA-STREAM-ERROR-UNKNOWN:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-MEDIA-STREAM-ERROR-UNKNOWN:CAPS">

723	727	<ANCHOR id="TP-MESSAGE-PART-SUPPORT-FLAG-MULTIPLE-ATTACHMENTS:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-MESSAGE-PART-SUPPORT-FLAG-MULTIPLE-ATTACHMENTS:CAPS">
724	728	<ANCHOR id="TpMessageSendingFlags" href="telepathy-glib/telepathy-glib-enums.html#TpMessageSendingFlags">
725	729	<ANCHOR id="TP-MESSAGE-SENDING-FLAG-REPORT-DELIVERY:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-MESSAGE-SENDING-FLAG-REPORT-DELIVERY:CAPS">
	730	<ANCHOR id="TP-MESSAGE-SENDING-FLAG-REPORT-READ:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-MESSAGE-SENDING-FLAG-REPORT-READ:CAPS">
	731	<ANCHOR id="TP-MESSAGE-SENDING-FLAG-REPORT-DELETED:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-MESSAGE-SENDING-FLAG-REPORT-DELETED:CAPS">
726	732	<ANCHOR id="NUM-TP-SOCKET-ACCESS-CONTROLS:CAPS" href="telepathy-glib/telepathy-glib-enums.html#NUM-TP-SOCKET-ACCESS-CONTROLS:CAPS">
727	733	<ANCHOR id="TpSocketAccessControl" href="telepathy-glib/telepathy-glib-enums.html#TpSocketAccessControl">
728	734	<ANCHOR id="TP-SOCKET-ACCESS-CONTROL-LOCALHOST:CAPS" href="telepathy-glib/telepathy-glib-enums.html#TP-SOCKET-ACCESS-CONTROL-LOCALHOST:CAPS">

+4

-4

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

639	639	</tr>
640	640	</tbody>
641	641	</table></div>
642		<p class="since">Since 0.11.UNRELEASED</p>
	642	<p class="since">Since 0.11.9</p>
643	643	</div>
644	644	<hr>
645	645	<div class="refsect2" title="tp_account_set_enabled_async ()">

1188	1188	</tr>
1189	1189	</tbody>
1190	1190	</table></div>
1191		<p class="since">Since 0.11.UNRELEASED</p>
	1191	<p class="since">Since 0.11.9</p>
1192	1192	</div>
1193	1193	<hr>
1194	1194	<div class="refsect2" title="tp_account_set_service_finish ()">

1225	1225	</tr>
1226	1226	</tbody>
1227	1227	</table></div>
1228		<p class="since">Since 0.11.UNRELEASED</p>
	1228	<p class="since">Since 0.11.9</p>
1229	1229	</div>
1230	1230	<hr>
1231	1231	<div class="refsect2" title="tp_account_request_presence_async ()">

3131	3131	<a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()"><code class="function">tp_account_set_service_async()</code></a>.
3132	3132	</p>
3133	3133	<p>Default value: NULL</p>
3134		<p class="since">Since 0.11.UNRELEASED</p>
	3134	<p class="since">Since 0.11.9</p>
3135	3135	</div>
3136	3136	<hr>
3137	3137	<div class="refsect2" title='The "valid" property'>

+30

-17

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

234	234	<p>
235	235	</p>
236	236	<div class="example">
237		<a name="id612188"></a><p class="title"><b>Example 1. Using <a class="link" href="telepathy-glib-asv.html#tp-asv-new" title="tp_asv_new ()"><code class="function">tp_asv_new()</code></a></b></p>
	237	<a name="id430872"></a><p class="title"><b>Example 1. Using <a class="link" href="telepathy-glib-asv.html#tp-asv-new" title="tp_asv_new ()"><code class="function">tp_asv_new()</code></a></b></p>
238	238	<div class="example-contents">
239	239	<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
240	240	<tbody>

301	301	<tbody>
302	302	<tr>
303	303	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
304		<td>A GHashTable where the keys are strings and the values are GValues
	304	<td> A GHashTable where the keys are
	305	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
305	306	</td>
306	307	</tr>
307	308	<tr>

384	385	<tbody>
385	386	<tr>
386	387	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
387		<td>A GHashTable where the keys are strings and the values are GValues
	388	<td> A GHashTable where the keys are
	389	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
388	390	</td>
389	391	</tr>
390	392	<tr>

400	402	</tr>
401	403	<tr>
402	404	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
403		<td> the value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	405	<td> the value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
404	406	</td>
405	407	</tr>
406	408	</tbody>

560	562	<tbody>
561	563	<tr>
562	564	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
563		<td>A GHashTable where the keys are strings and the values are GValues
	565	<td> A GHashTable where the keys are
	566	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
564	567	</td>
565	568	</tr>
566	569	<tr>

570	573	</tr>
571	574	<tr>
572	575	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
573		<td> the string value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	576	<td> the string value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
574	577	</td>
575	578	</tr>
576	579	</tbody>

678	681	<tbody>
679	682	<tr>
680	683	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
681		<td>A GHashTable where the keys are strings and the values are GValues
	684	<td> A GHashTable where the keys are
	685	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
682	686	</td>
683	687	</tr>
684	688	<tr>

758	762	<tbody>
759	763	<tr>
760	764	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
761		<td>A GHashTable where the keys are strings and the values are GValues
	765	<td> A GHashTable where the keys are
	766	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
762	767	</td>
763	768	</tr>
764	769	<tr>

838	843	<tbody>
839	844	<tr>
840	845	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
841		<td>A GHashTable where the keys are strings and the values are GValues
	846	<td> A GHashTable where the keys are
	847	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
842	848	</td>
843	849	</tr>
844	850	<tr>

919	925	<tbody>
920	926	<tr>
921	927	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
922		<td>A GHashTable where the keys are strings and the values are GValues
	928	<td> A GHashTable where the keys are
	929	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
923	930	</td>
924	931	</tr>
925	932	<tr>

929	936	</tr>
930	937	<tr>
931	938	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
932		<td> the object-path value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	939	<td> the object-path value of <em class="parameter"><code>key</code></em>, or
	940	<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
933	941	</td>
934	942	</tr>
935	943	</tbody>

1071	1079	<tbody>
1072	1080	<tr>
1073	1081	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
1074		<td>A GHashTable where the keys are strings and the values are GValues
	1082	<td> A GHashTable where the keys are
	1083	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
1075	1084	</td>
1076	1085	</tr>
1077	1086	<tr>

1081	1090	</tr>
1082	1091	<tr>
1083	1092	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1084		<td> the string value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1093	<td> the string value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1085	1094	</td>
1086	1095	</tr>
1087	1096	</tbody>

1223	1232	<tbody>
1224	1233	<tr>
1225	1234	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
1226		<td>A GHashTable where the keys are strings and the values are GValues
	1235	<td> A GHashTable where the keys are
	1236	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
1227	1237	</td>
1228	1238	</tr>
1229	1239	<tr>

1233	1243	</tr>
1234	1244	<tr>
1235	1245	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1236		<td> the <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string-array value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
	1246	<td> the <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string-array
	1247	value of <em class="parameter"><code>key</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1237	1248	</td>
1238	1249	</tr>
1239	1250	</tbody>

1297	1308	<tbody>
1298	1309	<tr>
1299	1310	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
1300		<td>A GHashTable where the keys are strings and the values are GValues
	1311	<td> A GHashTable where the keys are
	1312	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
1301	1313	</td>
1302	1314	</tr>
1303	1315	<tr>

1376	1388	<tbody>
1377	1389	<tr>
1378	1390	<td><p><span class="term"><em class="parameter"><code>asv</code></em> :</span></p></td>
1379		<td>A GHashTable where the keys are strings and the values are GValues
	1391	<td> A GHashTable where the keys are
	1392	strings and the values are GValues. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
1380	1393	</td>
1381	1394	</tr>
1382	1395	<tr>

+2

-2

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

100	100	</tr>
101	101	<tr>
102	102	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
103		<td> the same <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> as the <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--channel-classes" title='The "channel-classes" property'><span class="type">"channel-classes"</span></a> property
104
	103	<td> the same <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> as the
	104	<a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--channel-classes" title='The "channel-classes" property'><span class="type">"channel-classes"</span></a> property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
105	105	</td>
106	106	</tr>
107	107	</tbody>

+3

-3

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

1862	1862	</tr>
1863	1863	<tr>
1864	1864	<td><p><span class="term"><em class="parameter"><code>in_Flags</code></em> :</span></p></td>
1865		<td>Used to pass an 'in' argument: Flags affecting how the message is sent.
	1865	<td>Used to pass an 'in' argument: Flags affecting how the message is sent. The channel MAY ignore some or all flags, depending on <tp:member-ref>DeliveryReportingSupport</tp:member-ref>; the flags that were handled by the CM are provided in <tp:member-ref>MessageSent</tp:member-ref>.
1866	1866	</td>
1867	1867	</tr>
1868	1868	<tr>

1949	1949	</tr>
1950	1950	<tr>
1951	1951	<td><p><span class="term"><em class="parameter"><code>in_Flags</code></em> :</span></p></td>
1952		<td>Used to pass an 'in' argument: Flags affecting how the message is sent.
	1952	<td>Used to pass an 'in' argument: Flags affecting how the message is sent. The channel MAY ignore some or all flags, depending on <tp:member-ref>DeliveryReportingSupport</tp:member-ref>; the flags that were handled by the CM are provided in <tp:member-ref>MessageSent</tp:member-ref>.
1953	1953	</td>
1954	1954	</tr>
1955	1955	<tr>

2002	2002	</tr>
2003	2003	<tr>
2004	2004	<td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
2005		<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> The message content, including any attachments or alternatives
	2005	<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The message content, including any attachments or alternatives. If the incoming message contains formatted text without a plain text alternative, the connection manager MUST generate a <tt>text/plain</tt> alternative from the formatted text, and include it in this message (both here, and in the <tp:member-ref>PendingMessages</tp:member-ref> property).</p>
2006	2006	</td>
2007	2007	</tr>
2008	2008	<tr>

+2

-2

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

1659	1659	</tr>
1660	1660	<tr>
1661	1661	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1662		<td> the same <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a> as the <a class="link" href="telepathy-glib-connection.html#TpConnection--capabilities" title='The "capabilities" property'><span class="type">"capabilities"</span></a>
1663		property
	1662	<td> the same <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a> as the
	1663	<a class="link" href="telepathy-glib-connection.html#TpConnection--capabilities" title='The "capabilities" property'><span class="type">"capabilities"</span></a> property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1664	1664	</td>
1665	1665	</tr>
1666	1666	</tbody>

+1

-2

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

1148	1148	<tr>
1149	1149	<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1150	1150	<td> the same <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a> (or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) as the
1151		<a class="link" href="telepathy-glib-contact.html#TpContact--capabilities" title='The "capabilities" property'><span class="type">"capabilities"</span></a> property
1152
	1151	<a class="link" href="telepathy-glib-contact.html#TpContact--capabilities" title='The "capabilities" property'><span class="type">"capabilities"</span></a> property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1153	1152	</td>
1154	1153	</tr>
1155	1154	</tbody>

+51

-13

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

1273	1273	<pre class="programlisting">typedef enum {
1274	1274	TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_FAILURES = 1,
1275	1275	TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_SUCCESSES = 2,
	1276	TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_READ = 4,
	1277	TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_DELETED = 8,
1276	1278	} TpDeliveryReportingSupportFlags;
1277	1279	</pre>
1278	1280	<p>
1279		Flags indicating the level of support for delivery reporting on this channel. Any future flags added to this set will conform to the convention that the presence of an extra flag implies that more operations will succeed.
	1281	Flags indicating the level of support for delivery reporting on this channel, as found on the DeliveryReportingSupport property. Any future flags added to this set will conform to the convention that the presence of an extra flag implies that more operations will succeed. Note that CMs may always provide more reports than are requested in the Message_Sending_Flags passed to SendMessage. If senders want delivery reports, they should ask for them. If they don't want delivery reports, they can just ignore them, so there's no need to have capability discovery for what will happen if a delivery report isn't requested.
1280	1282	</p>
1281	1283	<p>
1282	1284	Bitfield/set of flags generated from the Telepathy specification.

1286	1288	<tbody>
1287	1289	<tr>
1288	1290	<td><p><a name="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-FAILURES:CAPS"></a><span class="term"><code class="literal">TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_FAILURES</code></span></p></td>
1289		<td> Clients MAY expect to receive negative delivery reports if Message_Sending_Flag_Report_Delivery is specified when sending. If senders want delivery reports, they should ask for them. If they don't want delivery reports, they can just ignore them, so there's no need to have capability discovery for what will happen if a delivery report isn't requested.
	1291	<td> Clients MAY expect to receive negative delivery reports if Message_Sending_Flag_Report_Delivery is specified when sending.
1290	1292	</td>
1291	1293	</tr>
1292	1294	<tr>
1293	1295	<td><p><a name="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-SUCCESSES:CAPS"></a><span class="term"><code class="literal">TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_SUCCESSES</code></span></p></td>
1294		<td> Clients MAY expect to receive positive delivery reports if Message_Sending_Flag_Report_Delivery is specified when sending. Same rationale as Receive_Failures.
	1296	<td> Clients MAY expect to receive positive delivery reports if Message_Sending_Flag_Report_Delivery is specified when sending.
	1297	</td>
	1298	</tr>
	1299	<tr>
	1300	<td><p><a name="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-READ:CAPS"></a><span class="term"><code class="literal">TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_READ</code></span></p></td>
	1301	<td> Clients MAY expect to receive Delivery_Status Read reports if Message_Sending_Flag_Report_Read is specified when sending.
	1302	</td>
	1303	</tr>
	1304	<tr>
	1305	<td><p><a name="TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-DELETED:CAPS"></a><span class="term"><code class="literal">TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_DELETED</code></span></p></td>
	1306	<td> Clients MAY expect to receive Delivery_Status Deleted reports if Message_Sending_Flag_Report_Deleted is specified when sending.
1295	1307	</td>
1296	1308	</tr>
1297	1309	</tbody>

1306	1318	TP_DELIVERY_STATUS_TEMPORARILY_FAILED = 2,
1307	1319	TP_DELIVERY_STATUS_PERMANENTLY_FAILED = 3,
1308	1320	TP_DELIVERY_STATUS_ACCEPTED = 4,
	1321	TP_DELIVERY_STATUS_READ = 5,
	1322	TP_DELIVERY_STATUS_DELETED = 6,
1309	1323	} TpDeliveryStatus;
1310	1324	</pre>
1311	1325	<p>

1342	1356	<td> An intermediate server has accepted the message but the message has not been yet delivered to the ultimate recipient. The connection manager might send a Failed report or Delivered report later. Similar to "202 Accepted" success code in SIP; analogous to 251 and 252 responses in SMTP.
1343	1357	</td>
1344	1358	</tr>
	1359	<tr>
	1360	<td><p><a name="TP-DELIVERY-STATUS-READ:CAPS"></a><span class="term"><code class="literal">TP_DELIVERY_STATUS_READ</code></span></p></td>
	1361	<td> The message has been read by the intended recipient.
	1362	</td>
	1363	</tr>
	1364	<tr>
	1365	<td><p><a name="TP-DELIVERY-STATUS-DELETED:CAPS"></a><span class="term"><code class="literal">TP_DELIVERY_STATUS_DELETED</code></span></p></td>
	1366	<td> The message has been deleted by the intended recipient. This MAY be signalled on its own if the message is deleted without being read, or after Read if the message was read before being deleted.
	1367	</td>
	1368	</tr>
1345	1369	</tbody>
1346	1370	</table></div>
1347	1371	</div>
1348	1372	<hr>
1349	1373	<div class="refsect2" title="NUM_TP_DELIVERY_STATUSES">
1350	1374	<a name="NUM-TP-DELIVERY-STATUSES:CAPS"></a><h3>NUM_TP_DELIVERY_STATUSES</h3>
1351		<pre class="programlisting">#define NUM_TP_DELIVERY_STATUSES (4+1)
	1375	<pre class="programlisting">#define NUM_TP_DELIVERY_STATUSES (6+1)
1352	1376	</pre>
1353	1377	<p>
1354	1378	1 higher than the highest valid value of <a class="link" href="telepathy-glib-enums.html#TpDeliveryStatus" title="enum TpDeliveryStatus"><span class="type">TpDeliveryStatus</span></a>.

1566	1590	<a name="TpMessageSendingFlags"></a><h3>enum TpMessageSendingFlags</h3>
1567	1591	<pre class="programlisting">typedef enum {
1568	1592	TP_MESSAGE_SENDING_FLAG_REPORT_DELIVERY = 1,
	1593	TP_MESSAGE_SENDING_FLAG_REPORT_READ = 2,
	1594	TP_MESSAGE_SENDING_FLAG_REPORT_DELETED = 4,
1569	1595	} TpMessageSendingFlags;
1570	1596	</pre>
1571	1597	<p>
1572		Flags altering the way a message is sent. The "most usual" action should always be to have these flags unset.
1573		</p>
1574		<p>
1575		Bitfield/set of flags generated from the Telepathy specification.
1576		</p>
1577		<div class="variablelist"><table border="0">
1578		<col align="left" valign="top">
1579		<tbody><tr>
	1598	Flags altering the way a message is sent. The "most usual" action should always be to have these flags unset. Some indication of which flags are supported is provided by the DeliveryReportingSupport property.
	1599	</p>
	1600	<p>
	1601	Bitfield/set of flags generated from the Telepathy specification.
	1602	</p>
	1603	<div class="variablelist"><table border="0">
	1604	<col align="left" valign="top">
	1605	<tbody>
	1606	<tr>
1580	1607	<td><p><a name="TP-MESSAGE-SENDING-FLAG-REPORT-DELIVERY:CAPS"></a><span class="term"><code class="literal">TP_MESSAGE_SENDING_FLAG_REPORT_DELIVERY</code></span></p></td>
1581	1608	<td> Provide a successful delivery report if possible, even if this is not the default for this protocol. Ignored if delivery reports are not possible on this protocol. In some protocols, like XMPP, it is not conventional to request or send positive delivery notifications. Delivery failure reports SHOULD always be sent, but if this flag is present, the connection manager MAY also try harder to obtain failed delivery reports or allow them to be matched to outgoing messages.
1582	1609	</td>
1583		</tr></tbody>
	1610	</tr>
	1611	<tr>
	1612	<td><p><a name="TP-MESSAGE-SENDING-FLAG-REPORT-READ:CAPS"></a><span class="term"><code class="literal">TP_MESSAGE_SENDING_FLAG_REPORT_READ</code></span></p></td>
	1613	<td> Provide a delivery report when the message is read by the recipient, even if this is not the default for this protocol. Ignored if read reports are not possible on this protocol.
	1614	</td>
	1615	</tr>
	1616	<tr>
	1617	<td><p><a name="TP-MESSAGE-SENDING-FLAG-REPORT-DELETED:CAPS"></a><span class="term"><code class="literal">TP_MESSAGE_SENDING_FLAG_REPORT_DELETED</code></span></p></td>
	1618	<td> Provide a delivery report when the message is deleted by the recipient, even if this is not the default for this protocol. Ignored if such reports are not possible on this protocol.
	1619	</td>
	1620	</tr>
	1621	</tbody>
1584	1622	</table></div>
1585	1623	</div>
1586	1624	<hr>

+84

-9

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

716	716	<p>
717	717	An amount of money in a specified currency. For example,
718	718	3.21 British pounds would conventionally be represented by
719		(Amount = 321, Scale = 2, Currency = &quot;GBP&quot;), but could be
720		represented by (Amount = 3210, Scale = 3, Currency = &quot;GBP&quot;)
721		in a service that records balance in units of 0.001 pounds.
	719	(
	720	<var>
	721	Amount
	722	</var>
	723	=
	724	<tt>
	725	321
	726	</tt>
	727	,
	728	<var>
	729	Scale
	730	</var>
	731	=
	732	<tt>
	733	2
	734	</tt>
	735	,
	736
	737	<var>
	738	Currency
	739	</var>
	740	=
	741	<tt>
	742	&quot;GBP&quot;
	743	</tt>
	744	), but could be represented by
	745	(
	746	<var>
	747	Amount
	748	</var>
	749	=
	750	<tt>
	751	3210
	752	</tt>
	753	,
	754	<var>
	755	Scale
	756	</var>
	757	=
	758	<tt>
	759	3
	760	</tt>
	761	,
	762
	763	<var>
	764	Currency
	765	</var>
	766	=
	767	<tt>
	768	&quot;GBP&quot;
	769	</tt>
	770	) in a service that records
	771	balance in units of 0.001 pounds.
722	772	</p>
723	773
724	774	</p>
725	775	<p>
726	776
727	777	<p>
728		As a special case, if Amount = 0, Scale = 2**32 - 1 (i.e.
729		the largest possible 32-bit unsigned integer) and Currency = &quot;&quot;,
730		this indicates an unknown amount.
	778	As a special case, if
	779	<var>
	780	Amount
	781	</var>
	782	=
	783	<tt>
	784	0
	785	</tt>
	786	,
	787
	788	<var>
	789	Scale
	790	</var>
	791	=
	792	<tt>
	793	2**32 - 1
	794	</tt>
	795	(i.e. the largest possible
	796	32-bit unsigned integer) and
	797	<var>
	798	Currency
	799	</var>
	800	=
	801	<tt>
	802	&quot;&quot;
	803	</tt>
	804	, this
	805	indicates an unknown amount.
731	806	</p>
732	807
733	808

741	816	<p>
742	817	Member 0 (D-Bus type <code class="literal">i</code>,
743	818	named <code class="literal">Amount</code>):
744		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The amount, expressed as a fixed-point number with decimal scale defined by the Scale property; for instance, an Amount value of 1234 with Scale of 2 represents 12.34 in the currency unit given by the Currency.</p>
	819	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The amount, expressed as a fixed-point number with decimal scale defined by the <var>Scale</var> field; for instance, an <var>Amount</var> value of <tt>1234</tt> with <var>Scale</var> of <tt>2</tt> represents 12.34 in the currency unit given by the <var>Currency</var> field.</p>
745	820	</p>
746	821	<p>
747	822	Member 1 (D-Bus type <code class="literal">u</code>,
748	823	named <code class="literal">Scale</code>):
749		<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The decimal scale for the fixed point value of the Amount property, defining the number of rightmost decimal digits from the integer value which form the fractional part of the resulting currency value.</p> <p>As well as defining the interpretation of Amount, user interfaces may use this value to determine the precision with which to display the amount.</p>
	824	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The decimal scale for the fixed point value of the <var>Amount</var> field, defining the number of rightmost decimal digits from the integer value which form the fractional part of the resulting currency value.</p> <p>As well as defining the interpretation of <var>Amount</var>, user interfaces may use this value to determine the precision with which to display the amount.</p>
750	825	</p>
751	826	<p>
752	827	Member 2 (D-Bus type <code class="literal">s</code>,
753	828	named <code class="literal">Currency</code>):
754		The currency code represented by this amount, which SHOULD be an international currency code such as &quot;EUR&quot;, &quot;USD&quot;, or &quot;JPY&quot; if possible. An empty string can be used to indicate that the currency is not known.
	829	The currency code represented by this amount, which SHOULD be an international currency code such as <tt>&quot;EUR&quot;</tt>, <tt>&quot;USD&quot;</tt>, or <tt>&quot;JPY&quot;</tt> if possible. An empty string can be used to indicate that the currency is not known.
755	830	</p>
756	831	</div>
757	832	<hr>

+3

-3

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

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

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

1575	1575	</tr>
1576	1576	</tbody>
1577	1577	</table></div>
1578		<p class="since">Since 0.11.UNRELEASED</p>
	1578	<p class="since">Since 0.11.9</p>
1579	1579	</div>
1580	1580	</div>
1581	1581	</div>

+10

-4

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

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

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

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

3054	3054	<keyword type="constant" name="TP_CHANNEL_PASSWORD_FLAG_PROVIDE" link="telepathy-glib-enums.html#TP-CHANNEL-PASSWORD-FLAG-PROVIDE:CAPS"/>
3055	3055	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_FAILURES" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-FAILURES:CAPS"/>
3056	3056	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_SUCCESSES" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-SUCCESSES:CAPS"/>
	3057	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_READ" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-READ:CAPS"/>
	3058	<keyword type="constant" name="TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_DELETED" link="telepathy-glib-enums.html#TP-DELIVERY-REPORTING-SUPPORT-FLAG-RECEIVE-DELETED:CAPS"/>
3057	3059	<keyword type="constant" name="TP_DELIVERY_STATUS_UNKNOWN" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-UNKNOWN:CAPS"/>
3058	3060	<keyword type="constant" name="TP_DELIVERY_STATUS_DELIVERED" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-DELIVERED:CAPS"/>
3059	3061	<keyword type="constant" name="TP_DELIVERY_STATUS_TEMPORARILY_FAILED" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-TEMPORARILY-FAILED:CAPS"/>
3060	3062	<keyword type="constant" name="TP_DELIVERY_STATUS_PERMANENTLY_FAILED" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-PERMANENTLY-FAILED:CAPS"/>
3061	3063	<keyword type="constant" name="TP_DELIVERY_STATUS_ACCEPTED" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-ACCEPTED:CAPS"/>
	3064	<keyword type="constant" name="TP_DELIVERY_STATUS_READ" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-READ:CAPS"/>
	3065	<keyword type="constant" name="TP_DELIVERY_STATUS_DELETED" link="telepathy-glib-enums.html#TP-DELIVERY-STATUS-DELETED:CAPS"/>
3062	3066	<keyword type="constant" name="TP_MEDIA_STREAM_ERROR_UNKNOWN" link="telepathy-glib-enums.html#TP-MEDIA-STREAM-ERROR-UNKNOWN:CAPS"/>
3063	3067	<keyword type="constant" name="TP_MEDIA_STREAM_ERROR_EOS" link="telepathy-glib-enums.html#TP-MEDIA-STREAM-ERROR-EOS:CAPS"/>
3064	3068	<keyword type="constant" name="TP_MEDIA_STREAM_ERROR_CODEC_NEGOTIATION_FAILED" link="telepathy-glib-enums.html#TP-MEDIA-STREAM-ERROR-CODEC-NEGOTIATION-FAILED:CAPS"/>

3077	3081	<keyword type="constant" name="TP_MESSAGE_PART_SUPPORT_FLAG_ONE_ATTACHMENT" link="telepathy-glib-enums.html#TP-MESSAGE-PART-SUPPORT-FLAG-ONE-ATTACHMENT:CAPS"/>
3078	3082	<keyword type="constant" name="TP_MESSAGE_PART_SUPPORT_FLAG_MULTIPLE_ATTACHMENTS" link="telepathy-glib-enums.html#TP-MESSAGE-PART-SUPPORT-FLAG-MULTIPLE-ATTACHMENTS:CAPS"/>
3079	3083	<keyword type="constant" name="TP_MESSAGE_SENDING_FLAG_REPORT_DELIVERY" link="telepathy-glib-enums.html#TP-MESSAGE-SENDING-FLAG-REPORT-DELIVERY:CAPS"/>
	3084	<keyword type="constant" name="TP_MESSAGE_SENDING_FLAG_REPORT_READ" link="telepathy-glib-enums.html#TP-MESSAGE-SENDING-FLAG-REPORT-READ:CAPS"/>
	3085	<keyword type="constant" name="TP_MESSAGE_SENDING_FLAG_REPORT_DELETED" link="telepathy-glib-enums.html#TP-MESSAGE-SENDING-FLAG-REPORT-DELETED:CAPS"/>
3080	3086	<keyword type="constant" name="TP_SOCKET_ACCESS_CONTROL_LOCALHOST" link="telepathy-glib-enums.html#TP-SOCKET-ACCESS-CONTROL-LOCALHOST:CAPS"/>
3081	3087	<keyword type="constant" name="TP_SOCKET_ACCESS_CONTROL_PORT" link="telepathy-glib-enums.html#TP-SOCKET-ACCESS-CONTROL-PORT:CAPS"/>
3082	3088	<keyword type="constant" name="TP_SOCKET_ACCESS_CONTROL_NETMASK" link="telepathy-glib-enums.html#TP-SOCKET-ACCESS-CONTROL-NETMASK:CAPS"/>

+6

-0

docs/reference/tmpl/enums.sgml less more

349	349
350	350	@TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_FAILURES:
351	351	@TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_SUCCESSES:
	352	@TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_READ:
	353	@TP_DELIVERY_REPORTING_SUPPORT_FLAG_RECEIVE_DELETED:
352	354
353	355	<!-- ##### ENUM TpDeliveryStatus ##### -->
354	356	<para>

360	362	@TP_DELIVERY_STATUS_TEMPORARILY_FAILED:
361	363	@TP_DELIVERY_STATUS_PERMANENTLY_FAILED:
362	364	@TP_DELIVERY_STATUS_ACCEPTED:
	365	@TP_DELIVERY_STATUS_READ:
	366	@TP_DELIVERY_STATUS_DELETED:
363	367
364	368	<!-- ##### MACRO NUM_TP_DELIVERY_STATUSES ##### -->
365	369	<para>

442	446	</para>
443	447
444	448	@TP_MESSAGE_SENDING_FLAG_REPORT_DELIVERY:
	449	@TP_MESSAGE_SENDING_FLAG_REPORT_READ:
	450	@TP_MESSAGE_SENDING_FLAG_REPORT_DELETED:
445	451
446	452	<!-- ##### MACRO NUM_TP_SOCKET_ACCESS_CONTROLS ##### -->
447	453	<para>

+82

-18

spec/Channel_Interface_Messages.xml less more

625	625	<dt>content-type (s)</dt>
626	626	<dd>
627	627	<p>The MIME type of this part. See the documentation
628		for ReceivedMessage for notes on the special status of
629		"text/plain" parts.</p>
	628	for <tp:member-ref>MessageReceived</tp:member-ref> and
	629	<tp:member-ref>MessageSent</tp:member-ref> for notes on the
	630	special status of "text/plain" parts.</p>
630	631
631	632	<p>Connection managers MUST NOT signal parts without a
632	633	'content-type' key; if a protocol provides no way to determine

941	942	<arg direction="in" name="Flags" type="u"
942	943	tp:type="Message_Sending_Flags">
943	944	<tp:docstring>
944		Flags affecting how the message is sent.
	945	Flags affecting how the message is sent. The channel MAY ignore some
	946	or all flags, depending on
	947	<tp:member-ref>DeliveryReportingSupport</tp:member-ref>; the flags
	948	that were handled by the CM are provided in
	949	<tp:member-ref>MessageSent</tp:member-ref>.
945	950	</tp:docstring>
946	951	</arg>
947	952

970	975	type="u">
971	976	<tp:docstring>
972	977	Flags altering the way a message is sent. The "most usual" action
973		should always be to have these flags unset.
	978	should always be to have these flags unset. Some indication of which
	979	flags are supported is provided by the
	980	<tp:member-ref>DeliveryReportingSupport</tp:member-ref> property.
974	981	</tp:docstring>
975	982
976	983	<tp:flag suffix="Report_Delivery" value="1">

988	995	is present, the connection manager MAY also try harder to obtain
989	996	failed delivery reports or allow them to be matched to outgoing
990	997	messages.</p>
	998	</tp:docstring>
	999	</tp:flag>
	1000
	1001	<tp:flag suffix="Report_Read" value="2">
	1002	<tp:added version="0.19.9"/>
	1003	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	1004	<p>Provide a delivery report when the message is read by the
	1005	recipient, even if this is not the default for this protocol.
	1006	Ignored if read reports are not possible on this protocol.</p>
	1007	</tp:docstring>
	1008	</tp:flag>
	1009
	1010	<tp:flag suffix="Report_Deleted" value="4">
	1011	<tp:added version="0.19.9"/>
	1012	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	1013	<p>Provide a delivery report when the message is deleted by the
	1014	recipient, even if this is not the default for this protocol.
	1015	Ignored if such reports are not possible on this protocol.</p>
991	1016	</tp:docstring>
992	1017	</tp:flag>
993	1018	</tp:flags>

1150	1175
1151	1176	<arg type="aa{sv}" tp:type="Message_Part[]" name="Message">
1152	1177	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
1153		The message content, including any attachments or alternatives
	1178	<p>The message content, including any attachments or alternatives. If
	1179	the incoming message contains formatted text without a plain text
	1180	alternative, the connection manager MUST generate a
	1181	<tt>text/plain</tt> alternative from the formatted text, and
	1182	include it in this message (both here, and in the
	1183	<tp:member-ref>PendingMessages</tp:member-ref> property).</p>
1154	1184	</tp:docstring>
1155	1185	</arg>
1156	1186	</signal>

1223	1253	</tp:rationale>
1224	1254	</tp:docstring>
1225	1255	</tp:enumvalue>
	1256
	1257	<tp:enumvalue suffix="Read" value="5">
	1258	<tp:added version="0.19.9"/>
	1259	<tp:docstring>
	1260	The message has been read by the intended recipient.
	1261	</tp:docstring>
	1262	</tp:enumvalue>
	1263
	1264	<tp:enumvalue suffix="Deleted" value="6">
	1265	<tp:added version="0.19.9"/>
	1266	<tp:docstring>
	1267	The message has been deleted by the intended recipient. This MAY be
	1268	signalled on its own if the message is deleted without being read, or
	1269	after <code>Read</code> if the message was read before being deleted.
	1270	</tp:docstring>
	1271	</tp:enumvalue>
1226	1272	</tp:enum>
1227	1273
1228	1274	<tp:flags name="Delivery_Reporting_Support_Flags"
1229	1275	value-prefix="Delivery_Reporting_Support_Flag" type="u">
1230	1276	<tp:docstring>
1231	1277	Flags indicating the level of support for delivery reporting on this
1232		channel. Any future flags added to this set will conform to the
	1278	channel, as found on the
	1279	<tp:member-ref>DeliveryReportingSupport</tp:member-ref> property. Any
	1280	future flags added to this set will conform to the
1233	1281	convention that the presence of an extra flag implies that
1234		more operations will succeed.
	1282	more operations will succeed. Note that CMs may always provide more
	1283	reports than are requested in the
	1284	<tp:type>Message_Sending_Flags</tp:type> passed to
	1285	<tp:member-ref>SendMessage</tp:member-ref>.
	1286
	1287	<tp:rationale>
	1288	If senders want delivery reports, they should ask for them. If they
	1289	don't want delivery reports, they can just ignore them, so there's no
	1290	need to have capability discovery for what will happen if a delivery
	1291	report isn't requested.
	1292	</tp:rationale>
1235	1293	</tp:docstring>
1236	1294
1237	1295	<tp:flag suffix="Receive_Failures" value="1">
1238	1296	<tp:docstring>
1239	1297	Clients MAY expect to receive negative delivery reports if
1240	1298	Message_Sending_Flag_Report_Delivery is specified when sending.
1241
1242		<tp:rationale>
1243		If senders want delivery reports, they should ask for them.
1244		If they don't want delivery reports, they can just ignore them,
1245		so there's no need to have capability discovery for what will
1246		happen if a delivery report isn't requested.
1247		</tp:rationale>
1248	1299	</tp:docstring>
1249	1300	</tp:flag>
1250	1301

1252	1303	<tp:docstring>
1253	1304	Clients MAY expect to receive positive delivery reports if
1254	1305	Message_Sending_Flag_Report_Delivery is specified when sending.
1255
1256		<tp:rationale>
1257		Same rationale as Receive_Failures.
1258		</tp:rationale>
1259	1306	</tp:docstring>
1260	1307	</tp:flag>
1261	1308
	1309	<tp:flag suffix="Receive_Read" value="4">
	1310	<tp:added version="0.19.9"/>
	1311	<tp:docstring>
	1312	Clients MAY expect to receive <tp:type>Delivery_Status</tp:type>
	1313	<code>Read</code> reports if Message_Sending_Flag_Report_Read
	1314	is specified when sending.
	1315	</tp:docstring>
	1316	</tp:flag>
	1317
	1318	<tp:flag suffix="Receive_Deleted" value="8">
	1319	<tp:added version="0.19.9"/>
	1320	<tp:docstring>
	1321	Clients MAY expect to receive <tp:type>Delivery_Status</tp:type>
	1322	<code>Deleted</code> reports if Message_Sending_Flag_Report_Deleted
	1323	is specified when sending.
	1324	</tp:docstring>
	1325	</tp:flag>
1262	1326	</tp:flags>
1263	1327
1264	1328	<property name="DeliveryReportingSupport" access="read"

+28

-22

spec/Connection_Interface_Balance.xml less more

34	34	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
35	35	<p>An amount of money in a specified currency. For example,
36	36	3.21 British pounds would conventionally be represented by
37		(Amount = 321, Scale = 2, Currency = "GBP"), but could be
38		represented by (Amount = 3210, Scale = 3, Currency = "GBP")
39		in a service that records balance in units of 0.001 pounds.</p>
	37	(<var>Amount</var> = <tt>321</tt>, <var>Scale</var> = <tt>2</tt>,
	38	<var>Currency</var> = <tt>"GBP"</tt>), but could be represented by
	39	(<var>Amount</var> = <tt>3210</tt>, <var>Scale</var> = <tt>3</tt>,
	40	<var>Currency</var> = <tt>"GBP"</tt>) in a service that records
	41	balance in units of 0.001 pounds.</p>
40	42
41		<p>As a special case, if Amount = 0, Scale = 2**32 - 1 (i.e.
42		the largest possible 32-bit unsigned integer) and Currency = "",
43		this indicates an unknown amount.</p>
	43	<p>As a special case, if <var>Amount</var> = <tt>0</tt>,
	44	<var>Scale</var> = <tt>2**32 - 1</tt> (i.e. the largest possible
	45	32-bit unsigned integer) and <var>Currency</var> = <tt>""</tt>, this
	46	indicates an unknown amount.</p>
44	47	</tp:docstring>
45	48
46	49	<tp:member type="i" name="Amount">
47	50	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
48	51	<p>The amount, expressed as a fixed-point number with decimal scale
49		defined by the Scale property; for instance, an Amount value of
50		1234 with Scale of 2 represents 12.34 in the currency unit given
51		by the Currency.</p>
	52	defined by the <var>Scale</var> field; for instance, an
	53	<var>Amount</var> value of <tt>1234</tt> with <var>Scale</var> of
	54	<tt>2</tt> represents 12.34 in the currency unit given by the
	55	<var>Currency</var> field.</p>
52	56	</tp:docstring>
53	57	</tp:member>
54	58	<tp:member type="u" name="Scale">
55	59	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
56		<p>The decimal scale for the fixed point value of the Amount
57		property, defining the number of rightmost decimal digits from
58		the integer value which form the fractional part of the resulting
59		currency value.</p>
	60	<p>The decimal scale for the fixed point value of the
	61	<var>Amount</var> field, defining the number of rightmost decimal
	62	digits from the integer value which form the fractional part of the
	63	resulting currency value.</p>
60	64
61		<p>As well as defining the interpretation of Amount, user interfaces
62		may use this value to determine the precision with which to display
63		the amount.</p>
	65	<p>As well as defining the interpretation of <var>Amount</var>, user
	66	interfaces may use this value to determine the precision with which
	67	to display the amount.</p>
64	68	</tp:docstring>
65	69	</tp:member>
66	70	<tp:member type="s" name="Currency">
67	71	<tp:docstring>
68	72	The currency code represented by this amount, which SHOULD be an
69		international currency code such as "EUR", "USD", or "JPY" if
70		possible. An empty string can be used to indicate that the currency
71		is not known.
	73	international currency code such as <tt>"EUR"</tt>, <tt>"USD"</tt>,
	74	or <tt>"JPY"</tt> if possible. An empty string can be used to
	75	indicate that the currency is not known.
72	76	</tp:docstring>
73	77	</tp:member>
74	78	</tp:struct>

76	80	<property name="AccountBalance" tp:name-for-bindings="Account_Balance"
77	81	access="read" type="(ius)" tp:type="Currency_Amount">
78	82	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
79		<p>The user's balance on the account corresponding to this Connection.
	83	<p>The user's balance on the account corresponding to this <tp:dbus-ref
	84	namespace="org.freedesktop.Telepathy">Connection</tp:dbus-ref>.
80	85	A negative amount may be possible on some services, and indicates
81	86	that the user owes money to the service provider.</p>
82	87
83	88	<p>On initial connection, this property may have an unknown
84		value, represented by Amount = 0, Scale = 2**32 - 1 (the largest
85		possible 32-bit unsigned integer) and Currency = "".</p>
	89	value, represented by <var>Amount</var> = <tt>0</tt>,
	90	<var>Scale</var> = <tt>2**32 - 1</tt> (the largest possible 32-bit
	91	unsigned integer) and <var>Currency</var> = <tt>""</tt>.</p>
86	92	</tp:docstring>
87	93	</property>
88	94

+1

-1

spec/all.xml less more

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

+2

-1

telepathy-glib/capabilities.c less more

77	77	*
78	78	* <!-- -->
79	79	*
80		* Returns: the same #GPtrArray as the #TpCapabilities:channel-classes property
	80	* Returns: (transfer none): the same #GPtrArray as the
	81	* #TpCapabilities:channel-classes property
81	82	*
82	83	* Since: 0.11.3
83	84	*/

+1

-1

telepathy-glib/channel-manager.c less more

103	103	* it matches a channel class handled by this manager. If so, they should
104	104	* return %TRUE to accept responsibility for the request, and ultimately emit
105	105	* exactly one of the #TpChannelManager::new-channels,
106		* #TpChannelManager::already-satisfied and
	106	* #TpChannelManager::request-already-satisfied and
107	107	* #TpChannelManager::request-failed signals (including @request_token in
108	108	* the appropriate argument).
109	109	*

+2

-2

telepathy-glib/connection.c less more

2044	2044	*
2045	2045	* <!-- -->
2046	2046	*
2047		* Returns: the same #TpCapabilities as the #TpConnection:capabilities
2048		* property
	2047	* Returns: (transfer none): the same #TpCapabilities as the
	2048	* #TpConnection:capabilities property
2049	2049	* Since: 0.11.3
2050	2050	*/
2051	2051	TpCapabilities *

+54

-55

telepathy-glib/contact.c less more

470	470	*
471	471	* <!-- -->
472	472	*
473		* Returns: the same #TpCapabilities (or %NULL) as the
	473	* Returns: (transfer none): the same #TpCapabilities (or %NULL) as the
474	474	* #TpContact:capabilities property
475	475	*
476	476	* Since: 0.11.3

2500	2500	TpProxyPendingCall *call;
2501	2501	GCancellable *cancellable;
2502	2502	gulong cancelled_id;
2503		guint cancel_idle_id;
2504	2503	} ContactInfoRequestData;
2505	2504
2506	2505	static void
2507		contact_info_request_data_disconnect_cancellable (ContactInfoRequestData *data)
2508		{
2509		if (data->cancelled_id != 0)
2510		g_cancellable_disconnect (data->cancellable, data->cancelled_id);
2511		data->cancelled_id = 0;
2512
2513		if (data->cancel_idle_id != 0)
2514		g_source_remove (data->cancel_idle_id);
2515		data->cancel_idle_id = 0;
2516		}
2517
2518		static void
2519	2506	contact_info_request_data_free (ContactInfoRequestData *data)
2520	2507	{
2521	2508	if (data != NULL)
2522	2509	{
2523	2510	g_object_unref (data->result);
2524	2511
2525		contact_info_request_data_disconnect_cancellable (data);
2526	2512	if (data->cancellable != NULL)
2527	2513	g_object_unref (data->cancellable);
2528	2514

2540	2526	ContactInfoRequestData *data = user_data;
2541	2527	TpContact *self = data->contact;
2542	2528
2543		/* At this point it's too late to cancel the operation */
2544		contact_info_request_data_disconnect_cancellable (data);
	2529	if (data->cancellable != NULL)
	2530	{
	2531	/* At this point it's too late to cancel the operation. This will block
	2532	* until the signal handler has finished if it's already running, so
	2533	* we're guaranteed to never be in a partially-cancelled state after
	2534	* this call. */
	2535	g_cancellable_disconnect (data->cancellable, data->cancelled_id);
	2536
	2537	/* If this is true, the cancelled callback has already run and completed the
	2538	* async result, so just bail. */
	2539	if (data->cancelled_id == 0)
	2540	return;
	2541
	2542	data->cancelled_id = 0;
	2543	}
2545	2544
2546	2545	if (error != NULL)
2547	2546	{

2553	2552	contact_maybe_set_info (self, contact_info);
2554	2553	}
2555	2554
2556		g_simple_async_result_complete (data->result);
	2555	g_simple_async_result_complete_in_idle (data->result);
2557	2556	data->call = NULL;
2558		}
2559
2560		static gboolean
2561		contact_info_request_cancelled_idle_cb (gpointer user_data)
2562		{
2563		ContactInfoRequestData *data = user_data;
2564		GError *error = NULL;
2565
2566		data->cancel_idle_id = 0;
2567
2568		if (!g_cancellable_set_error_if_cancelled (data->cancellable, &error))
2569		return FALSE;
2570
2571		DEBUG ("Request ContactInfo cancelled");
2572
2573		g_simple_async_result_set_from_error (data->result, error);
2574		g_simple_async_result_complete (data->result);
2575		g_clear_error (&error);
2576
2577		g_assert (data->call != NULL);
2578		tp_proxy_pending_call_cancel (data->call);
2579
2580		return FALSE;
2581	2557	}
2582	2558
2583	2559	static void
2584	2560	contact_info_request_cancelled_cb (GCancellable *cancellable,
2585	2561	ContactInfoRequestData *data)
2586	2562	{
2587		/* Cancellable is locked here, and g_cancellable_disconnect() also try to get
2588		* the lock. That could then make deadlock. To be safe we cancel the DBus call
2589		* in an idle callback. Use G_PRIORITY_HIGH to be sure our callback comes
2590		* before the DBus reply otherwise it could be racy. */
2591		data->cancel_idle_id = g_idle_add_full (G_PRIORITY_HIGH,
2592		contact_info_request_cancelled_idle_cb, data, NULL);
	2563	GError *error = NULL;
	2564	gboolean was_cancelled;
	2565
	2566	/* We disconnect from the signal manually; since we're in the cancelled
	2567	* callback, we hold the cancellable's lock so calling this instead of
	2568	* g_cancellable_disconnect() is fine. We do this here so that
	2569	* g_cancellable_disconnect() isn't called by contact_info_request_data_free()
	2570	* which is called by tp_proxy_pending_call_cancel().
	2571	* cancelled_id might already be 0 if the cancellable was cancelled before
	2572	* we connected to it. */
	2573	if (data->cancelled_id != 0)
	2574	g_signal_handler_disconnect (data->cancellable, data->cancelled_id);
	2575	data->cancelled_id = 0;
	2576
	2577	was_cancelled = g_cancellable_set_error_if_cancelled (data->cancellable,
	2578	&error);
	2579	g_assert (was_cancelled);
	2580
	2581	DEBUG ("Request ContactInfo cancelled");
	2582
	2583	g_simple_async_result_set_from_error (data->result, error);
	2584	g_simple_async_result_complete_in_idle (data->result);
	2585	g_clear_error (&error);
	2586
	2587	if (data->call != NULL)
	2588	tp_proxy_pending_call_cancel (data->call);
2593	2589	}
2594	2590
2595	2591	/**

2636	2632	data->result = g_simple_async_result_new (G_OBJECT (self), callback,
2637	2633	user_data, tp_contact_request_contact_info_finish);
2638	2634
	2635	if (cancellable != NULL)
	2636	{
	2637	data->cancellable = g_object_ref (cancellable);
	2638	data->cancelled_id = g_cancellable_connect (data->cancellable,
	2639	G_CALLBACK (contact_info_request_cancelled_cb), data, NULL);
	2640
	2641	/* Return early if the cancellable has already been cancelled */
	2642	if (data->cancelled_id == 0)
	2643	return;
	2644	}
	2645
2639	2646	data->call = tp_cli_connection_interface_contact_info_call_request_contact_info (
2640	2647	self->priv->connection, 60601000, self->priv->handle,
2641	2648	contact_info_request_cb,
2642	2649	data, (GDestroyNotify) contact_info_request_data_free,
2643	2650	NULL);
2644
2645		if (cancellable != NULL)
2646		{
2647		data->cancellable = g_object_ref (cancellable);
2648		data->cancelled_id = g_cancellable_connect (data->cancellable,
2649		G_CALLBACK (contact_info_request_cancelled_cb), data, NULL);
2650		}
2651
2652	2651	}
2653	2652
2654	2653	/**

+40

-27

telepathy-glib/dbus.c less more

785	785	}
786	786
787	787	/**
788		* tp_asv_get_boolean: (skip)
789		* @asv: A GHashTable where the keys are strings and the values are GValues
	788	* tp_asv_get_boolean:
	789	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	790	* strings and the values are GValues
790	791	* @key: The key to look up
791	792	* @valid: Either %NULL, or a location to store %TRUE if the key actually
792	793	* exists and has a boolean value

850	851	}
851	852
852	853	/**
853		* tp_asv_get_bytes: (skip)
854		* @asv: A GHashTable where the keys are strings and the values are GValues
	854	* tp_asv_get_bytes:
	855	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	856	* strings and the values are GValues
855	857	* @key: The key to look up
856	858	*
857	859	* If a value for @key in @asv is present and is an array of bytes

864	866	* g_boxed_copy (DBUS_TYPE_G_UCHAR_ARRAY, ...) if you need to keep
865	867	* it for longer.
866	868	*
867		* Returns: the string value of @key, or %NULL
	869	* Returns: (transfer none) (allow-none): the string value of @key, or %NULL
868	870	* Since: 0.7.9
869	871	*/
870	872	const GArray *

941	943	}
942	944
943	945	/**
944		* tp_asv_get_string: (skip)
945		* @asv: A GHashTable where the keys are strings and the values are GValues
	946	* tp_asv_get_string:
	947	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	948	* strings and the values are GValues
946	949	* @key: The key to look up
947	950	*
948	951	* If a value for @key in @asv is present and is a string, return it.

953	956	* for @key in @asv is not removed or altered. Copy it with g_strdup() if you
954	957	* need to keep it for longer.
955	958	*
956		* Returns: the string value of @key, or %NULL
	959	* Returns: (transfer none) (allow-none): the string value of @key, or %NULL
957	960	* Since: 0.7.9
958	961	*/
959	962	const gchar *

1050	1053	}
1051	1054
1052	1055	/**
1053		* tp_asv_get_int32: (skip)
1054		* @asv: A GHashTable where the keys are strings and the values are GValues
	1056	* tp_asv_get_int32:
	1057	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1058	* strings and the values are GValues
1055	1059	* @key: The key to look up
1056	1060	* @valid: Either %NULL, or a location in which to store %TRUE on success or
1057	1061	* %FALSE on failure

1162	1166	}
1163	1167
1164	1168	/**
1165		* tp_asv_get_uint32: (skip)
1166		* @asv: A GHashTable where the keys are strings and the values are GValues
	1169	* tp_asv_get_uint32:
	1170	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1171	* strings and the values are GValues
1167	1172	* @key: The key to look up
1168	1173	* @valid: Either %NULL, or a location in which to store %TRUE on success or
1169	1174	* %FALSE on failure

1274	1279	}
1275	1280
1276	1281	/**
1277		* tp_asv_get_int64: (skip)
1278		* @asv: A GHashTable where the keys are strings and the values are GValues
	1282	* tp_asv_get_int64:
	1283	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1284	* strings and the values are GValues
1279	1285	* @key: The key to look up
1280	1286	* @valid: Either %NULL, or a location in which to store %TRUE on success or
1281	1287	* %FALSE on failure

1375	1381	}
1376	1382
1377	1383	/**
1378		* tp_asv_get_uint64: (skip)
1379		* @asv: A GHashTable where the keys are strings and the values are GValues
	1384	* tp_asv_get_uint64:
	1385	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1386	* strings and the values are GValues
1380	1387	* @key: The key to look up
1381	1388	* @valid: Either %NULL, or a location in which to store %TRUE on success or
1382	1389	* %FALSE on failure

1480	1487	}
1481	1488
1482	1489	/**
1483		* tp_asv_get_double: (skip)
1484		* @asv: A GHashTable where the keys are strings and the values are GValues
	1490	* tp_asv_get_double:
	1491	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1492	* strings and the values are GValues
1485	1493	* @key: The key to look up
1486	1494	* @valid: Either %NULL, or a location in which to store %TRUE on success or
1487	1495	* %FALSE on failure

1578	1586	}
1579	1587
1580	1588	/**
1581		* tp_asv_get_object_path: (skip)
1582		* @asv: A GHashTable where the keys are strings and the values are GValues
	1589	* tp_asv_get_object_path:
	1590	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1591	* strings and the values are GValues
1583	1592	* @key: The key to look up
1584	1593	*
1585	1594	* If a value for @key in @asv is present and is an object path, return it.

1590	1599	* for @key in @asv is not removed or altered. Copy it with g_strdup() if you
1591	1600	* need to keep it for longer.
1592	1601	*
1593		* Returns: the object-path value of @key, or %NULL
	1602	* Returns: (transfer none) (allow-none): the object-path value of @key, or
	1603	* %NULL
1594	1604	* Since: 0.7.9
1595	1605	*/
1596	1606	const gchar *

1689	1699	}
1690	1700
1691	1701	/**
1692		* tp_asv_get_boxed: (skip)
1693		* @asv: A GHashTable where the keys are strings and the values are GValues
	1702	* tp_asv_get_boxed:
	1703	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1704	* strings and the values are GValues
1694	1705	* @key: The key to look up
1695	1706	* @type: The type that the key's value should have, which must be derived
1696	1707	* from %G_TYPE_BOXED

1704	1715	* for @key in @asv is not removed or altered. Copy it, for instance with
1705	1716	* g_boxed_copy(), if you need to keep it for longer.
1706	1717	*
1707		* Returns: the value of @key, or %NULL
	1718	* Returns: (transfer none) (allow-none): the value of @key, or %NULL
1708	1719	* Since: 0.7.9
1709	1720	*/
1710	1721	gpointer

1812	1823	}
1813	1824
1814	1825	/**
1815		* tp_asv_get_strv: (skip)
1816		* @asv: A GHashTable where the keys are strings and the values are GValues
	1826	* tp_asv_get_strv:
	1827	* @asv: (element-type utf8 GObject.Value): A GHashTable where the keys are
	1828	* strings and the values are GValues
1817	1829	* @key: The key to look up
1818	1830	*
1819	1831	* If a value for @key in @asv is present and is an array of strings (strv),

1825	1837	* for @key in @asv is not removed or altered. Copy it with g_strdupv() if you
1826	1838	* need to keep it for longer.
1827	1839	*
1828		* Returns: the %NULL-terminated string-array value of @key, or %NULL
	1840	* Returns: (transfer none) (allow-none): the %NULL-terminated string-array
	1841	* value of @key, or %NULL
1829	1842	* Since: 0.7.9
1830	1843	*/
1831	1844	const gchar * const *