Imported Upstream version 0.11.13
Simon McVittie
13 years ago
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 | ||
0 | 240 | commit 8aef064cf3b8ab529f289b64ec30023e07ce00f6 |
1 | 241 | Author: Simon McVittie <simon.mcvittie@collabora.co.uk> |
2 | 242 | Date: 2010-08-10 16:22:21 +0100 |
44 | 44 | rsync -rtzvPp --chmod=a+rX docs/reference/html/ \ |
45 | 45 | $(UPLOAD_BRANCH_TO)-$(BRANCH)/ |
46 | 46 | |
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 | ||
47 | 58 | include tools/lcov.am |
48 | 59 | |
49 | 60 | CHANGELOG_RANGE = telepathy-glib-0.8.0.. |
216 | 216 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
217 | 217 | VALAC = @VALAC@ |
218 | 218 | VALAFLAGS = @VALAFLAGS@ |
219 | VALA_CFLAGS = @VALA_CFLAGS@ | |
220 | VALA_LIBS = @VALA_LIBS@ | |
221 | 219 | VAPIGEN = @VAPIGEN@ |
222 | 220 | VERSION = @VERSION@ |
223 | 221 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
491 | 489 | |
492 | 490 | distclean-tags: |
493 | 491 | -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags |
492 | @HAVE_AUTOMAKE_FOR_DIST_TRUE@dist-hook: | |
494 | 493 | |
495 | 494 | distdir: $(DISTFILES) |
496 | 495 | $(am__remove_distdir) |
809 | 808 | upload-branch-docs: all |
810 | 809 | rsync -rtzvPp --chmod=a+rX docs/reference/html/ \ |
811 | 810 | $(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 | |
812 | 819 | lcov-reset: |
813 | 820 | lcov --directory @top_srcdir@ --zerocounters |
814 | 821 |
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 | ||
0 | 39 | telepathy-glib 0.11.12 (2010-08-10) |
1 | 40 | =================================== |
2 | 41 |
1367 | 1367 | AC_SUBST([am__untar]) |
1368 | 1368 | ]) # _AM_PROG_TAR |
1369 | 1369 | |
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 | ||
1370 | 1400 | m4_include([m4/compiler.m4]) |
1371 | 1401 | m4_include([m4/gtk-doc.m4]) |
1372 | 1402 | m4_include([m4/introspection.m4]) |
0 | 0 | #! /bin/sh |
1 | 1 | # Guess values for system-dependent variables and create Makefiles. |
2 | # Generated by GNU Autoconf 2.67 for Telepathy-GLib 0.11.12. | |
2 | # Generated by GNU Autoconf 2.67 for Telepathy-GLib 0.11.13. | |
3 | 3 | # |
4 | 4 | # Report bugs to <https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=tp-glib>. |
5 | 5 | # |
677 | 677 | |
678 | 678 | |
679 | 679 | |
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 | ' | |
680 | 740 | |
681 | 741 | test -n "$DJDIR" || exec 7<&0 </dev/null |
682 | 742 | exec 6>&1 |
701 | 761 | # Identity of this package. |
702 | 762 | PACKAGE_NAME='Telepathy-GLib' |
703 | 763 | 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' | |
706 | 766 | PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=tp-glib' |
707 | 767 | PACKAGE_URL='' |
708 | 768 | |
774 | 834 | VAPIGEN |
775 | 835 | VALAFLAGS |
776 | 836 | VALAC |
777 | VALA_LIBS | |
778 | VALA_CFLAGS | |
779 | 837 | DBUS_LIBS |
780 | 838 | DBUS_CFLAGS |
781 | 839 | GLIB_MKENUMS |
869 | 927 | LDFLAGS |
870 | 928 | CFLAGS |
871 | 929 | CC |
930 | HAVE_AUTOMAKE_FOR_DIST_FALSE | |
931 | HAVE_AUTOMAKE_FOR_DIST_TRUE | |
872 | 932 | AM_BACKSLASH |
873 | 933 | AM_DEFAULT_VERBOSITY |
874 | 934 | am__untar |
978 | 1038 | GIO_UNIX_LIBS |
979 | 1039 | DBUS_CFLAGS |
980 | 1040 | DBUS_LIBS |
981 | VALA_CFLAGS | |
982 | VALA_LIBS | |
983 | 1041 | CXX |
984 | 1042 | CXXFLAGS |
985 | 1043 | CCC |
1526 | 1584 | # Omit some internal or obsolete options to make the list less imposing. |
1527 | 1585 | # This message is too long to be a string in the A/UX 3.1 sh. |
1528 | 1586 | 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. | |
1530 | 1588 | |
1531 | 1589 | Usage: $0 [OPTION]... [VAR=VALUE]... |
1532 | 1590 | |
1596 | 1654 | |
1597 | 1655 | if test -n "$ac_init_help"; then |
1598 | 1656 | 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:";; | |
1600 | 1658 | esac |
1601 | 1659 | cat <<\_ACEOF |
1602 | 1660 | |
1671 | 1729 | linker flags for GIO_UNIX, overriding pkg-config |
1672 | 1730 | DBUS_CFLAGS C compiler flags for DBUS, overriding pkg-config |
1673 | 1731 | 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 | |
1676 | 1732 | CXX C++ compiler command |
1677 | 1733 | CXXFLAGS C++ compiler flags |
1678 | 1734 | CXXCPP C++ preprocessor |
1743 | 1799 | test -n "$ac_init_help" && exit $ac_status |
1744 | 1800 | if $ac_init_version; then |
1745 | 1801 | cat <<\_ACEOF |
1746 | Telepathy-GLib configure 0.11.12 | |
1802 | Telepathy-GLib configure 0.11.13 | |
1747 | 1803 | generated by GNU Autoconf 2.67 |
1748 | 1804 | |
1749 | 1805 | Copyright (C) 2010 Free Software Foundation, Inc. |
2233 | 2289 | This file contains any messages produced by compilers while |
2234 | 2290 | running configure, to aid debugging if configure makes a mistake. |
2235 | 2291 | |
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 | |
2237 | 2293 | generated by GNU Autoconf 2.67. Invocation command line was |
2238 | 2294 | |
2239 | 2295 | $ $0 $@ |
3051 | 3107 | |
3052 | 3108 | # Define the identity of the package. |
3053 | 3109 | PACKAGE='telepathy-glib' |
3054 | VERSION='0.11.12' | |
3110 | VERSION='0.11.13' | |
3055 | 3111 | |
3056 | 3112 | |
3057 | 3113 | cat >>confdefs.h <<_ACEOF |
3105 | 3161 | *) AM_DEFAULT_VERBOSITY=1;; |
3106 | 3162 | esac |
3107 | 3163 | 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 | |
3108 | 3173 | |
3109 | 3174 | |
3110 | 3175 | ac_ext=c |
5060 | 5125 | else |
5061 | 5126 | lt_cv_nm_interface="BSD nm" |
5062 | 5127 | 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) | |
5064 | 5129 | (eval "$ac_compile" 2>conftest.err) |
5065 | 5130 | 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) | |
5067 | 5132 | (eval "$NM \"conftest.$ac_objext\"" 2>conftest.err > conftest.out) |
5068 | 5133 | cat conftest.err >&5 |
5069 | (eval echo "\"\$as_me:5070: output\"" >&5) | |
5134 | (eval echo "\"\$as_me:5135: output\"" >&5) | |
5070 | 5135 | cat conftest.out >&5 |
5071 | 5136 | if $GREP 'External.*some_variable' conftest.out > /dev/null; then |
5072 | 5137 | lt_cv_nm_interface="MS dumpbin" |
6272 | 6337 | ;; |
6273 | 6338 | *-*-irix6*) |
6274 | 6339 | # Find out which ABI we are using. |
6275 | echo '#line 6276 "configure"' > conftest.$ac_ext | |
6340 | echo '#line 6341 "configure"' > conftest.$ac_ext | |
6276 | 6341 | if { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_compile\""; } >&5 |
6277 | 6342 | (eval $ac_compile) 2>&5 |
6278 | 6343 | ac_status=$? |
7801 | 7866 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
7802 | 7867 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
7803 | 7868 | -e 's:$: $lt_compiler_flag:'` |
7804 | (eval echo "\"\$as_me:7805: $lt_compile\"" >&5) | |
7869 | (eval echo "\"\$as_me:7870: $lt_compile\"" >&5) | |
7805 | 7870 | (eval "$lt_compile" 2>conftest.err) |
7806 | 7871 | ac_status=$? |
7807 | 7872 | cat conftest.err >&5 |
7808 | echo "$as_me:7809: \$? = $ac_status" >&5 | |
7873 | echo "$as_me:7874: \$? = $ac_status" >&5 | |
7809 | 7874 | if (exit $ac_status) && test -s "$ac_outfile"; then |
7810 | 7875 | # The compiler can only warn and ignore the option if not recognized |
7811 | 7876 | # So say no if there are warnings other than the usual output. |
8140 | 8205 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
8141 | 8206 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
8142 | 8207 | -e 's:$: $lt_compiler_flag:'` |
8143 | (eval echo "\"\$as_me:8144: $lt_compile\"" >&5) | |
8208 | (eval echo "\"\$as_me:8209: $lt_compile\"" >&5) | |
8144 | 8209 | (eval "$lt_compile" 2>conftest.err) |
8145 | 8210 | ac_status=$? |
8146 | 8211 | cat conftest.err >&5 |
8147 | echo "$as_me:8148: \$? = $ac_status" >&5 | |
8212 | echo "$as_me:8213: \$? = $ac_status" >&5 | |
8148 | 8213 | if (exit $ac_status) && test -s "$ac_outfile"; then |
8149 | 8214 | # The compiler can only warn and ignore the option if not recognized |
8150 | 8215 | # So say no if there are warnings other than the usual output. |
8245 | 8310 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
8246 | 8311 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
8247 | 8312 | -e 's:$: $lt_compiler_flag:'` |
8248 | (eval echo "\"\$as_me:8249: $lt_compile\"" >&5) | |
8313 | (eval echo "\"\$as_me:8314: $lt_compile\"" >&5) | |
8249 | 8314 | (eval "$lt_compile" 2>out/conftest.err) |
8250 | 8315 | ac_status=$? |
8251 | 8316 | cat out/conftest.err >&5 |
8252 | echo "$as_me:8253: \$? = $ac_status" >&5 | |
8317 | echo "$as_me:8318: \$? = $ac_status" >&5 | |
8253 | 8318 | if (exit $ac_status) && test -s out/conftest2.$ac_objext |
8254 | 8319 | then |
8255 | 8320 | # The compiler can only warn and ignore the option if not recognized |
8300 | 8365 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
8301 | 8366 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
8302 | 8367 | -e 's:$: $lt_compiler_flag:'` |
8303 | (eval echo "\"\$as_me:8304: $lt_compile\"" >&5) | |
8368 | (eval echo "\"\$as_me:8369: $lt_compile\"" >&5) | |
8304 | 8369 | (eval "$lt_compile" 2>out/conftest.err) |
8305 | 8370 | ac_status=$? |
8306 | 8371 | cat out/conftest.err >&5 |
8307 | echo "$as_me:8308: \$? = $ac_status" >&5 | |
8372 | echo "$as_me:8373: \$? = $ac_status" >&5 | |
8308 | 8373 | if (exit $ac_status) && test -s out/conftest2.$ac_objext |
8309 | 8374 | then |
8310 | 8375 | # The compiler can only warn and ignore the option if not recognized |
10684 | 10749 | lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 |
10685 | 10750 | lt_status=$lt_dlunknown |
10686 | 10751 | cat > conftest.$ac_ext <<_LT_EOF |
10687 | #line 10688 "configure" | |
10752 | #line 10753 "configure" | |
10688 | 10753 | #include "confdefs.h" |
10689 | 10754 | |
10690 | 10755 | #if HAVE_DLFCN_H |
10780 | 10845 | lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 |
10781 | 10846 | lt_status=$lt_dlunknown |
10782 | 10847 | cat > conftest.$ac_ext <<_LT_EOF |
10783 | #line 10784 "configure" | |
10848 | #line 10849 "configure" | |
10784 | 10849 | #include "confdefs.h" |
10785 | 10850 | |
10786 | 10851 | #if HAVE_DLFCN_H |
11450 | 11515 | |
11451 | 11516 | |
11452 | 11517 | |
11453 | LT_CURRENT=41 | |
11518 | LT_CURRENT=42 | |
11454 | 11519 | LT_REVISION=0 |
11455 | LT_AGE=41 | |
11520 | LT_AGE=42 | |
11456 | 11521 | |
11457 | 11522 | |
11458 | 11523 | |
12184 | 12249 | |
12185 | 12250 | |
12186 | 12251 | 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 | ||
12278 | 12252 | # Extract the first word of "valac", so it can be a program name with args. |
12279 | 12253 | set dummy valac; ac_word=$2 |
12280 | 12254 | { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 |
12302 | 12276 | done |
12303 | 12277 | IFS=$as_save_IFS |
12304 | 12278 | |
12305 | test -z "$ac_cv_path_VALAC" && ac_cv_path_VALAC="valac" | |
12306 | 12279 | ;; |
12307 | 12280 | esac |
12308 | 12281 | fi |
12316 | 12289 | fi |
12317 | 12290 | |
12318 | 12291 | |
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 | |
12330 | 12400 | $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 | |
12331 | 12410 | fi |
12332 | 12411 | |
12333 | 12412 | |
15385 | 15464 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
15386 | 15465 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
15387 | 15466 | -e 's:$: $lt_compiler_flag:'` |
15388 | (eval echo "\"\$as_me:15389: $lt_compile\"" >&5) | |
15467 | (eval echo "\"\$as_me:15468: $lt_compile\"" >&5) | |
15389 | 15468 | (eval "$lt_compile" 2>conftest.err) |
15390 | 15469 | ac_status=$? |
15391 | 15470 | cat conftest.err >&5 |
15392 | echo "$as_me:15393: \$? = $ac_status" >&5 | |
15471 | echo "$as_me:15472: \$? = $ac_status" >&5 | |
15393 | 15472 | if (exit $ac_status) && test -s "$ac_outfile"; then |
15394 | 15473 | # The compiler can only warn and ignore the option if not recognized |
15395 | 15474 | # So say no if there are warnings other than the usual output. |
15484 | 15563 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
15485 | 15564 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
15486 | 15565 | -e 's:$: $lt_compiler_flag:'` |
15487 | (eval echo "\"\$as_me:15488: $lt_compile\"" >&5) | |
15566 | (eval echo "\"\$as_me:15567: $lt_compile\"" >&5) | |
15488 | 15567 | (eval "$lt_compile" 2>out/conftest.err) |
15489 | 15568 | ac_status=$? |
15490 | 15569 | cat out/conftest.err >&5 |
15491 | echo "$as_me:15492: \$? = $ac_status" >&5 | |
15570 | echo "$as_me:15571: \$? = $ac_status" >&5 | |
15492 | 15571 | if (exit $ac_status) && test -s out/conftest2.$ac_objext |
15493 | 15572 | then |
15494 | 15573 | # The compiler can only warn and ignore the option if not recognized |
15536 | 15615 | -e 's:.*FLAGS}\{0,1\} :&$lt_compiler_flag :; t' \ |
15537 | 15616 | -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ |
15538 | 15617 | -e 's:$: $lt_compiler_flag:'` |
15539 | (eval echo "\"\$as_me:15540: $lt_compile\"" >&5) | |
15618 | (eval echo "\"\$as_me:15619: $lt_compile\"" >&5) | |
15540 | 15619 | (eval "$lt_compile" 2>out/conftest.err) |
15541 | 15620 | ac_status=$? |
15542 | 15621 | cat out/conftest.err >&5 |
15543 | echo "$as_me:15544: \$? = $ac_status" >&5 | |
15622 | echo "$as_me:15623: \$? = $ac_status" >&5 | |
15544 | 15623 | if (exit $ac_status) && test -s out/conftest2.$ac_objext |
15545 | 15624 | then |
15546 | 15625 | # The compiler can only warn and ignore the option if not recognized |
16530 | 16609 | fi |
16531 | 16610 | |
16532 | 16611 | |
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" | |
16534 | 16613 | |
16535 | 16614 | cat >confcache <<\_ACEOF |
16536 | 16615 | # This file is a shell script that caches the results of configure |
16638 | 16717 | am__EXEEXT_FALSE= |
16639 | 16718 | fi |
16640 | 16719 | |
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 | |
16641 | 16724 | if test -z "${AMDEP_TRUE}" && test -z "${AMDEP_FALSE}"; then |
16642 | 16725 | as_fn_error $? "conditional \"AMDEP\" was never defined. |
16643 | 16726 | Usually this means the macro was only invoked conditionally." "$LINENO" 5 |
17114 | 17197 | # report actual input values of CONFIG_FILES etc. instead of their |
17115 | 17198 | # values after options handling. |
17116 | 17199 | 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 | |
17118 | 17201 | generated by GNU Autoconf 2.67. Invocation command line was |
17119 | 17202 | |
17120 | 17203 | CONFIG_FILES = $CONFIG_FILES |
17180 | 17263 | cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 |
17181 | 17264 | ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" |
17182 | 17265 | ac_cs_version="\\ |
17183 | Telepathy-GLib config.status 0.11.12 | |
17266 | Telepathy-GLib config.status 0.11.13 | |
17184 | 17267 | configured by $0, generated by GNU Autoconf 2.67, |
17185 | 17268 | with options \\"\$ac_cs_config\\" |
17186 | 17269 | |
17690 | 17773 | "tools/Makefile") CONFIG_FILES="$CONFIG_FILES tools/Makefile" ;; |
17691 | 17774 | "m4/Makefile") CONFIG_FILES="$CONFIG_FILES m4/Makefile" ;; |
17692 | 17775 | "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" ;; | |
17695 | 17776 | |
17696 | 17777 | *) as_fn_error $? "invalid argument: \`$ac_config_target'" "$LINENO" 5 ;; |
17697 | 17778 | esac |
10 | 10 | |
11 | 11 | m4_define([tp_glib_major_version], [0]) |
12 | 12 | m4_define([tp_glib_minor_version], [11]) |
13 | m4_define([tp_glib_micro_version], [12]) | |
13 | m4_define([tp_glib_micro_version], [13]) | |
14 | 14 | m4_define([tp_glib_nano_version], [0]) |
15 | 15 | |
16 | 16 | # If library source has changed since last release, increment revision |
25 | 25 | # (we don't guarantee that we won't add ABI then remove it again, if it was |
26 | 26 | # never seen in a release). |
27 | 27 | |
28 | m4_define([tp_glib_lt_current], [41]) | |
28 | m4_define([tp_glib_lt_current], [42]) | |
29 | 29 | m4_define([tp_glib_lt_revision], [0]) |
30 | m4_define([tp_glib_lt_age], [41]) | |
30 | m4_define([tp_glib_lt_age], [42]) | |
31 | 31 | |
32 | 32 | # Some magic |
33 | 33 | m4_define([tp_glib_base_version], |
44 | 44 | AM_INIT_AUTOMAKE([1.9 -Wno-portability]) |
45 | 45 | AM_CONFIG_HEADER(config.h) |
46 | 46 | |
47 | dnl We're compatible with automake 1.9 (to be nice to Maemo 5), but with | |
48 | dnl reduced functionality | |
47 | 49 | 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]) | |
48 | 55 | |
49 | 56 | dnl check for tools |
50 | 57 | AC_PROG_CC |
195 | 202 | enable_vala_bindings=no ) |
196 | 203 | |
197 | 204 | 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])]) | |
200 | 207 | have_vala=yes |
201 | 208 | |
202 | 209 | AC_PATH_PROG(VALAC, valac, valac) |
203 | 210 | AC_SUBST(VALAC) |
204 | 211 | AC_SUBST(VALAFLAGS) |
205 | 212 | |
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?]) | |
213 | 217 | fi |
214 | 218 | |
215 | 219 | AC_SUBST(VAPIGEN) |
295 | 299 | tests/tools/Makefile \ |
296 | 300 | tools/Makefile \ |
297 | 301 | m4/Makefile \ |
298 | vala/Makefile \ | |
299 | vala/telepathy-vala.pc \ | |
300 | vala/telepathy-vala-uninstalled.pc | |
302 | vala/Makefile | |
301 | 303 | ) |
198 | 198 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
199 | 199 | VALAC = @VALAC@ |
200 | 200 | VALAFLAGS = @VALAFLAGS@ |
201 | VALA_CFLAGS = @VALA_CFLAGS@ | |
202 | VALA_LIBS = @VALA_LIBS@ | |
203 | 201 | VAPIGEN = @VAPIGEN@ |
204 | 202 | VERSION = @VERSION@ |
205 | 203 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
173 | 173 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
174 | 174 | VALAC = @VALAC@ |
175 | 175 | VALAFLAGS = @VALAFLAGS@ |
176 | VALA_CFLAGS = @VALA_CFLAGS@ | |
177 | VALA_LIBS = @VALA_LIBS@ | |
178 | 176 | VAPIGEN = @VAPIGEN@ |
179 | 177 | VERSION = @VERSION@ |
180 | 178 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
256 | 256 | <ANCHOR id="TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS"> |
257 | 257 | <ANCHOR id="TP-CLIENT-BUS-NAME-BASE:CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS"> |
258 | 258 | <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"> | |
259 | 261 | <ANCHOR id="telepathy-glib-handle" href="telepathy-glib/telepathy-glib-handle.html"> |
260 | 262 | <ANCHOR id="telepathy-glib-handle.synopsis" href="telepathy-glib/telepathy-glib-handle.html#telepathy-glib-handle.synopsis"> |
261 | 263 | <ANCHOR id="telepathy-glib-handle.description" href="telepathy-glib/telepathy-glib-handle.html#telepathy-glib-handle.description"> |
854 | 856 | <ANCHOR id="telepathy-glib-errors.description" href="telepathy-glib/telepathy-glib-errors.html#telepathy-glib-errors.description"> |
855 | 857 | <ANCHOR id="telepathy-glib-errors.details" href="telepathy-glib/telepathy-glib-errors.html#telepathy-glib-errors.details"> |
856 | 858 | <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"> | |
858 | 860 | <ANCHOR id="TP-TYPE-ERROR:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"> |
859 | 861 | <ANCHOR id="TpError" href="telepathy-glib/telepathy-glib-errors.html#TpError"> |
860 | 862 | <ANCHOR id="TP-ERROR-NETWORK-ERROR:CAPS" href="telepathy-glib/telepathy-glib-errors.html#TP-ERROR-NETWORK-ERROR:CAPS"> |
3890 | 3892 | <ANCHOR id="tp-clear-object" href="telepathy-glib/telepathy-glib-util.html#tp-clear-object"> |
3891 | 3893 | <ANCHOR id="tp-clear-boxed" href="telepathy-glib/telepathy-glib-util.html#tp-clear-boxed"> |
3892 | 3894 | <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"> | |
3893 | 3897 | <ANCHOR id="telepathy-glib-gnio-util" href="telepathy-glib/telepathy-glib-gnio-util.html"> |
3894 | 3898 | <ANCHOR id="telepathy-glib-gnio-util.synopsis" href="telepathy-glib/telepathy-glib-gnio-util.html#telepathy-glib-gnio-util.synopsis"> |
3895 | 3899 | <ANCHOR id="telepathy-glib-gnio-util.description" href="telepathy-glib/telepathy-glib-gnio-util.html#telepathy-glib-gnio-util.description"> |
89 | 89 | <a name="telepathy-glib-TpPresenceMixin.description"></a><h2>Description</h2> |
90 | 90 | <p> |
91 | 91 | 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. | |
102 | 96 | </p> |
103 | 97 | <p> |
104 | 98 | 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 |
108 | 102 | <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. |
109 | 103 | </p> |
110 | 104 | <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> | |
127 | 156 | </p> |
128 | 157 | </div> |
129 | 158 | <div class="refsect1" title="Details"> |
533 | 562 | <td><p><span class="term"><em class="parameter"><code>status_available</code></em>Â :</span></p></td> |
534 | 563 | <td>A callback to be used to determine if a given presence |
535 | 564 | 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. | |
537 | 567 | </td> |
538 | 568 | </tr> |
539 | 569 | <tr> |
146 | 146 | <p> |
147 | 147 | Data structure representing a <a class="link" href="telepathy-glib-account-channel-request.html#TpAccountChannelRequest"><span class="type">TpAccountChannelRequest</span></a> object. |
148 | 148 | </p> |
149 | <p class="since">Since 0.11.UNRELEASED</p> | |
149 | <p class="since">Since 0.11.12</p> | |
150 | 150 | </div> |
151 | 151 | <hr> |
152 | 152 | <div class="refsect2" title="tp_account_channel_request_new ()"> |
169 | 169 | <tr> |
170 | 170 | <td><p><span class="term"><em class="parameter"><code>request</code></em>Â :</span></p></td> |
171 | 171 | <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> | |
173 | 173 | </td> |
174 | 174 | </tr> |
175 | 175 | <tr> |
176 | 176 | <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>) | |
179 | 181 | </td> |
180 | 182 | </tr> |
181 | 183 | <tr> |
186 | 188 | </tr> |
187 | 189 | </tbody> |
188 | 190 | </table></div> |
189 | <p class="since">Since 0.11.UNRELEASED</p> | |
191 | <p class="since">Since 0.11.12</p> | |
190 | 192 | </div> |
191 | 193 | <hr> |
192 | 194 | <div class="refsect2" title="tp_account_channel_request_get_request ()"> |
211 | 213 | </tr> |
212 | 214 | </tbody> |
213 | 215 | </table></div> |
214 | <p class="since">Since 0.11.UNRELEASED</p> | |
216 | <p class="since">Since 0.11.12</p> | |
215 | 217 | </div> |
216 | 218 | <hr> |
217 | 219 | <div class="refsect2" title="tp_account_channel_request_get_user_action_time ()"> |
237 | 239 | </tr> |
238 | 240 | </tbody> |
239 | 241 | </table></div> |
240 | <p class="since">Since 0.11.UNRELEASED</p> | |
242 | <p class="since">Since 0.11.12</p> | |
241 | 243 | </div> |
242 | 244 | <hr> |
243 | 245 | <div class="refsect2" title="tp_account_channel_request_get_account ()"> |
262 | 264 | </tr> |
263 | 265 | </tbody> |
264 | 266 | </table></div> |
265 | <p class="since">Since 0.11.UNRELEASED</p> | |
267 | <p class="since">Since 0.11.12</p> | |
266 | 268 | </div> |
267 | 269 | <hr> |
268 | 270 | <div class="refsect2" title="tp_account_channel_request_create_and_handle_channel_async ()"> |
280 | 282 | <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 |
281 | 283 | result of the operation. |
282 | 284 | </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> | |
283 | 290 | <div class="variablelist"><table border="0"> |
284 | 291 | <col align="left" valign="top"> |
285 | 292 | <tbody> |
305 | 312 | </tr> |
306 | 313 | </tbody> |
307 | 314 | </table></div> |
308 | <p class="since">Since 0.11.UNRELEASED</p> | |
315 | <p class="since">Since 0.11.12</p> | |
309 | 316 | </div> |
310 | 317 | <hr> |
311 | 318 | <div class="refsect2" title="tp_account_channel_request_create_and_handle_channel_finish ()"> |
351 | 358 | </tr> |
352 | 359 | </tbody> |
353 | 360 | </table></div> |
354 | <p class="since">Since 0.11.UNRELEASED</p> | |
361 | <p class="since">Since 0.11.12</p> | |
355 | 362 | </div> |
356 | 363 | <hr> |
357 | 364 | <div class="refsect2" title="tp_account_channel_request_ensure_and_handle_channel_async ()"> |
373 | 380 | If the channel already exists and is already being handled, or if a |
374 | 381 | newly created channel is sent to a different handler, this operation |
375 | 382 | 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>.) | |
378 | 392 | </p> |
379 | 393 | <div class="variablelist"><table border="0"> |
380 | 394 | <col align="left" valign="top"> |
401 | 415 | </tr> |
402 | 416 | </tbody> |
403 | 417 | </table></div> |
404 | <p class="since">Since 0.11.UNRELEASED</p> | |
418 | <p class="since">Since 0.11.12</p> | |
405 | 419 | </div> |
406 | 420 | <hr> |
407 | 421 | <div class="refsect2" title="tp_account_channel_request_ensure_and_handle_channel_finish ()"> |
452 | 466 | </tr> |
453 | 467 | </tbody> |
454 | 468 | </table></div> |
455 | <p class="since">Since 0.11.UNRELEASED</p> | |
469 | <p class="since">Since 0.11.12</p> | |
456 | 470 | </div> |
457 | 471 | <hr> |
458 | 472 | <div class="refsect2" title="tp_account_channel_request_create_channel_async ()"> |
504 | 518 | </tr> |
505 | 519 | </tbody> |
506 | 520 | </table></div> |
507 | <p class="since">Since 0.11.UNRELEASED</p> | |
521 | <p class="since">Since 0.11.12</p> | |
508 | 522 | </div> |
509 | 523 | <hr> |
510 | 524 | <div class="refsect2" title="tp_account_channel_request_create_channel_finish ()"> |
544 | 558 | </tr> |
545 | 559 | </tbody> |
546 | 560 | </table></div> |
547 | <p class="since">Since 0.11.UNRELEASED</p> | |
561 | <p class="since">Since 0.11.12</p> | |
548 | 562 | </div> |
549 | 563 | <hr> |
550 | 564 | <div class="refsect2" title="tp_account_channel_request_ensure_channel_async ()"> |
559 | 573 | Asynchronously calls EnsureChannel on the ChannelDispatcher to create a |
560 | 574 | 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> |
561 | 575 | 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> | |
562 | 586 | <em class="parameter"><code>callback</code></em> will be called when an existing channel's handler has been |
563 | 587 | notified, a new channel has been created and dispatched, or the request |
564 | 588 | has failed. |
597 | 621 | </tr> |
598 | 622 | </tbody> |
599 | 623 | </table></div> |
600 | <p class="since">Since 0.11.UNRELEASED</p> | |
624 | <p class="since">Since 0.11.12</p> | |
601 | 625 | </div> |
602 | 626 | <hr> |
603 | 627 | <div class="refsect2" title="tp_account_channel_request_ensure_channel_finish ()"> |
637 | 661 | </tr> |
638 | 662 | </tbody> |
639 | 663 | </table></div> |
640 | <p class="since">Since 0.11.UNRELEASED</p> | |
664 | <p class="since">Since 0.11.12</p> | |
641 | 665 | </div> |
642 | 666 | </div> |
643 | 667 | <div class="refsect1" title="Property Details"> |
652 | 676 | <p> |
653 | 677 | 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>. |
654 | 678 | </p> |
655 | <p class="since">Since 0.11.UNRELEASED</p> | |
679 | <p class="since">Since 0.11.12</p> | |
656 | 680 | </div> |
657 | 681 | <hr> |
658 | 682 | <div class="refsect2" title='The "request" property'> |
659 | 683 | <a name="TpAccountChannelRequest--request"></a><h3>The <code class="literal">"request"</code> property</h3> |
660 | 684 | <pre class="programlisting"> "request" <span class="type">GHashTable_gchararray+GValue_*</span> : Read / Write / Construct Only</pre> |
661 | 685 | <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>. | |
664 | 688 | </p> |
665 | 689 | <p> |
666 | 690 | 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>. |
667 | 691 | </p> |
668 | <p class="since">Since 0.11.UNRELEASED</p> | |
692 | <p class="since">Since 0.11.12</p> | |
669 | 693 | </div> |
670 | 694 | <hr> |
671 | 695 | <div class="refsect2" title='The "user-action-time" property'> |
672 | 696 | <a name="TpAccountChannelRequest--user-action-time"></a><h3>The <code class="literal">"user-action-time"</code> property</h3> |
673 | 697 | <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> |
674 | 698 | <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 | |
676 | 700 | requesting the channel. |
677 | 701 | </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> | |
678 | 728 | <p>Default value: 0</p> |
679 | <p class="since">Since 0.11.UNRELEASED</p> | |
729 | <p class="since">Since 0.11.12</p> | |
680 | 730 | </div> |
681 | 731 | </div> |
682 | 732 | <div class="refsect1" title="Signal Details"> |
689 | 739 | <a class="link" href="telepathy-glib-handle-channels-context.html#TpHandleChannelsContext"><span class="type">TpHandleChannelsContext</span></a> *context, |
690 | 740 | <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> |
691 | 741 | <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. | |
693 | 754 | </p> |
694 | 755 | <div class="variablelist"><table border="0"> |
695 | 756 | <col align="left" valign="top"> |
706 | 767 | </tr> |
707 | 768 | <tr> |
708 | 769 | <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> | |
711 | 774 | </td> |
712 | 775 | </tr> |
713 | 776 | <tr> |
722 | 785 | </tr> |
723 | 786 | </tbody> |
724 | 787 | </table></div> |
725 | <p class="since">Since 0.11.UNRELEASED</p> | |
788 | <p class="since">Since 0.11.12</p> | |
726 | 789 | </div> |
727 | 790 | </div> |
728 | 791 | </div> |
234 | 234 | <p> |
235 | 235 | </p> |
236 | 236 | <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> | |
238 | 238 | <div class="example-contents"> |
239 | 239 | <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> |
240 | 240 | <tbody> |
546 | 546 | <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> |
547 | 547 | <p> |
548 | 548 | 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. | |
550 | 550 | </p> |
551 | 551 | <p> |
552 | 552 | Otherwise return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. |
182 | 182 | <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> |
183 | 183 | <p> |
184 | 184 | 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>. | |
188 | 187 | </p> |
189 | 188 | <p> |
190 | 189 | 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>. | |
193 | 192 | </p> |
194 | 193 | <div class="variablelist"><table border="0"> |
195 | 194 | <col align="left" valign="top"> |
286 | 285 | </p> |
287 | 286 | <p> |
288 | 287 | 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>. | |
291 | 290 | </p> |
292 | 291 | <div class="variablelist"><table border="0"> |
293 | 292 | <col align="left" valign="top"> |
383 | 382 | Called by subclasses to define the actual implementation of the |
384 | 383 | <code class="function">ObserveChannels()</code> D-Bus method. |
385 | 384 | </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> | |
386 | 389 | <div class="variablelist"><table border="0"> |
387 | 390 | <col align="left" valign="top"> |
388 | 391 | <tbody> |
408 | 411 | <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> |
409 | 412 | <p> |
410 | 413 | 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>. | |
414 | 416 | </p> |
415 | 417 | <p> |
416 | 418 | 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>. | |
419 | 421 | </p> |
420 | 422 | <div class="variablelist"><table border="0"> |
421 | 423 | <col align="left" valign="top"> |
564 | 566 | Called by subclasses to define the actual implementation of the |
565 | 567 | <code class="function">AddDispatchOperation()</code> D-Bus method. |
566 | 568 | </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> | |
567 | 573 | <div class="variablelist"><table border="0"> |
568 | 574 | <col align="left" valign="top"> |
569 | 575 | <tbody> |
596 | 602 | </p> |
597 | 603 | <p> |
598 | 604 | 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>. | |
601 | 607 | </p> |
602 | 608 | <div class="variablelist"><table border="0"> |
603 | 609 | <col align="left" valign="top"> |
631 | 637 | </p> |
632 | 638 | <p> |
633 | 639 | 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>. | |
636 | 642 | </p> |
637 | 643 | <div class="variablelist"><table border="0"> |
638 | 644 | <col align="left" valign="top"> |
669 | 675 | </p> |
670 | 676 | <p> |
671 | 677 | 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>. | |
674 | 680 | </p> |
675 | 681 | <div class="variablelist"><table border="0"> |
676 | 682 | <col align="left" valign="top"> |
698 | 704 | <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> |
699 | 705 | <p> |
700 | 706 | 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>. | |
704 | 709 | </p> |
705 | 710 | <p> |
706 | 711 | 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>. | |
709 | 714 | </p> |
710 | 715 | <div class="variablelist"><table border="0"> |
711 | 716 | <col align="left" valign="top"> |
737 | 742 | <p> |
738 | 743 | 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 |
739 | 744 | 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>. | |
741 | 746 | </p> |
742 | 747 | <div class="variablelist"><table border="0"> |
743 | 748 | <col align="left" valign="top"> |
802 | 807 | </tr> |
803 | 808 | <tr> |
804 | 809 | <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) | |
807 | 814 | </td> |
808 | 815 | </tr> |
809 | 816 | <tr> |
826 | 833 | Called by subclasses to define the actual implementation of the |
827 | 834 | <code class="function">HandleChannels()</code> D-Bus method. |
828 | 835 | </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> | |
829 | 840 | <div class="variablelist"><table border="0"> |
830 | 841 | <col align="left" valign="top"> |
831 | 842 | <tbody> |
911 | 922 | </p> |
912 | 923 | <p> |
913 | 924 | 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>. | |
916 | 927 | </p> |
917 | 928 | <div class="variablelist"><table border="0"> |
918 | 929 | <col align="left" valign="top"> |
945 | 956 | </p> |
946 | 957 | <p> |
947 | 958 | 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>. | |
950 | 961 | </p> |
951 | 962 | <div class="variablelist"><table border="0"> |
952 | 963 | <col align="left" valign="top"> |
143 | 143 | <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> |
144 | 144 | (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>, |
145 | 145 | <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>, | |
147 | 147 | <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>, |
148 | 148 | <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>); |
149 | 149 | <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> |
1157 | 1157 | <pre class="programlisting"><span class="returnvalue">void</span> tp_channel_dispatch_operation_handle_with_time_async |
1158 | 1158 | (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>, |
1159 | 1159 | <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>, | |
1161 | 1161 | <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>, |
1162 | 1162 | <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> |
1163 | 1163 | <p> |
1167 | 1167 | </p> |
1168 | 1168 | <p> |
1169 | 1169 | 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 | |
1171 | 1171 | result of <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#gdk-event-get-time"><code class="function">gdk_event_get_time()</code></a> if it is not <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>). Otherwise, it |
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>). | |
1175 | 1177 | </p> |
1176 | 1178 | <p> |
1177 | 1179 | This method has been introduced in telepathy-mission-control 5.5.0. |
1192 | 1194 | </td> |
1193 | 1195 | </tr> |
1194 | 1196 | <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> | |
1197 | 1201 | </td> |
1198 | 1202 | </tr> |
1199 | 1203 | <tr> |
148 | 148 | </p> |
149 | 149 | <p> |
150 | 150 | 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. | |
152 | 152 | </p> |
153 | 153 | <p> |
154 | 154 | 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> |
481 | 481 | <em class="parameter"><code>contacts</code></em> will contain contact objects for those IDs that were |
482 | 482 | valid (it may be empty), and <em class="parameter"><code>failed_id_errors</code></em> will map the IDs |
483 | 483 | 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 | |
485 | 485 | <a class="link" href="telepathy-glib-errors.html#TP-ERROR-INVALID-HANDLE:CAPS"><code class="literal">TP_ERROR_INVALID_HANDLE</code></a>). |
486 | 486 | </p> |
487 | 487 | <p> |
786 | 786 | </tr> |
787 | 787 | <tr> |
788 | 788 | <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 | |
790 | 790 | 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 |
791 | 791 | <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a> |
792 | 792 | |
816 | 816 | </tr> |
817 | 817 | <tr> |
818 | 818 | <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 | |
820 | 820 | <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 |
821 | 821 | <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Slices.html#g-slice-free"><code class="function">g_slice_free()</code></a> |
822 | 822 | |
845 | 845 | </tr> |
846 | 846 | <tr> |
847 | 847 | <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 | |
849 | 849 | 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> |
850 | 850 | |
851 | 851 | </td> |
874 | 874 | </tr> |
875 | 875 | <tr> |
876 | 876 | <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>, | |
878 | 878 | 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> |
879 | 879 | |
880 | 880 | </td> |
905 | 905 | </tr> |
906 | 906 | <tr> |
907 | 907 | <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>, | |
909 | 909 | 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> |
910 | 910 | |
911 | 911 | </td> |
51 | 51 | #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> |
52 | 52 | #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> |
53 | 53 | #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> | |
54 | 56 | </pre> |
55 | 57 | </div> |
56 | 58 | <div class="refsect1" title="Description"> |
170 | 172 | The common prefix of the well-known object path for any Telepathy Client. |
171 | 173 | </p> |
172 | 174 | </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> | |
173 | 211 | </div> |
174 | 212 | </div> |
175 | 213 | <div class="footer"> |
41 | 41 | #include <telepathy-glib/errors.h> |
42 | 42 | |
43 | 43 | #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> | |
45 | 45 | #define <a class="link" href="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS" title="TP_TYPE_ERROR">TP_TYPE_ERROR</a> |
46 | 46 | enum <a class="link" href="telepathy-glib-errors.html#TpError" title="enum TpError">TpError</a>; |
47 | 47 | <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>, |
118 | 118 | <p class="since">Since 0.7.1</p> |
119 | 119 | </div> |
120 | 120 | <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 ()) | |
124 | 124 | </pre> |
125 | 125 | <p> |
126 | 126 | The error domain for the D-Bus errors described in the Telepathy |
133 | 133 | 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 |
134 | 134 | called. |
135 | 135 | </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> | |
136 | 141 | </div> |
137 | 142 | <hr> |
138 | 143 | <div class="refsect2" title="TP_TYPE_ERROR"> |
475 | 480 | <td>org.freedesktop.Telepathy.Error.Cert.Revoked: |
476 | 481 | Raised if the server provided an SSL/TLS certificate that has been |
477 | 482 | revoked. |
478 | Since: 0.11.UNRELEASED | |
483 | Since: 0.11.12 | |
479 | 484 | </td> |
480 | 485 | </tr> |
481 | 486 | <tr> |
483 | 488 | <td>org.freedesktop.Telepathy.Error.Cert.Insecure: |
484 | 489 | Raised if the server provided an SSL/TLS certificate that uses an |
485 | 490 | insecure cipher algorithm or is cryptographically weak. |
486 | Since: 0.11.UNRELEASED | |
491 | Since: 0.11.12 | |
487 | 492 | </td> |
488 | 493 | </tr> |
489 | 494 | <tr> |
492 | 497 | Raised if the length in bytes of the server certificate, or the depth |
493 | 498 | of the server certificate chain, exceed the limits imposed by the |
494 | 499 | crypto library. |
495 | Since: 0.11.UNRELEASED | |
500 | Since: 0.11.12 | |
496 | 501 | </td> |
497 | 502 | </tr> |
498 | 503 | </tbody> |
220 | 220 | <p> |
221 | 221 | Expands to a call to a function |
222 | 222 | 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> | |
224 | 224 | </p> |
225 | 225 | <p class="since">Since 0.11.1</p> |
226 | 226 | </div> |
248 | 248 | <a name="TpHandleChannelsContext--user-action-time"></a><h3>The <code class="literal">"user-action-time"</code> property</h3> |
249 | 249 | <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> |
250 | 250 | <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. | |
262 | 258 | </p> |
263 | 259 | <p>Allowed values: >= 0</p> |
264 | 260 | <p>Default value: 0</p> |
383 | 383 | <td class="listing_code"><pre class="programlisting">TpChannel <span class="symbol">*</span>channel <span class="symbol">= ...;</span> |
384 | 384 | GQuark features<span class="symbol">[] = {</span> TP_CHANNEL_FEATURE_CORE<span class="symbol">,</span> <span class="number">0</span> <span class="symbol">};</span> |
385 | 385 | |
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> | |
387 | 387 | </tr> |
388 | 388 | </tbody> |
389 | 389 | </table> |
228 | 228 | </tr> |
229 | 229 | <tr> |
230 | 230 | <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) | |
233 | 235 | </td> |
234 | 236 | </tr> |
235 | 237 | <tr> |
115 | 115 | <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>, |
116 | 116 | <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>, |
117 | 117 | <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>); | |
118 | 121 | </pre> |
119 | 122 | </div> |
120 | 123 | <div class="refsect1" title="Description"> |
1146 | 1149 | <p> |
1147 | 1150 | </p> |
1148 | 1151 | <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> | |
1150 | 1153 | <div class="example-contents"> |
1151 | 1154 | <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> |
1152 | 1155 | <tbody> |
1212 | 1215 | <p> |
1213 | 1216 | </p> |
1214 | 1217 | <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> | |
1216 | 1219 | <div class="example-contents"> |
1217 | 1220 | <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> |
1218 | 1221 | <tbody> |
1577 | 1580 | </table></div> |
1578 | 1581 | <p class="since">Since 0.11.9</p> |
1579 | 1582 | </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> | |
1580 | 1649 | </div> |
1581 | 1650 | </div> |
1582 | 1651 | <div class="footer"> |
325 | 325 | <function name="TP_CHANNEL_DISPATCHER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS"/> |
326 | 326 | <function name="TP_CLIENT_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS"/> |
327 | 327 | <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"/> | |
328 | 330 | <function name="TpHandle" link="telepathy-glib-handle.html#TpHandle"/> |
329 | 331 | <function name="TP_TYPE_HANDLE" link="telepathy-glib-handle.html#TP-TYPE-HANDLE:CAPS"/> |
330 | 332 | <function name="TP_UNKNOWN_HANDLE_TYPE" link="telepathy-glib-handle.html#TP-UNKNOWN-HANDLE-TYPE:CAPS"/> |
683 | 685 | <function name="enum TpAnonymityModeFlags" link="telepathy-glib-enums.html#TpAnonymityModeFlags"/> |
684 | 686 | <function name="enum TpStorageRestrictionFlags" link="telepathy-glib-enums.html#TpStorageRestrictionFlags"/> |
685 | 687 | <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"/> | |
687 | 689 | <function name="TP_TYPE_ERROR" link="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"/> |
688 | 690 | <function name="enum TpError" link="telepathy-glib-errors.html#TpError"/> |
689 | 691 | <function name="tp_g_set_error_invalid_handle_type ()" link="telepathy-glib-errors.html#tp-g-set-error-invalid-handle-type"/> |
2976 | 2978 | <function name="tp_clear_object()" link="telepathy-glib-util.html#tp-clear-object"/> |
2977 | 2979 | <function name="tp_clear_boxed()" link="telepathy-glib-util.html#tp-clear-boxed"/> |
2978 | 2980 | <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"/> | |
2979 | 2983 | <function name="tp_g_socket_address_from_variant ()" link="telepathy-glib-gnio-util.html#tp-g-socket-address-from-variant"/> |
2980 | 2984 | <function name="tp_address_variant_from_g_socket_address ()" link="telepathy-glib-gnio-util.html#tp-address-variant-from-g-socket-address"/> |
2981 | 2985 | <function name="TP_ANSI_RESET" link="telepathy-glib-debug-ansi.html#TP-ANSI-RESET:CAPS"/> |
325 | 325 | <keyword type="macro" name="TP_CHANNEL_DISPATCHER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH:CAPS"/> |
326 | 326 | <keyword type="macro" name="TP_CLIENT_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE:CAPS"/> |
327 | 327 | <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"/> | |
328 | 330 | <keyword type="typedef" name="TpHandle" link="telepathy-glib-handle.html#TpHandle"/> |
329 | 331 | <keyword type="macro" name="TP_TYPE_HANDLE" link="telepathy-glib-handle.html#TP-TYPE-HANDLE:CAPS"/> |
330 | 332 | <keyword type="macro" name="TP_UNKNOWN_HANDLE_TYPE" link="telepathy-glib-handle.html#TP-UNKNOWN-HANDLE-TYPE:CAPS" since="0.7.0"/> |
683 | 685 | <keyword type="enum" name="enum TpAnonymityModeFlags" link="telepathy-glib-enums.html#TpAnonymityModeFlags"/> |
684 | 686 | <keyword type="enum" name="enum TpStorageRestrictionFlags" link="telepathy-glib-enums.html#TpStorageRestrictionFlags"/> |
685 | 687 | <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"/> | |
687 | 689 | <keyword type="macro" name="TP_TYPE_ERROR" link="telepathy-glib-errors.html#TP-TYPE-ERROR:CAPS"/> |
688 | 690 | <keyword type="enum" name="enum TpError" link="telepathy-glib-errors.html#TpError"/> |
689 | 691 | <keyword type="function" name="tp_g_set_error_invalid_handle_type ()" link="telepathy-glib-errors.html#tp-g-set-error-invalid-handle-type"/> |
1764 | 1766 | <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"/> |
1765 | 1767 | <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"/> |
1766 | 1768 | <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"/> | |
1779 | 1781 | <keyword type="property" name="The "account" property" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--account"/> |
1780 | 1782 | <keyword type="property" name="The "request" property" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--request"/> |
1781 | 1783 | <keyword type="property" name="The "user-action-time" property" link="telepathy-glib-account-channel-request.html#TpAccountChannelRequest--user-action-time"/> |
2976 | 2978 | <keyword type="macro" name="tp_clear_object()" link="telepathy-glib-util.html#tp-clear-object" since="0.11.7"/> |
2977 | 2979 | <keyword type="macro" name="tp_clear_boxed()" link="telepathy-glib-util.html#tp-clear-boxed" since="0.11.7"/> |
2978 | 2980 | <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"/> | |
2979 | 2983 | <keyword type="function" name="tp_g_socket_address_from_variant ()" link="telepathy-glib-gnio-util.html#tp-g-socket-address-from-variant"/> |
2980 | 2984 | <keyword type="function" name="tp_address_variant_from_g_socket_address ()" link="telepathy-glib-gnio-util.html#tp-address-variant-from-g-socket-address"/> |
2981 | 2985 | <keyword type="macro" name="TP_ANSI_RESET" link="telepathy-glib-debug-ansi.html#TP-ANSI-RESET:CAPS"/> |
28 | 28 | TP_CHANNEL_DISPATCHER_OBJECT_PATH |
29 | 29 | TP_CLIENT_BUS_NAME_BASE |
30 | 30 | TP_CLIENT_OBJECT_PATH_BASE |
31 | TP_USER_ACTION_TIME_NOT_USER_ACTION | |
32 | TP_USER_ACTION_TIME_CURRENT_TIME | |
31 | 33 | </SECTION> |
32 | 34 | |
33 | 35 | <SECTION> |
1205 | 1207 | tp_clear_object |
1206 | 1208 | tp_clear_boxed |
1207 | 1209 | tp_simple_async_report_success_in_idle |
1210 | tp_user_action_time_from_x11 | |
1211 | tp_user_action_time_should_present | |
1208 | 1212 | </SECTION> |
1209 | 1213 | |
1210 | 1214 | <SECTION> |
1898 | 1902 | <INCLUDE>telepathy-glib/errors.h</INCLUDE> |
1899 | 1903 | <FILE>errors</FILE> |
1900 | 1904 | TP_ERROR_PREFIX |
1901 | TP_ERRORS | |
1905 | TP_ERROR | |
1902 | 1906 | TP_TYPE_ERROR |
1903 | 1907 | TpError |
1904 | 1908 | tp_g_set_error_invalid_handle_type |
1949 | 1953 | <SUBSECTION Standard> |
1950 | 1954 | tp_error_get_type |
1951 | 1955 | tp_errors_quark |
1956 | tp_error_quark | |
1952 | 1957 | <SUBSECTION Private> |
1953 | TP_ERROR | |
1958 | TP_ERRORS | |
1954 | 1959 | </SECTION> |
1955 | 1960 | |
1956 | 1961 | <SECTION> |
8 | 8 | |
9 | 9 | </para> |
10 | 10 | |
11 | ||
12 | 11 | <!-- ##### SECTION See_Also ##### --> |
13 | 12 | <para> |
14 | 13 | |
15 | 14 | </para> |
16 | ||
17 | 15 | |
18 | 16 | <!-- ##### SECTION Stability_Level ##### --> |
19 | 17 |
36 | 36 | </para> |
37 | 37 | |
38 | 38 | @parent_class: |
39 | @get_contacts: | |
40 | @get_states: | |
39 | @dup_contacts: | |
40 | @dup_states: | |
41 | 41 | @get_contact_list_persists: |
42 | 42 | |
43 | 43 | <!-- ##### FUNCTION tp_base_contact_list_mixin_class_init ##### --> |
165 | 165 | @Returns: |
166 | 166 | |
167 | 167 | |
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 ##### --> | |
187 | 187 | <para> |
188 | 188 | |
189 | 189 | </para> |
195 | 195 | @publish_request: |
196 | 196 | |
197 | 197 | |
198 | <!-- ##### FUNCTION tp_base_contact_list_get_states ##### --> | |
198 | <!-- ##### FUNCTION tp_base_contact_list_dup_states ##### --> | |
199 | 199 | <para> |
200 | 200 | |
201 | 201 | </para> |
442 | 442 | </para> |
443 | 443 | |
444 | 444 | @parent: |
445 | @get_groups: | |
446 | @get_group_members: | |
447 | @get_contact_groups: | |
445 | @dup_groups: | |
446 | @dup_group_members: | |
447 | @dup_contact_groups: | |
448 | 448 | @has_disjoint_groups: |
449 | 449 | @normalize_group: |
450 | 450 | |
468 | 468 | @Returns: |
469 | 469 | |
470 | 470 | |
471 | <!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### --> | |
471 | <!-- ##### USER_FUNCTION TpBaseContactListDupContactGroupsFunc ##### --> | |
472 | 472 | <para> |
473 | 473 | |
474 | 474 | </para> |
478 | 478 | @Returns: |
479 | 479 | |
480 | 480 | |
481 | <!-- ##### FUNCTION tp_base_contact_list_get_contact_groups ##### --> | |
481 | <!-- ##### FUNCTION tp_base_contact_list_dup_contact_groups ##### --> | |
482 | 482 | <para> |
483 | 483 | |
484 | 484 | </para> |
488 | 488 | @Returns: |
489 | 489 | |
490 | 490 | |
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 ##### --> | |
510 | 510 | <para> |
511 | 511 | |
512 | 512 | </para> |
516 | 516 | @Returns: |
517 | 517 | |
518 | 518 | |
519 | <!-- ##### FUNCTION tp_base_contact_list_get_group_members ##### --> | |
519 | <!-- ##### FUNCTION tp_base_contact_list_dup_group_members ##### --> | |
520 | 520 | <para> |
521 | 521 | |
522 | 522 | </para> |
813 | 813 | </para> |
814 | 814 | |
815 | 815 | @parent: |
816 | @get_blocked_contacts: | |
816 | @dup_blocked_contacts: | |
817 | 817 | @block_contacts_async: |
818 | 818 | @block_contacts_finish: |
819 | 819 | @unblock_contacts_async: |
829 | 829 | @Returns: |
830 | 830 | |
831 | 831 | |
832 | <!-- ##### FUNCTION tp_base_contact_list_get_blocked_contacts ##### --> | |
832 | <!-- ##### FUNCTION tp_base_contact_list_dup_blocked_contacts ##### --> | |
833 | 833 | <para> |
834 | 834 | |
835 | 835 | </para> |
297 | 297 | |
298 | 298 | @self: |
299 | 299 | @handler: |
300 | @user_action_timestamp: | |
300 | @user_action_time: | |
301 | 301 | @callback: |
302 | 302 | @user_data: |
303 | 303 |
96 | 96 | |
97 | 97 | |
98 | 98 | |
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 |
26 | 26 | |
27 | 27 | |
28 | 28 | |
29 | <!-- ##### MACRO TP_ERRORS ##### --> | |
29 | <!-- ##### MACRO TP_ERROR ##### --> | |
30 | 30 | <para> |
31 | 31 | |
32 | 32 | </para> |
77 | 77 | </para> |
78 | 78 | |
79 | 79 | |
80 | <!-- ##### MACRO TP_ERRORS ##### --> | |
81 | <para> | |
82 | ||
83 | </para> | |
84 | ||
85 | ||
80 | 86 | <!-- ##### MACRO TP_ERROR_STR_NOT_YET ##### --> |
81 | 87 | <para> |
82 | 88 | |
283 | 289 | </para> |
284 | 290 | |
285 | 291 | @parent_class: |
286 | @get_contacts: | |
287 | @get_states: | |
292 | @dup_contacts: | |
293 | @dup_states: | |
288 | 294 | @get_contact_list_persists: |
289 | 295 | |
290 | 296 | <!-- ##### USER_FUNCTION TpBaseContactListCreateGroupsFunc ##### --> |
298 | 304 | @callback: |
299 | 305 | @user_data: |
300 | 306 | |
301 | <!-- ##### USER_FUNCTION TpBaseContactListGetContactGroupsFunc ##### --> | |
307 | <!-- ##### USER_FUNCTION TpBaseContactListDupContactGroupsFunc ##### --> | |
302 | 308 | <para> |
303 | 309 | |
304 | 310 | </para> |
307 | 313 | @contact: |
308 | 314 | @Returns: |
309 | 315 | |
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 ##### --> | |
319 | 325 | <para> |
320 | 326 | |
321 | 327 | </para> |
324 | 330 | @group: |
325 | 331 | @Returns: |
326 | 332 | |
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 ##### --> | |
336 | 342 | <para> |
337 | 343 | |
338 | 344 | </para> |
343 | 349 | @publish: |
344 | 350 | @publish_request: |
345 | 351 | |
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 | ||
346 | 397 | <!-- ##### USER_FUNCTION TpBaseContactListGroupContactsFunc ##### --> |
347 | 398 | <para> |
348 | 399 | |
421 | 472 | </para> |
422 | 473 | |
423 | 474 | @parent: |
424 | @get_blocked_contacts: | |
475 | @dup_blocked_contacts: | |
425 | 476 | @block_contacts_async: |
426 | 477 | @block_contacts_finish: |
427 | 478 | @unblock_contacts_async: |
434 | 485 | </para> |
435 | 486 | |
436 | 487 | @parent: |
437 | @get_groups: | |
438 | @get_group_members: | |
439 | @get_contact_groups: | |
488 | @dup_groups: | |
489 | @dup_group_members: | |
490 | @dup_contact_groups: | |
440 | 491 | @has_disjoint_groups: |
441 | 492 | @normalize_group: |
442 | 493 | |
746 | 797 | @error: |
747 | 798 | @Returns: |
748 | 799 | |
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 | ||
749 | 853 | <!-- ##### FUNCTION tp_base_contact_list_false_func ##### --> |
750 | 854 | <para> |
751 | 855 |
415 | 415 | @source_tag: |
416 | 416 | |
417 | 417 | |
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 |
198 | 198 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
199 | 199 | VALAC = @VALAC@ |
200 | 200 | VALAFLAGS = @VALAFLAGS@ |
201 | VALA_CFLAGS = @VALA_CFLAGS@ | |
202 | VALA_LIBS = @VALA_LIBS@ | |
203 | 201 | VAPIGEN = @VAPIGEN@ |
204 | 202 | VERSION = @VERSION@ |
205 | 203 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
284 | 284 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
285 | 285 | VALAC = @VALAC@ |
286 | 286 | VALAFLAGS = @VALAFLAGS@ |
287 | VALA_CFLAGS = @VALA_CFLAGS@ | |
288 | VALA_LIBS = @VALA_LIBS@ | |
289 | 287 | VAPIGEN = @VAPIGEN@ |
290 | 288 | VERSION = @VERSION@ |
291 | 289 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
198 | 198 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
199 | 199 | VALAC = @VALAC@ |
200 | 200 | VALAFLAGS = @VALAFLAGS@ |
201 | VALA_CFLAGS = @VALA_CFLAGS@ | |
202 | VALA_LIBS = @VALA_LIBS@ | |
203 | 201 | VAPIGEN = @VAPIGEN@ |
204 | 202 | VERSION = @VERSION@ |
205 | 203 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
233 | 233 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
234 | 234 | VALAC = @VALAC@ |
235 | 235 | VALAFLAGS = @VALAFLAGS@ |
236 | VALA_CFLAGS = @VALA_CFLAGS@ | |
237 | VALA_LIBS = @VALA_LIBS@ | |
238 | 236 | VAPIGEN = @VAPIGEN@ |
239 | 237 | VERSION = @VERSION@ |
240 | 238 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
233 | 233 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
234 | 234 | VALAC = @VALAC@ |
235 | 235 | VALAFLAGS = @VALAFLAGS@ |
236 | VALA_CFLAGS = @VALA_CFLAGS@ | |
237 | VALA_LIBS = @VALA_LIBS@ | |
238 | 236 | VAPIGEN = @VAPIGEN@ |
239 | 237 | VERSION = @VERSION@ |
240 | 238 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
234 | 234 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
235 | 235 | VALAC = @VALAC@ |
236 | 236 | VALAFLAGS = @VALAFLAGS@ |
237 | VALA_CFLAGS = @VALA_CFLAGS@ | |
238 | VALA_LIBS = @VALA_LIBS@ | |
239 | 237 | VAPIGEN = @VAPIGEN@ |
240 | 238 | VERSION = @VERSION@ |
241 | 239 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
231 | 231 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
232 | 232 | VALAC = @VALAC@ |
233 | 233 | VALAFLAGS = @VALAFLAGS@ |
234 | VALA_CFLAGS = @VALA_CFLAGS@ | |
235 | VALA_LIBS = @VALA_LIBS@ | |
236 | 234 | VAPIGEN = @VAPIGEN@ |
237 | 235 | VERSION = @VERSION@ |
238 | 236 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
224 | 224 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
225 | 225 | VALAC = @VALAC@ |
226 | 226 | VALAFLAGS = @VALAFLAGS@ |
227 | VALA_CFLAGS = @VALA_CFLAGS@ | |
228 | VALA_LIBS = @VALA_LIBS@ | |
229 | 227 | VAPIGEN = @VAPIGEN@ |
230 | 228 | VERSION = @VERSION@ |
231 | 229 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
223 | 223 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
224 | 224 | VALAC = @VALAC@ |
225 | 225 | VALAFLAGS = @VALAFLAGS@ |
226 | VALA_CFLAGS = @VALA_CFLAGS@ | |
227 | VALA_LIBS = @VALA_LIBS@ | |
228 | 226 | VAPIGEN = @VAPIGEN@ |
229 | 227 | VERSION = @VERSION@ |
230 | 228 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
205 | 205 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
206 | 206 | VALAC = @VALAC@ |
207 | 207 | VALAFLAGS = @VALAFLAGS@ |
208 | VALA_CFLAGS = @VALA_CFLAGS@ | |
209 | VALA_LIBS = @VALA_LIBS@ | |
210 | 208 | VAPIGEN = @VAPIGEN@ |
211 | 209 | VERSION = @VERSION@ |
212 | 210 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
198 | 198 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
199 | 199 | VALAC = @VALAC@ |
200 | 200 | VALAFLAGS = @VALAFLAGS@ |
201 | VALA_CFLAGS = @VALA_CFLAGS@ | |
202 | VALA_LIBS = @VALA_LIBS@ | |
203 | 201 | VAPIGEN = @VAPIGEN@ |
204 | 202 | VERSION = @VERSION@ |
205 | 203 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
233 | 233 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
234 | 234 | VALAC = @VALAC@ |
235 | 235 | VALAFLAGS = @VALAFLAGS@ |
236 | VALA_CFLAGS = @VALA_CFLAGS@ | |
237 | VALA_LIBS = @VALA_LIBS@ | |
238 | 236 | VAPIGEN = @VAPIGEN@ |
239 | 237 | VERSION = @VERSION@ |
240 | 238 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
202 | 202 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
203 | 203 | VALAC = @VALAC@ |
204 | 204 | VALAFLAGS = @VALAFLAGS@ |
205 | VALA_CFLAGS = @VALA_CFLAGS@ | |
206 | VALA_LIBS = @VALA_LIBS@ | |
207 | 205 | VAPIGEN = @VAPIGEN@ |
208 | 206 | VERSION = @VERSION@ |
209 | 207 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
158 | 158 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
159 | 159 | VALAC = @VALAC@ |
160 | 160 | VALAFLAGS = @VALAFLAGS@ |
161 | VALA_CFLAGS = @VALA_CFLAGS@ | |
162 | VALA_LIBS = @VALA_LIBS@ | |
163 | 161 | VAPIGEN = @VAPIGEN@ |
164 | 162 | VERSION = @VERSION@ |
165 | 163 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
158 | 158 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
159 | 159 | VALAC = @VALAC@ |
160 | 160 | VALAFLAGS = @VALAFLAGS@ |
161 | VALA_CFLAGS = @VALA_CFLAGS@ | |
162 | VALA_LIBS = @VALA_LIBS@ | |
163 | 161 | VAPIGEN = @VAPIGEN@ |
164 | 162 | VERSION = @VERSION@ |
165 | 163 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
278 | 278 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
279 | 279 | VALAC = @VALAC@ |
280 | 280 | VALAFLAGS = @VALAFLAGS@ |
281 | VALA_CFLAGS = @VALA_CFLAGS@ | |
282 | VALA_LIBS = @VALA_LIBS@ | |
283 | 281 | VAPIGEN = @VAPIGEN@ |
284 | 282 | VERSION = @VERSION@ |
285 | 283 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
581 | 579 | versions/0.11.7.abi \ |
582 | 580 | versions/0.11.9.abi \ |
583 | 581 | versions/0.11.11.abi \ |
584 | versions/0.11.12.abi | |
582 | versions/0.11.12.abi \ | |
583 | versions/0.11.13.abi | |
585 | 584 | |
586 | 585 | |
587 | 586 | # The quoting here is unnecessary but harmless, and has the useful side-effect |
743 | 742 | @HAVE_INTROSPECTION_TRUE@ $(srcdir)/protocol.c $(srcdir)/protocol.h \ |
744 | 743 | @HAVE_INTROSPECTION_TRUE@ $(srcdir)/base-connection.c $(srcdir)/base-connection.h \ |
745 | 744 | @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 \ | |
746 | 746 | @HAVE_INTROSPECTION_TRUE@ _gen/telepathy-enums.h \ |
747 | 747 | @HAVE_INTROSPECTION_TRUE@ _gen/telepathy-interfaces.h |
748 | 748 |
44 | 44 | versions/0.11.7.abi \ |
45 | 45 | versions/0.11.9.abi \ |
46 | 46 | versions/0.11.11.abi \ |
47 | versions/0.11.12.abi | |
47 | versions/0.11.12.abi \ | |
48 | versions/0.11.13.abi | |
48 | 49 | |
49 | 50 | # The quoting here is unnecessary but harmless, and has the useful side-effect |
50 | 51 | # that vim quickfix mode (:make) doesn't interpret the libtool --mode=link |
280 | 280 | /** |
281 | 281 | * TpAccountChannelRequest:request: |
282 | 282 | * |
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. | |
285 | 285 | * |
286 | 286 | * This property can't be %NULL. |
287 | 287 | * |
297 | 297 | /** |
298 | 298 | * TpAccountChannelRequest:user-action-time: |
299 | 299 | * |
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 | |
301 | 301 | * 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. | |
302 | 323 | * |
303 | 324 | * Since: 0.11.12 |
304 | 325 | */ |
313 | 334 | * TpAccountChannelRequest::re-handled: |
314 | 335 | * @self: a #TpAccountChannelRequest |
315 | 336 | * @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 | |
318 | 341 | * @context: a #TpHandleChannelsContext representing the context of |
319 | 342 | * the HandleChannels() call. |
320 | 343 | * |
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. | |
322 | 354 | * |
323 | 355 | * Since: 0.11.12 |
324 | 356 | */ |
336 | 368 | * tp_account_channel_request_new: |
337 | 369 | * @account: a #TpAccount |
338 | 370 | * @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) | |
342 | 376 | * |
343 | 377 | * Convenience function to create a new #TpAccountChannelRequest object. |
344 | 378 | * |
777 | 811 | * tp_account_channel_request_create_and_handle_channel_finish() to get the |
778 | 812 | * result of the operation. |
779 | 813 | * |
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 | * | |
780 | 818 | * Since: 0.11.12 |
781 | 819 | */ |
782 | 820 | void |
834 | 872 | * If the channel already exists and is already being handled, or if a |
835 | 873 | * newly created channel is sent to a different handler, this operation |
836 | 874 | * 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.) | |
839 | 883 | * |
840 | 884 | * Since: 0.11.12 |
841 | 885 | */ |
1031 | 1075 | * Asynchronously calls EnsureChannel on the ChannelDispatcher to create a |
1032 | 1076 | * channel with the properties defined in #TpAccountChannelRequest:request |
1033 | 1077 | * 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 | * | |
1034 | 1086 | * @callback will be called when an existing channel's handler has been |
1035 | 1087 | * notified, a new channel has been created and dispatched, or the request |
1036 | 1088 | * has failed. |
527 | 527 | } |
528 | 528 | |
529 | 529 | static void |
530 | channel_prepare_cb (GObject *source, | |
530 | adoc_channel_prepare_cb (GObject *source, | |
531 | 531 | GAsyncResult *result, |
532 | 532 | gpointer user_data) |
533 | 533 | { |
578 | 578 | self->priv->num_pending++; |
579 | 579 | |
580 | 580 | tp_proxy_prepare_async (channel, channel_features, |
581 | channel_prepare_cb, g_object_ref (self)); | |
581 | adoc_channel_prepare_cb, g_object_ref (self)); | |
582 | 582 | } |
583 | 583 | } |
584 | 584 |
40 | 40 | |
41 | 41 | /** |
42 | 42 | * 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) | |
43 | 51 | * |
44 | 52 | * 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. | |
45 | 60 | * |
46 | 61 | * Since: 0.11.5 |
47 | 62 | */ |
109 | 124 | * @requests_satisfied: (element-type TelepathyGLib.ChannelRequest): a #GList of |
110 | 125 | * #TpChannelRequest having their object-path defined but are not guaranteed |
111 | 126 | * 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) | |
114 | 131 | * @context: a #TpHandleChannelsContext representing the context of this |
115 | 132 | * D-Bus call |
116 | 133 | * |
145 | 162 | #include "telepathy-glib/debug-internal.h" |
146 | 163 | #include "telepathy-glib/_gen/signals-marshal.h" |
147 | 164 | |
148 | struct _TpBaseClientClassPrivate { | |
149 | /*<private>*/ | |
150 | TpBaseClientClassObserveChannelsImpl observe_channels_impl; | |
151 | TpBaseClientClassAddDispatchOperationImpl add_dispatch_operation_impl; | |
152 | TpBaseClientClassHandleChannelsImpl handle_channels_impl; | |
153 | }; | |
154 | ||
155 | 165 | static void observer_iface_init (gpointer, gpointer); |
156 | 166 | static void approver_iface_init (gpointer, gpointer); |
157 | 167 | static void handler_iface_init (gpointer, gpointer); |
165 | 175 | G_IMPLEMENT_INTERFACE(TP_TYPE_SVC_CLIENT_APPROVER, approver_iface_init); |
166 | 176 | G_IMPLEMENT_INTERFACE(TP_TYPE_SVC_CLIENT_HANDLER, handler_iface_init); |
167 | 177 | 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)) | |
171 | 179 | |
172 | 180 | enum { |
173 | 181 | PROP_DBUS_DAEMON = 1, |
244 | 252 | * a %TP_HASH_TYPE_CHANNEL_CLASS |
245 | 253 | * |
246 | 254 | * 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. | |
250 | 257 | * |
251 | 258 | * 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. | |
254 | 261 | * |
255 | 262 | * Since: 0.11.5 |
256 | 263 | */ |
292 | 299 | |
293 | 300 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
294 | 301 | 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); | |
296 | 303 | |
297 | 304 | self->priv->flags |= CLIENT_IS_OBSERVER; |
298 | 305 | g_ptr_array_add (self->priv->observer_filters, filter); |
317 | 324 | * its filter, it will automatically be restarted by service-activation. |
318 | 325 | * |
319 | 326 | * 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. | |
322 | 329 | * |
323 | 330 | * Since: 0.11.5 |
324 | 331 | */ |
330 | 337 | |
331 | 338 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
332 | 339 | 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); | |
334 | 341 | |
335 | 342 | self->priv->flags |= (CLIENT_IS_OBSERVER | CLIENT_OBSERVER_RECOVER); |
336 | 343 | } |
342 | 349 | * a %TP_HASH_TYPE_CHANNEL_CLASS |
343 | 350 | * |
344 | 351 | * 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. | |
348 | 354 | * |
349 | 355 | * 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. | |
352 | 358 | * |
353 | 359 | * Since: 0.11.5 |
354 | 360 | */ |
390 | 396 | |
391 | 397 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
392 | 398 | 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); | |
394 | 400 | |
395 | 401 | self->priv->flags |= CLIENT_IS_APPROVER; |
396 | 402 | g_ptr_array_add (self->priv->approver_filters, filter); |
406 | 412 | * |
407 | 413 | * This method may only be called before tp_base_client_register() is |
408 | 414 | * called, and may only be called on objects whose class has called |
409 | * tp_base_client_implement_handle_channels(). | |
415 | * #TpBaseClientClass.handle_channels. | |
410 | 416 | * |
411 | 417 | * Since: 0.11.6 |
412 | 418 | */ |
417 | 423 | |
418 | 424 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
419 | 425 | 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); | |
421 | 427 | |
422 | 428 | self->priv->flags |= CLIENT_IS_HANDLER; |
423 | 429 | } |
429 | 435 | * a %TP_HASH_TYPE_CHANNEL_CLASS |
430 | 436 | * |
431 | 437 | * 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. | |
435 | 440 | * |
436 | 441 | * 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. | |
439 | 444 | * |
440 | 445 | * Since: 0.11.6 |
441 | 446 | */ |
478 | 483 | |
479 | 484 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
480 | 485 | 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); | |
482 | 487 | |
483 | 488 | self->priv->flags |= CLIENT_IS_HANDLER; |
484 | 489 | g_ptr_array_add (self->priv->handler_filters, filter); |
495 | 500 | * D-Bus property.) |
496 | 501 | * |
497 | 502 | * 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. | |
500 | 505 | * |
501 | 506 | * Since: 0.11.6 |
502 | 507 | */ |
508 | 513 | |
509 | 514 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
510 | 515 | 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); | |
512 | 517 | |
513 | 518 | if (bypass_approval) |
514 | 519 | { |
533 | 538 | * return the list of pending requests. |
534 | 539 | * |
535 | 540 | * 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. | |
538 | 543 | * |
539 | 544 | * Since: 0.11.6 |
540 | 545 | */ |
545 | 550 | |
546 | 551 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
547 | 552 | 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); | |
549 | 554 | |
550 | 555 | self->priv->flags |= (CLIENT_IS_HANDLER | CLIENT_HANDLER_WANTS_REQUESTS); |
551 | 556 | } |
556 | 561 | { |
557 | 562 | TpBaseClientClass *cls = TP_BASE_CLIENT_GET_CLASS (self); |
558 | 563 | |
559 | g_return_if_fail (cls->priv->handle_channels_impl != NULL); | |
564 | g_return_if_fail (cls->handle_channels != NULL); | |
560 | 565 | |
561 | 566 | self->priv->flags |= CLIENT_IS_HANDLER; |
562 | 567 | |
578 | 583 | * tp_base_client_add_handler_capabilities(). |
579 | 584 | * |
580 | 585 | * 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. | |
583 | 588 | * |
584 | 589 | * Since: 0.11.6 |
585 | 590 | */ |
591 | 596 | |
592 | 597 | g_return_if_fail (TP_IS_BASE_CLIENT (self)); |
593 | 598 | 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); | |
595 | 600 | |
596 | 601 | _tp_base_client_add_handler_capability (self, token); |
597 | 602 | } |
609 | 614 | * particular streaming protocols and codecs. |
610 | 615 | * |
611 | 616 | * 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. | |
614 | 619 | * |
615 | 620 | * Since: 0.11.6 |
616 | 621 | */ |
641 | 646 | * tp_base_client_add_handler_capability() for each capability token. |
642 | 647 | * |
643 | 648 | * 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. | |
646 | 651 | * |
647 | 652 | * Since: 0.11.6 |
648 | 653 | */ |
1229 | 1234 | cls->dbus_properties_class.interfaces = prop_ifaces; |
1230 | 1235 | tp_dbus_properties_mixin_class_init (object_class, |
1231 | 1236 | G_STRUCT_OFFSET (TpBaseClientClass, dbus_properties_class)); |
1232 | ||
1233 | cls->priv = G_TYPE_CLASS_GET_PRIVATE (cls, TP_TYPE_BASE_CLIENT, | |
1234 | TpBaseClientClassPrivate); | |
1235 | 1237 | } |
1236 | 1238 | |
1237 | 1239 | static GList * |
1268 | 1270 | channels_list = ptr_array_to_list (ctx->channels); |
1269 | 1271 | requests_list = ptr_array_to_list (ctx->requests); |
1270 | 1272 | |
1271 | cls->priv->observe_channels_impl (self, ctx->account, ctx->connection, | |
1273 | cls->observe_channels (self, ctx->account, ctx->connection, | |
1272 | 1274 | channels_list, ctx->dispatch_operation, requests_list, ctx); |
1273 | 1275 | |
1274 | 1276 | g_list_free (channels_list); |
1317 | 1319 | return; |
1318 | 1320 | } |
1319 | 1321 | |
1320 | if (cls->priv->observe_channels_impl == NULL) | |
1322 | if (cls->observe_channels == NULL) | |
1321 | 1323 | { |
1322 | 1324 | WARNING ("class %s does not implement ObserveChannels", |
1323 | 1325 | G_OBJECT_TYPE_NAME (self)); |
1459 | 1461 | |
1460 | 1462 | channels_list = ptr_array_to_list (ctx->channels); |
1461 | 1463 | |
1462 | cls->priv->add_dispatch_operation_impl (self, ctx->account, ctx->connection, | |
1464 | cls->add_dispatch_operation (self, ctx->account, ctx->connection, | |
1463 | 1465 | channels_list, ctx->dispatch_operation, ctx); |
1464 | 1466 | |
1465 | 1467 | g_list_free (channels_list); |
1505 | 1507 | return; |
1506 | 1508 | } |
1507 | 1509 | |
1508 | if (cls->priv->add_dispatch_operation_impl == NULL) | |
1510 | if (cls->add_dispatch_operation == NULL) | |
1509 | 1511 | { |
1510 | 1512 | WARNING ("class %s does not implement AddDispatchOperation", |
1511 | 1513 | G_OBJECT_TYPE_NAME (self)); |
1676 | 1678 | tp_g_signal_connect_object (ctx, "done", G_CALLBACK (ctx_done_cb), |
1677 | 1679 | self, 0); |
1678 | 1680 | |
1679 | cls->priv->handle_channels_impl (self, ctx->account, ctx->connection, | |
1681 | cls->handle_channels (self, ctx->account, ctx->connection, | |
1680 | 1682 | channels_list, requests_list, ctx->user_action_time, ctx); |
1681 | 1683 | |
1682 | 1684 | g_list_free (channels_list); |
1683 | 1685 | g_list_free (requests_list); |
1684 | 1686 | |
1685 | 1687 | if (_tp_handle_channels_context_get_state (ctx) == |
1686 | TP_OBSERVE_CHANNELS_CONTEXT_STATE_NONE) | |
1688 | TP_HANDLE_CHANNELS_CONTEXT_STATE_NONE) | |
1687 | 1689 | { |
1688 | 1690 | error = g_error_new (TP_ERRORS, TP_ERROR_NOT_IMPLEMENTED, |
1689 | 1691 | "Implementation of HandledChannels in %s didn't call " |
1741 | 1743 | return; |
1742 | 1744 | } |
1743 | 1745 | |
1744 | if (cls->priv->handle_channels_impl == NULL) | |
1746 | if (cls->handle_channels == NULL) | |
1745 | 1747 | { |
1746 | 1748 | DEBUG ("class %s does not implement HandleChannels", |
1747 | 1749 | G_OBJECT_TYPE_NAME (self)); |
1995 | 1997 | * Called by subclasses to define the actual implementation of the |
1996 | 1998 | * ObserveChannels() D-Bus method. |
1997 | 1999 | * |
2000 | * Since 0.11.13 this is exactly equivalent to setting the | |
2001 | * #TpBaseClientClass.observe_channels function pointer. | |
2002 | * | |
1998 | 2003 | * Since: 0.11.5 |
1999 | 2004 | */ |
2000 | 2005 | void |
2001 | 2006 | tp_base_client_implement_observe_channels (TpBaseClientClass *cls, |
2002 | 2007 | TpBaseClientClassObserveChannelsImpl impl) |
2003 | 2008 | { |
2004 | cls->priv->observe_channels_impl = impl; | |
2009 | cls->observe_channels = impl; | |
2005 | 2010 | } |
2006 | 2011 | |
2007 | 2012 | /** |
2106 | 2111 | * Called by subclasses to define the actual implementation of the |
2107 | 2112 | * AddDispatchOperation() D-Bus method. |
2108 | 2113 | * |
2114 | * Since 0.11.13 this is exactly equivalent to setting the | |
2115 | * #TpBaseClientClass.add_dispatch_operation function pointer. | |
2116 | * | |
2109 | 2117 | * Since: 0.11.5 |
2110 | 2118 | */ |
2111 | 2119 | void |
2112 | 2120 | tp_base_client_implement_add_dispatch_operation (TpBaseClientClass *cls, |
2113 | 2121 | TpBaseClientClassAddDispatchOperationImpl impl) |
2114 | 2122 | { |
2115 | cls->priv->add_dispatch_operation_impl = impl; | |
2123 | cls->add_dispatch_operation = impl; | |
2116 | 2124 | } |
2117 | 2125 | |
2118 | 2126 | /** |
2124 | 2132 | * Called by subclasses to define the actual implementation of the |
2125 | 2133 | * HandleChannels() D-Bus method. |
2126 | 2134 | * |
2135 | * Since 0.11.13 this is exactly equivalent to setting the | |
2136 | * #TpBaseClientClass.handle_channels function pointer. | |
2137 | * | |
2127 | 2138 | * Since: 0.11.6 |
2128 | 2139 | */ |
2129 | 2140 | void |
2130 | 2141 | tp_base_client_implement_handle_channels (TpBaseClientClass *cls, |
2131 | 2142 | TpBaseClientClassHandleChannelsImpl impl) |
2132 | 2143 | { |
2133 | cls->priv->handle_channels_impl = impl; | |
2144 | cls->handle_channels = impl; | |
2134 | 2145 | } |
2135 | 2146 | |
2136 | 2147 | /** |
40 | 40 | typedef struct _TpBaseClientPrivate TpBaseClientPrivate; |
41 | 41 | typedef struct _TpBaseClientClassPrivate TpBaseClientClassPrivate; |
42 | 42 | |
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 | ||
43 | 69 | struct _TpBaseClientClass { |
70 | /*<public>*/ | |
71 | GObjectClass parent_class; | |
72 | TpBaseClientClassObserveChannelsImpl observe_channels; | |
73 | TpBaseClientClassAddDispatchOperationImpl add_dispatch_operation; | |
74 | TpBaseClientClassHandleChannelsImpl handle_channels; | |
44 | 75 | /*<private>*/ |
45 | GObjectClass parent_class; | |
46 | GCallback _padding[7]; | |
76 | GCallback _padding[4]; | |
47 | 77 | TpDBusPropertiesMixinClass dbus_properties_class; |
48 | 78 | TpBaseClientClassPrivate *priv; |
49 | 79 | }; |
58 | 88 | |
59 | 89 | /* Protected methods; should be called only by subclasses */ |
60 | 90 | |
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 | ||
70 | 91 | void tp_base_client_implement_observe_channels (TpBaseClientClass *klass, |
71 | 92 | TpBaseClientClassObserveChannelsImpl impl); |
72 | 93 | |
73 | typedef void (*TpBaseClientClassAddDispatchOperationImpl) ( | |
74 | TpBaseClient *client, | |
75 | TpAccount *account, | |
76 | TpConnection *connection, | |
77 | GList *channels, | |
78 | TpChannelDispatchOperation *dispatch_operation, | |
79 | TpAddDispatchOperationContext *context); | |
80 | ||
81 | 94 | void tp_base_client_implement_add_dispatch_operation (TpBaseClientClass *klass, |
82 | 95 | 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); | |
92 | 96 | |
93 | 97 | void tp_base_client_implement_handle_channels (TpBaseClientClass *klass, |
94 | 98 | TpBaseClientClassHandleChannelsImpl impl); |
1329 | 1329 | * @handler: (allow-none): The well-known bus name (starting with |
1330 | 1330 | * #TP_CLIENT_BUS_NAME_BASE) of the channel handler that should handle the |
1331 | 1331 | * 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 | |
1333 | 1335 | * @callback: a callback to call when the call returns |
1334 | 1336 | * @user_data: data to pass to @callback |
1335 | 1337 | * |
1338 | 1340 | * This timestamp will be passed to the Handler when HandleChannels is called. |
1339 | 1341 | * |
1340 | 1342 | * 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 | |
1342 | 1344 | * 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). | |
1346 | 1350 | * |
1347 | 1351 | * This method has been introduced in telepathy-mission-control 5.5.0. |
1348 | 1352 | * |
1352 | 1356 | tp_channel_dispatch_operation_handle_with_time_async ( |
1353 | 1357 | TpChannelDispatchOperation *self, |
1354 | 1358 | const gchar *handler, |
1355 | gint64 user_action_timestamp, | |
1359 | gint64 user_action_time, | |
1356 | 1360 | GAsyncReadyCallback callback, |
1357 | 1361 | gpointer user_data) |
1358 | 1362 | { |
1365 | 1369 | tp_channel_dispatch_operation_handle_with_time_async); |
1366 | 1370 | |
1367 | 1371 | 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, | |
1369 | 1373 | handle_with_cb, result, NULL, G_OBJECT (self)); |
1370 | 1374 | } |
1371 | 1375 |
120 | 120 | void tp_channel_dispatch_operation_handle_with_time_async ( |
121 | 121 | TpChannelDispatchOperation *self, |
122 | 122 | const gchar *handler, |
123 | gint64 user_action_timestamp, | |
123 | gint64 user_action_time, | |
124 | 124 | GAsyncReadyCallback callback, |
125 | 125 | gpointer user_data); |
126 | 126 |
102 | 102 | #define TP_CLIENT_BUS_NAME_BASE "org.freedesktop.Telepathy.Client." |
103 | 103 | |
104 | 104 | /** |
105 | * TP_CLIENT_OBJECT_PATH_BASE | |
105 | * TP_CLIENT_OBJECT_PATH_BASE: | |
106 | 106 | * |
107 | 107 | * The common prefix of the well-known object path for any Telepathy Client. |
108 | 108 | */ |
109 | 109 | #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) | |
110 | 142 | |
111 | 143 | /* telepathy-glib-specific version of G_GNUC_DEPRECATED so our regression |
112 | 144 | * tests can continue to test deprecated functionality, while avoiding |
34 | 34 | */ |
35 | 35 | |
36 | 36 | /** |
37 | * TP_ERRORS: | |
37 | * TP_ERROR: | |
38 | 38 | * |
39 | 39 | * The error domain for the D-Bus errors described in the Telepathy |
40 | 40 | * specification. Error codes in this domain come from the #TpError |
44 | 44 | * domain. Since 0.7.17, this function automatically registers the domain with |
45 | 45 | * dbus-glib for server-side use (using dbus_g_error_domain_register()) when |
46 | 46 | * 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 | |
47 | 52 | */ |
48 | 53 | |
49 | 54 | /** |
189 | 194 | */ |
190 | 195 | |
191 | 196 | /** |
192 | * tp_g_set_error_invalid_handle_type: | |
197 | * tp_g_set_error_invalid_handle_type: (skip) | |
193 | 198 | * @type: An invalid handle type |
194 | 199 | * @error: Either %NULL, or used to return an error (as for g_set_error) |
195 | 200 | * |
207 | 212 | } |
208 | 213 | |
209 | 214 | /** |
210 | * tp_g_set_error_unsupported_handle_type: | |
215 | * tp_g_set_error_unsupported_handle_type: (skip) | |
211 | 216 | * @type: An unsupported handle type |
212 | 217 | * @error: Either %NULL, or used to return an error (as for g_set_error) |
213 | 218 | * |
238 | 243 | * tools/glib-errors-str-gen.py. |
239 | 244 | */ |
240 | 245 | |
246 | /** | |
247 | * tp_errors_quark: (skip) | |
248 | * | |
249 | * <!-- --> | |
250 | * | |
251 | * Deprecated: Use tp_error_quark() instead. | |
252 | */ | |
241 | 253 | GQuark |
242 | 254 | tp_errors_quark (void) |
243 | 255 | { |
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 | { | |
244 | 269 | static gsize quark = 0; |
245 | 270 | |
246 | 271 | if (g_once_init_enter (&quark)) |
247 | 272 | { |
273 | /* FIXME: When we next break API, this should be changed to | |
274 | * "tp-error-quark" */ | |
248 | 275 | GQuark domain = g_quark_from_static_string ("tp_errors"); |
249 | 276 | |
250 | 277 | g_type_init (); |
28 | 28 | G_BEGIN_DECLS |
29 | 29 | |
30 | 30 | GQuark tp_errors_quark (void); |
31 | GQuark tp_error_quark (void); | |
31 | 32 | |
32 | 33 | #define TP_ERROR_PREFIX "org.freedesktop.Telepathy.Error" |
33 | 34 | |
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 ()) | |
36 | 37 | |
37 | 38 | void tp_g_set_error_invalid_handle_type (guint type, GError **error); |
38 | 39 | void tp_g_set_error_unsupported_handle_type (guint type, GError **error); |
367 | 367 | /** |
368 | 368 | * TpHandleChannelsContext:user-action-time: |
369 | 369 | * |
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 | * | |
371 | 375 | * 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. | |
379 | 376 | * |
380 | 377 | * Since: 0.11.6 |
381 | 378 | */ |
604 | 601 | } |
605 | 602 | |
606 | 603 | static void |
607 | channel_prepare_cb (GObject *source, | |
604 | hcc_channel_prepare_cb (GObject *source, | |
608 | 605 | GAsyncResult *result, |
609 | 606 | gpointer user_data) |
610 | 607 | { |
651 | 648 | self->priv->num_pending++; |
652 | 649 | |
653 | 650 | tp_proxy_prepare_async (channel, channel_features, |
654 | channel_prepare_cb, g_object_ref (self)); | |
651 | hcc_channel_prepare_cb, g_object_ref (self)); | |
655 | 652 | } |
656 | 653 | } |
657 | 654 |
35 | 35 | $(srcdir)/protocol.c $(srcdir)/protocol.h \ |
36 | 36 | $(srcdir)/base-connection.c $(srcdir)/base-connection.h \ |
37 | 37 | $(srcdir)/handle-repo.c $(srcdir)/handle-repo.h $(srcdir)/handle-set.c \ |
38 | $(srcdir)/errors.c $(srcdir)/errors.h \ | |
38 | 39 | _gen/telepathy-enums.h \ |
39 | 40 | _gen/telepathy-interfaces.h |
40 | 41 |
576 | 576 | } |
577 | 577 | |
578 | 578 | static void |
579 | channel_prepare_cb (GObject *source, | |
579 | occ_channel_prepare_cb (GObject *source, | |
580 | 580 | GAsyncResult *result, |
581 | 581 | gpointer user_data) |
582 | 582 | { |
622 | 622 | self->priv->num_pending++; |
623 | 623 | |
624 | 624 | tp_proxy_prepare_async (channel, channel_features, |
625 | channel_prepare_cb, g_object_ref (self)); | |
625 | occ_channel_prepare_cb, g_object_ref (self)); | |
626 | 626 | } |
627 | 627 | } |
628 | 628 |
25 | 25 | * @see_also: #TpSvcConnectionInterfacePresence |
26 | 26 | * |
27 | 27 | * 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. | |
37 | 32 | * |
38 | 33 | * To use the presence mixin, include a #TpPresenceMixinClass somewhere in your |
39 | 34 | * class structure and a #TpPresenceMixin somewhere in your instance structure, |
41 | 36 | * tp_presence_mixin_init() from your init function or constructor, and |
42 | 37 | * tp_presence_mixin_finalize() from your dispose or finalize function. |
43 | 38 | * |
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 --> | |
60 | 90 | * |
61 | 91 | * Since: 0.5.13 |
62 | 92 | */ |
186 | 216 | * structure |
187 | 217 | * @status_available: A callback to be used to determine if a given presence |
188 | 218 | * 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. | |
190 | 221 | * @get_contact_statuses: A callback to be used get the current presence status |
191 | 222 | * for contacts. This is used in implementations of various D-Bus methods and |
192 | 223 | * hence must be provided. |
385 | 416 | |
386 | 417 | DEBUG ("called."); |
387 | 418 | |
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 | } | |
394 | 429 | |
395 | 430 | if (g_type_interface_peek (G_OBJECT_GET_CLASS (obj), |
396 | 431 | TP_TYPE_SVC_CONNECTION_INTERFACE_SIMPLE_PRESENCE) != NULL) |
1577 | 1577 | * TpChannel *channel = ...; |
1578 | 1578 | * GQuark features[] = { TP_CHANNEL_FEATURE_CORE, 0 }; |
1579 | 1579 | * |
1580 | * tp_proxy_prepare_async (channel, features, NULL, callback, user_data); | |
1580 | * tp_proxy_prepare_async (channel, features, callback, user_data); | |
1581 | 1581 | * ]| |
1582 | 1582 | * |
1583 | 1583 | * If a feature represents core functionality (like %TP_CHANNEL_FEATURE_CORE), |
255 | 255 | g_object_class_install_property (object_class, PROP_DESTROY, |
256 | 256 | param_spec); |
257 | 257 | |
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; | |
260 | 259 | } |
261 | 260 | |
262 | 261 | /** |
87 | 87 | * @requests_satisfied: (element-type TelepathyGLib.ChannelRequest): a #GList of |
88 | 88 | * #TpChannelRequest having their object-path defined but are not guaranteed |
89 | 89 | * 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) | |
92 | 94 | * @context: a #TpHandleChannelsContext representing the context of this |
93 | 95 | * D-Bus call |
94 | 96 | * @user_data: arbitrary user-supplied data passed to tp_simple_handler_new() |
303 | 305 | g_object_class_install_property (object_class, PROP_DESTROY, |
304 | 306 | param_spec); |
305 | 307 | |
306 | tp_base_client_implement_handle_channels (base_clt_cls, handle_channels); | |
308 | base_clt_cls->handle_channels = handle_channels; | |
307 | 309 | } |
308 | 310 | |
309 | 311 | /** |
279 | 279 | g_object_class_install_property (object_class, PROP_DESTROY, |
280 | 280 | param_spec); |
281 | 281 | |
282 | tp_base_client_implement_observe_channels (base_clt_cls, observe_channels); | |
282 | base_clt_cls->observe_channels = observe_channels; | |
283 | 283 | } |
284 | 284 | |
285 | 285 | /** |
1364 | 1364 | g_simple_async_result_complete_in_idle (simple); |
1365 | 1365 | g_object_unref (simple); |
1366 | 1366 | } |
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 | } |
140 | 140 | void tp_simple_async_report_success_in_idle (GObject *source, |
141 | 141 | GAsyncReadyCallback callback, gpointer user_data, gpointer source_tag); |
142 | 142 | |
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 | ||
143 | 147 | G_END_DECLS |
144 | 148 | |
145 | 149 | #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 |
337 | 337 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
338 | 338 | VALAC = @VALAC@ |
339 | 339 | VALAFLAGS = @VALAFLAGS@ |
340 | VALA_CFLAGS = @VALA_CFLAGS@ | |
341 | VALA_LIBS = @VALA_LIBS@ | |
342 | 340 | VAPIGEN = @VAPIGEN@ |
343 | 341 | VERSION = @VERSION@ |
344 | 342 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
643 | 643 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
644 | 644 | VALAC = @VALAC@ |
645 | 645 | VALAFLAGS = @VALAFLAGS@ |
646 | VALA_CFLAGS = @VALA_CFLAGS@ | |
647 | VALA_LIBS = @VALA_LIBS@ | |
648 | 646 | VAPIGEN = @VAPIGEN@ |
649 | 647 | VERSION = @VERSION@ |
650 | 648 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
198 | 198 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
199 | 199 | VALAC = @VALAC@ |
200 | 200 | VALAFLAGS = @VALAFLAGS@ |
201 | VALA_CFLAGS = @VALA_CFLAGS@ | |
202 | VALA_LIBS = @VALA_LIBS@ | |
203 | 201 | VAPIGEN = @VAPIGEN@ |
204 | 202 | VERSION = @VERSION@ |
205 | 203 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
163 | 163 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
164 | 164 | VALAC = @VALAC@ |
165 | 165 | VALAFLAGS = @VALAFLAGS@ |
166 | VALA_CFLAGS = @VALA_CFLAGS@ | |
167 | VALA_LIBS = @VALA_LIBS@ | |
168 | 166 | VAPIGEN = @VAPIGEN@ |
169 | 167 | VERSION = @VERSION@ |
170 | 168 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
160 | 160 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
161 | 161 | VALAC = @VALAC@ |
162 | 162 | VALAFLAGS = @VALAFLAGS@ |
163 | VALA_CFLAGS = @VALA_CFLAGS@ | |
164 | VALA_LIBS = @VALA_LIBS@ | |
165 | 163 | VAPIGEN = @VAPIGEN@ |
166 | 164 | VERSION = @VERSION@ |
167 | 165 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
10 | 10 | $(NULL) |
11 | 11 | |
12 | 12 | pkgconfigdir = ${libdir}/pkgconfig |
13 | pkgconfig_DATA = telepathy-vala.pc | |
14 | 13 | |
15 | telepathy-glib.vapi: $(top_srcdir)/telepathy-glib/TelepathyGLib-0.12.gir | |
14 | telepathy-glib.vapi: $(top_builddir)/telepathy-glib/TelepathyGLib-0.12.gir | |
16 | 15 | $(VAPIGEN_V)$(VAPIGEN) \ |
17 | 16 | --library telepathy-glib \ |
18 | 17 | --pkg gio-2.0 \ |
35 | 35 | host_triplet = @host@ |
36 | 36 | subdir = vala |
37 | 37 | 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 | |
41 | 39 | ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 |
42 | 40 | am__aclocal_m4_deps = $(top_srcdir)/m4/compiler.m4 \ |
43 | 41 | $(top_srcdir)/m4/gtk-doc.m4 $(top_srcdir)/m4/introspection.m4 \ |
51 | 49 | $(ACLOCAL_M4) |
52 | 50 | mkinstalldirs = $(install_sh) -d |
53 | 51 | CONFIG_HEADER = $(top_builddir)/config.h |
54 | CONFIG_CLEAN_FILES = telepathy-vala.pc telepathy-vala-uninstalled.pc | |
52 | CONFIG_CLEAN_FILES = | |
55 | 53 | CONFIG_CLEAN_VPATH_FILES = |
56 | 54 | AM_V_GEN = $(am__v_GEN_$(V)) |
57 | 55 | am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY)) |
82 | 80 | am__base_list = \ |
83 | 81 | sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ |
84 | 82 | 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) | |
88 | 85 | DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) |
89 | 86 | ACLOCAL = @ACLOCAL@ |
90 | 87 | AMTAR = @AMTAR@ |
186 | 183 | TP_GLIB_CFLAGS = @TP_GLIB_CFLAGS@ |
187 | 184 | VALAC = @VALAC@ |
188 | 185 | VALAFLAGS = @VALAFLAGS@ |
189 | VALA_CFLAGS = @VALA_CFLAGS@ | |
190 | VALA_LIBS = @VALA_LIBS@ | |
191 | 186 | VAPIGEN = @VAPIGEN@ |
192 | 187 | VERSION = @VERSION@ |
193 | 188 | VERSION_SCRIPT_ARG = @VERSION_SCRIPT_ARG@ |
263 | 258 | $(NULL) |
264 | 259 | |
265 | 260 | pkgconfigdir = ${libdir}/pkgconfig |
266 | pkgconfig_DATA = telepathy-vala.pc | |
267 | 261 | CLEANFILES = \ |
268 | 262 | $(BUILT_SOURCES) \ |
269 | 263 | $(NULL) |
307 | 301 | $(ACLOCAL_M4): $(am__aclocal_m4_deps) |
308 | 302 | cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh |
309 | 303 | $(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)/$@ | |
314 | 304 | |
315 | 305 | mostlyclean-libtool: |
316 | 306 | -rm -f *.lo |
337 | 327 | test -n "$$files" || exit 0; \ |
338 | 328 | echo " ( cd '$(DESTDIR)$(vapidir)' && rm -f" $$files ")"; \ |
339 | 329 | 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 | |
360 | 330 | install-vapiDATA: $(vapi_DATA) |
361 | 331 | @$(NORMAL_INSTALL) |
362 | 332 | test -z "$(vapidir)" || $(MKDIR_P) "$(DESTDIR)$(vapidir)" |
419 | 389 | $(MAKE) $(AM_MAKEFLAGS) check-am |
420 | 390 | all-am: Makefile $(DATA) |
421 | 391 | installdirs: |
422 | for dir in "$(DESTDIR)$(vapidir)" "$(DESTDIR)$(pkgconfigdir)" "$(DESTDIR)$(vapidir)"; do \ | |
392 | for dir in "$(DESTDIR)$(vapidir)" "$(DESTDIR)$(vapidir)"; do \ | |
423 | 393 | test -z "$$dir" || $(MKDIR_P) "$$dir"; \ |
424 | 394 | done |
425 | 395 | install: $(BUILT_SOURCES) |
470 | 440 | |
471 | 441 | info-am: |
472 | 442 | |
473 | install-data-am: install-dist_vapiDATA install-pkgconfigDATA \ | |
474 | install-vapiDATA | |
443 | install-data-am: install-dist_vapiDATA install-vapiDATA | |
475 | 444 | |
476 | 445 | install-dvi: install-dvi-am |
477 | 446 | |
515 | 484 | |
516 | 485 | ps-am: |
517 | 486 | |
518 | uninstall-am: uninstall-dist_vapiDATA uninstall-pkgconfigDATA \ | |
519 | uninstall-vapiDATA | |
487 | uninstall-am: uninstall-dist_vapiDATA uninstall-vapiDATA | |
520 | 488 | |
521 | 489 | .MAKE: all check install install-am install-strip |
522 | 490 | |
526 | 494 | install-data install-data-am install-dist_vapiDATA install-dvi \ |
527 | 495 | install-dvi-am install-exec install-exec-am install-html \ |
528 | 496 | 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 \ | |
535 | 502 | uninstall-vapiDATA |
536 | 503 | |
537 | 504 | |
538 | telepathy-glib.vapi: $(top_srcdir)/telepathy-glib/TelepathyGLib-0.12.gir | |
505 | telepathy-glib.vapi: $(top_builddir)/telepathy-glib/TelepathyGLib-0.12.gir | |
539 | 506 | $(VAPIGEN_V)$(VAPIGEN) \ |
540 | 507 | --library telepathy-glib \ |
541 | 508 | --pkg gio-2.0 \ |
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 | 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 |