Codebase list telepathy-glib / a610289
Imported Upstream version 0.11.13 Simon McVittie 13 years ago
81 changed file(s) with 1597 addition(s) and 672 deletion(s). Raw diff Collapse all Expand all
0 commit 08937be31c96c9b8a29d2e63d7fa48514ccac378
1 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2 Date: 2010-08-17 12:17:02 +0100
3
4 Prepare version 0.11.13
5
6 commit e7df0c7ad266dbd993a3814470a334cee023ab26
7 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
8 Date: 2010-08-17 11:51:53 +0100
9
10 Makefile.am, configure.ac: refuse to make dist if automake is too old
11
12 This avoids accidentally making tarballs that can't have vala bindings.
13
14 commit 80c0a6edfd19b58666136e159b83c6ffc9152aae
15 Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
16 Date: 2010-08-17 11:35:52 +0200
17
18 remove telepathy-vala.pc (fdo #29070)
19
20 commit aaaf3a3d7461197fbb7abf0567fff196bd5c5576
21 Merge: c1d6a79 ae539a3
22 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
23 Date: 2010-08-13 16:25:17 +0100
24
25 Merge branch 'vala-pc-fixes'
26
27 Reviewed-by: Travis Reitter <travis.reitter@collabora.co.uk>
28
29 commit ae539a3ee029a3b57903e24442022c079b358b55
30 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
31 Date: 2010-08-13 15:44:23 +0100
32
33 Fix out-of-tree builds of the Vala bindings
34
35 The .gir file is produced in the builddir, not the srcdir, if these differ.
36
37 commit 5b8e77822b3396cffa1ef934c684a5866e6b2774
38 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
39 Date: 2010-08-13 15:32:30 +0100
40
41 Mostly revert increased vala dependency, which we don't actually need now
42
43 commit 82b210dae1e8ac3704fc115e5e4ebae30eef3449
44 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
45 Date: 2010-08-13 15:27:07 +0100
46
47 Don't output vapigen path repeatedly
48
49 commit 3dd8c1007d530b1adc43686a794cd5ed8588f196
50 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
51 Date: 2010-08-13 15:26:53 +0100
52
53 Check VAPIGEN against "false" now
54
55 commit 4fb199d3de6c48b286be2cea8a4d72a87fb41a43
56 Author: Travis Reitter <travis.reitter@collabora.co.uk>
57 Date: 2010-08-12 09:11:20 -0700
58
59 Don't depend upon vala-1.0.pc for vapigen detection.
60
61 commit 84b8c4ce3fcc8a37f02abde914ee0bbd32462cfe
62 Author: Travis Reitter <travis.reitter@collabora.co.uk>
63 Date: 2010-08-12 09:09:06 -0700
64
65 Don't rely upon the vala-1.0.pc file for checking Vala version.
66
67 This .pc file is meant for internal (libvala) use only.
68
69 commit c1d6a792e503635570f796a4bf51cc9d232c7014
70 Merge: aec41c5 71a3237
71 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
72 Date: 2010-08-12 14:59:00 +0100
73
74 Merge branch 'user-action-times'
75
76 Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
77
78 commit aec41c5bb1b9c54543c045ed5cee27046a65d84c
79 Author: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
80 Date: 2010-08-12 14:48:23 +0200
81
82 rename channel_prepare_cb to make debug clearer
83
84 commit 71a3237abfd52ae2454f3a3bdadf11d29b28a4dc
85 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
86 Date: 2010-08-12 14:13:51 +0100
87
88 TpBaseClient: convert virtual methods into normal GObject virtual methods
89
90 This means they use up class-struct space, but can be used by bindings.
91
92 commit 19052d0fdc1aeb99175c9a2facdbb1fcba611b0c
93 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
94 Date: 2010-08-12 13:52:58 +0100
95
96 TpAccountChannelRequest: explain what "ensure" means
97
98 commit 584bd4c93d44c62f7a7b4d03124db320818eb923
99 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
100 Date: 2010-08-12 13:52:47 +0100
101
102 TpAccountChannelRequest: mention how the _and_handle variants work
103
104 commit 2bf98cc55abfc19ae2df793daf30fa459a227d44
105 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
106 Date: 2010-08-12 13:52:21 +0100
107
108 TpAccountChannelRequest::re-handled: say why this signal exists
109
110 commit b417df887b3b9262caf799d82dff58afd142b24f
111 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
112 Date: 2010-08-12 13:38:50 +0100
113
114 Reference TpAccountChannelRequest:user-action-time whenever user_action_time is seen
115
116 commit 5309abc6ec8c2d543602893ecf8852f007fcfdeb
117 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
118 Date: 2010-08-12 13:30:37 +0100
119
120 tp_account_channel_request_new: cross-reference detailed docs for user action time
121
122 commit 0e7854c637287a3a2418540682e7c5f3e3ad80a6
123 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
124 Date: 2010-08-12 13:36:25 +0100
125
126 Centralize user action time docs in TpAccountChannelRequest:user-action-time
127
128 commit b5a3c1de22416194ad21e10ab94fac2041e36679
129 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
130 Date: 2010-08-12 13:29:48 +0100
131
132 TpAccountChannelRequest:user-action-time: explain how to get from X11
133
134 commit 8f5da5f6eb50b60bc735a015b8b9aa624e0639b3
135 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
136 Date: 2010-08-12 13:30:24 +0100
137
138 tp_account_channel_request_create_and_handle_channel_finish: say how the handler will be notified
139
140 commit 65c529d1b908439637b7b13a0ae26a5cb6443251
141 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
142 Date: 2010-08-12 13:30:13 +0100
143
144 TpAccountChannelRequest::re-handled: explain what this means
145
146 commit b4f25fdb08d392bec05ebafbdd750f733efb1d11
147 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
148 Date: 2010-08-12 13:29:26 +0100
149
150 TpAccountChannelRequest:request: fix documentation
151
152 commit fbec3c1debdef60acf3d3e023f306c0befcf921c
153 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
154 Date: 2010-08-12 13:43:58 +0100
155
156 Add tp_user_action_time_from_x11, tp_user_action_time_should_present
157
158 commit 3323e65977bfdb41f2d4e6d7436e920d01963ece
159 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
160 Date: 2010-08-12 12:05:20 +0100
161
162 Reference TP_USER_ACTION_TIME_* everywhere a user action time is used
163
164 commit fb293f7fd966fe4512d776cd13c07800038e8610
165 Merge: 7d0e590 94c62a7
166 Author: Danielle Madeley <danielle.madeley@collabora.co.uk>
167 Date: 2010-08-12 21:05:16 +1000
168
169 Merge branch 'trivia'
170
171 commit b6534993a4390e6bce962ff2ad2279900a1ee353
172 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
173 Date: 2010-08-12 12:04:43 +0100
174
175 Add TP_USER_ACTION_TIME_NOT_USER_ACTION, TP_USER_ACTION_TIME_CURRENT_TIME
176
177 commit 7d0e5907e6b62619d190a1972142dfc71a521056
178 Merge: 0621e22 7e23f84
179 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
180 Date: 2010-08-12 12:01:44 +0100
181
182 Merge branch 'presence-mixin'
183
184 Reviewed-by: Senko Rasic <senko.rasic@collabora.co.uk>
185
186 commit 94c62a7cf9caabd029f3b2cf78f328d4c5dc4abc
187 Author: Danielle Madeley <danielle.madeley@collabora.co.uk>
188 Date: 2010-08-12 20:52:47 +1000
189
190 Remove extra NULL from tp_proxy_prepare_async example
191
192 commit 7e23f84f8f6a453303de650c4a3143978f2ac4bc
193 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
194 Date: 2010-08-12 11:30:23 +0100
195
196 Rewrite TpPresenceMixin introduction
197
198 - more complete documentation of how to wire it up to the interfaces
199 - recommendation to implement both (see fd.o #25019)
200 - talk about SimplePresence first
201
202 commit 56f42300097369d4d79965a5d9b0e6abdbe35f7e
203 Author: Butch Howard <ext-butch.howard@nokia.com>
204 Date: 2010-08-12 11:19:18 +0100
205
206 fd.o #25019: allow TpPresenceMixin on connections without old-style Presence
207
208 Bug: https://bugs.freedesktop.org/show_bug.cgi?id=25019
209 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
210
211 commit 0621e229d02f3bdb62863dafcd7adbd2262f8194
212 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
213 Date: 2010-08-11 15:48:00 +0100
214
215 Fix misuse of enums, and hence compilation with gcc-4.5
216
217 TP_OBSERVE_CHANNELS_CONTEXT_STATE_NONE == 0 and
218 TP_HANDLE_CHANNELS_CONTEXT_STATE_NONE == 0, so this typo was harmless.
219
220 Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
221
222 commit c607c65ea43508974af39333deefb38a8ef8c198
223 Author: Philip Withnall <philip.withnall@collabora.co.uk>
224 Date: 2010-08-02 13:51:33 +0100
225
226 fd.o #29358: introspect TpError
227
228 We need to duplicate tp_errors_quark() as tp_error_quark() so that
229 g-ir-scanner picks up the relationship between the quark and error enum.
230 The new quark function returns the same quark as the old one.
231
232 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
233
234 commit 6f44809a5998b9354d69cf9e6c2020dabd2da1e0
235 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
236 Date: 2010-08-10 18:01:25 +0100
237
238 Nano version
239
0240 commit 8aef064cf3b8ab529f289b64ec30023e07ce00f6
1241 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2242 Date: 2010-08-10 16:22:21 +0100
4444 rsync -rtzvPp --chmod=a+rX docs/reference/html/ \
4545 $(UPLOAD_BRANCH_TO)-$(BRANCH)/
4646
47 if HAVE_AUTOMAKE_FOR_DIST
48 # automake is new enough to make dist
49 else
50 dist-hook: dist-hook-check-am
51 dist-hook-check-am:
52 @echo "*** Your automake is too old to compile Vala.">&2
53 @echo "*** You can build telepathy-glib with this automake, but you">&2
54 @echo "*** should not use it to make tarball releases.">&2
55 @exit 1
56 endif
57
4758 include tools/lcov.am
4859
4960 CHANGELOG_RANGE = telepathy-glib-0.8.0..
216216 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
217217 VALAC = @VALAC@
218218 VALAFLAGS = @VALAFLAGS@
219 VALA_CFLAGS = @VALA_CFLAGS@
220 VALA_LIBS = @VALA_LIBS@
221219 VAPIGEN = @VAPIGEN@
222220 VERSION = @VERSION@
223221 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
491489
492490 distclean-tags:
493491 -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
492 @HAVE_AUTOMAKE_FOR_DIST_TRUE@dist-hook:
494493
495494 distdir: $(DISTFILES)
496495 $(am__remove_distdir)
809808 upload-branch-docs: all
810809 rsync -rtzvPp --chmod=a+rX docs/reference/html/ \
811810 $(UPLOAD_BRANCH_TO)-$(BRANCH)/
811
812 # automake is new enough to make dist
813 @HAVE_AUTOMAKE_FOR_DIST_FALSE@dist-hook: dist-hook-check-am
814 @HAVE_AUTOMAKE_FOR_DIST_FALSE@dist-hook-check-am:
815 @HAVE_AUTOMAKE_FOR_DIST_FALSE@ @echo "*** Your automake is too old to compile Vala.">&2
816 @HAVE_AUTOMAKE_FOR_DIST_FALSE@ @echo "*** You can build telepathy-glib with this automake, but you">&2
817 @HAVE_AUTOMAKE_FOR_DIST_FALSE@ @echo "*** should not use it to make tarball releases.">&2
818 @HAVE_AUTOMAKE_FOR_DIST_FALSE@ @exit 1
812819 lcov-reset:
813820 lcov --directory @top_srcdir@ --zerocounters
814821
0 telepathy-glib 0.11.13 (2010-08-17)
1 ===================================
2
3 Dependencies:
4
5 • When building from git or otherwise running automake, automake 1.11 is
6 strongly recommended. If an older version is used, it will not be possible
7 to generate Vala bindings, or to make tarball distributions.
8
9 Changes to experimental API:
10
11 • fd.o #29070: remove telepathy-vala.pc. Vala bindings should ask pkg-config
12 for telepathy-glib, and can check that the VAPI file exists by attempting
13 to link a trivial Vala program; see libfolks for example code (cassidy)
14
15 Enhancements:
16
17 • fd.o #29358: add TP_ERROR as an alias for TP_ERRORS, for introspectability
18 (pwithnall)
19
20 • add TP_USER_ACTION_TIME_NOT_USER_ACTION, TP_USER_ACTION_TIME_CURRENT_TIME,
21 tp_user_action_time_from_x11, tp_user_action_time_should_present (smcv)
22
23 • improve various documentation (smcv, danni)
24
25 • convert TpBaseClient virtual methods into normal GObject virtual methods
26 so they can be introspected (smcv)
27
28 Fixes:
29
30 • Don't rely on vala-1.0.pc to check for vala version and vapigen (treitter)
31
32 • fd.o #25019: let the TpPresenceMixin work on connections that implement
33 SimplePresence but not complex Presence (Butch Howard)
34
35 • Fix a harmless misuse of enums that caused warnings on gcc 4.5 (smcv)
36
37 • Fix out-of-tree builds with Vala enabled (smcv)
38
039 telepathy-glib 0.11.12 (2010-08-10)
140 ===================================
241
13671367 AC_SUBST([am__untar])
13681368 ]) # _AM_PROG_TAR
13691369
1370 # Autoconf support for the Vala compiler
1371
1372 # Copyright (C) 2008, 2009 Free Software Foundation, Inc.
1373 #
1374 # This file is free software; the Free Software Foundation
1375 # gives unlimited permission to copy and/or distribute it,
1376 # with or without modifications, as long as this notice is preserved.
1377
1378 # serial 4
1379
1380 # Check whether the Vala compiler exists in `PATH'. If it is found, the
1381 # variable VALAC is set. Optionally a minimum release number of the
1382 # compiler can be requested.
1383 #
1384 # AM_PROG_VALAC([MINIMUM-VERSION])
1385 # --------------------------------
1386 AC_DEFUN([AM_PROG_VALAC],
1387 [AC_PATH_PROG([VALAC], [valac], [])
1388 AS_IF([test -z "$VALAC"],
1389 [AC_MSG_WARN([No Vala compiler found. You will not be able to compile .vala source files.])],
1390 [AS_IF([test -n "$1"],
1391 [AC_MSG_CHECKING([$VALAC is at least version $1])
1392 am__vala_version=`$VALAC --version | sed 's/Vala *//'`
1393 AS_VERSION_COMPARE([$1], ["$am__vala_version"],
1394 [AC_MSG_RESULT([yes])],
1395 [AC_MSG_RESULT([yes])],
1396 [AC_MSG_RESULT([no])
1397 AC_MSG_ERROR([Vala $1 not found.])])])])
1398 ])
1399
13701400 m4_include([m4/compiler.m4])
13711401 m4_include([m4/gtk-doc.m4])
13721402 m4_include([m4/introspection.m4])
00 #! /bin/sh
11 # Guess values for system-dependent variables and create Makefiles.
2 # Generated by GNU Autoconf 2.67 for Telepathy-GLib 0.11.12.
2 # Generated by GNU Autoconf 2.67 for Telepathy-GLib 0.11.13.
33 #
44 # Report bugs to <https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=tp-glib>.
55 #
677677
678678
679679
680 as_awk_strverscmp='
681 # Use only awk features that work with 7th edition Unix awk (1978).
682 # My, what an old awk you have, Mr. Solaris!
683 END {
684 while (length(v1) && length(v2)) {
685 # Set d1 to be the next thing to compare from v1, and likewise for d2.
686 # Normally this is a single character, but if v1 and v2 contain digits,
687 # compare them as integers and fractions as strverscmp does.
688 if (v1 ~ /^[0-9]/ && v2 ~ /^[0-9]/) {
689 # Split v1 and v2 into their leading digit string components d1 and d2,
690 # and advance v1 and v2 past the leading digit strings.
691 for (len1 = 1; substr(v1, len1 + 1) ~ /^[0-9]/; len1++) continue
692 for (len2 = 1; substr(v2, len2 + 1) ~ /^[0-9]/; len2++) continue
693 d1 = substr(v1, 1, len1); v1 = substr(v1, len1 + 1)
694 d2 = substr(v2, 1, len2); v2 = substr(v2, len2 + 1)
695 if (d1 ~ /^0/) {
696 if (d2 ~ /^0/) {
697 # Compare two fractions.
698 while (d1 ~ /^0/ && d2 ~ /^0/) {
699 d1 = substr(d1, 2); len1--
700 d2 = substr(d2, 2); len2--
701 }
702 if (len1 != len2 && ! (len1 && len2 && substr(d1, 1, 1) == substr(d2, 1, 1))) {
703 # The two components differ in length, and the common prefix
704 # contains only leading zeros. Consider the longer to be less.
705 d1 = -len1
706 d2 = -len2
707 } else {
708 # Otherwise, compare as strings.
709 d1 = "x" d1
710 d2 = "x" d2
711 }
712 } else {
713 # A fraction is less than an integer.
714 exit 1
715 }
716 } else {
717 if (d2 ~ /^0/) {
718 # An integer is greater than a fraction.
719 exit 2
720 } else {
721 # Compare two integers.
722 d1 += 0
723 d2 += 0
724 }
725 }
726 } else {
727 # The normal case, without worrying about digits.
728 d1 = substr(v1, 1, 1); v1 = substr(v1, 2)
729 d2 = substr(v2, 1, 1); v2 = substr(v2, 2)
730 }
731 if (d1 < d2) exit 1
732 if (d1 > d2) exit 2
733 }
734 # Beware Solaris /usr/xgp4/bin/awk (at least through Solaris 10),
735 # which mishandles some comparisons of empty strings to integers.
736 if (length(v2)) exit 1
737 if (length(v1)) exit 2
738 }
739 '
680740
681741 test -n "$DJDIR" || exec 7<&0 </dev/null
682742 exec 6>&1
701761 # Identity of this package.
702762 PACKAGE_NAME='Telepathy-GLib'
703763 PACKAGE_TARNAME='telepathy-glib'
704 PACKAGE_VERSION='0.11.12'
705 PACKAGE_STRING='Telepathy-GLib 0.11.12'
764 PACKAGE_VERSION='0.11.13'
765 PACKAGE_STRING='Telepathy-GLib 0.11.13'
706766 PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=tp-glib'
707767 PACKAGE_URL=''
708768
774834 VAPIGEN
775835 VALAFLAGS
776836 VALAC
777 VALA_LIBS
778 VALA_CFLAGS
779837 DBUS_LIBS
780838 DBUS_CFLAGS
781839 GLIB_MKENUMS
869927 LDFLAGS
870928 CFLAGS
871929 CC
930 HAVE_AUTOMAKE_FOR_DIST_FALSE
931 HAVE_AUTOMAKE_FOR_DIST_TRUE
872932 AM_BACKSLASH
873933 AM_DEFAULT_VERBOSITY
874934 am__untar
9781038 GIO_UNIX_LIBS
9791039 DBUS_CFLAGS
9801040 DBUS_LIBS
981 VALA_CFLAGS
982 VALA_LIBS
9831041 CXX
9841042 CXXFLAGS
9851043 CCC
15261584 # Omit some internal or obsolete options to make the list less imposing.
15271585 # This message is too long to be a string in the A/UX 3.1 sh.
15281586 cat <<_ACEOF
1529 \`configure' configures Telepathy-GLib 0.11.12 to adapt to many kinds of systems.
1587 \`configure' configures Telepathy-GLib 0.11.13 to adapt to many kinds of systems.
15301588
15311589 Usage: $0 [OPTION]... [VAR=VALUE]...
15321590
15961654
15971655 if test -n "$ac_init_help"; then
15981656 case $ac_init_help in
1599 short | recursive ) echo "Configuration of Telepathy-GLib 0.11.12:";;
1657 short | recursive ) echo "Configuration of Telepathy-GLib 0.11.13:";;
16001658 esac
16011659 cat <<\_ACEOF
16021660
16711729 linker flags for GIO_UNIX, overriding pkg-config
16721730 DBUS_CFLAGS C compiler flags for DBUS, overriding pkg-config
16731731 DBUS_LIBS linker flags for DBUS, overriding pkg-config
1674 VALA_CFLAGS C compiler flags for VALA, overriding pkg-config
1675 VALA_LIBS linker flags for VALA, overriding pkg-config
16761732 CXX C++ compiler command
16771733 CXXFLAGS C++ compiler flags
16781734 CXXCPP C++ preprocessor
17431799 test -n "$ac_init_help" && exit $ac_status
17441800 if $ac_init_version; then
17451801 cat <<\_ACEOF
1746 Telepathy-GLib configure 0.11.12
1802 Telepathy-GLib configure 0.11.13
17471803 generated by GNU Autoconf 2.67
17481804
17491805 Copyright (C) 2010 Free Software Foundation, Inc.
22332289 This file contains any messages produced by compilers while
22342290 running configure, to aid debugging if configure makes a mistake.
22352291
2236 It was created by Telepathy-GLib $as_me 0.11.12, which was
2292 It was created by Telepathy-GLib $as_me 0.11.13, which was
22372293 generated by GNU Autoconf 2.67. Invocation command line was
22382294
22392295 $ $0 $@
30513107
30523108 # Define the identity of the package.
30533109 PACKAGE='telepathy-glib'
3054 VERSION='0.11.12'
3110 VERSION='0.11.13'
30553111
30563112
30573113 cat >>confdefs.h <<_ACEOF
31053161 *) AM_DEFAULT_VERBOSITY=1;;
31063162 esac
31073163 AM_BACKSLASH='\'
3164
3165 have_automake_for_dist=true
3166 if $have_automake_for_dist; then
3167 HAVE_AUTOMAKE_FOR_DIST_TRUE=
3168 HAVE_AUTOMAKE_FOR_DIST_FALSE='#'
3169 else
3170 HAVE_AUTOMAKE_FOR_DIST_TRUE='#'
3171 HAVE_AUTOMAKE_FOR_DIST_FALSE=
3172 fi
31083173
31093174
31103175 ac_ext=c
50605125 else
50615126 lt_cv_nm_interface="BSD nm"
50625127 echo "int some_variable = 0;" > conftest.$ac_ext
5063 (eval echo "\"\$as_me:5064: $ac_compile\"" >&5)
5128 (eval echo "\"\$as_me:5129: $ac_compile\"" >&5)
50645129 (eval "$ac_compile" 2>conftest.err)
50655130 cat conftest.err >&5
5066 (eval echo "\"\$as_me:5067: $NM \\\"conftest.$ac_objext\\\"\"" >&5)
5131 (eval echo "\"\$as_me:5132: $NM \\\"conftest.$ac_objext\\\"\"" >&5)
50675132 (eval "$NM \"conftest.$ac_objext\"" 2>conftest.err > conftest.out)
50685133 cat conftest.err >&5
5069 (eval echo "\"\$as_me:5070: output\"" >&5)
5134 (eval echo "\"\$as_me:5135: output\"" >&5)
50705135 cat conftest.out >&5
50715136 if $GREP 'External.*some_variable' conftest.out > /dev/null; then
50725137 lt_cv_nm_interface="MS dumpbin"
62726337 ;;
62736338 *-*-irix6*)
62746339 # Find out which ABI we are using.
6275 echo '#line 6276 "configure"' > conftest.$ac_ext
6340 echo '#line 6341 "configure"' > conftest.$ac_ext
62766341 if { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_compile\""; } >&5
62776342 (eval $ac_compile) 2>&5
62786343 ac_status=$?
78017866 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
78027867 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
78037868 -e 's:$: $lt_compiler_flag:'`
7804 (eval echo "\"\$as_me:7805: $lt_compile\"" >&5)
7869 (eval echo "\"\$as_me:7870: $lt_compile\"" >&5)
78057870 (eval "$lt_compile" 2>conftest.err)
78067871 ac_status=$?
78077872 cat conftest.err >&5
7808 echo "$as_me:7809: \$? = $ac_status" >&5
7873 echo "$as_me:7874: \$? = $ac_status" >&5
78097874 if (exit $ac_status) && test -s "$ac_outfile"; then
78107875 # The compiler can only warn and ignore the option if not recognized
78117876 # So say no if there are warnings other than the usual output.
81408205 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
81418206 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
81428207 -e 's:$: $lt_compiler_flag:'`
8143 (eval echo "\"\$as_me:8144: $lt_compile\"" >&5)
8208 (eval echo "\"\$as_me:8209: $lt_compile\"" >&5)
81448209 (eval "$lt_compile" 2>conftest.err)
81458210 ac_status=$?
81468211 cat conftest.err >&5
8147 echo "$as_me:8148: \$? = $ac_status" >&5
8212 echo "$as_me:8213: \$? = $ac_status" >&5
81488213 if (exit $ac_status) && test -s "$ac_outfile"; then
81498214 # The compiler can only warn and ignore the option if not recognized
81508215 # So say no if there are warnings other than the usual output.
82458310 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
82468311 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
82478312 -e 's:$: $lt_compiler_flag:'`
8248 (eval echo "\"\$as_me:8249: $lt_compile\"" >&5)
8313 (eval echo "\"\$as_me:8314: $lt_compile\"" >&5)
82498314 (eval "$lt_compile" 2>out/conftest.err)
82508315 ac_status=$?
82518316 cat out/conftest.err >&5
8252 echo "$as_me:8253: \$? = $ac_status" >&5
8317 echo "$as_me:8318: \$? = $ac_status" >&5
82538318 if (exit $ac_status) && test -s out/conftest2.$ac_objext
82548319 then
82558320 # The compiler can only warn and ignore the option if not recognized
83008365 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
83018366 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
83028367 -e 's:$: $lt_compiler_flag:'`
8303 (eval echo "\"\$as_me:8304: $lt_compile\"" >&5)
8368 (eval echo "\"\$as_me:8369: $lt_compile\"" >&5)
83048369 (eval "$lt_compile" 2>out/conftest.err)
83058370 ac_status=$?
83068371 cat out/conftest.err >&5
8307 echo "$as_me:8308: \$? = $ac_status" >&5
8372 echo "$as_me:8373: \$? = $ac_status" >&5
83088373 if (exit $ac_status) && test -s out/conftest2.$ac_objext
83098374 then
83108375 # The compiler can only warn and ignore the option if not recognized
1068410749 lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2
1068510750 lt_status=$lt_dlunknown
1068610751 cat > conftest.$ac_ext <<_LT_EOF
10687 #line 10688 "configure"
10752 #line 10753 "configure"
1068810753 #include "confdefs.h"
1068910754
1069010755 #if HAVE_DLFCN_H
1078010845 lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2
1078110846 lt_status=$lt_dlunknown
1078210847 cat > conftest.$ac_ext <<_LT_EOF
10783 #line 10784 "configure"
10848 #line 10849 "configure"
1078410849 #include "confdefs.h"
1078510850
1078610851 #if HAVE_DLFCN_H
1145011515
1145111516
1145211517
11453 LT_CURRENT=41
11518 LT_CURRENT=42
1145411519 LT_REVISION=0
11455 LT_AGE=41
11520 LT_AGE=42
1145611521
1145711522
1145811523
1218412249
1218512250
1218612251 if test x$enable_vala_bindings = xyes; then
12187
12188 pkg_failed=no
12189 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for VALA" >&5
12190 $as_echo_n "checking for VALA... " >&6; }
12191
12192 if test -n "$VALA_CFLAGS"; then
12193 pkg_cv_VALA_CFLAGS="$VALA_CFLAGS"
12194 elif test -n "$PKG_CONFIG"; then
12195 if test -n "$PKG_CONFIG" && \
12196 { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"vala-1.0 >= 0.9.2.97-2b08\""; } >&5
12197 ($PKG_CONFIG --exists --print-errors "vala-1.0 >= 0.9.2.97-2b08") 2>&5
12198 ac_status=$?
12199 $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
12200 test $ac_status = 0; }; then
12201 pkg_cv_VALA_CFLAGS=`$PKG_CONFIG --cflags "vala-1.0 >= 0.9.2.97-2b08" 2>/dev/null`
12202 else
12203 pkg_failed=yes
12204 fi
12205 else
12206 pkg_failed=untried
12207 fi
12208 if test -n "$VALA_LIBS"; then
12209 pkg_cv_VALA_LIBS="$VALA_LIBS"
12210 elif test -n "$PKG_CONFIG"; then
12211 if test -n "$PKG_CONFIG" && \
12212 { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"vala-1.0 >= 0.9.2.97-2b08\""; } >&5
12213 ($PKG_CONFIG --exists --print-errors "vala-1.0 >= 0.9.2.97-2b08") 2>&5
12214 ac_status=$?
12215 $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
12216 test $ac_status = 0; }; then
12217 pkg_cv_VALA_LIBS=`$PKG_CONFIG --libs "vala-1.0 >= 0.9.2.97-2b08" 2>/dev/null`
12218 else
12219 pkg_failed=yes
12220 fi
12221 else
12222 pkg_failed=untried
12223 fi
12224
12225
12226
12227 if test $pkg_failed = yes; then
12228 { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
12229 $as_echo "no" >&6; }
12230
12231 if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
12232 _pkg_short_errors_supported=yes
12233 else
12234 _pkg_short_errors_supported=no
12235 fi
12236 if test $_pkg_short_errors_supported = yes; then
12237 VALA_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors "vala-1.0 >= 0.9.2.97-2b08" 2>&1`
12238 else
12239 VALA_PKG_ERRORS=`$PKG_CONFIG --print-errors "vala-1.0 >= 0.9.2.97-2b08" 2>&1`
12240 fi
12241 # Put the nasty error message in config.log where it belongs
12242 echo "$VALA_PKG_ERRORS" >&5
12243
12244 as_fn_error $? "Package requirements (vala-1.0 >= 0.9.2.97-2b08) were not met:
12245
12246 $VALA_PKG_ERRORS
12247
12248 Consider adjusting the PKG_CONFIG_PATH environment variable if you
12249 installed software in a non-standard prefix.
12250
12251 Alternatively, you may set the environment variables VALA_CFLAGS
12252 and VALA_LIBS to avoid the need to call pkg-config.
12253 See the pkg-config man page for more details." "$LINENO" 5
12254 elif test $pkg_failed = untried; then
12255 { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
12256 $as_echo "no" >&6; }
12257 { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
12258 $as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
12259 as_fn_error $? "The pkg-config script could not be found or is too old. Make sure it
12260 is in your PATH or set the PKG_CONFIG environment variable to the full
12261 path to pkg-config.
12262
12263 Alternatively, you may set the environment variables VALA_CFLAGS
12264 and VALA_LIBS to avoid the need to call pkg-config.
12265 See the pkg-config man page for more details.
12266
12267 To get pkg-config, see <http://pkg-config.freedesktop.org/>.
12268 See \`config.log' for more details" "$LINENO" 5 ; }
12269 else
12270 VALA_CFLAGS=$pkg_cv_VALA_CFLAGS
12271 VALA_LIBS=$pkg_cv_VALA_LIBS
12272 { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
12273 $as_echo "yes" >&6; }
12274
12275 fi
12276 have_vala=yes
12277
1227812252 # Extract the first word of "valac", so it can be a program name with args.
1227912253 set dummy valac; ac_word=$2
1228012254 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
1230212276 done
1230312277 IFS=$as_save_IFS
1230412278
12305 test -z "$ac_cv_path_VALAC" && ac_cv_path_VALAC="valac"
1230612279 ;;
1230712280 esac
1230812281 fi
1231612289 fi
1231712290
1231812291
12319
12320
12321
12322 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for vapigen" >&5
12323 $as_echo_n "checking for vapigen... " >&6; }
12324 VAPIGEN=`$PKG_CONFIG --variable=vapigen vala-1.0`
12325
12326 if test "x$VAPIGEN" = "x"; then
12327 as_fn_error $? "not found. Was vala compiled with --enable-vapigen?" "$LINENO" 5
12328 else
12329 { $as_echo "$as_me:${as_lineno-$LINENO}: result: $VAPIGEN" >&5
12292 if test -z "$VALAC"; then :
12293 { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: No Vala compiler found. You will not be able to compile .vala source files." >&5
12294 $as_echo "$as_me: WARNING: No Vala compiler found. You will not be able to compile .vala source files." >&2;}
12295 else
12296 if test -n "0.9.3"; then :
12297 { $as_echo "$as_me:${as_lineno-$LINENO}: checking $VALAC is at least version 0.9.3" >&5
12298 $as_echo_n "checking $VALAC is at least version 0.9.3... " >&6; }
12299 am__vala_version=`$VALAC --version | sed 's/Vala *//'`
12300 as_arg_v1=0.9.3
12301 as_arg_v2="$am__vala_version"
12302 awk "$as_awk_strverscmp" v1="$as_arg_v1" v2="$as_arg_v2" /dev/null
12303 case $? in #(
12304 1) :
12305 { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
12306 $as_echo "yes" >&6; } ;; #(
12307 0) :
12308 { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
12309 $as_echo "yes" >&6; } ;; #(
12310 2) :
12311 { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
12312 $as_echo "no" >&6; }
12313 as_fn_error $? "Vala 0.9.3 not found." "$LINENO" 5 ;; #(
12314 *) :
12315 ;;
12316 esac
12317 fi
12318 fi
12319
12320 have_vala=yes
12321
12322 # Extract the first word of "valac", so it can be a program name with args.
12323 set dummy valac; ac_word=$2
12324 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
12325 $as_echo_n "checking for $ac_word... " >&6; }
12326 if test "${ac_cv_path_VALAC+set}" = set; then :
12327 $as_echo_n "(cached) " >&6
12328 else
12329 case $VALAC in
12330 [\\/]* | ?:[\\/]*)
12331 ac_cv_path_VALAC="$VALAC" # Let the user override the test with a path.
12332 ;;
12333 *)
12334 as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
12335 for as_dir in $PATH
12336 do
12337 IFS=$as_save_IFS
12338 test -z "$as_dir" && as_dir=.
12339 for ac_exec_ext in '' $ac_executable_extensions; do
12340 if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
12341 ac_cv_path_VALAC="$as_dir/$ac_word$ac_exec_ext"
12342 $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
12343 break 2
12344 fi
12345 done
12346 done
12347 IFS=$as_save_IFS
12348
12349 test -z "$ac_cv_path_VALAC" && ac_cv_path_VALAC="valac"
12350 ;;
12351 esac
12352 fi
12353 VALAC=$ac_cv_path_VALAC
12354 if test -n "$VALAC"; then
12355 { $as_echo "$as_me:${as_lineno-$LINENO}: result: $VALAC" >&5
12356 $as_echo "$VALAC" >&6; }
12357 else
12358 { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
12359 $as_echo "no" >&6; }
12360 fi
12361
12362
12363
12364
12365
12366 # Extract the first word of "vapigen", so it can be a program name with args.
12367 set dummy vapigen; ac_word=$2
12368 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
12369 $as_echo_n "checking for $ac_word... " >&6; }
12370 if test "${ac_cv_path_VAPIGEN+set}" = set; then :
12371 $as_echo_n "(cached) " >&6
12372 else
12373 case $VAPIGEN in
12374 [\\/]* | ?:[\\/]*)
12375 ac_cv_path_VAPIGEN="$VAPIGEN" # Let the user override the test with a path.
12376 ;;
12377 *)
12378 as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
12379 for as_dir in $PATH
12380 do
12381 IFS=$as_save_IFS
12382 test -z "$as_dir" && as_dir=.
12383 for ac_exec_ext in '' $ac_executable_extensions; do
12384 if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
12385 ac_cv_path_VAPIGEN="$as_dir/$ac_word$ac_exec_ext"
12386 $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
12387 break 2
12388 fi
12389 done
12390 done
12391 IFS=$as_save_IFS
12392
12393 test -z "$ac_cv_path_VAPIGEN" && ac_cv_path_VAPIGEN="false"
12394 ;;
12395 esac
12396 fi
12397 VAPIGEN=$ac_cv_path_VAPIGEN
12398 if test -n "$VAPIGEN"; then
12399 { $as_echo "$as_me:${as_lineno-$LINENO}: result: $VAPIGEN" >&5
1233012400 $as_echo "$VAPIGEN" >&6; }
12401 else
12402 { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
12403 $as_echo "no" >&6; }
12404 fi
12405
12406
12407
12408 if test "x$VAPIGEN" = "xfalse"; then
12409 as_fn_error $? "vapigen not found. Was vala compiled with --enable-vapigen?" "$LINENO" 5
1233112410 fi
1233212411
1233312412
1538515464 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
1538615465 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
1538715466 -e 's:$: $lt_compiler_flag:'`
15388 (eval echo "\"\$as_me:15389: $lt_compile\"" >&5)
15467 (eval echo "\"\$as_me:15468: $lt_compile\"" >&5)
1538915468 (eval "$lt_compile" 2>conftest.err)
1539015469 ac_status=$?
1539115470 cat conftest.err >&5
15392 echo "$as_me:15393: \$? = $ac_status" >&5
15471 echo "$as_me:15472: \$? = $ac_status" >&5
1539315472 if (exit $ac_status) && test -s "$ac_outfile"; then
1539415473 # The compiler can only warn and ignore the option if not recognized
1539515474 # So say no if there are warnings other than the usual output.
1548415563 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
1548515564 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
1548615565 -e 's:$: $lt_compiler_flag:'`
15487 (eval echo "\"\$as_me:15488: $lt_compile\"" >&5)
15566 (eval echo "\"\$as_me:15567: $lt_compile\"" >&5)
1548815567 (eval "$lt_compile" 2>out/conftest.err)
1548915568 ac_status=$?
1549015569 cat out/conftest.err >&5
15491 echo "$as_me:15492: \$? = $ac_status" >&5
15570 echo "$as_me:15571: \$? = $ac_status" >&5
1549215571 if (exit $ac_status) && test -s out/conftest2.$ac_objext
1549315572 then
1549415573 # The compiler can only warn and ignore the option if not recognized
1553615615 -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \
1553715616 -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \
1553815617 -e 's:$: $lt_compiler_flag:'`
15539 (eval echo "\"\$as_me:15540: $lt_compile\"" >&5)
15618 (eval echo "\"\$as_me:15619: $lt_compile\"" >&5)
1554015619 (eval "$lt_compile" 2>out/conftest.err)
1554115620 ac_status=$?
1554215621 cat out/conftest.err >&5
15543 echo "$as_me:15544: \$? = $ac_status" >&5
15622 echo "$as_me:15623: \$? = $ac_status" >&5
1554415623 if (exit $ac_status) && test -s out/conftest2.$ac_objext
1554515624 then
1554615625 # The compiler can only warn and ignore the option if not recognized
1653016609 fi
1653116610
1653216611
16533 ac_config_files="$ac_config_files Makefile docs/Makefile docs/reference/Makefile examples/Makefile examples/client/Makefile examples/cm/Makefile examples/cm/callable/Makefile examples/cm/channelspecific/Makefile examples/cm/contactlist/Makefile examples/cm/echo-message-parts/Makefile examples/cm/extended/Makefile examples/cm/no-protocols/Makefile examples/extensions/Makefile examples/future/Makefile examples/future/call-cm/Makefile extensions/Makefile spec/Makefile telepathy-glib/Makefile telepathy-glib/telepathy-glib.pc telepathy-glib/telepathy-glib-uninstalled.pc tests/Makefile tests/lib/Makefile tests/dbus/Makefile tests/tools/Makefile tools/Makefile m4/Makefile vala/Makefile vala/telepathy-vala.pc vala/telepathy-vala-uninstalled.pc"
16612 ac_config_files="$ac_config_files Makefile docs/Makefile docs/reference/Makefile examples/Makefile examples/client/Makefile examples/cm/Makefile examples/cm/callable/Makefile examples/cm/channelspecific/Makefile examples/cm/contactlist/Makefile examples/cm/echo-message-parts/Makefile examples/cm/extended/Makefile examples/cm/no-protocols/Makefile examples/extensions/Makefile examples/future/Makefile examples/future/call-cm/Makefile extensions/Makefile spec/Makefile telepathy-glib/Makefile telepathy-glib/telepathy-glib.pc telepathy-glib/telepathy-glib-uninstalled.pc tests/Makefile tests/lib/Makefile tests/dbus/Makefile tests/tools/Makefile tools/Makefile m4/Makefile vala/Makefile"
1653416613
1653516614 cat >confcache <<\_ACEOF
1653616615 # This file is a shell script that caches the results of configure
1663816717 am__EXEEXT_FALSE=
1663916718 fi
1664016719
16720 if test -z "${HAVE_AUTOMAKE_FOR_DIST_TRUE}" && test -z "${HAVE_AUTOMAKE_FOR_DIST_FALSE}"; then
16721 as_fn_error $? "conditional \"HAVE_AUTOMAKE_FOR_DIST\" was never defined.
16722 Usually this means the macro was only invoked conditionally." "$LINENO" 5
16723 fi
1664116724 if test -z "${AMDEP_TRUE}" && test -z "${AMDEP_FALSE}"; then
1664216725 as_fn_error $? "conditional \"AMDEP\" was never defined.
1664316726 Usually this means the macro was only invoked conditionally." "$LINENO" 5
1711417197 # report actual input values of CONFIG_FILES etc. instead of their
1711517198 # values after options handling.
1711617199 ac_log="
17117 This file was extended by Telepathy-GLib $as_me 0.11.12, which was
17200 This file was extended by Telepathy-GLib $as_me 0.11.13, which was
1711817201 generated by GNU Autoconf 2.67. Invocation command line was
1711917202
1712017203 CONFIG_FILES = $CONFIG_FILES
1718017263 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
1718117264 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
1718217265 ac_cs_version="\\
17183 Telepathy-GLib config.status 0.11.12
17266 Telepathy-GLib config.status 0.11.13
1718417267 configured by $0, generated by GNU Autoconf 2.67,
1718517268 with options \\"\$ac_cs_config\\"
1718617269
1769017773 "tools/Makefile") CONFIG_FILES="$CONFIG_FILES tools/Makefile" ;;
1769117774 "m4/Makefile") CONFIG_FILES="$CONFIG_FILES m4/Makefile" ;;
1769217775 "vala/Makefile") CONFIG_FILES="$CONFIG_FILES vala/Makefile" ;;
17693 "vala/telepathy-vala.pc") CONFIG_FILES="$CONFIG_FILES vala/telepathy-vala.pc" ;;
17694 "vala/telepathy-vala-uninstalled.pc") CONFIG_FILES="$CONFIG_FILES vala/telepathy-vala-uninstalled.pc" ;;
1769517776
1769617777 *) as_fn_error $? "invalid argument: \`$ac_config_target'" "$LINENO" 5 ;;
1769717778 esac
1010
1111 m4_define([tp_glib_major_version], [0])
1212 m4_define([tp_glib_minor_version], [11])
13 m4_define([tp_glib_micro_version], [12])
13 m4_define([tp_glib_micro_version], [13])
1414 m4_define([tp_glib_nano_version], [0])
1515
1616 # If library source has changed since last release, increment revision
2525 # (we don't guarantee that we won't add ABI then remove it again, if it was
2626 # never seen in a release).
2727
28 m4_define([tp_glib_lt_current], [41])
28 m4_define([tp_glib_lt_current], [42])
2929 m4_define([tp_glib_lt_revision], [0])
30 m4_define([tp_glib_lt_age], [41])
30 m4_define([tp_glib_lt_age], [42])
3131
3232 # Some magic
3333 m4_define([tp_glib_base_version],
4444 AM_INIT_AUTOMAKE([1.9 -Wno-portability])
4545 AM_CONFIG_HEADER(config.h)
4646
47 dnl We're compatible with automake 1.9 (to be nice to Maemo 5), but with
48 dnl reduced functionality
4749 m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES])
50 m4_ifdef([AM_PROG_VALAC],
51 [have_automake_for_dist=true],
52 [AC_MSG_WARN([You have Automake < 1.11, 'make dist' will not work])
53 have_automake_for_dist=false])
54 AM_CONDITIONAL([HAVE_AUTOMAKE_FOR_DIST], [$have_automake_for_dist])
4855
4956 dnl check for tools
5057 AC_PROG_CC
195202 enable_vala_bindings=no )
196203
197204 if test x$enable_vala_bindings = xyes; then
198 PKG_CHECK_MODULES(VALA,
199 [vala-1.0 >= 0.9.2.97-2b08])
205 m4_ifdef([AM_PROG_VALAC], [AM_PROG_VALAC(0.9.3)],
206 [AC_MSG_ERROR([Automake >= 1.11 required for Vala bindings])])
200207 have_vala=yes
201208
202209 AC_PATH_PROG(VALAC, valac, valac)
203210 AC_SUBST(VALAC)
204211 AC_SUBST(VALAFLAGS)
205212
206 AC_MSG_CHECKING([for vapigen])
207 VAPIGEN=`$PKG_CONFIG --variable=vapigen vala-1.0`
208
209 if test "x$VAPIGEN" = "x"; then
210 AC_MSG_ERROR([not found. Was vala compiled with --enable-vapigen?])
211 else
212 AC_MSG_RESULT([$VAPIGEN])
213 AC_PATH_PROG([VAPIGEN], [vapigen], [false])
214
215 if test "x$VAPIGEN" = "xfalse"; then
216 AC_MSG_ERROR([vapigen not found. Was vala compiled with --enable-vapigen?])
213217 fi
214218
215219 AC_SUBST(VAPIGEN)
295299 tests/tools/Makefile \
296300 tools/Makefile \
297301 m4/Makefile \
298 vala/Makefile \
299 vala/telepathy-vala.pc \
300 vala/telepathy-vala-uninstalled.pc
302 vala/Makefile
301303 )
198198 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
199199 VALAC = @VALAC@
200200 VALAFLAGS = @VALAFLAGS@
201 VALA_CFLAGS = @VALA_CFLAGS@
202 VALA_LIBS = @VALA_LIBS@
203201 VAPIGEN = @VAPIGEN@
204202 VERSION = @VERSION@
205203 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
173173 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
174174 VALAC = @VALAC@
175175 VALAFLAGS = @VALAFLAGS@
176 VALA_CFLAGS = @VALA_CFLAGS@
177 VALA_LIBS = @VALA_LIBS@
178176 VAPIGEN = @VAPIGEN@
179177 VERSION = @VERSION@
180178 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
256256 <ANCHOR id="TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS">
257257 <ANCHOR id="TP-CLIENT-BUS-NAME-BASE:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS">
258258 <ANCHOR id="TP-CLIENT-OBJECT-PATH-BASE:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE:CAPS">
259 <ANCHOR id="TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS">
260 <ANCHOR id="TP-USER-ACTION-TIME-CURRENT-TIME:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-USER-ACTION-TIME-CURRENT-TIME:CAPS">
259261 <ANCHOR id="telepathy-glib-handle" href="telepathy-glib/telepathy-glib-handle.html">
260262 <ANCHOR id="telepathy-glib-handle.synopsis" href="telepathy-glib/telepathy-glib-handle.html#telepathy-glib-handle.synopsis">
261263 <ANCHOR id="telepathy-glib-handle.description" href="telepathy-glib/telepathy-glib-handle.html#telepathy-glib-handle.description">
854856 <ANCHOR id="telepathy-glib-errors.description" href="telepathy-glib/telepathy-glib-errors.html#telepathy-glib-errors.description">
855857 <ANCHOR id="telepathy-glib-errors.details" href="telepathy-glib/telepathy-glib-errors.html#telepathy-glib-errors.details">
856858 <ANCHOR id="TP-ERROR-PREFIX:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-ERROR-PREFIX:CAPS">
857 <ANCHOR id="TP-ERRORS:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-ERRORS:CAPS">
859 <ANCHOR id="TP-ERROR:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-ERROR:CAPS">
858860 <ANCHOR id="TP-TYPE-ERROR:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS">
859861 <ANCHOR id="TpError" href="telepathy-glib/telepathy-glib-errors.html#TpError">
860862 <ANCHOR id="TP-ERROR-NETWORK-ERROR:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-ERROR-NETWORK-ERROR:CAPS">
38903892 <ANCHOR id="tp-clear-object" href="telepathy-glib/telepathy-glib-util.html#tp-clear-object">
38913893 <ANCHOR id="tp-clear-boxed" href="telepathy-glib/telepathy-glib-util.html#tp-clear-boxed">
38923894 <ANCHOR id="tp-simple-async-report-success-in-idle" href="telepathy-glib/telepathy-glib-util.html#tp-simple-async-report-success-in-idle">
3895 <ANCHOR id="tp-user-action-time-from-x11" href="telepathy-glib/telepathy-glib-util.html#tp-user-action-time-from-x11">
3896 <ANCHOR id="tp-user-action-time-should-present" href="telepathy-glib/telepathy-glib-util.html#tp-user-action-time-should-present">
38933897 <ANCHOR id="telepathy-glib-gnio-util" href="telepathy-glib/telepathy-glib-gnio-util.html">
38943898 <ANCHOR id="telepathy-glib-gnio-util.synopsis" href="telepathy-glib/telepathy-glib-gnio-util.html#telepathy-glib-gnio-util.synopsis">
38953899 <ANCHOR id="telepathy-glib-gnio-util.description" href="telepathy-glib/telepathy-glib-gnio-util.html#telepathy-glib-gnio-util.description">
8989 <a name="telepathy-glib-TpPresenceMixin.description"></a><h2>Description</h2>
9090 <p>
9191 This mixin can be added to a <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> subclass to implement the
92 presence interface in a general way. It does not support protocols where it
93 is possible to set multiple statuses on yourself at once, however. Hence all
94 presence statuses will have the exclusive flag set.
95 </p>
96 <p>
97 There are plans to deprecate the notion of last activity time in the D-Bus
98 presence interface, so <a class="link" href="telepathy-glib-TpPresenceMixin.html#TpPresenceStatus" title="TpPresenceStatus"><span class="type">TpPresenceStatus</span></a> doesn't include it at all.
99 Consequently, the last activity time field in presence data presented over
100 D-Bus will always be zero and the SetLastActivityTime method doesn't actually
101 do anything.
92 SimplePresence and/or Presence interfaces. Implementing both interfaces
93 (as described below) is recommended. In particular, you must implement the
94 old-style Presence interface if compatibility with telepathy-glib
95 versions older than 0.11.UNRELEASED is required.
10296 </p>
10397 <p>
10498 To use the presence mixin, include a <a class="link" href="telepathy-glib-TpPresenceMixin.html#TpPresenceMixinClass" title="TpPresenceMixinClass"><span class="type">TpPresenceMixinClass</span></a> somewhere in your
108102 <a class="link" href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-finalize" title="tp_presence_mixin_finalize ()"><code class="function">tp_presence_mixin_finalize()</code></a> from your dispose or finalize function.
109103 </p>
110104 <p>
111 To use the presence mixin as the implementation of
112 <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfacePresence"><span class="type">TpSvcConnectionInterfacePresence</span></a>, in the function you pass to
113 G_IMPLEMENT_INTERFACE, you should call tp_presence_mixin_iface_init.
114 TpPresenceMixin implements all of the D-Bus methods in the Presence
115 interface.
116 </p>
117 <p>
118 Since 0.7.13 you can also implement
119 <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceSimplePresence"><span class="type">TpSvcConnectionInterfaceSimplePresence</span></a> by using this mixin, in this case
120 you should pass tp_presence_mixin_iface_init as an argument to
121 G_IMPLEMENT_INTERFACE. Note that this can cause the status_available
122 callback to be called while disconnected. Also to fully implement this
123 interface some dbus properties need to be supported. To do that using this
124 mixin the instance needs to use the dbus properties mixin and call
125 tp_presence_mixin_simple_presence_init_dbus_properties in the class init
126 function
105 </p>
106 <div class="section" title="Implementing SimplePresence">
107 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
108 <a name="id1030883"></a>Implementing SimplePresence</h2></div></div></div>
109 <p>
110 Since 0.7.13 this mixin supports the entire SimplePresence interface.
111 You can implement <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceSimplePresence"><span class="type">TpSvcConnectionInterfaceSimplePresence</span></a> as follows:
112 </p>
113 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
114 <li class="listitem"><p>use the <a class="link" href="telepathy-glib-TpContactsMixin.html#TpContactsMixin" title="TpContactsMixin"><span class="type">TpContactsMixin</span></a> and <span class="type">TpDBusPropertiesMixin</span></p></li>
115 <li class="listitem"><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
116 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>
117 </p></li>
118 <li class="listitem"><p>
119 call tp_presence_mixin_simple_presence_init_dbus_properties in the
120 <span class="type">GTypeClass.class_init</span> function
121 </p></li>
122 <li class="listitem"><p>
123 call <a class="link" href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-simple-presence-register-with-contacts-mixin" title="tp_presence_mixin_simple_presence_register_with_contacts_mixin ()"><code class="function">tp_presence_mixin_simple_presence_register_with_contacts_mixin()</code></a>
124 in the <span class="type">GObjectClass.constructed</span> function
125 </p></li>
126 </ul></div>
127 <p>
128 </p>
129 </div>
130 <p>
131 </p>
132 <div class="section" title="Implementing old-style Presence">
133 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
134 <a name="id1030994"></a>Implementing old-style Presence</h2></div></div></div>
135 <p>
136 This mixin also supports a large subset of the deprecated Presence
137 interface. It does not support protocols where it is possible to set
138 multiple statuses on yourself at once (all presence statuses will have the
139 exclusive flag set), or last-activity-time information.
140 </p>
141 <p>
142 To use the presence mixin as the implementation of
143 <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfacePresence"><span class="type">TpSvcConnectionInterfacePresence</span></a>, use <a class="link" href="telepathy-glib-TpPresenceMixin.html#tp-presence-mixin-iface-init" title="tp_presence_mixin_iface_init ()"><code class="function">tp_presence_mixin_iface_init()</code></a> as
144 the function you pass 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>.
145 The presence mixin implements all of the D-Bus methods in the Presence
146 interface.
147 </p>
148 <p>
149 In telepathy-glib versions older than 0.11.UNRELEASED, every connection
150 that used the <a class="link" href="telepathy-glib-TpPresenceMixin.html#TpPresenceMixin" title="TpPresenceMixin"><span class="type">TpPresenceMixin</span></a> was required to implement
151 <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfacePresence"><span class="type">TpSvcConnectionInterfacePresence</span></a>; failing to do so would lead to an
152 assertion failure. Since 0.11.UNRELEASED, this is no longer required.
153 </p>
154 </div>
155 <p>
127156 </p>
128157 </div>
129158 <div class="refsect1" title="Details">
533562 <td><p><span class="term"><em class="parameter"><code>status_available</code></em> :</span></p></td>
534563 <td>A callback to be used to determine if a given presence
535564 status is available to be set on the connection. If NULL, all statuses are
536 always considered available.
565 always considered available. If SimplePresence is implemented, this
566 callback may be called before the connection is connected.
537567 </td>
538568 </tr>
539569 <tr>
146146 <p>
147147 Data structure representing a <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest"><span class="type">TpAccountChannelRequest</span></a> object.
148148 </p>
149 <p class="since">Since 0.11.UNRELEASED</p>
149 <p class="since">Since 0.11.12</p>
150150 </div>
151151 <hr>
152152 <div class="refsect2" title="tp_account_channel_request_new ()">
169169 <tr>
170170 <td><p><span class="term"><em class="parameter"><code>request</code></em> :</span></p></td>
171171 <td> the requested
172 properties of the channel. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
172 properties of the channel (see <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--request" title='The "request" property'><span class="type">"request"</span></a>). <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
173173 </td>
174174 </tr>
175175 <tr>
176176 <td><p><span class="term"><em class="parameter"><code>user_action_time</code></em> :</span></p></td>
177 <td>the user action time to pass to the channel dispatcher
178 when requesting the channel
177 <td>the time of the user action that caused this request,
178 or one of the special values <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> or
179 <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> (see
180 <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a>)
179181 </td>
180182 </tr>
181183 <tr>
186188 </tr>
187189 </tbody>
188190 </table></div>
189 <p class="since">Since 0.11.UNRELEASED</p>
191 <p class="since">Since 0.11.12</p>
190192 </div>
191193 <hr>
192194 <div class="refsect2" title="tp_account_channel_request_get_request ()">
211213 </tr>
212214 </tbody>
213215 </table></div>
214 <p class="since">Since 0.11.UNRELEASED</p>
216 <p class="since">Since 0.11.12</p>
215217 </div>
216218 <hr>
217219 <div class="refsect2" title="tp_account_channel_request_get_user_action_time ()">
237239 </tr>
238240 </tbody>
239241 </table></div>
240 <p class="since">Since 0.11.UNRELEASED</p>
242 <p class="since">Since 0.11.12</p>
241243 </div>
242244 <hr>
243245 <div class="refsect2" title="tp_account_channel_request_get_account ()">
262264 </tr>
263265 </tbody>
264266 </table></div>
265 <p class="since">Since 0.11.UNRELEASED</p>
267 <p class="since">Since 0.11.12</p>
266268 </div>
267269 <hr>
268270 <div class="refsect2" title="tp_account_channel_request_create_and_handle_channel_async ()">
280282 <a class="link" href="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-finish" title="tp_account_channel_request_create_and_handle_channel_finish ()"><code class="function">tp_account_channel_request_create_and_handle_channel_finish()</code></a> to get the
281283 result of the operation.
282284 </p>
285 <p>
286 (Behind the scenes, this works by creating a temporary <a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="type">TpBaseClient</span></a>, then
287 acting like <a class="link" href="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-channel-async" title="tp_account_channel_request_create_channel_async ()"><code class="function">tp_account_channel_request_create_channel_async()</code></a> with the
288 temporary <a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="type">TpBaseClient</span></a> as the <em class="parameter"><code>preferred_handler</code></em>.)
289 </p>
283290 <div class="variablelist"><table border="0">
284291 <col align="left" valign="top">
285292 <tbody>
305312 </tr>
306313 </tbody>
307314 </table></div>
308 <p class="since">Since 0.11.UNRELEASED</p>
315 <p class="since">Since 0.11.12</p>
309316 </div>
310317 <hr>
311318 <div class="refsect2" title="tp_account_channel_request_create_and_handle_channel_finish ()">
351358 </tr>
352359 </tbody>
353360 </table></div>
354 <p class="since">Since 0.11.UNRELEASED</p>
361 <p class="since">Since 0.11.12</p>
355362 </div>
356363 <hr>
357364 <div class="refsect2" title="tp_account_channel_request_ensure_and_handle_channel_async ()">
373380 If the channel already exists and is already being handled, or if a
374381 newly created channel is sent to a different handler, this operation
375382 will fail with the error <a class="link" href="telepathy-glib-errors.html#TP-ERROR-NOT-YOURS:CAPS"><code class="literal">TP_ERROR_NOT_YOURS</code></a>. The other handler
376 will be notified that the channel was requested again, and can
377 move its window to the foreground, if applicable.
383 will be notified that the channel was requested again (for instance
384 with <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest-re-handled" title='The "re-handled" signal'><span class="type">"re-handled"</span></a>,
385 <a class="link" href="telepathy-glib-base-client.html#TpBaseClientClassHandleChannelsImpl" title="TpBaseClientClassHandleChannelsImpl ()"><span class="type">TpBaseClientClassHandleChannelsImpl</span></a> or <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--callback" title='The "callback" property'><span class="type">"callback"</span></a>),
386 and can move its window to the foreground, if applicable.
387 </p>
388 <p>
389 (Behind the scenes, this works by creating a temporary <a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="type">TpBaseClient</span></a>, then
390 acting like <a class="link" href="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-channel-async" title="tp_account_channel_request_ensure_channel_async ()"><code class="function">tp_account_channel_request_ensure_channel_async()</code></a> with the
391 temporary <a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="type">TpBaseClient</span></a> as the <em class="parameter"><code>preferred_handler</code></em>.)
378392 </p>
379393 <div class="variablelist"><table border="0">
380394 <col align="left" valign="top">
401415 </tr>
402416 </tbody>
403417 </table></div>
404 <p class="since">Since 0.11.UNRELEASED</p>
418 <p class="since">Since 0.11.12</p>
405419 </div>
406420 <hr>
407421 <div class="refsect2" title="tp_account_channel_request_ensure_and_handle_channel_finish ()">
452466 </tr>
453467 </tbody>
454468 </table></div>
455 <p class="since">Since 0.11.UNRELEASED</p>
469 <p class="since">Since 0.11.12</p>
456470 </div>
457471 <hr>
458472 <div class="refsect2" title="tp_account_channel_request_create_channel_async ()">
504518 </tr>
505519 </tbody>
506520 </table></div>
507 <p class="since">Since 0.11.UNRELEASED</p>
521 <p class="since">Since 0.11.12</p>
508522 </div>
509523 <hr>
510524 <div class="refsect2" title="tp_account_channel_request_create_channel_finish ()">
544558 </tr>
545559 </tbody>
546560 </table></div>
547 <p class="since">Since 0.11.UNRELEASED</p>
561 <p class="since">Since 0.11.12</p>
548562 </div>
549563 <hr>
550564 <div class="refsect2" title="tp_account_channel_request_ensure_channel_async ()">
559573 Asynchronously calls EnsureChannel on the ChannelDispatcher to create a
560574 channel with the properties defined in <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--request" title='The "request" property'><span class="type">"request"</span></a>
561575 and let the ChannelDispatcher dispatch it to an handler.
576 </p>
577 <p>
578 If a suitable channel already existed, its handler will be notified that
579 the channel was requested again (for instance with
580 <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest-re-handled" title='The "re-handled" signal'><span class="type">"re-handled"</span></a>, <a class="link" href="telepathy-glib-base-client.html#TpBaseClientClassHandleChannelsImpl" title="TpBaseClientClassHandleChannelsImpl ()"><span class="type">TpBaseClientClassHandleChannelsImpl</span></a>
581 or <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--callback" title='The "callback" property'><span class="type">"callback"</span></a>), and can move its window to the foreground,
582 if applicable. Otherwise, a new channel will be created and dispatched to
583 a handler.
584 </p>
585 <p>
562586 <em class="parameter"><code>callback</code></em> will be called when an existing channel's handler has been
563587 notified, a new channel has been created and dispatched, or the request
564588 has failed.
597621 </tr>
598622 </tbody>
599623 </table></div>
600 <p class="since">Since 0.11.UNRELEASED</p>
624 <p class="since">Since 0.11.12</p>
601625 </div>
602626 <hr>
603627 <div class="refsect2" title="tp_account_channel_request_ensure_channel_finish ()">
637661 </tr>
638662 </tbody>
639663 </table></div>
640 <p class="since">Since 0.11.UNRELEASED</p>
664 <p class="since">Since 0.11.12</p>
641665 </div>
642666 </div>
643667 <div class="refsect1" title="Property Details">
652676 <p>
653677 This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
654678 </p>
655 <p class="since">Since 0.11.UNRELEASED</p>
679 <p class="since">Since 0.11.12</p>
656680 </div>
657681 <hr>
658682 <div class="refsect2" title='The "request" property'>
659683 <a name="TpAccountChannelRequest--request"></a><h3>The <code class="literal">"request"</code> property</h3>
660684 <pre class="programlisting"> "request" <span class="type">GHashTable_gchararray+GValue_*</span> : Read / Write / Construct Only</pre>
661685 <p>
662 The <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> used to request the channel.
663 Read-only except during construction.
686 The desired D-Bus properties for the channel, represented as a
687 <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> where the keys are strings and the values are <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
664688 </p>
665689 <p>
666690 This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
667691 </p>
668 <p class="since">Since 0.11.UNRELEASED</p>
692 <p class="since">Since 0.11.12</p>
669693 </div>
670694 <hr>
671695 <div class="refsect2" title='The "user-action-time" property'>
672696 <a name="TpAccountChannelRequest--user-action-time"></a><h3>The <code class="literal">"user-action-time"</code> property</h3>
673697 <pre class="programlisting"> "user-action-time" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> : Read / Write / Construct Only</pre>
674698 <p>
675 The user action time that will be passed to mission-control when
699 The user action time that will be passed to the channel dispatcher when
676700 requesting the channel.
677701 </p>
702 <p>
703 This may be the time at which user action occurred, or one of the special
704 values <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> or
705 <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>.
706 </p>
707 <p>
708 If <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>, the action doesn't involve any
709 user action. Clients should avoid stealing focus when presenting the
710 channel.
711 </p>
712 <p>
713 If <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>, clients SHOULD behave as though the
714 user action happened at the current time, e.g. a client may
715 request that its window gains focus.
716 </p>
717 <p>
718 On X11-based systems, Gdk 2.x, Clutter 1.0 etc.,
719 <a class="link" href="telepathy-glib-util.html#tp-user-action-time-from-x11" title="tp_user_action_time_from_x11 ()"><code class="function">tp_user_action_time_from_x11()</code></a> can be used to convert an X11 timestamp to
720 a Telepathy user action time.
721 </p>
722 <p>
723 If the channel request succeeds, this user action time will be passed on
724 to the channel's handler. If the handler is a GUI, it may use
725 <a class="link" href="telepathy-glib-util.html#tp-user-action-time-should-present" title="tp_user_action_time_should_present ()"><code class="function">tp_user_action_time_should_present()</code></a> to decide whether to bring its
726 window to the foreground.
727 </p>
678728 <p>Default value: 0</p>
679 <p class="since">Since 0.11.UNRELEASED</p>
729 <p class="since">Since 0.11.12</p>
680730 </div>
681731 </div>
682732 <div class="refsect1" title="Signal Details">
689739 <a class="link" href="telepathy-glib-handle-channels-context.html#TpHandleChannelsContext"><span class="type">TpHandleChannelsContext</span></a> *context,
690740 <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>
691741 <p>
692 Emitted when channel which has been created using <em class="parameter"><code>self</code></em> has be re-handled.
742 Emitted when the channel created using <em class="parameter"><code>self</code></em> has been "re-handled".
743 </p>
744 <p>
745 This means that a Telepathy client has made another request for a
746 matching channel using an "ensure" API like
747 <a class="link" href="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-channel-async" title="tp_account_channel_request_ensure_channel_async ()"><code class="function">tp_account_channel_request_ensure_channel_async()</code></a>, while the channel
748 still exists. Instead of creating a new channel, the channel dispatcher
749 notifies the existing handler of <em class="parameter"><code>channel</code></em>, resulting in this signal.
750 </p>
751 <p>
752 Most GUI handlers should respond to this signal by checking
753 <em class="parameter"><code>user_action_time</code></em>, and if appropriate, moving to the foreground.
693754 </p>
694755 <div class="variablelist"><table border="0">
695756 <col align="left" valign="top">
706767 </tr>
707768 <tr>
708769 <td><p><span class="term"><em class="parameter"><code>user_action_time</code></em> :</span></p></td>
709 <td>the time at which user action occurred, or 0 if this
710 channel is to be handled for some reason not involving user action.
770 <td>the time at which user action occurred, or one of the
771 special values <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> or
772 <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>; see
773 <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a>
711774 </td>
712775 </tr>
713776 <tr>
722785 </tr>
723786 </tbody>
724787 </table></div>
725 <p class="since">Since 0.11.UNRELEASED</p>
788 <p class="since">Since 0.11.12</p>
726789 </div>
727790 </div>
728791 </div>
234234 <p>
235235 </p>
236236 <div class="example">
237 <a name="id600487"></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="id552154"></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>
238238 <div class="example-contents">
239239 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
240240 <tbody>
546546 <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> *key</code></em>);</pre>
547547 <p>
548548 If a value for <em class="parameter"><code>key</code></em> in <em class="parameter"><code>asv</code></em> is present and is an array of bytes
549 (its GType is <code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code>), return it.
549 (its GType is <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UCHAR-ARRAY:CAPS"><code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code></a>), return it.
550550 </p>
551551 <p>
552552 Otherwise return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
182182 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *filter</code></em>);</pre>
183183 <p>
184184 Register a new channel class as Observer.ObserverChannelFilter.
185 The <em class="parameter"><code>observe_channels</code></em> virtual method set up using
186 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-observe-channels" title="tp_base_client_implement_observe_channels ()"><code class="function">tp_base_client_implement_observe_channels()</code></a> will be called whenever
187 a new channel's properties match the ones in <em class="parameter"><code>filter</code></em>.
185 The <span class="type">TpBaseClientClass.observe_channels</span> virtual method will be called
186 whenever a new channel's properties match the ones in <em class="parameter"><code>filter</code></em>.
188187 </p>
189188 <p>
190189 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
191 called, and may only be called on objects whose class has called
192 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-observe-channels" title="tp_base_client_implement_observe_channels ()"><code class="function">tp_base_client_implement_observe_channels()</code></a>.
190 called, and may only be called on objects whose class implements
191 <span class="type">TpBaseClientClass.observe_channels</span>.
193192 </p>
194193 <div class="variablelist"><table border="0">
195194 <col align="left" valign="top">
286285 </p>
287286 <p>
288287 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
289 called, and may only be called on objects whose class has called
290 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-observe-channels" title="tp_base_client_implement_observe_channels ()"><code class="function">tp_base_client_implement_observe_channels()</code></a>.
288 called, and may only be called on objects whose class implements
289 <span class="type">TpBaseClientClass.observe_channels</span>.
291290 </p>
292291 <div class="variablelist"><table border="0">
293292 <col align="left" valign="top">
383382 Called by subclasses to define the actual implementation of the
384383 <code class="function">ObserveChannels()</code> D-Bus method.
385384 </p>
385 <p>
386 Since 0.11.UNRELEASED this is exactly equivalent to setting the
387 <span class="type">TpBaseClientClass.observe_channels</span> function pointer.
388 </p>
386389 <div class="variablelist"><table border="0">
387390 <col align="left" valign="top">
388391 <tbody>
408411 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *filter</code></em>);</pre>
409412 <p>
410413 Register a new channel class as Approver.ApproverChannelFilter.
411 The <em class="parameter"><code>add_dispatch_operation</code></em> virtual method set up using
412 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-add-dispatch-operation" title="tp_base_client_implement_add_dispatch_operation ()"><code class="function">tp_base_client_implement_add_dispatch_operation()</code></a> will be called whenever
413 a new channel's properties match the ones in <em class="parameter"><code>filter</code></em>.
414 The <span class="type">TpBaseClientClass.add_dispatch_operation</span> virtual method will be called
415 whenever a new channel's properties match the ones in <em class="parameter"><code>filter</code></em>.
414416 </p>
415417 <p>
416418 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
417 called, and may only be called on objects whose class has called
418 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-add-dispatch-operation" title="tp_base_client_implement_add_dispatch_operation ()"><code class="function">tp_base_client_implement_add_dispatch_operation()</code></a>.
419 called, and may only be called on objects whose class implements
420 <span class="type">TpBaseClientClass.add_dispatch_operation</span>.
419421 </p>
420422 <div class="variablelist"><table border="0">
421423 <col align="left" valign="top">
564566 Called by subclasses to define the actual implementation of the
565567 <code class="function">AddDispatchOperation()</code> D-Bus method.
566568 </p>
569 <p>
570 Since 0.11.UNRELEASED this is exactly equivalent to setting the
571 <span class="type">TpBaseClientClass.add_dispatch_operation</span> function pointer.
572 </p>
567573 <div class="variablelist"><table border="0">
568574 <col align="left" valign="top">
569575 <tbody>
596602 </p>
597603 <p>
598604 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
599 called, and may only be called on objects whose class has called
600 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
605 called, and may only be called on objects whose class implements
606 <span class="type">TpBaseClientClass.handle_channels</span>.
601607 </p>
602608 <div class="variablelist"><table border="0">
603609 <col align="left" valign="top">
631637 </p>
632638 <p>
633639 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
634 called, and may only be called on objects whose class has called
635 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
640 called, and may only be called on objects whose class implements
641 <span class="type">TpBaseClientClass.handle_channels</span>.
636642 </p>
637643 <div class="variablelist"><table border="0">
638644 <col align="left" valign="top">
669675 </p>
670676 <p>
671677 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
672 called, and may only be called on objects whose class has called
673 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
678 called, and may only be called on objects whose class implements
679 <span class="type">TpBaseClientClass.handle_channels</span>.
674680 </p>
675681 <div class="variablelist"><table border="0">
676682 <col align="left" valign="top">
698704 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *filter</code></em>);</pre>
699705 <p>
700706 Register a new channel class as Handler.HandlerChannelFilter.
701 The <em class="parameter"><code>handle_channels</code></em> virtual method set up using
702 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a> will be called whenever
703 a new channel's properties match the ones in <em class="parameter"><code>filter</code></em>.
707 The <span class="type">TpBaseClientClass.handle_channels</span> virtual method will be called
708 whenever a new channel's properties match the ones in <em class="parameter"><code>filter</code></em>.
704709 </p>
705710 <p>
706711 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
707 called, and may only be called on objects whose class has called
708 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
712 called, and may only be called on objects whose class implements
713 <span class="type">TpBaseClientClass.handle_channels</span>.
709714 </p>
710715 <div class="variablelist"><table border="0">
711716 <col align="left" valign="top">
737742 <p>
738743 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
739744 called, and may only be called on objects whose class has called
740 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
745 <span class="type">TpBaseClientClass.handle_channels</span>.
741746 </p>
742747 <div class="variablelist"><table border="0">
743748 <col align="left" valign="top">
802807 </tr>
803808 <tr>
804809 <td><p><span class="term"><em class="parameter"><code>user_action_time</code></em> :</span></p></td>
805 <td>the time at which user action occurred, or 0 if this
806 channel is to be handled for some reason not involving user action.
810 <td>the time at which user action occurred, or one of the
811 special values <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> or
812 <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>
813 (see <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a> for details)
807814 </td>
808815 </tr>
809816 <tr>
826833 Called by subclasses to define the actual implementation of the
827834 <code class="function">HandleChannels()</code> D-Bus method.
828835 </p>
836 <p>
837 Since 0.11.UNRELEASED this is exactly equivalent to setting the
838 <span class="type">TpBaseClientClass.handle_channels</span> function pointer.
839 </p>
829840 <div class="variablelist"><table border="0">
830841 <col align="left" valign="top">
831842 <tbody>
911922 </p>
912923 <p>
913924 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
914 called, and may only be called on objects whose class has called
915 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
925 called, and may only be called on objects whose class implements
926 <span class="type">TpBaseClientClass.handle_channels</span>.
916927 </p>
917928 <div class="variablelist"><table border="0">
918929 <col align="left" valign="top">
945956 </p>
946957 <p>
947958 This method may only be called before <a class="link" href="telepathy-glib-base-client.html#tp-base-client-register" title="tp_base_client_register ()"><code class="function">tp_base_client_register()</code></a> is
948 called, and may only be called on objects whose class has called
949 <a class="link" href="telepathy-glib-base-client.html#tp-base-client-implement-handle-channels" title="tp_base_client_implement_handle_channels ()"><code class="function">tp_base_client_implement_handle_channels()</code></a>.
959 called, and may only be called on objects whose class implements
960 <span class="type">TpBaseClientClass.handle_channels</span>.
950961 </p>
951962 <div class="variablelist"><table border="0">
952963 <col align="left" valign="top">
143143 <span class="returnvalue">void</span> <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-handle-with-time-async" title="tp_channel_dispatch_operation_handle_with_time_async ()">tp_channel_dispatch_operation_handle_with_time_async</a>
144144 (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>,
145145 <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> *handler</code></em>,
146 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> user_action_timestamp</code></em>,
146 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> user_action_time</code></em>,
147147 <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>,
148148 <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>);
149149 <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-channel-dispatch-operation.html#tp-channel-dispatch-operation-handle-with-time-finish" title="tp_channel_dispatch_operation_handle_with_time_finish ()">tp_channel_dispatch_operation_handle_with_time_finish</a>
11571157 <pre class="programlisting"><span class="returnvalue">void</span> tp_channel_dispatch_operation_handle_with_time_async
11581158 (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>,
11591159 <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> *handler</code></em>,
1160 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> user_action_timestamp</code></em>,
1160 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> user_action_time</code></em>,
11611161 <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>,
11621162 <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>
11631163 <p>
11671167 </p>
11681168 <p>
11691169 If an X server timestamp for the user action causing this method call is
1170 available, <em class="parameter"><code>user_action_timestamp</code></em> should be this timestamp (for instance, the
1170 available, <em class="parameter"><code>user_action_time</code></em> should be this timestamp (for instance, the
11711171 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
1172 may be 0 to behave as if there was no user action or it happened a long time
1173 ago, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Limits-of-Basic-Types.html#G-MAXINT64:CAPS"><code class="literal">G_MAXINT64</code></a> to have the Handler behave as though the user action had
1174 just happened (resembling, but not numerically equal to, <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>).
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 user action or it happened a long time ago, or
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 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>).
11751177 </p>
11761178 <p>
11771179 This method has been introduced in telepathy-mission-control 5.5.0.
11921194 </td>
11931195 </tr>
11941196 <tr>
1195 <td><p><span class="term"><em class="parameter"><code>user_action_timestamp</code></em> :</span></p></td>
1196 <td>the time at which user action occurred
1197 <td><p><span class="term"><em class="parameter"><code>user_action_time</code></em> :</span></p></td>
1198 <td>the time at which user action occurred, or one of the
1199 special values <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> or
1200 <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>
11971201 </td>
11981202 </tr>
11991203 <tr>
148148 </p>
149149 <p>
150150 On failure, the <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a> signal will be emitted with some
151 other suitable error, usually from the <a class="link" href="telepathy-glib-errors.html#TP-ERRORS:CAPS" title="TP_ERRORS"><code class="literal">TP_ERRORS</code></a> domain.
151 other suitable error, usually from the <a href="/usr/share/gtk-doc/html/telepathy-glib/telepathy-glib-errors.html#TP-ERRORS:CAPS"><code class="literal">TP_ERRORS</code></a> domain.
152152 </p>
153153 <p>
154154 If the channel dispatcher crashes or exits, the <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a>
481481 <em class="parameter"><code>contacts</code></em> will contain contact objects for those IDs that were
482482 valid (it may be empty), and <em class="parameter"><code>failed_id_errors</code></em> will map the IDs
483483 that were not valid to a corresponding <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> (if the connection manager
484 complies with the Telepathy spec, it will have domain <a class="link" href="telepathy-glib-errors.html#TP-ERRORS:CAPS" title="TP_ERRORS"><code class="literal">TP_ERRORS</code></a> and code
484 complies with the Telepathy spec, it will have domain <a href="/usr/share/gtk-doc/html/telepathy-glib/telepathy-glib-errors.html#TP-ERRORS:CAPS"><code class="literal">TP_ERRORS</code></a> and code
485485 <a class="link" href="telepathy-glib-errors.html#TP-ERROR-INVALID-HANDLE:CAPS"><code class="literal">TP_ERROR_INVALID_HANDLE</code></a>).
486486 </p>
487487 <p>
786786 </tr>
787787 <tr>
788788 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
789 <td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code> whose value is a copy
789 <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-UCHAR-ARRAY:CAPS"><code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code></a> whose value is a copy
790790 of <em class="parameter"><code>length</code></em> bytes from <em class="parameter"><code>bytes</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
791791 <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a>
792792
816816 </tr>
817817 <tr>
818818 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
819 <td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code> whose value is
819 <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-UCHAR-ARRAY:CAPS"><code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code></a> whose value is
820820 <em class="parameter"><code>bytes</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
821821 <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a>
822822
845845 </tr>
846846 <tr>
847847 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
848 <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-related-functions.html#DBUS-TYPE-G-OBJECT-PATH--CAPS"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a> whose value is a copy
848 <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
849849 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>
850850
851851 </td>
874874 </tr>
875875 <tr>
876876 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
877 <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-related-functions.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>,
877 <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>,
878878 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>
879879
880880 </td>
905905 </tr>
906906 <tr>
907907 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
908 <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-related-functions.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>,
908 <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>,
909909 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>
910910
911911 </td>
5151 #define <a class="link" href="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS" title="TP_CHANNEL_DISPATCHER_OBJECT_PATH">TP_CHANNEL_DISPATCHER_OBJECT_PATH</a>
5252 #define <a class="link" href="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS" title="TP_CLIENT_BUS_NAME_BASE">TP_CLIENT_BUS_NAME_BASE</a>
5353 #define <a class="link" href="telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE:CAPS" title="TP_CLIENT_OBJECT_PATH_BASE">TP_CLIENT_OBJECT_PATH_BASE</a>
54 #define <a class="link" href="telepathy-glib-defs.html#TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS" title="TP_USER_ACTION_TIME_NOT_USER_ACTION">TP_USER_ACTION_TIME_NOT_USER_ACTION</a>
55 #define <a class="link" href="telepathy-glib-defs.html#TP-USER-ACTION-TIME-CURRENT-TIME:CAPS" title="TP_USER_ACTION_TIME_CURRENT_TIME">TP_USER_ACTION_TIME_CURRENT_TIME</a>
5456 </pre>
5557 </div>
5658 <div class="refsect1" title="Description">
170172 The common prefix of the well-known object path for any Telepathy Client.
171173 </p>
172174 </div>
175 <hr>
176 <div class="refsect2" title="TP_USER_ACTION_TIME_NOT_USER_ACTION">
177 <a name="TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS"></a><h3>TP_USER_ACTION_TIME_NOT_USER_ACTION</h3>
178 <pre class="programlisting">#define TP_USER_ACTION_TIME_NOT_USER_ACTION (G_GINT64_CONSTANT (0))
179 </pre>
180 <p>
181 The "user action time" used by methods like
182 <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 are
183 not a result of user action.
184 </p>
185 <p>
186 See also <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a>,
187 <a class="link" href="telepathy-glib-util.html#tp-user-action-time-from-x11" title="tp_user_action_time_from_x11 ()"><code class="function">tp_user_action_time_from_x11()</code></a>, <a class="link" href="telepathy-glib-util.html#tp-user-action-time-should-present" title="tp_user_action_time_should_present ()"><code class="function">tp_user_action_time_should_present()</code></a> and
188 <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>.
189 </p>
190 <p class="since">Since 0.11.UNRELEASED</p>
191 </div>
192 <hr>
193 <div class="refsect2" title="TP_USER_ACTION_TIME_CURRENT_TIME">
194 <a name="TP-USER-ACTION-TIME-CURRENT-TIME:CAPS"></a><h3>TP_USER_ACTION_TIME_CURRENT_TIME</h3>
195 <pre class="programlisting">#define TP_USER_ACTION_TIME_CURRENT_TIME (G_MAXINT64)
196 </pre>
197 <p>
198 The "user action time" used by methods like
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 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
202 in Telepathy is not the same).
203 </p>
204 <p>
205 See also <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a>,
206 <a class="link" href="telepathy-glib-util.html#tp-user-action-time-from-x11" title="tp_user_action_time_from_x11 ()"><code class="function">tp_user_action_time_from_x11()</code></a>, <a class="link" href="telepathy-glib-util.html#tp-user-action-time-should-present" title="tp_user_action_time_should_present ()"><code class="function">tp_user_action_time_should_present()</code></a> and
207 <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>.
208 </p>
209 <p class="since">Since 0.11.UNRELEASED</p>
210 </div>
173211 </div>
174212 </div>
175213 <div class="footer">
4141 #include &lt;telepathy-glib/errors.h&gt;
4242
4343 #define <a class="link" href="telepathy-glib-errors.html#TP-ERROR-PREFIX:CAPS" title="TP_ERROR_PREFIX">TP_ERROR_PREFIX</a>
44 #define <a class="link" href="telepathy-glib-errors.html#TP-ERRORS:CAPS" title="TP_ERRORS">TP_ERRORS</a>
44 #define <a class="link" href="telepathy-glib-errors.html#TP-ERROR:CAPS" title="TP_ERROR">TP_ERROR</a>
4545 #define <a class="link" href="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS" title="TP_TYPE_ERROR">TP_TYPE_ERROR</a>
4646 enum <a class="link" href="telepathy-glib-errors.html#TpError" title="enum TpError">TpError</a>;
4747 <span class="returnvalue">void</span> <a class="link" href="telepathy-glib-errors.html#tp-g-set-error-invalid-handle-type" title="tp_g_set_error_invalid_handle_type ()">tp_g_set_error_invalid_handle_type</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> type</code></em>,
118118 <p class="since">Since 0.7.1</p>
119119 </div>
120120 <hr>
121 <div class="refsect2" title="TP_ERRORS">
122 <a name="TP-ERRORS:CAPS"></a><h3>TP_ERRORS</h3>
123 <pre class="programlisting">#define TP_ERRORS (tp_errors_quark ())
121 <div class="refsect2" title="TP_ERROR">
122 <a name="TP-ERROR:CAPS"></a><h3>TP_ERROR</h3>
123 <pre class="programlisting">#define TP_ERROR (tp_error_quark ())
124124 </pre>
125125 <p>
126126 The error domain for the D-Bus errors described in the Telepathy
133133 dbus-glib for server-side use (using <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGError.html#dbus-g-error-domain-register"><code class="function">dbus_g_error_domain_register()</code></a>) when
134134 called.
135135 </p>
136 <p>
137 This used to be called <a href="/usr/share/gtk-doc/html/telepathy-glib/telepathy-glib-errors.html#TP-ERRORS:CAPS"><code class="literal">TP_ERRORS</code></a>. To be compatible with telepathy-glib
138 0.10.x, use <a href="/usr/share/gtk-doc/html/telepathy-glib/telepathy-glib-errors.html#TP-ERRORS:CAPS"><code class="literal">TP_ERRORS</code></a>.
139 </p>
140 <p class="since">Since 0.11.7</p>
136141 </div>
137142 <hr>
138143 <div class="refsect2" title="TP_TYPE_ERROR">
475480 <td>org.freedesktop.Telepathy.Error.Cert.Revoked:
476481 Raised if the server provided an SSL/TLS certificate that has been
477482 revoked.
478 Since: 0.11.UNRELEASED
483 Since: 0.11.12
479484 </td>
480485 </tr>
481486 <tr>
483488 <td>org.freedesktop.Telepathy.Error.Cert.Insecure:
484489 Raised if the server provided an SSL/TLS certificate that uses an
485490 insecure cipher algorithm or is cryptographically weak.
486 Since: 0.11.UNRELEASED
491 Since: 0.11.12
487492 </td>
488493 </tr>
489494 <tr>
492497 Raised if the length in bytes of the server certificate, or the depth
493498 of the server certificate chain, exceed the limits imposed by the
494499 crypto library.
495 Since: 0.11.UNRELEASED
500 Since: 0.11.12
496501 </td>
497502 </tr>
498503 </tbody>
220220 <p>
221221 Expands to a call to a function
222222 that returns the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a>
223 of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a>, i.e. the same thing as <code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code>
223 of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><code class="literal">G_TYPE_UCHAR</code></a>, i.e. the same thing as <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UCHAR-ARRAY:CAPS"><code class="literal">DBUS_TYPE_G_UCHAR_ARRAY</code></a>
224224 </p>
225225 <p class="since">Since 0.11.1</p>
226226 </div>
248248 <a name="TpHandleChannelsContext--user-action-time"></a><h3>The <code class="literal">"user-action-time"</code> property</h3>
249249 <pre class="programlisting"> "user-action-time" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> : Read / Write / Construct Only</pre>
250250 <p>
251 The User_Action_Time that have been passed to HandleChannels.
252 Read-only except during construction.
253 </p>
254 <p>
255 If 0, the action doesn't involve any user action. Clients
256 SHOULD avoid stealing focus when presenting the channel.
257 </p>
258 <p>
259 If <a href="http://library.gnome.org/devel/glib/unstable/glib-Limits-of-Basic-Types.html#G-MAXINT64:CAPS"><span class="type">G_MAXINT64</span></a>: clients SHOULD behave as though the user
260 action happened at the current time, e.g. a client MAY
261 request that its window gains focus.
251 The time at which user action occurred, or one of the
252 special values <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> or
253 <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>
254 (see <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a> for details)
255 </p>
256 <p>
257 Read-only except during construction.
262258 </p>
263259 <p>Allowed values: &gt;= 0</p>
264260 <p>Default value: 0</p>
383383 <td class="listing_code"><pre class="programlisting">TpChannel <span class="symbol">*</span>channel <span class="symbol">= ...;</span>
384384 GQuark features<span class="symbol">[] = {</span> TP_CHANNEL_FEATURE_CORE<span class="symbol">,</span> <span class="number">0</span> <span class="symbol">};</span>
385385
386 <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> NULL<span class="symbol">,</span> callback<span class="symbol">,</span> user_data<span class="symbol">);</span></pre></td>
386 <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>
387387 </tr>
388388 </tbody>
389389 </table>
228228 </tr>
229229 <tr>
230230 <td><p><span class="term"><em class="parameter"><code>user_action_time</code></em> :</span></p></td>
231 <td>the time at which user action occurred, or 0 if this
232 channel is to be handled for some reason not involving user action.
231 <td>the time at which user action occurred, or one of the
232 special values <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> or
233 <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>
234 (see <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time" title='The "user-action-time" property'><span class="type">"user-action-time"</span></a> for details)
233235 </td>
234236 </tr>
235237 <tr>
115115 <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>,
116116 <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>,
117117 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> source_tag</code></em>);
118 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a> <a class="link" href="telepathy-glib-util.html#tp-user-action-time-from-x11" title="tp_user_action_time_from_x11 ()">tp_user_action_time_from_x11</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> x11_time</code></em>);
119 <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-util.html#tp-user-action-time-should-present" title="tp_user_action_time_should_present ()">tp_user_action_time_should_present</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> user_action_time</code></em>,
120 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *x11_time</code></em>);
118121 </pre>
119122 </div>
120123 <div class="refsect1" title="Description">
11461149 <p>
11471150 </p>
11481151 <div class="example">
1149 <a name="id1138178"></a><p class="title"><b>Example 2.  using tp_value_array_build</b></p>
1152 <a name="id1091054"></a><p class="title"><b>Example 2.  using tp_value_array_build</b></p>
11501153 <div class="example-contents">
11511154 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
11521155 <tbody>
12121215 <p>
12131216 </p>
12141217 <div class="example">
1215 <a name="id1138357"></a><p class="title"><b>Example 3. using tp_value_array_unpack</b></p>
1218 <a name="id1091233"></a><p class="title"><b>Example 3. using tp_value_array_unpack</b></p>
12161219 <div class="example-contents">
12171220 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
12181221 <tbody>
15771580 </table></div>
15781581 <p class="since">Since 0.11.9</p>
15791582 </div>
1583 <hr>
1584 <div class="refsect2" title="tp_user_action_time_from_x11 ()">
1585 <a name="tp-user-action-time-from-x11"></a><h3>tp_user_action_time_from_x11 ()</h3>
1586 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a> tp_user_action_time_from_x11 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> x11_time</code></em>);</pre>
1587 <p>
1588 Convert an X11 timestamp into a user action time as used in Telepathy.
1589 </p>
1590 <p>
1591 This also works for the timestamps used by Gdk 2.x and Clutter 1.0;
1592 it may or may not work with other toolkits or versions.
1593 </p>
1594 <div class="variablelist"><table border="0">
1595 <col align="left" valign="top">
1596 <tbody>
1597 <tr>
1598 <td><p><span class="term"><em class="parameter"><code>x11_time</code></em> :</span></p></td>
1599 <td>an X11 timestamp, or 0 to indicate the current time
1600 </td>
1601 </tr>
1602 <tr>
1603 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1604 <td> a nonzero Telepathy user action time, or
1605 <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>
1606 </td>
1607 </tr>
1608 </tbody>
1609 </table></div>
1610 </div>
1611 <hr>
1612 <div class="refsect2" title="tp_user_action_time_should_present ()">
1613 <a name="tp-user-action-time-should-present"></a><h3>tp_user_action_time_should_present ()</h3>
1614 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_user_action_time_should_present (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> user_action_time</code></em>,
1615 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *x11_time</code></em>);</pre>
1616 <p>
1617 Interpret a Telepathy user action time to decide whether a Handler should
1618 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
1619 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.
1620 </p>
1621 <p>
1622 <em class="parameter"><code>x11_time</code></em> is used to return a timestamp in the right format for X11,
1623 Gdk 2.x and Clutter 1.0; it may or may not work with other toolkits or
1624 versions.
1625 </p>
1626 <div class="variablelist"><table border="0">
1627 <col align="left" valign="top">
1628 <tbody>
1629 <tr>
1630 <td><p><span class="term"><em class="parameter"><code>user_action_time</code></em> :</span></p></td>
1631 <td> the Telepathy user action time. <span class="annotation">[type gint64]</span>
1632 </td>
1633 </tr>
1634 <tr>
1635 <td><p><span class="term"><em class="parameter"><code>x11_time</code></em> :</span></p></td>
1636 <td> a pointer to guint32 used to
1637 return an X11 timestamp, or 0 to indicate the current time; if
1638 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, the value placed here is not meaningful. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1639 </td>
1640 </tr>
1641 <tr>
1642 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1643 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if it would be appropriate to present a window
1644 </td>
1645 </tr>
1646 </tbody>
1647 </table></div>
1648 </div>
15801649 </div>
15811650 </div>
15821651 <div class="footer">
325325 <function name="TP_CHANNEL_DISPATCHER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS"/>
326326 <function name="TP_CLIENT_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS"/>
327327 <function name="TP_CLIENT_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE:CAPS"/>
328 <function name="TP_USER_ACTION_TIME_NOT_USER_ACTION" link="telepathy-glib-defs.html#TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS"/>
329 <function name="TP_USER_ACTION_TIME_CURRENT_TIME" link="telepathy-glib-defs.html#TP-USER-ACTION-TIME-CURRENT-TIME:CAPS"/>
328330 <function name="TpHandle" link="telepathy-glib-handle.html#TpHandle"/>
329331 <function name="TP_TYPE_HANDLE" link="telepathy-glib-handle.html#TP-TYPE-HANDLE:CAPS"/>
330332 <function name="TP_UNKNOWN_HANDLE_TYPE" link="telepathy-glib-handle.html#TP-UNKNOWN-HANDLE-TYPE:CAPS"/>
683685 <function name="enum TpAnonymityModeFlags" link="telepathy-glib-enums.html#TpAnonymityModeFlags"/>
684686 <function name="enum TpStorageRestrictionFlags" link="telepathy-glib-enums.html#TpStorageRestrictionFlags"/>
685687 <function name="TP_ERROR_PREFIX" link="telepathy-glib-errors.html#TP-ERROR-PREFIX:CAPS"/>
686 <function name="TP_ERRORS" link="telepathy-glib-errors.html#TP-ERRORS:CAPS"/>
688 <function name="TP_ERROR" link="telepathy-glib-errors.html#TP-ERROR:CAPS"/>
687689 <function name="TP_TYPE_ERROR" link="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"/>
688690 <function name="enum TpError" link="telepathy-glib-errors.html#TpError"/>
689691 <function name="tp_g_set_error_invalid_handle_type ()" link="telepathy-glib-errors.html#tp-g-set-error-invalid-handle-type"/>
29762978 <function name="tp_clear_object()" link="telepathy-glib-util.html#tp-clear-object"/>
29772979 <function name="tp_clear_boxed()" link="telepathy-glib-util.html#tp-clear-boxed"/>
29782980 <function name="tp_simple_async_report_success_in_idle ()" link="telepathy-glib-util.html#tp-simple-async-report-success-in-idle"/>
2981 <function name="tp_user_action_time_from_x11 ()" link="telepathy-glib-util.html#tp-user-action-time-from-x11"/>
2982 <function name="tp_user_action_time_should_present ()" link="telepathy-glib-util.html#tp-user-action-time-should-present"/>
29792983 <function name="tp_g_socket_address_from_variant ()" link="telepathy-glib-gnio-util.html#tp-g-socket-address-from-variant"/>
29802984 <function name="tp_address_variant_from_g_socket_address ()" link="telepathy-glib-gnio-util.html#tp-address-variant-from-g-socket-address"/>
29812985 <function name="TP_ANSI_RESET" link="telepathy-glib-debug-ansi.html#TP-ANSI-RESET:CAPS"/>
325325 <keyword type="macro" name="TP_CHANNEL_DISPATCHER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS"/>
326326 <keyword type="macro" name="TP_CLIENT_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS"/>
327327 <keyword type="macro" name="TP_CLIENT_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE:CAPS"/>
328 <keyword type="macro" name="TP_USER_ACTION_TIME_NOT_USER_ACTION" link="telepathy-glib-defs.html#TP-USER-ACTION-TIME-NOT-USER-ACTION:CAPS" since="0.11.UNRELEASED"/>
329 <keyword type="macro" name="TP_USER_ACTION_TIME_CURRENT_TIME" link="telepathy-glib-defs.html#TP-USER-ACTION-TIME-CURRENT-TIME:CAPS" since="0.11.UNRELEASED"/>
328330 <keyword type="typedef" name="TpHandle" link="telepathy-glib-handle.html#TpHandle"/>
329331 <keyword type="macro" name="TP_TYPE_HANDLE" link="telepathy-glib-handle.html#TP-TYPE-HANDLE:CAPS"/>
330332 <keyword type="macro" name="TP_UNKNOWN_HANDLE_TYPE" link="telepathy-glib-handle.html#TP-UNKNOWN-HANDLE-TYPE:CAPS" since="0.7.0"/>
683685 <keyword type="enum" name="enum TpAnonymityModeFlags" link="telepathy-glib-enums.html#TpAnonymityModeFlags"/>
684686 <keyword type="enum" name="enum TpStorageRestrictionFlags" link="telepathy-glib-enums.html#TpStorageRestrictionFlags"/>
685687 <keyword type="macro" name="TP_ERROR_PREFIX" link="telepathy-glib-errors.html#TP-ERROR-PREFIX:CAPS" since="0.7.1"/>
686 <keyword type="macro" name="TP_ERRORS" link="telepathy-glib-errors.html#TP-ERRORS:CAPS"/>
688 <keyword type="macro" name="TP_ERROR" link="telepathy-glib-errors.html#TP-ERROR:CAPS" since="0.11.7"/>
687689 <keyword type="macro" name="TP_TYPE_ERROR" link="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"/>
688690 <keyword type="enum" name="enum TpError" link="telepathy-glib-errors.html#TpError"/>
689691 <keyword type="function" name="tp_g_set_error_invalid_handle_type ()" link="telepathy-glib-errors.html#tp-g-set-error-invalid-handle-type"/>
17641766 <keyword type="function" name="tp_cli_client_approver_callback_for_add_dispatch_operation ()" link="telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation"/>
17651767 <keyword type="function" name="tp_cli_client_approver_call_add_dispatch_operation ()" link="telepathy-glib-client.html#tp-cli-client-approver-call-add-dispatch-operation"/>
17661768 <keyword type="struct" name="TpAccountChannelRequest" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest-struct"/>
1767 <keyword type="function" name="tp_account_channel_request_new ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-new" since="0.11.UNRELEASED"/>
1768 <keyword type="function" name="tp_account_channel_request_get_request ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-get-request" since="0.11.UNRELEASED"/>
1769 <keyword type="function" name="tp_account_channel_request_get_user_action_time ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-get-user-action-time" since="0.11.UNRELEASED"/>
1770 <keyword type="function" name="tp_account_channel_request_get_account ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-get-account" since="0.11.UNRELEASED"/>
1771 <keyword type="function" name="tp_account_channel_request_create_and_handle_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-async" since="0.11.UNRELEASED"/>
1772 <keyword type="function" name="tp_account_channel_request_create_and_handle_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-finish" since="0.11.UNRELEASED"/>
1773 <keyword type="function" name="tp_account_channel_request_ensure_and_handle_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-and-handle-channel-async" since="0.11.UNRELEASED"/>
1774 <keyword type="function" name="tp_account_channel_request_ensure_and_handle_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-and-handle-channel-finish" since="0.11.UNRELEASED"/>
1775 <keyword type="function" name="tp_account_channel_request_create_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-channel-async" since="0.11.UNRELEASED"/>
1776 <keyword type="function" name="tp_account_channel_request_create_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-channel-finish" since="0.11.UNRELEASED"/>
1777 <keyword type="function" name="tp_account_channel_request_ensure_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-channel-async" since="0.11.UNRELEASED"/>
1778 <keyword type="function" name="tp_account_channel_request_ensure_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-channel-finish" since="0.11.UNRELEASED"/>
1769 <keyword type="function" name="tp_account_channel_request_new ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-new" since="0.11.12"/>
1770 <keyword type="function" name="tp_account_channel_request_get_request ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-get-request" since="0.11.12"/>
1771 <keyword type="function" name="tp_account_channel_request_get_user_action_time ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-get-user-action-time" since="0.11.12"/>
1772 <keyword type="function" name="tp_account_channel_request_get_account ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-get-account" since="0.11.12"/>
1773 <keyword type="function" name="tp_account_channel_request_create_and_handle_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-async" since="0.11.12"/>
1774 <keyword type="function" name="tp_account_channel_request_create_and_handle_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-finish" since="0.11.12"/>
1775 <keyword type="function" name="tp_account_channel_request_ensure_and_handle_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-and-handle-channel-async" since="0.11.12"/>
1776 <keyword type="function" name="tp_account_channel_request_ensure_and_handle_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-and-handle-channel-finish" since="0.11.12"/>
1777 <keyword type="function" name="tp_account_channel_request_create_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-channel-async" since="0.11.12"/>
1778 <keyword type="function" name="tp_account_channel_request_create_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-channel-finish" since="0.11.12"/>
1779 <keyword type="function" name="tp_account_channel_request_ensure_channel_async ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-channel-async" since="0.11.12"/>
1780 <keyword type="function" name="tp_account_channel_request_ensure_channel_finish ()" link="telepathy-glib-account-channel-request.html#tp-account-channel-request-ensure-channel-finish" since="0.11.12"/>
17791781 <keyword type="property" name="The &quot;account&quot; property" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--account"/>
17801782 <keyword type="property" name="The &quot;request&quot; property" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--request"/>
17811783 <keyword type="property" name="The &quot;user-action-time&quot; property" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time"/>
29762978 <keyword type="macro" name="tp_clear_object()" link="telepathy-glib-util.html#tp-clear-object" since="0.11.7"/>
29772979 <keyword type="macro" name="tp_clear_boxed()" link="telepathy-glib-util.html#tp-clear-boxed" since="0.11.7"/>
29782980 <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"/>
2981 <keyword type="function" name="tp_user_action_time_from_x11 ()" link="telepathy-glib-util.html#tp-user-action-time-from-x11"/>
2982 <keyword type="function" name="tp_user_action_time_should_present ()" link="telepathy-glib-util.html#tp-user-action-time-should-present"/>
29792983 <keyword type="function" name="tp_g_socket_address_from_variant ()" link="telepathy-glib-gnio-util.html#tp-g-socket-address-from-variant"/>
29802984 <keyword type="function" name="tp_address_variant_from_g_socket_address ()" link="telepathy-glib-gnio-util.html#tp-address-variant-from-g-socket-address"/>
29812985 <keyword type="macro" name="TP_ANSI_RESET" link="telepathy-glib-debug-ansi.html#TP-ANSI-RESET:CAPS"/>
2828 TP_CHANNEL_DISPATCHER_OBJECT_PATH
2929 TP_CLIENT_BUS_NAME_BASE
3030 TP_CLIENT_OBJECT_PATH_BASE
31 TP_USER_ACTION_TIME_NOT_USER_ACTION
32 TP_USER_ACTION_TIME_CURRENT_TIME
3133 </SECTION>
3234
3335 <SECTION>
12051207 tp_clear_object
12061208 tp_clear_boxed
12071209 tp_simple_async_report_success_in_idle
1210 tp_user_action_time_from_x11
1211 tp_user_action_time_should_present
12081212 </SECTION>
12091213
12101214 <SECTION>
18981902 <INCLUDE>telepathy-glib/errors.h</INCLUDE>
18991903 <FILE>errors</FILE>
19001904 TP_ERROR_PREFIX
1901 TP_ERRORS
1905 TP_ERROR
19021906 TP_TYPE_ERROR
19031907 TpError
19041908 tp_g_set_error_invalid_handle_type
19491953 <SUBSECTION Standard>
19501954 tp_error_get_type
19511955 tp_errors_quark
1956 tp_error_quark
19521957 <SUBSECTION Private>
1953 TP_ERROR
1958 TP_ERRORS
19541959 </SECTION>
19551960
19561961 <SECTION>
88
99 </para>
1010
11
1211 <!-- ##### SECTION See_Also ##### -->
1312 <para>
1413
1514 </para>
16
1715
1816 <!-- ##### SECTION Stability_Level ##### -->
1917
3636 </para>
3737
3838 @parent_class:
39 @get_contacts:
40 @get_states:
39 @dup_contacts:
40 @dup_states:
4141 @get_contact_list_persists:
4242
4343 <!-- ##### FUNCTION tp_base_contact_list_mixin_class_init ##### -->
165165 @Returns:
166166
167167
168 <!-- ##### USER_FUNCTION TpBaseContactListGetContactsFunc ##### -->
169 <para>
170
171 </para>
172
173 @self:
174 @Returns:
175
176
177 <!-- ##### FUNCTION tp_base_contact_list_get_contacts ##### -->
178 <para>
179
180 </para>
181
182 @self:
183 @Returns:
184
185
186 <!-- ##### USER_FUNCTION TpBaseContactListGetStatesFunc ##### -->
168 <!-- ##### USER_FUNCTION TpBaseContactListDupContactsFunc ##### -->
169 <para>
170
171 </para>
172
173 @self:
174 @Returns:
175
176
177 <!-- ##### FUNCTION tp_base_contact_list_dup_contacts ##### -->
178 <para>
179
180 </para>
181
182 @self:
183 @Returns:
184
185
186 <!-- ##### USER_FUNCTION TpBaseContactListDupStatesFunc ##### -->
187187 <para>
188188
189189 </para>
195195 @publish_request:
196196
197197
198 <!-- ##### FUNCTION tp_base_contact_list_get_states ##### -->
198 <!-- ##### FUNCTION tp_base_contact_list_dup_states ##### -->
199199 <para>
200200
201201 </para>
442442 </para>
443443
444444 @parent:
445 @get_groups:
446 @get_group_members:
447 @get_contact_groups:
445 @dup_groups:
446 @dup_group_members:
447 @dup_contact_groups:
448448 @has_disjoint_groups:
449449 @normalize_group:
450450
468468 @Returns:
469469
470470
471 <!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### -->
471 <!-- ##### USER_FUNCTION TpBaseContactListDupContactGroupsFunc ##### -->
472472 <para>
473473
474474 </para>
478478 @Returns:
479479
480480
481 <!-- ##### FUNCTION tp_base_contact_list_get_contact_groups ##### -->
481 <!-- ##### FUNCTION tp_base_contact_list_dup_contact_groups ##### -->
482482 <para>
483483
484484 </para>
488488 @Returns:
489489
490490
491 <!-- ##### USER_FUNCTION TpBaseContactListGetGroupsFunc ##### -->
492 <para>
493
494 </para>
495
496 @self:
497 @Returns:
498
499
500 <!-- ##### FUNCTION tp_base_contact_list_get_groups ##### -->
501 <para>
502
503 </para>
504
505 @self:
506 @Returns:
507
508
509 <!-- ##### USER_FUNCTION TpBaseContactListGetGroupMembersFunc ##### -->
491 <!-- ##### USER_FUNCTION TpBaseContactListDupGroupsFunc ##### -->
492 <para>
493
494 </para>
495
496 @self:
497 @Returns:
498
499
500 <!-- ##### FUNCTION tp_base_contact_list_dup_groups ##### -->
501 <para>
502
503 </para>
504
505 @self:
506 @Returns:
507
508
509 <!-- ##### USER_FUNCTION TpBaseContactListDupGroupMembersFunc ##### -->
510510 <para>
511511
512512 </para>
516516 @Returns:
517517
518518
519 <!-- ##### FUNCTION tp_base_contact_list_get_group_members ##### -->
519 <!-- ##### FUNCTION tp_base_contact_list_dup_group_members ##### -->
520520 <para>
521521
522522 </para>
813813 </para>
814814
815815 @parent:
816 @get_blocked_contacts:
816 @dup_blocked_contacts:
817817 @block_contacts_async:
818818 @block_contacts_finish:
819819 @unblock_contacts_async:
829829 @Returns:
830830
831831
832 <!-- ##### FUNCTION tp_base_contact_list_get_blocked_contacts ##### -->
832 <!-- ##### FUNCTION tp_base_contact_list_dup_blocked_contacts ##### -->
833833 <para>
834834
835835 </para>
297297
298298 @self:
299299 @handler:
300 @user_action_timestamp:
300 @user_action_time:
301301 @callback:
302302 @user_data:
303303
9696
9797
9898
99 <!-- ##### MACRO TP_USER_ACTION_TIME_NOT_USER_ACTION ##### -->
100 <para>
101
102 </para>
103
104
105
106 <!-- ##### MACRO TP_USER_ACTION_TIME_CURRENT_TIME ##### -->
107 <para>
108
109 </para>
110
111
112
2626
2727
2828
29 <!-- ##### MACRO TP_ERRORS ##### -->
29 <!-- ##### MACRO TP_ERROR ##### -->
3030 <para>
3131
3232 </para>
7777 </para>
7878
7979
80 <!-- ##### MACRO TP_ERRORS ##### -->
81 <para>
82
83 </para>
84
85
8086 <!-- ##### MACRO TP_ERROR_STR_NOT_YET ##### -->
8187 <para>
8288
283289 </para>
284290
285291 @parent_class:
286 @get_contacts:
287 @get_states:
292 @dup_contacts:
293 @dup_states:
288294 @get_contact_list_persists:
289295
290296 <!-- ##### USER_FUNCTION TpBaseContactListCreateGroupsFunc ##### -->
298304 @callback:
299305 @user_data:
300306
301 <!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### -->
307 <!-- ##### USER_FUNCTION TpBaseContactListDupContactGroupsFunc ##### -->
302308 <para>
303309
304310 </para>
307313 @contact:
308314 @Returns:
309315
310 <!-- ##### USER_FUNCTION TpBaseContactListGetContactsFunc ##### -->
311 <para>
312
313 </para>
314
315 @self:
316 @Returns:
317
318 <!-- ##### USER_FUNCTION TpBaseContactListGetGroupMembersFunc ##### -->
316 <!-- ##### USER_FUNCTION TpBaseContactListDupContactsFunc ##### -->
317 <para>
318
319 </para>
320
321 @self:
322 @Returns:
323
324 <!-- ##### USER_FUNCTION TpBaseContactListDupGroupMembersFunc ##### -->
319325 <para>
320326
321327 </para>
324330 @group:
325331 @Returns:
326332
327 <!-- ##### USER_FUNCTION TpBaseContactListGetGroupsFunc ##### -->
328 <para>
329
330 </para>
331
332 @self:
333 @Returns:
334
335 <!-- ##### USER_FUNCTION TpBaseContactListGetStatesFunc ##### -->
333 <!-- ##### USER_FUNCTION TpBaseContactListDupGroupsFunc ##### -->
334 <para>
335
336 </para>
337
338 @self:
339 @Returns:
340
341 <!-- ##### USER_FUNCTION TpBaseContactListDupStatesFunc ##### -->
336342 <para>
337343
338344 </para>
343349 @publish:
344350 @publish_request:
345351
352 <!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### -->
353 <para>
354
355 </para>
356
357 @self:
358 @contact:
359 @Returns:
360
361 <!-- ##### USER_FUNCTION TpBaseContactListGetContactsFunc ##### -->
362 <para>
363
364 </para>
365
366 @self:
367 @Returns:
368
369 <!-- ##### USER_FUNCTION TpBaseContactListGetGroupMembersFunc ##### -->
370 <para>
371
372 </para>
373
374 @self:
375 @group:
376 @Returns:
377
378 <!-- ##### USER_FUNCTION TpBaseContactListGetGroupsFunc ##### -->
379 <para>
380
381 </para>
382
383 @self:
384 @Returns:
385
386 <!-- ##### USER_FUNCTION TpBaseContactListGetStatesFunc ##### -->
387 <para>
388
389 </para>
390
391 @self:
392 @contact:
393 @subscribe:
394 @publish:
395 @publish_request:
396
346397 <!-- ##### USER_FUNCTION TpBaseContactListGroupContactsFunc ##### -->
347398 <para>
348399
421472 </para>
422473
423474 @parent:
424 @get_blocked_contacts:
475 @dup_blocked_contacts:
425476 @block_contacts_async:
426477 @block_contacts_finish:
427478 @unblock_contacts_async:
434485 </para>
435486
436487 @parent:
437 @get_groups:
438 @get_group_members:
439 @get_contact_groups:
488 @dup_groups:
489 @dup_group_members:
490 @dup_contact_groups:
440491 @has_disjoint_groups:
441492 @normalize_group:
442493
746797 @error:
747798 @Returns:
748799
800 <!-- ##### FUNCTION tp_base_contact_list_dup_blocked_contacts ##### -->
801 <para>
802
803 </para>
804
805 @self:
806 @Returns:
807
808 <!-- ##### FUNCTION tp_base_contact_list_dup_contact_groups ##### -->
809 <para>
810
811 </para>
812
813 @self:
814 @contact:
815 @Returns:
816
817 <!-- ##### FUNCTION tp_base_contact_list_dup_contacts ##### -->
818 <para>
819
820 </para>
821
822 @self:
823 @Returns:
824
825 <!-- ##### FUNCTION tp_base_contact_list_dup_group_members ##### -->
826 <para>
827
828 </para>
829
830 @self:
831 @group:
832 @Returns:
833
834 <!-- ##### FUNCTION tp_base_contact_list_dup_groups ##### -->
835 <para>
836
837 </para>
838
839 @self:
840 @Returns:
841
842 <!-- ##### FUNCTION tp_base_contact_list_dup_states ##### -->
843 <para>
844
845 </para>
846
847 @self:
848 @contact:
849 @subscribe:
850 @publish:
851 @publish_request:
852
749853 <!-- ##### FUNCTION tp_base_contact_list_false_func ##### -->
750854 <para>
751855
415415 @source_tag:
416416
417417
418 <!-- ##### FUNCTION tp_user_action_time_from_x11 ##### -->
419 <para>
420
421 </para>
422
423 @x11_time:
424 @Returns:
425
426
427 <!-- ##### FUNCTION tp_user_action_time_should_present ##### -->
428 <para>
429
430 </para>
431
432 @user_action_time:
433 @x11_time:
434 @Returns:
435
436
198198 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
199199 VALAC = @VALAC@
200200 VALAFLAGS = @VALAFLAGS@
201 VALA_CFLAGS = @VALA_CFLAGS@
202 VALA_LIBS = @VALA_LIBS@
203201 VAPIGEN = @VAPIGEN@
204202 VERSION = @VERSION@
205203 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
284284 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
285285 VALAC = @VALAC@
286286 VALAFLAGS = @VALAFLAGS@
287 VALA_CFLAGS = @VALA_CFLAGS@
288 VALA_LIBS = @VALA_LIBS@
289287 VAPIGEN = @VAPIGEN@
290288 VERSION = @VERSION@
291289 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
198198 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
199199 VALAC = @VALAC@
200200 VALAFLAGS = @VALAFLAGS@
201 VALA_CFLAGS = @VALA_CFLAGS@
202 VALA_LIBS = @VALA_LIBS@
203201 VAPIGEN = @VAPIGEN@
204202 VERSION = @VERSION@
205203 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
233233 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
234234 VALAC = @VALAC@
235235 VALAFLAGS = @VALAFLAGS@
236 VALA_CFLAGS = @VALA_CFLAGS@
237 VALA_LIBS = @VALA_LIBS@
238236 VAPIGEN = @VAPIGEN@
239237 VERSION = @VERSION@
240238 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
233233 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
234234 VALAC = @VALAC@
235235 VALAFLAGS = @VALAFLAGS@
236 VALA_CFLAGS = @VALA_CFLAGS@
237 VALA_LIBS = @VALA_LIBS@
238236 VAPIGEN = @VAPIGEN@
239237 VERSION = @VERSION@
240238 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
234234 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
235235 VALAC = @VALAC@
236236 VALAFLAGS = @VALAFLAGS@
237 VALA_CFLAGS = @VALA_CFLAGS@
238 VALA_LIBS = @VALA_LIBS@
239237 VAPIGEN = @VAPIGEN@
240238 VERSION = @VERSION@
241239 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
231231 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
232232 VALAC = @VALAC@
233233 VALAFLAGS = @VALAFLAGS@
234 VALA_CFLAGS = @VALA_CFLAGS@
235 VALA_LIBS = @VALA_LIBS@
236234 VAPIGEN = @VAPIGEN@
237235 VERSION = @VERSION@
238236 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
224224 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
225225 VALAC = @VALAC@
226226 VALAFLAGS = @VALAFLAGS@
227 VALA_CFLAGS = @VALA_CFLAGS@
228 VALA_LIBS = @VALA_LIBS@
229227 VAPIGEN = @VAPIGEN@
230228 VERSION = @VERSION@
231229 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
223223 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
224224 VALAC = @VALAC@
225225 VALAFLAGS = @VALAFLAGS@
226 VALA_CFLAGS = @VALA_CFLAGS@
227 VALA_LIBS = @VALA_LIBS@
228226 VAPIGEN = @VAPIGEN@
229227 VERSION = @VERSION@
230228 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
205205 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
206206 VALAC = @VALAC@
207207 VALAFLAGS = @VALAFLAGS@
208 VALA_CFLAGS = @VALA_CFLAGS@
209 VALA_LIBS = @VALA_LIBS@
210208 VAPIGEN = @VAPIGEN@
211209 VERSION = @VERSION@
212210 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
198198 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
199199 VALAC = @VALAC@
200200 VALAFLAGS = @VALAFLAGS@
201 VALA_CFLAGS = @VALA_CFLAGS@
202 VALA_LIBS = @VALA_LIBS@
203201 VAPIGEN = @VAPIGEN@
204202 VERSION = @VERSION@
205203 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
233233 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
234234 VALAC = @VALAC@
235235 VALAFLAGS = @VALAFLAGS@
236 VALA_CFLAGS = @VALA_CFLAGS@
237 VALA_LIBS = @VALA_LIBS@
238236 VAPIGEN = @VAPIGEN@
239237 VERSION = @VERSION@
240238 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
202202 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
203203 VALAC = @VALAC@
204204 VALAFLAGS = @VALAFLAGS@
205 VALA_CFLAGS = @VALA_CFLAGS@
206 VALA_LIBS = @VALA_LIBS@
207205 VAPIGEN = @VAPIGEN@
208206 VERSION = @VERSION@
209207 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
158158 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
159159 VALAC = @VALAC@
160160 VALAFLAGS = @VALAFLAGS@
161 VALA_CFLAGS = @VALA_CFLAGS@
162 VALA_LIBS = @VALA_LIBS@
163161 VAPIGEN = @VAPIGEN@
164162 VERSION = @VERSION@
165163 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
158158 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
159159 VALAC = @VALAC@
160160 VALAFLAGS = @VALAFLAGS@
161 VALA_CFLAGS = @VALA_CFLAGS@
162 VALA_LIBS = @VALA_LIBS@
163161 VAPIGEN = @VAPIGEN@
164162 VERSION = @VERSION@
165163 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
278278 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
279279 VALAC = @VALAC@
280280 VALAFLAGS = @VALAFLAGS@
281 VALA_CFLAGS = @VALA_CFLAGS@
282 VALA_LIBS = @VALA_LIBS@
283281 VAPIGEN = @VAPIGEN@
284282 VERSION = @VERSION@
285283 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
581579 versions/0.11.7.abi \
582580 versions/0.11.9.abi \
583581 versions/0.11.11.abi \
584 versions/0.11.12.abi
582 versions/0.11.12.abi \
583 versions/0.11.13.abi
585584
586585
587586 # The quoting here is unnecessary but harmless, and has the useful side-effect
743742 @HAVE_INTROSPECTION_TRUE@ $(srcdir)/protocol.c $(srcdir)/protocol.h \
744743 @HAVE_INTROSPECTION_TRUE@ $(srcdir)/base-connection.c $(srcdir)/base-connection.h \
745744 @HAVE_INTROSPECTION_TRUE@ $(srcdir)/handle-repo.c $(srcdir)/handle-repo.h $(srcdir)/handle-set.c \
745 @HAVE_INTROSPECTION_TRUE@ $(srcdir)/errors.c $(srcdir)/errors.h \
746746 @HAVE_INTROSPECTION_TRUE@ _gen/telepathy-enums.h \
747747 @HAVE_INTROSPECTION_TRUE@ _gen/telepathy-interfaces.h
748748
4444 versions/0.11.7.abi \
4545 versions/0.11.9.abi \
4646 versions/0.11.11.abi \
47 versions/0.11.12.abi
47 versions/0.11.12.abi \
48 versions/0.11.13.abi
4849
4950 # The quoting here is unnecessary but harmless, and has the useful side-effect
5051 # that vim quickfix mode (:make) doesn't interpret the libtool --mode=link
280280 /**
281281 * TpAccountChannelRequest:request:
282282 *
283 * The #TpAccount used to request the channel.
284 * Read-only except during construction.
283 * The desired D-Bus properties for the channel, represented as a
284 * #GHashTable where the keys are strings and the values are #GValue.
285285 *
286286 * This property can't be %NULL.
287287 *
297297 /**
298298 * TpAccountChannelRequest:user-action-time:
299299 *
300 * The user action time that will be passed to mission-control when
300 * The user action time that will be passed to the channel dispatcher when
301301 * requesting the channel.
302 *
303 * This may be the time at which user action occurred, or one of the special
304 * values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
305 * %TP_USER_ACTION_TIME_CURRENT_TIME.
306 *
307 * If %TP_USER_ACTION_TIME_NOT_USER_ACTION, the action doesn't involve any
308 * user action. Clients should avoid stealing focus when presenting the
309 * channel.
310 *
311 * If %TP_USER_ACTION_TIME_CURRENT_TIME, clients SHOULD behave as though the
312 * user action happened at the current time, e.g. a client may
313 * request that its window gains focus.
314 *
315 * On X11-based systems, Gdk 2.x, Clutter 1.0 etc.,
316 * tp_user_action_time_from_x11() can be used to convert an X11 timestamp to
317 * a Telepathy user action time.
318 *
319 * If the channel request succeeds, this user action time will be passed on
320 * to the channel's handler. If the handler is a GUI, it may use
321 * tp_user_action_time_should_present() to decide whether to bring its
322 * window to the foreground.
302323 *
303324 * Since: 0.11.12
304325 */
313334 * TpAccountChannelRequest::re-handled:
314335 * @self: a #TpAccountChannelRequest
315336 * @channel: the #TpChannel being re-handled
316 * @user_action_time: the time at which user action occurred, or 0 if this
317 * channel is to be handled for some reason not involving user action.
337 * @user_action_time: the time at which user action occurred, or one of the
338 * special values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
339 * %TP_USER_ACTION_TIME_CURRENT_TIME; see
340 * #TpAccountChannelRequest:user-action-time
318341 * @context: a #TpHandleChannelsContext representing the context of
319342 * the HandleChannels() call.
320343 *
321 * Emitted when channel which has been created using @self has be re-handled.
344 * Emitted when the channel created using @self has been "re-handled".
345 *
346 * This means that a Telepathy client has made another request for a
347 * matching channel using an "ensure" API like
348 * tp_account_channel_request_ensure_channel_async(), while the channel
349 * still exists. Instead of creating a new channel, the channel dispatcher
350 * notifies the existing handler of @channel, resulting in this signal.
351 *
352 * Most GUI handlers should respond to this signal by checking
353 * @user_action_time, and if appropriate, moving to the foreground.
322354 *
323355 * Since: 0.11.12
324356 */
336368 * tp_account_channel_request_new:
337369 * @account: a #TpAccount
338370 * @request: (transfer none) (element-type utf8 GObject.Value): the requested
339 * properties of the channel
340 * @user_action_time: the user action time to pass to the channel dispatcher
341 * when requesting the channel
371 * properties of the channel (see #TpAccountChannelRequest:request)
372 * @user_action_time: the time of the user action that caused this request,
373 * or one of the special values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
374 * %TP_USER_ACTION_TIME_CURRENT_TIME (see
375 * #TpAccountChannelRequest:user-action-time)
342376 *
343377 * Convenience function to create a new #TpAccountChannelRequest object.
344378 *
777811 * tp_account_channel_request_create_and_handle_channel_finish() to get the
778812 * result of the operation.
779813 *
814 * (Behind the scenes, this works by creating a temporary #TpBaseClient, then
815 * acting like tp_account_channel_request_create_channel_async() with the
816 * temporary #TpBaseClient as the @preferred_handler.)
817 *
780818 * Since: 0.11.12
781819 */
782820 void
834872 * If the channel already exists and is already being handled, or if a
835873 * newly created channel is sent to a different handler, this operation
836874 * will fail with the error %TP_ERROR_NOT_YOURS. The other handler
837 * will be notified that the channel was requested again, and can
838 * move its window to the foreground, if applicable.
875 * will be notified that the channel was requested again (for instance
876 * with #TpAccountChannelRequest::re-handled,
877 * #TpBaseClientClassHandleChannelsImpl or #TpSimpleHandler:callback),
878 * and can move its window to the foreground, if applicable.
879 *
880 * (Behind the scenes, this works by creating a temporary #TpBaseClient, then
881 * acting like tp_account_channel_request_ensure_channel_async() with the
882 * temporary #TpBaseClient as the @preferred_handler.)
839883 *
840884 * Since: 0.11.12
841885 */
10311075 * Asynchronously calls EnsureChannel on the ChannelDispatcher to create a
10321076 * channel with the properties defined in #TpAccountChannelRequest:request
10331077 * and let the ChannelDispatcher dispatch it to an handler.
1078 *
1079 * If a suitable channel already existed, its handler will be notified that
1080 * the channel was requested again (for instance with
1081 * #TpAccountChannelRequest::re-handled, #TpBaseClientClassHandleChannelsImpl
1082 * or #TpSimpleHandler:callback), and can move its window to the foreground,
1083 * if applicable. Otherwise, a new channel will be created and dispatched to
1084 * a handler.
1085 *
10341086 * @callback will be called when an existing channel's handler has been
10351087 * notified, a new channel has been created and dispatched, or the request
10361088 * has failed.
527527 }
528528
529529 static void
530 channel_prepare_cb (GObject *source,
530 adoc_channel_prepare_cb (GObject *source,
531531 GAsyncResult *result,
532532 gpointer user_data)
533533 {
578578 self->priv->num_pending++;
579579
580580 tp_proxy_prepare_async (channel, channel_features,
581 channel_prepare_cb, g_object_ref (self));
581 adoc_channel_prepare_cb, g_object_ref (self));
582582 }
583583 }
584584
4040
4141 /**
4242 * TpBaseClientClass:
43 * @parent_class: the parent class
44 * @observe_channels: the function called to observe newly-created channels
45 * matching this client's observer filter (since 0.11.13)
46 * @add_dispatch_operation: the function called to request user approval of
47 * unrequested (incoming) channels matching this client's approver filter
48 * (since 0.11.13)
49 * @handle_channels: the function called to handle channels matching this
50 * client's handler filter (since 0.11.13)
4351 *
4452 * The class of a #TpBaseClient.
53 *
54 * The virtual methods @observe_channels, @add_dispatch_operation and
55 * @handle_channels can be also implemented by calling
56 * tp_base_client_implement_observe_channels(),
57 * tp_base_client_implement_add_dispatch_operation() and
58 * tp_base_client_implement_handle_channels(). This is compatible with
59 * telepathy-glib versions older than 0.11.13.
4560 *
4661 * Since: 0.11.5
4762 */
109124 * @requests_satisfied: (element-type TelepathyGLib.ChannelRequest): a #GList of
110125 * #TpChannelRequest having their object-path defined but are not guaranteed
111126 * to be prepared.
112 * @user_action_time: the time at which user action occurred, or 0 if this
113 * channel is to be handled for some reason not involving user action.
127 * @user_action_time: the time at which user action occurred, or one of the
128 * special values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
129 * %TP_USER_ACTION_TIME_CURRENT_TIME
130 * (see #TpAccountChannelRequest:user-action-time for details)
114131 * @context: a #TpHandleChannelsContext representing the context of this
115132 * D-Bus call
116133 *
145162 #include "telepathy-glib/debug-internal.h"
146163 #include "telepathy-glib/_gen/signals-marshal.h"
147164
148 struct _TpBaseClientClassPrivate {
149 /*<private>*/
150 TpBaseClientClassObserveChannelsImpl observe_channels_impl;
151 TpBaseClientClassAddDispatchOperationImpl add_dispatch_operation_impl;
152 TpBaseClientClassHandleChannelsImpl handle_channels_impl;
153 };
154
155165 static void observer_iface_init (gpointer, gpointer);
156166 static void approver_iface_init (gpointer, gpointer);
157167 static void handler_iface_init (gpointer, gpointer);
165175 G_IMPLEMENT_INTERFACE(TP_TYPE_SVC_CLIENT_APPROVER, approver_iface_init);
166176 G_IMPLEMENT_INTERFACE(TP_TYPE_SVC_CLIENT_HANDLER, handler_iface_init);
167177 G_IMPLEMENT_INTERFACE(TP_TYPE_SVC_CLIENT_INTERFACE_REQUESTS,
168 requests_iface_init);
169 g_type_add_class_private (g_define_type_id, sizeof (
170 TpBaseClientClassPrivate)))
178 requests_iface_init))
171179
172180 enum {
173181 PROP_DBUS_DAEMON = 1,
244252 * a %TP_HASH_TYPE_CHANNEL_CLASS
245253 *
246254 * Register a new channel class as Observer.ObserverChannelFilter.
247 * The @observe_channels virtual method set up using
248 * tp_base_client_implement_observe_channels() will be called whenever
249 * a new channel's properties match the ones in @filter.
255 * The #TpBaseClientClass.observe_channels virtual method will be called
256 * whenever a new channel's properties match the ones in @filter.
250257 *
251258 * This method may only be called before tp_base_client_register() is
252 * called, and may only be called on objects whose class has called
253 * tp_base_client_implement_observe_channels().
259 * called, and may only be called on objects whose class implements
260 * #TpBaseClientClass.observe_channels.
254261 *
255262 * Since: 0.11.5
256263 */
292299
293300 g_return_if_fail (TP_IS_BASE_CLIENT (self));
294301 g_return_if_fail (!self->priv->registered);
295 g_return_if_fail (cls->priv->observe_channels_impl != NULL);
302 g_return_if_fail (cls->observe_channels != NULL);
296303
297304 self->priv->flags |= CLIENT_IS_OBSERVER;
298305 g_ptr_array_add (self->priv->observer_filters, filter);
317324 * its filter, it will automatically be restarted by service-activation.
318325 *
319326 * This method may only be called before tp_base_client_register() is
320 * called, and may only be called on objects whose class has called
321 * tp_base_client_implement_observe_channels().
327 * called, and may only be called on objects whose class implements
328 * #TpBaseClientClass.observe_channels.
322329 *
323330 * Since: 0.11.5
324331 */
330337
331338 g_return_if_fail (TP_IS_BASE_CLIENT (self));
332339 g_return_if_fail (!self->priv->registered);
333 g_return_if_fail (cls->priv->observe_channels_impl != NULL);
340 g_return_if_fail (cls->observe_channels != NULL);
334341
335342 self->priv->flags |= (CLIENT_IS_OBSERVER | CLIENT_OBSERVER_RECOVER);
336343 }
342349 * a %TP_HASH_TYPE_CHANNEL_CLASS
343350 *
344351 * Register a new channel class as Approver.ApproverChannelFilter.
345 * The @add_dispatch_operation virtual method set up using
346 * tp_base_client_implement_add_dispatch_operation() will be called whenever
347 * a new channel's properties match the ones in @filter.
352 * The #TpBaseClientClass.add_dispatch_operation virtual method will be called
353 * whenever a new channel's properties match the ones in @filter.
348354 *
349355 * This method may only be called before tp_base_client_register() is
350 * called, and may only be called on objects whose class has called
351 * tp_base_client_implement_add_dispatch_operation().
356 * called, and may only be called on objects whose class implements
357 * #TpBaseClientClass.add_dispatch_operation.
352358 *
353359 * Since: 0.11.5
354360 */
390396
391397 g_return_if_fail (TP_IS_BASE_CLIENT (self));
392398 g_return_if_fail (!self->priv->registered);
393 g_return_if_fail (cls->priv->add_dispatch_operation_impl != NULL);
399 g_return_if_fail (cls->add_dispatch_operation != NULL);
394400
395401 self->priv->flags |= CLIENT_IS_APPROVER;
396402 g_ptr_array_add (self->priv->approver_filters, filter);
406412 *
407413 * This method may only be called before tp_base_client_register() is
408414 * called, and may only be called on objects whose class has called
409 * tp_base_client_implement_handle_channels().
415 * #TpBaseClientClass.handle_channels.
410416 *
411417 * Since: 0.11.6
412418 */
417423
418424 g_return_if_fail (TP_IS_BASE_CLIENT (self));
419425 g_return_if_fail (!self->priv->registered);
420 g_return_if_fail (cls->priv->handle_channels_impl != NULL);
426 g_return_if_fail (cls->handle_channels != NULL);
421427
422428 self->priv->flags |= CLIENT_IS_HANDLER;
423429 }
429435 * a %TP_HASH_TYPE_CHANNEL_CLASS
430436 *
431437 * Register a new channel class as Handler.HandlerChannelFilter.
432 * The @handle_channels virtual method set up using
433 * tp_base_client_implement_handle_channels() will be called whenever
434 * a new channel's properties match the ones in @filter.
438 * The #TpBaseClientClass.handle_channels virtual method will be called
439 * whenever a new channel's properties match the ones in @filter.
435440 *
436441 * This method may only be called before tp_base_client_register() is
437 * called, and may only be called on objects whose class has called
438 * tp_base_client_implement_handle_channels().
442 * called, and may only be called on objects whose class implements
443 * #TpBaseClientClass.handle_channels.
439444 *
440445 * Since: 0.11.6
441446 */
478483
479484 g_return_if_fail (TP_IS_BASE_CLIENT (self));
480485 g_return_if_fail (!self->priv->registered);
481 g_return_if_fail (cls->priv->handle_channels_impl != NULL);
486 g_return_if_fail (cls->handle_channels != NULL);
482487
483488 self->priv->flags |= CLIENT_IS_HANDLER;
484489 g_ptr_array_add (self->priv->handler_filters, filter);
495500 * D-Bus property.)
496501 *
497502 * This method may only be called before tp_base_client_register() is
498 * called, and may only be called on objects whose class has called
499 * tp_base_client_implement_handle_channels().
503 * called, and may only be called on objects whose class implements
504 * #TpBaseClientClass.handle_channels.
500505 *
501506 * Since: 0.11.6
502507 */
508513
509514 g_return_if_fail (TP_IS_BASE_CLIENT (self));
510515 g_return_if_fail (!self->priv->registered);
511 g_return_if_fail (cls->priv->handle_channels_impl != NULL);
516 g_return_if_fail (cls->handle_channels != NULL);
512517
513518 if (bypass_approval)
514519 {
533538 * return the list of pending requests.
534539 *
535540 * This method may only be called before tp_base_client_register() is
536 * called, and may only be called on objects whose class has called
537 * tp_base_client_implement_handle_channels().
541 * called, and may only be called on objects whose class implements
542 * #TpBaseClientClass.handle_channels.
538543 *
539544 * Since: 0.11.6
540545 */
545550
546551 g_return_if_fail (TP_IS_BASE_CLIENT (self));
547552 g_return_if_fail (!self->priv->registered);
548 g_return_if_fail (cls->priv->handle_channels_impl != NULL);
553 g_return_if_fail (cls->handle_channels != NULL);
549554
550555 self->priv->flags |= (CLIENT_IS_HANDLER | CLIENT_HANDLER_WANTS_REQUESTS);
551556 }
556561 {
557562 TpBaseClientClass *cls = TP_BASE_CLIENT_GET_CLASS (self);
558563
559 g_return_if_fail (cls->priv->handle_channels_impl != NULL);
564 g_return_if_fail (cls->handle_channels != NULL);
560565
561566 self->priv->flags |= CLIENT_IS_HANDLER;
562567
578583 * tp_base_client_add_handler_capabilities().
579584 *
580585 * This method may only be called before tp_base_client_register() is
581 * called, and may only be called on objects whose class has called
582 * tp_base_client_implement_handle_channels().
586 * called, and may only be called on objects whose class implements
587 * #TpBaseClientClass.handle_channels.
583588 *
584589 * Since: 0.11.6
585590 */
591596
592597 g_return_if_fail (TP_IS_BASE_CLIENT (self));
593598 g_return_if_fail (!self->priv->registered);
594 g_return_if_fail (cls->priv->handle_channels_impl != NULL);
599 g_return_if_fail (cls->handle_channels != NULL);
595600
596601 _tp_base_client_add_handler_capability (self, token);
597602 }
609614 * particular streaming protocols and codecs.
610615 *
611616 * This method may only be called before tp_base_client_register() is
612 * called, and may only be called on objects whose class has called
613 * tp_base_client_implement_handle_channels().
617 * called, and may only be called on objects whose class implements
618 * #TpBaseClientClass.handle_channels.
614619 *
615620 * Since: 0.11.6
616621 */
641646 * tp_base_client_add_handler_capability() for each capability token.
642647 *
643648 * This method may only be called before tp_base_client_register() is
644 * called, and may only be called on objects whose class has called
645 * tp_base_client_implement_handle_channels().
649 * called, and may only be called on objects whose class implements
650 * #TpBaseClientClass.handle_channels.
646651 *
647652 * Since: 0.11.6
648653 */
12291234 cls->dbus_properties_class.interfaces = prop_ifaces;
12301235 tp_dbus_properties_mixin_class_init (object_class,
12311236 G_STRUCT_OFFSET (TpBaseClientClass, dbus_properties_class));
1232
1233 cls->priv = G_TYPE_CLASS_GET_PRIVATE (cls, TP_TYPE_BASE_CLIENT,
1234 TpBaseClientClassPrivate);
12351237 }
12361238
12371239 static GList *
12681270 channels_list = ptr_array_to_list (ctx->channels);
12691271 requests_list = ptr_array_to_list (ctx->requests);
12701272
1271 cls->priv->observe_channels_impl (self, ctx->account, ctx->connection,
1273 cls->observe_channels (self, ctx->account, ctx->connection,
12721274 channels_list, ctx->dispatch_operation, requests_list, ctx);
12731275
12741276 g_list_free (channels_list);
13171319 return;
13181320 }
13191321
1320 if (cls->priv->observe_channels_impl == NULL)
1322 if (cls->observe_channels == NULL)
13211323 {
13221324 WARNING ("class %s does not implement ObserveChannels",
13231325 G_OBJECT_TYPE_NAME (self));
14591461
14601462 channels_list = ptr_array_to_list (ctx->channels);
14611463
1462 cls->priv->add_dispatch_operation_impl (self, ctx->account, ctx->connection,
1464 cls->add_dispatch_operation (self, ctx->account, ctx->connection,
14631465 channels_list, ctx->dispatch_operation, ctx);
14641466
14651467 g_list_free (channels_list);
15051507 return;
15061508 }
15071509
1508 if (cls->priv->add_dispatch_operation_impl == NULL)
1510 if (cls->add_dispatch_operation == NULL)
15091511 {
15101512 WARNING ("class %s does not implement AddDispatchOperation",
15111513 G_OBJECT_TYPE_NAME (self));
16761678 tp_g_signal_connect_object (ctx, "done", G_CALLBACK (ctx_done_cb),
16771679 self, 0);
16781680
1679 cls->priv->handle_channels_impl (self, ctx->account, ctx->connection,
1681 cls->handle_channels (self, ctx->account, ctx->connection,
16801682 channels_list, requests_list, ctx->user_action_time, ctx);
16811683
16821684 g_list_free (channels_list);
16831685 g_list_free (requests_list);
16841686
16851687 if (_tp_handle_channels_context_get_state (ctx) ==
1686 TP_OBSERVE_CHANNELS_CONTEXT_STATE_NONE)
1688 TP_HANDLE_CHANNELS_CONTEXT_STATE_NONE)
16871689 {
16881690 error = g_error_new (TP_ERRORS, TP_ERROR_NOT_IMPLEMENTED,
16891691 "Implementation of HandledChannels in %s didn't call "
17411743 return;
17421744 }
17431745
1744 if (cls->priv->handle_channels_impl == NULL)
1746 if (cls->handle_channels == NULL)
17451747 {
17461748 DEBUG ("class %s does not implement HandleChannels",
17471749 G_OBJECT_TYPE_NAME (self));
19951997 * Called by subclasses to define the actual implementation of the
19961998 * ObserveChannels() D-Bus method.
19971999 *
2000 * Since 0.11.13 this is exactly equivalent to setting the
2001 * #TpBaseClientClass.observe_channels function pointer.
2002 *
19982003 * Since: 0.11.5
19992004 */
20002005 void
20012006 tp_base_client_implement_observe_channels (TpBaseClientClass *cls,
20022007 TpBaseClientClassObserveChannelsImpl impl)
20032008 {
2004 cls->priv->observe_channels_impl = impl;
2009 cls->observe_channels = impl;
20052010 }
20062011
20072012 /**
21062111 * Called by subclasses to define the actual implementation of the
21072112 * AddDispatchOperation() D-Bus method.
21082113 *
2114 * Since 0.11.13 this is exactly equivalent to setting the
2115 * #TpBaseClientClass.add_dispatch_operation function pointer.
2116 *
21092117 * Since: 0.11.5
21102118 */
21112119 void
21122120 tp_base_client_implement_add_dispatch_operation (TpBaseClientClass *cls,
21132121 TpBaseClientClassAddDispatchOperationImpl impl)
21142122 {
2115 cls->priv->add_dispatch_operation_impl = impl;
2123 cls->add_dispatch_operation = impl;
21162124 }
21172125
21182126 /**
21242132 * Called by subclasses to define the actual implementation of the
21252133 * HandleChannels() D-Bus method.
21262134 *
2135 * Since 0.11.13 this is exactly equivalent to setting the
2136 * #TpBaseClientClass.handle_channels function pointer.
2137 *
21272138 * Since: 0.11.6
21282139 */
21292140 void
21302141 tp_base_client_implement_handle_channels (TpBaseClientClass *cls,
21312142 TpBaseClientClassHandleChannelsImpl impl)
21322143 {
2133 cls->priv->handle_channels_impl = impl;
2144 cls->handle_channels = impl;
21342145 }
21352146
21362147 /**
4040 typedef struct _TpBaseClientPrivate TpBaseClientPrivate;
4141 typedef struct _TpBaseClientClassPrivate TpBaseClientClassPrivate;
4242
43 typedef void (*TpBaseClientClassObserveChannelsImpl) (
44 TpBaseClient *client,
45 TpAccount *account,
46 TpConnection *connection,
47 GList *channels,
48 TpChannelDispatchOperation *dispatch_operation,
49 GList *requests,
50 TpObserveChannelsContext *context);
51
52 typedef void (*TpBaseClientClassAddDispatchOperationImpl) (
53 TpBaseClient *client,
54 TpAccount *account,
55 TpConnection *connection,
56 GList *channels,
57 TpChannelDispatchOperation *dispatch_operation,
58 TpAddDispatchOperationContext *context);
59
60 typedef void (*TpBaseClientClassHandleChannelsImpl) (
61 TpBaseClient *client,
62 TpAccount *account,
63 TpConnection *connection,
64 GList *channels,
65 GList *requests_satisfied,
66 gint64 user_action_time,
67 TpHandleChannelsContext *context);
68
4369 struct _TpBaseClientClass {
70 /*<public>*/
71 GObjectClass parent_class;
72 TpBaseClientClassObserveChannelsImpl observe_channels;
73 TpBaseClientClassAddDispatchOperationImpl add_dispatch_operation;
74 TpBaseClientClassHandleChannelsImpl handle_channels;
4475 /*<private>*/
45 GObjectClass parent_class;
46 GCallback _padding[7];
76 GCallback _padding[4];
4777 TpDBusPropertiesMixinClass dbus_properties_class;
4878 TpBaseClientClassPrivate *priv;
4979 };
5888
5989 /* Protected methods; should be called only by subclasses */
6090
61 typedef void (*TpBaseClientClassObserveChannelsImpl) (
62 TpBaseClient *client,
63 TpAccount *account,
64 TpConnection *connection,
65 GList *channels,
66 TpChannelDispatchOperation *dispatch_operation,
67 GList *requests,
68 TpObserveChannelsContext *context);
69
7091 void tp_base_client_implement_observe_channels (TpBaseClientClass *klass,
7192 TpBaseClientClassObserveChannelsImpl impl);
7293
73 typedef void (*TpBaseClientClassAddDispatchOperationImpl) (
74 TpBaseClient *client,
75 TpAccount *account,
76 TpConnection *connection,
77 GList *channels,
78 TpChannelDispatchOperation *dispatch_operation,
79 TpAddDispatchOperationContext *context);
80
8194 void tp_base_client_implement_add_dispatch_operation (TpBaseClientClass *klass,
8295 TpBaseClientClassAddDispatchOperationImpl impl);
83
84 typedef void (*TpBaseClientClassHandleChannelsImpl) (
85 TpBaseClient *client,
86 TpAccount *account,
87 TpConnection *connection,
88 GList *channels,
89 GList *requests_satisfied,
90 gint64 user_action_time,
91 TpHandleChannelsContext *context);
9296
9397 void tp_base_client_implement_handle_channels (TpBaseClientClass *klass,
9498 TpBaseClientClassHandleChannelsImpl impl);
13291329 * @handler: (allow-none): The well-known bus name (starting with
13301330 * #TP_CLIENT_BUS_NAME_BASE) of the channel handler that should handle the
13311331 * channel, or %NULL if the client has no preferred channel handler
1332 * @user_action_timestamp: the time at which user action occurred
1332 * @user_action_time: the time at which user action occurred, or one of the
1333 * special values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
1334 * %TP_USER_ACTION_TIME_CURRENT_TIME
13331335 * @callback: a callback to call when the call returns
13341336 * @user_data: data to pass to @callback
13351337 *
13381340 * This timestamp will be passed to the Handler when HandleChannels is called.
13391341 *
13401342 * If an X server timestamp for the user action causing this method call is
1341 * available, @user_action_timestamp should be this timestamp (for instance, the
1343 * available, @user_action_time should be this timestamp (for instance, the
13421344 * result of gdk_event_get_time() if it is not %GDK_CURRENT_TIME). Otherwise, it
1343 * may be 0 to behave as if there was no user action or it happened a long time
1344 * ago, or %G_MAXINT64 to have the Handler behave as though the user action had
1345 * just happened (resembling, but not numerically equal to, %GDK_CURRENT_TIME).
1345 * may be %TP_USER_ACTION_TIME_NOT_USER_ACTION to behave as if there was no
1346 * user action or it happened a long time ago, or
1347 * %TP_USER_ACTION_TIME_CURRENT_TIME to have the Handler behave as though the
1348 * user action had just happened (resembling, but not numerically equal to,
1349 * %GDK_CURRENT_TIME).
13461350 *
13471351 * This method has been introduced in telepathy-mission-control 5.5.0.
13481352 *
13521356 tp_channel_dispatch_operation_handle_with_time_async (
13531357 TpChannelDispatchOperation *self,
13541358 const gchar *handler,
1355 gint64 user_action_timestamp,
1359 gint64 user_action_time,
13561360 GAsyncReadyCallback callback,
13571361 gpointer user_data)
13581362 {
13651369 tp_channel_dispatch_operation_handle_with_time_async);
13661370
13671371 tp_cli_channel_dispatch_operation_call_handle_with_time (self, -1,
1368 handler != NULL ? handler: "", user_action_timestamp,
1372 handler != NULL ? handler: "", user_action_time,
13691373 handle_with_cb, result, NULL, G_OBJECT (self));
13701374 }
13711375
120120 void tp_channel_dispatch_operation_handle_with_time_async (
121121 TpChannelDispatchOperation *self,
122122 const gchar *handler,
123 gint64 user_action_timestamp,
123 gint64 user_action_time,
124124 GAsyncReadyCallback callback,
125125 gpointer user_data);
126126
102102 #define TP_CLIENT_BUS_NAME_BASE "org.freedesktop.Telepathy.Client."
103103
104104 /**
105 * TP_CLIENT_OBJECT_PATH_BASE
105 * TP_CLIENT_OBJECT_PATH_BASE:
106106 *
107107 * The common prefix of the well-known object path for any Telepathy Client.
108108 */
109109 #define TP_CLIENT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Client/"
110
111 /**
112 * TP_USER_ACTION_TIME_NOT_USER_ACTION:
113 *
114 * The "user action time" used by methods like
115 * tp_account_channel_request_new() to represent channel requests that are
116 * not a result of user action.
117 *
118 * See also #TpAccountChannelRequest:user-action-time,
119 * tp_user_action_time_from_x11(), tp_user_action_time_should_present() and
120 * %TP_USER_ACTION_TIME_CURRENT_TIME.
121 *
122 * Since: 0.11.13
123 */
124 #define TP_USER_ACTION_TIME_NOT_USER_ACTION (G_GINT64_CONSTANT (0))
125
126 /**
127 * TP_USER_ACTION_TIME_CURRENT_TIME:
128 *
129 * The "user action time" used by methods like
130 * tp_account_channel_request_new() to represent channel requests that should
131 * be treated as though they happened at the current time. This is the same
132 * concept as %GDK_CURRENT_TIME in Gdk (but note that the numerical value used
133 * in Telepathy is not the same).
134 *
135 * See also #TpAccountChannelRequest:user-action-time,
136 * tp_user_action_time_from_x11(), tp_user_action_time_should_present() and
137 * %TP_USER_ACTION_TIME_NOT_USER_ACTION.
138 *
139 * Since: 0.11.13
140 */
141 #define TP_USER_ACTION_TIME_CURRENT_TIME (G_MAXINT64)
110142
111143 /* telepathy-glib-specific version of G_GNUC_DEPRECATED so our regression
112144 * tests can continue to test deprecated functionality, while avoiding
3434 */
3535
3636 /**
37 * TP_ERRORS:
37 * TP_ERROR:
3838 *
3939 * The error domain for the D-Bus errors described in the Telepathy
4040 * specification. Error codes in this domain come from the #TpError
4444 * domain. Since 0.7.17, this function automatically registers the domain with
4545 * dbus-glib for server-side use (using dbus_g_error_domain_register()) when
4646 * called.
47 *
48 * This used to be called %TP_ERRORS. To be compatible with telepathy-glib
49 * 0.10.x, use %TP_ERRORS.
50 *
51 * Since: 0.11.7
4752 */
4853
4954 /**
189194 */
190195
191196 /**
192 * tp_g_set_error_invalid_handle_type:
197 * tp_g_set_error_invalid_handle_type: (skip)
193198 * @type: An invalid handle type
194199 * @error: Either %NULL, or used to return an error (as for g_set_error)
195200 *
207212 }
208213
209214 /**
210 * tp_g_set_error_unsupported_handle_type:
215 * tp_g_set_error_unsupported_handle_type: (skip)
211216 * @type: An unsupported handle type
212217 * @error: Either %NULL, or used to return an error (as for g_set_error)
213218 *
238243 * tools/glib-errors-str-gen.py.
239244 */
240245
246 /**
247 * tp_errors_quark: (skip)
248 *
249 * <!-- -->
250 *
251 * Deprecated: Use tp_error_quark() instead.
252 */
241253 GQuark
242254 tp_errors_quark (void)
243255 {
256 return tp_error_quark ();
257 }
258
259 /**
260 * tp_error_quark:
261 *
262 * Return the error domain quark for #TpError.
263 *
264 * Since: 0.11.13
265 */
266 GQuark
267 tp_error_quark (void)
268 {
244269 static gsize quark = 0;
245270
246271 if (g_once_init_enter (&quark))
247272 {
273 /* FIXME: When we next break API, this should be changed to
274 * "tp-error-quark" */
248275 GQuark domain = g_quark_from_static_string ("tp_errors");
249276
250277 g_type_init ();
2828 G_BEGIN_DECLS
2929
3030 GQuark tp_errors_quark (void);
31 GQuark tp_error_quark (void);
3132
3233 #define TP_ERROR_PREFIX "org.freedesktop.Telepathy.Error"
3334
34 #define TP_ERRORS (tp_errors_quark ())
35 #define TP_ERROR TP_ERRORS
35 #define TP_ERRORS TP_ERROR
36 #define TP_ERROR (tp_error_quark ())
3637
3738 void tp_g_set_error_invalid_handle_type (guint type, GError **error);
3839 void tp_g_set_error_unsupported_handle_type (guint type, GError **error);
367367 /**
368368 * TpHandleChannelsContext:user-action-time:
369369 *
370 * The User_Action_Time that have been passed to HandleChannels.
370 * The time at which user action occurred, or one of the
371 * special values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
372 * %TP_USER_ACTION_TIME_CURRENT_TIME
373 * (see #TpAccountChannelRequest:user-action-time for details)
374 *
371375 * Read-only except during construction.
372 *
373 * If 0, the action doesn't involve any user action. Clients
374 * SHOULD avoid stealing focus when presenting the channel.
375 *
376 * If #G_MAXINT64: clients SHOULD behave as though the user
377 * action happened at the current time, e.g. a client MAY
378 * request that its window gains focus.
379376 *
380377 * Since: 0.11.6
381378 */
604601 }
605602
606603 static void
607 channel_prepare_cb (GObject *source,
604 hcc_channel_prepare_cb (GObject *source,
608605 GAsyncResult *result,
609606 gpointer user_data)
610607 {
651648 self->priv->num_pending++;
652649
653650 tp_proxy_prepare_async (channel, channel_features,
654 channel_prepare_cb, g_object_ref (self));
651 hcc_channel_prepare_cb, g_object_ref (self));
655652 }
656653 }
657654
3535 $(srcdir)/protocol.c $(srcdir)/protocol.h \
3636 $(srcdir)/base-connection.c $(srcdir)/base-connection.h \
3737 $(srcdir)/handle-repo.c $(srcdir)/handle-repo.h $(srcdir)/handle-set.c \
38 $(srcdir)/errors.c $(srcdir)/errors.h \
3839 _gen/telepathy-enums.h \
3940 _gen/telepathy-interfaces.h
4041
576576 }
577577
578578 static void
579 channel_prepare_cb (GObject *source,
579 occ_channel_prepare_cb (GObject *source,
580580 GAsyncResult *result,
581581 gpointer user_data)
582582 {
622622 self->priv->num_pending++;
623623
624624 tp_proxy_prepare_async (channel, channel_features,
625 channel_prepare_cb, g_object_ref (self));
625 occ_channel_prepare_cb, g_object_ref (self));
626626 }
627627 }
628628
2525 * @see_also: #TpSvcConnectionInterfacePresence
2626 *
2727 * This mixin can be added to a #TpBaseConnection subclass to implement the
28 * presence interface in a general way. It does not support protocols where it
29 * is possible to set multiple statuses on yourself at once, however. Hence all
30 * presence statuses will have the exclusive flag set.
31 *
32 * There are plans to deprecate the notion of last activity time in the D-Bus
33 * presence interface, so #TpPresenceStatus doesn't include it at all.
34 * Consequently, the last activity time field in presence data presented over
35 * D-Bus will always be zero and the SetLastActivityTime method doesn't actually
36 * do anything.
28 * SimplePresence and/or Presence interfaces. Implementing both interfaces
29 * (as described below) is recommended. In particular, you must implement the
30 * old-style Presence interface if compatibility with telepathy-glib
31 * versions older than 0.11.13 is required.
3732 *
3833 * To use the presence mixin, include a #TpPresenceMixinClass somewhere in your
3934 * class structure and a #TpPresenceMixin somewhere in your instance structure,
4136 * tp_presence_mixin_init() from your init function or constructor, and
4237 * tp_presence_mixin_finalize() from your dispose or finalize function.
4338 *
44 * To use the presence mixin as the implementation of
45 * #TpSvcConnectionInterfacePresence, in the function you pass to
46 * G_IMPLEMENT_INTERFACE, you should call tp_presence_mixin_iface_init.
47 * TpPresenceMixin implements all of the D-Bus methods in the Presence
48 * interface.
49 *
50 * Since 0.7.13 you can also implement
51 * #TpSvcConnectionInterfaceSimplePresence by using this mixin, in this case
52 * you should pass tp_presence_mixin_iface_init as an argument to
53 * G_IMPLEMENT_INTERFACE. Note that this can cause the status_available
54 * callback to be called while disconnected. Also to fully implement this
55 * interface some dbus properties need to be supported. To do that using this
56 * mixin the instance needs to use the dbus properties mixin and call
57 * tp_presence_mixin_simple_presence_init_dbus_properties in the class init
58 * function
59 *
39 * <section>
40 * <title>Implementing SimplePresence</title>
41 * <para>
42 * Since 0.7.13 this mixin supports the entire SimplePresence interface.
43 * You can implement #TpSvcConnectionInterfaceSimplePresence as follows:
44 * <itemizedlist>
45 * <listitem>
46 * <para>use the #TpContactsMixin and #TpDBusPropertiesMixin</para>
47 * </listitem>
48 * <listitem>
49 * <para>pass tp_presence_mixin_simple_presence_iface_init() as an
50 * argument to G_IMPLEMENT_INTERFACE()
51 * </para>
52 * </listitem>
53 * <listitem>
54 * <para>
55 * call tp_presence_mixin_simple_presence_init_dbus_properties in the
56 * #GTypeClass.class_init function
57 * </para>
58 * </listitem>
59 * <listitem>
60 * <para>
61 * call tp_presence_mixin_simple_presence_register_with_contacts_mixin()
62 * in the #GObjectClass.constructed function
63 * </para>
64 * </listitem>
65 * </itemizedlist>
66 * </para>
67 * </section> <!-- Simple Presence -->
68 * <section>
69 * <title>Implementing old-style Presence</title>
70 * <para>
71 * This mixin also supports a large subset of the deprecated Presence
72 * interface. It does not support protocols where it is possible to set
73 * multiple statuses on yourself at once (all presence statuses will have the
74 * exclusive flag set), or last-activity-time information.
75 * </para>
76 * <para>
77 * To use the presence mixin as the implementation of
78 * #TpSvcConnectionInterfacePresence, use tp_presence_mixin_iface_init() as
79 * the function you pass to G_IMPLEMENT_INTERFACE().
80 * The presence mixin implements all of the D-Bus methods in the Presence
81 * interface.
82 * </para>
83 * <para>
84 * In telepathy-glib versions older than 0.11.13, every connection
85 * that used the #TpPresenceMixin was required to implement
86 * #TpSvcConnectionInterfacePresence; failing to do so would lead to an
87 * assertion failure. Since 0.11.13, this is no longer required.
88 * </para>
89 * </section> <!-- complex Presence -->
6090 *
6191 * Since: 0.5.13
6292 */
186216 * structure
187217 * @status_available: A callback to be used to determine if a given presence
188218 * status is available to be set on the connection. If NULL, all statuses are
189 * always considered available.
219 * always considered available. If SimplePresence is implemented, this
220 * callback may be called before the connection is connected.
190221 * @get_contact_statuses: A callback to be used get the current presence status
191222 * for contacts. This is used in implementations of various D-Bus methods and
192223 * hence must be provided.
385416
386417 DEBUG ("called.");
387418
388 presence_hash = construct_presence_hash (mixin_cls->statuses,
389 contact_statuses);
390 tp_svc_connection_interface_presence_emit_presence_update (obj,
391 presence_hash);
392
393 g_hash_table_destroy (presence_hash);
419 if (g_type_interface_peek (G_OBJECT_GET_CLASS (obj),
420 TP_TYPE_SVC_CONNECTION_INTERFACE_PRESENCE) != NULL)
421 {
422 presence_hash = construct_presence_hash (mixin_cls->statuses,
423 contact_statuses);
424 tp_svc_connection_interface_presence_emit_presence_update (obj,
425 presence_hash);
426
427 g_hash_table_destroy (presence_hash);
428 }
394429
395430 if (g_type_interface_peek (G_OBJECT_GET_CLASS (obj),
396431 TP_TYPE_SVC_CONNECTION_INTERFACE_SIMPLE_PRESENCE) != NULL)
15771577 * TpChannel *channel = ...;
15781578 * GQuark features[] = { TP_CHANNEL_FEATURE_CORE, 0 };
15791579 *
1580 * tp_proxy_prepare_async (channel, features, NULL, callback, user_data);
1580 * tp_proxy_prepare_async (channel, features, callback, user_data);
15811581 * ]|
15821582 *
15831583 * If a feature represents core functionality (like %TP_CHANNEL_FEATURE_CORE),
255255 g_object_class_install_property (object_class, PROP_DESTROY,
256256 param_spec);
257257
258 tp_base_client_implement_add_dispatch_operation (base_clt_cls,
259 add_dispatch_operation);
258 base_clt_cls->add_dispatch_operation = add_dispatch_operation;
260259 }
261260
262261 /**
8787 * @requests_satisfied: (element-type TelepathyGLib.ChannelRequest): a #GList of
8888 * #TpChannelRequest having their object-path defined but are not guaranteed
8989 * to be prepared.
90 * @user_action_time: the time at which user action occurred, or 0 if this
91 * channel is to be handled for some reason not involving user action.
90 * @user_action_time: the time at which user action occurred, or one of the
91 * special values %TP_USER_ACTION_TIME_NOT_USER_ACTION or
92 * %TP_USER_ACTION_TIME_CURRENT_TIME
93 * (see #TpAccountChannelRequest:user-action-time for details)
9294 * @context: a #TpHandleChannelsContext representing the context of this
9395 * D-Bus call
9496 * @user_data: arbitrary user-supplied data passed to tp_simple_handler_new()
303305 g_object_class_install_property (object_class, PROP_DESTROY,
304306 param_spec);
305307
306 tp_base_client_implement_handle_channels (base_clt_cls, handle_channels);
308 base_clt_cls->handle_channels = handle_channels;
307309 }
308310
309311 /**
279279 g_object_class_install_property (object_class, PROP_DESTROY,
280280 param_spec);
281281
282 tp_base_client_implement_observe_channels (base_clt_cls, observe_channels);
282 base_clt_cls->observe_channels = observe_channels;
283283 }
284284
285285 /**
13641364 g_simple_async_result_complete_in_idle (simple);
13651365 g_object_unref (simple);
13661366 }
1367
1368 /**
1369 * tp_user_action_time_from_x11:
1370 * @x11_time: an X11 timestamp, or 0 to indicate the current time
1371 *
1372 * Convert an X11 timestamp into a user action time as used in Telepathy.
1373 *
1374 * This also works for the timestamps used by Gdk 2.x and Clutter 1.0;
1375 * it may or may not work with other toolkits or versions.
1376 *
1377 * Returns: a nonzero Telepathy user action time, or
1378 * %TP_USER_ACTION_TIME_CURRENT_TIME
1379 *
1380 * Since: 0.11.13
1381 */
1382 gint64
1383 tp_user_action_time_from_x11 (guint32 x11_time)
1384 {
1385 if (x11_time == 0)
1386 {
1387 return TP_USER_ACTION_TIME_CURRENT_TIME;
1388 }
1389
1390 return x11_time;
1391 }
1392
1393 /**
1394 * tp_user_action_time_should_present:
1395 * @user_action_time: (type gint64): the Telepathy user action time
1396 * @x11_time: (out) (allow-none): a pointer to guint32 used to
1397 * return an X11 timestamp, or 0 to indicate the current time; if
1398 * %FALSE is returned, the value placed here is not meaningful
1399 *
1400 * Interpret a Telepathy user action time to decide whether a Handler should
1401 * attempt to gain focus. If %TRUE is returned, it would be appropriate to
1402 * call gtk_window_present_with_time() using @x11_time as input, for instance.
1403 *
1404 * @x11_time is used to return a timestamp in the right format for X11,
1405 * Gdk 2.x and Clutter 1.0; it may or may not work with other toolkits or
1406 * versions.
1407 *
1408 * Returns: %TRUE if it would be appropriate to present a window
1409 *
1410 * Since: 0.11.13
1411 */
1412
1413 gboolean
1414 tp_user_action_time_should_present (gint64 user_action_time,
1415 guint32 *x11_time)
1416 {
1417 guint32 when = 0;
1418 gboolean ret;
1419
1420 if (user_action_time > 0 && user_action_time <= G_MAXUINT32)
1421 {
1422 when = (guint32) user_action_time;
1423 ret = TRUE;
1424 }
1425 else if (user_action_time == TP_USER_ACTION_TIME_CURRENT_TIME)
1426 {
1427 ret = TRUE;
1428 }
1429 else
1430 {
1431 ret = FALSE;
1432 }
1433
1434 if (ret && x11_time != NULL)
1435 *x11_time = when;
1436
1437 return ret;
1438 }
140140 void tp_simple_async_report_success_in_idle (GObject *source,
141141 GAsyncReadyCallback callback, gpointer user_data, gpointer source_tag);
142142
143 gint64 tp_user_action_time_from_x11 (guint32 x11_time);
144 gboolean tp_user_action_time_should_present (gint64 user_action_time,
145 guint32 *x11_time);
146
143147 G_END_DECLS
144148
145149 #undef __TP_IN_UTIL_H__
0 Version: TELEPATHY_GLIB_0.11.13
1 Extends: TELEPATHY_GLIB_0.11.12
2 Release: 0.11.13
3
4 tp_error_quark
5 tp_user_action_time_from_x11
6 tp_user_action_time_should_present
337337 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
338338 VALAC = @VALAC@
339339 VALAFLAGS = @VALAFLAGS@
340 VALA_CFLAGS = @VALA_CFLAGS@
341 VALA_LIBS = @VALA_LIBS@
342340 VAPIGEN = @VAPIGEN@
343341 VERSION = @VERSION@
344342 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
643643 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
644644 VALAC = @VALAC@
645645 VALAFLAGS = @VALAFLAGS@
646 VALA_CFLAGS = @VALA_CFLAGS@
647 VALA_LIBS = @VALA_LIBS@
648646 VAPIGEN = @VAPIGEN@
649647 VERSION = @VERSION@
650648 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
198198 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
199199 VALAC = @VALAC@
200200 VALAFLAGS = @VALAFLAGS@
201 VALA_CFLAGS = @VALA_CFLAGS@
202 VALA_LIBS = @VALA_LIBS@
203201 VAPIGEN = @VAPIGEN@
204202 VERSION = @VERSION@
205203 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
163163 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
164164 VALAC = @VALAC@
165165 VALAFLAGS = @VALAFLAGS@
166 VALA_CFLAGS = @VALA_CFLAGS@
167 VALA_LIBS = @VALA_LIBS@
168166 VAPIGEN = @VAPIGEN@
169167 VERSION = @VERSION@
170168 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
160160 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
161161 VALAC = @VALAC@
162162 VALAFLAGS = @VALAFLAGS@
163 VALA_CFLAGS = @VALA_CFLAGS@
164 VALA_LIBS = @VALA_LIBS@
165163 VAPIGEN = @VAPIGEN@
166164 VERSION = @VERSION@
167165 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
1010 $(NULL)
1111
1212 pkgconfigdir = ${libdir}/pkgconfig
13 pkgconfig_DATA = telepathy-vala.pc
1413
15 telepathy-glib.vapi: $(top_srcdir)/telepathy-glib/TelepathyGLib-0.12.gir
14 telepathy-glib.vapi: $(top_builddir)/telepathy-glib/TelepathyGLib-0.12.gir
1615 $(VAPIGEN_V)$(VAPIGEN) \
1716 --library telepathy-glib \
1817 --pkg gio-2.0 \
3535 host_triplet = @host@
3636 subdir = vala
3737 DIST_COMMON = $(dist_vapi_DATA) $(srcdir)/Makefile.am \
38 $(srcdir)/Makefile.in \
39 $(srcdir)/telepathy-vala-uninstalled.pc.in \
40 $(srcdir)/telepathy-vala.pc.in
38 $(srcdir)/Makefile.in
4139 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
4240 am__aclocal_m4_deps = $(top_srcdir)/m4/compiler.m4 \
4341 $(top_srcdir)/m4/gtk-doc.m4 $(top_srcdir)/m4/introspection.m4 \
5149 $(ACLOCAL_M4)
5250 mkinstalldirs = $(install_sh) -d
5351 CONFIG_HEADER = $(top_builddir)/config.h
54 CONFIG_CLEAN_FILES = telepathy-vala.pc telepathy-vala-uninstalled.pc
52 CONFIG_CLEAN_FILES =
5553 CONFIG_CLEAN_VPATH_FILES =
5654 AM_V_GEN = $(am__v_GEN_$(V))
5755 am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY))
8280 am__base_list = \
8381 sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
8482 sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
85 am__installdirs = "$(DESTDIR)$(vapidir)" "$(DESTDIR)$(pkgconfigdir)" \
86 "$(DESTDIR)$(vapidir)"
87 DATA = $(dist_vapi_DATA) $(pkgconfig_DATA) $(vapi_DATA)
83 am__installdirs = "$(DESTDIR)$(vapidir)" "$(DESTDIR)$(vapidir)"
84 DATA = $(dist_vapi_DATA) $(vapi_DATA)
8885 DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
8986 ACLOCAL = @ACLOCAL@
9087 AMTAR = @AMTAR@
186183 TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@
187184 VALAC = @VALAC@
188185 VALAFLAGS = @VALAFLAGS@
189 VALA_CFLAGS = @VALA_CFLAGS@
190 VALA_LIBS = @VALA_LIBS@
191186 VAPIGEN = @VAPIGEN@
192187 VERSION = @VERSION@
193188 VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@
263258 $(NULL)
264259
265260 pkgconfigdir = ${libdir}/pkgconfig
266 pkgconfig_DATA = telepathy-vala.pc
267261 CLEANFILES = \
268262 $(BUILT_SOURCES) \
269263 $(NULL)
307301 $(ACLOCAL_M4): $(am__aclocal_m4_deps)
308302 cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
309303 $(am__aclocal_m4_deps):
310 telepathy-vala.pc: $(top_builddir)/config.status $(srcdir)/telepathy-vala.pc.in
311 cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
312 telepathy-vala-uninstalled.pc: $(top_builddir)/config.status $(srcdir)/telepathy-vala-uninstalled.pc.in
313 cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
314304
315305 mostlyclean-libtool:
316306 -rm -f *.lo
337327 test -n "$$files" || exit 0; \
338328 echo " ( cd '$(DESTDIR)$(vapidir)' && rm -f" $$files ")"; \
339329 cd "$(DESTDIR)$(vapidir)" && rm -f $$files
340 install-pkgconfigDATA: $(pkgconfig_DATA)
341 @$(NORMAL_INSTALL)
342 test -z "$(pkgconfigdir)" || $(MKDIR_P) "$(DESTDIR)$(pkgconfigdir)"
343 @list='$(pkgconfig_DATA)'; test -n "$(pkgconfigdir)" || list=; \
344 for p in $$list; do \
345 if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
346 echo "$$d$$p"; \
347 done | $(am__base_list) | \
348 while read files; do \
349 echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(pkgconfigdir)'"; \
350 $(INSTALL_DATA) $$files "$(DESTDIR)$(pkgconfigdir)" || exit $$?; \
351 done
352
353 uninstall-pkgconfigDATA:
354 @$(NORMAL_UNINSTALL)
355 @list='$(pkgconfig_DATA)'; test -n "$(pkgconfigdir)" || list=; \
356 files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
357 test -n "$$files" || exit 0; \
358 echo " ( cd '$(DESTDIR)$(pkgconfigdir)' && rm -f" $$files ")"; \
359 cd "$(DESTDIR)$(pkgconfigdir)" && rm -f $$files
360330 install-vapiDATA: $(vapi_DATA)
361331 @$(NORMAL_INSTALL)
362332 test -z "$(vapidir)" || $(MKDIR_P) "$(DESTDIR)$(vapidir)"
419389 $(MAKE) $(AM_MAKEFLAGS) check-am
420390 all-am: Makefile $(DATA)
421391 installdirs:
422 for dir in "$(DESTDIR)$(vapidir)" "$(DESTDIR)$(pkgconfigdir)" "$(DESTDIR)$(vapidir)"; do \
392 for dir in "$(DESTDIR)$(vapidir)" "$(DESTDIR)$(vapidir)"; do \
423393 test -z "$$dir" || $(MKDIR_P) "$$dir"; \
424394 done
425395 install: $(BUILT_SOURCES)
470440
471441 info-am:
472442
473 install-data-am: install-dist_vapiDATA install-pkgconfigDATA \
474 install-vapiDATA
443 install-data-am: install-dist_vapiDATA install-vapiDATA
475444
476445 install-dvi: install-dvi-am
477446
515484
516485 ps-am:
517486
518 uninstall-am: uninstall-dist_vapiDATA uninstall-pkgconfigDATA \
519 uninstall-vapiDATA
487 uninstall-am: uninstall-dist_vapiDATA uninstall-vapiDATA
520488
521489 .MAKE: all check install install-am install-strip
522490
526494 install-data install-data-am install-dist_vapiDATA install-dvi \
527495 install-dvi-am install-exec install-exec-am install-html \
528496 install-html-am install-info install-info-am install-man \
529 install-pdf install-pdf-am install-pkgconfigDATA install-ps \
530 install-ps-am install-strip install-vapiDATA installcheck \
531 installcheck-am installdirs maintainer-clean \
532 maintainer-clean-generic mostlyclean mostlyclean-generic \
533 mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am \
534 uninstall-dist_vapiDATA uninstall-pkgconfigDATA \
497 install-pdf install-pdf-am install-ps install-ps-am \
498 install-strip install-vapiDATA installcheck installcheck-am \
499 installdirs maintainer-clean maintainer-clean-generic \
500 mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \
501 ps ps-am uninstall uninstall-am uninstall-dist_vapiDATA \
535502 uninstall-vapiDATA
536503
537504
538 telepathy-glib.vapi: $(top_srcdir)/telepathy-glib/TelepathyGLib-0.12.gir
505 telepathy-glib.vapi: $(top_builddir)/telepathy-glib/TelepathyGLib-0.12.gir
539506 $(VAPIGEN_V)$(VAPIGEN) \
540507 --library telepathy-glib \
541508 --pkg gio-2.0 \
+0
-12
vala/telepathy-vala-uninstalled.pc.in less more
0 prefix=
1 exec_prefix=
2 abs_top_srcdir=@abs_top_srcdir@
3 abs_top_builddir=@abs_top_builddir@
4 vapidir=${abs_top_srcdir}/vala
5 valaflags=--vapidir=${vapidir}
6
7 Name: Telepathy Vala bindings (uninstalled copy)
8 Description: Vala bindings for the Telepathy framework
9 Version: @VERSION@
10 Requires: pkg-config >= 0.21
11 Requires.private: dbus-glib-1 >= 0.82, glib-2.0 >= 2.22, gobject-2.0 >= 2.22, gio-2.0 >= 2.22, telepathy-glib
+0
-14
vala/telepathy-vala.pc.in less more
0 prefix=@prefix@
1 exec_prefix=@exec_prefix@
2 libdir=@libdir@
3 includedir=@includedir@
4 datarootdir=@datarootdir@
5 datadir=@datadir@
6 vapidir=@datadir@/vala/vapi
7 valaflags=
8
9 Name: Telepathy Vala bindings
10 Description: Vala bindings for the Telepathy framework
11 Version: @VERSION@
12 Requires: pkg-config >= 0.21
13 Requires.private: dbus-glib-1 >= 0.82, glib-2.0 >= 2.22, gobject-2.0 >= 2.22, gio-2.0 >= 2.22, telepathy-glib