Mercurial > pidgin.yaz
annotate doc/account-signals.dox @ 30720:8c586dbcae2d
Since a buddy's avatar information is distributed as part of their online
presence information, if they have changed their avatar while we were
offline (and they're now offline) we won't see the change until we're both
online at the same time.
So when the user requests to view a buddy's profile, we now also request
their current AvatarId - if it is different to what Pidgin has cached, we
request the new image.
Move buddy's avatar processing out of mxit_update_buddy_presence() and into
new function mxit_update_buddy_avatar(). The buddy avatar updating is
called when we receive a buddy's presence update or when we request the
buddies profile.
author | andrew.victor@mxit.com |
---|---|
date | Tue, 20 Jul 2010 09:46:28 +0000 |
parents | 0417d6bc47cd |
children | 28e27a37e4b4 |
rev | line source |
---|---|
6605 | 1 /** @page account-signals Account Signals |
2 | |
3 @signals | |
26845
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
4 @signal account-created |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
5 @signal account-destroying |
12053 | 6 @signal account-added |
6605 | 7 @signal account-connecting |
12053 | 8 @signal account-removed |
12127
944c97d11bb1
[gaim-migrate @ 14427]
Richard Laager <rlaager@wiktel.com>
parents:
12070
diff
changeset
|
9 @signal account-disabled |
944c97d11bb1
[gaim-migrate @ 14427]
Richard Laager <rlaager@wiktel.com>
parents:
12070
diff
changeset
|
10 @signal account-enabled |
6605 | 11 @signal account-setting-info |
12 @signal account-set-info | |
11628 | 13 @signal account-status-changed |
26776
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
14 @signal account-actions-changed |
21064
1aaa6e9881b9
Add the account-alias-changed signal to the summary at the top.
Etan Reisner <pidgin@unreliablesource.net>
parents:
20807
diff
changeset
|
15 @signal account-alias-changed |
21221
e98c08afb706
Changelog some of the stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21220
diff
changeset
|
16 @signal account-authorization-requested |
e98c08afb706
Changelog some of the stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21220
diff
changeset
|
17 @signal account-authorization-denied |
e98c08afb706
Changelog some of the stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21220
diff
changeset
|
18 @signal account-authorization-granted |
21366
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
19 @signal account-error-changed |
30119
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
20 @signal account-signed-on |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
21 @signal account-signed-off |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
22 @signal account-connection-error |
6605 | 23 @endsignals |
24 | |
20807
e0613cf8c493
Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
16183
diff
changeset
|
25 @see account.h |
e0613cf8c493
Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
16183
diff
changeset
|
26 |
6605 | 27 <hr> |
28 | |
26845
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
29 @signaldef account-created |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
30 @signalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
31 void (*account_created)(PurpleAccount *account); |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
32 @endsignalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
33 @signaldesc |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
34 Emitted when an account is created by calling purple_account_new. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
35 @param account The account. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
36 @since 2.6.0 |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
37 @endsignaldef |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
38 |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
39 @signaldef account-destroying |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
40 @signalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
41 void (*account_destroying)(PurpleAccount *account); |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
42 @endsignalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
43 @signaldesc |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
44 Emitted when an account is about to be destroyed. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
45 @param account The account. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
46 @since 2.6.0 |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
47 @endsignaldef |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
48 |
12053 | 49 @signaldef account-added |
50 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
51 void (*account_added)(PurpleAccount *account); |
12053 | 52 @endsignalproto |
53 @signaldesc | |
54 Emitted when an account is added. | |
55 @param account The account that was added. | |
26845
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
56 @see purple_accounts_add |
12053 | 57 @endsignaldef |
58 | |
6605 | 59 @signaldef account-connecting |
60 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
61 void (*account_connecting)(PurpleAccount *account); |
6605 | 62 @endsignalproto |
63 @signaldesc | |
64 This is called when an account is in the process of connecting. | |
6606
34eaa941ecd6
[gaim-migrate @ 7130]
Christian Hammond <chipx86@chipx86.com>
parents:
6605
diff
changeset
|
65 @param account The account in the process of connecting. |
6605 | 66 @endsignaldef |
67 | |
12053 | 68 @signaldef account-removed |
69 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
70 void (*account_removed)(PurpleAccount *account); |
12053 | 71 @endsignalproto |
72 @signaldesc | |
73 Emitted when an account is removed. | |
74 @param account The account that was removed. | |
26845
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26776
diff
changeset
|
75 @see purple_accounts_remove |
12053 | 76 @endsignaldef |
77 | |
12070 | 78 @signaldef account-disabled |
79 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
80 void (*account_disabled)(PurpleAccount *account); |
12070 | 81 @endsignalproto |
82 @signaldesc | |
83 Emitted when an account is disabled. | |
84 @param account The account that was disabled. | |
85 @endsignaldef | |
86 | |
87 @signaldef account-enabled | |
88 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
89 void (*account_enabled)(PurpleAccount *account); |
12070 | 90 @endsignalproto |
91 @signaldesc | |
92 Emitted when an account is enabled. | |
93 @param account The account that was enabled. | |
94 @endsignaldef | |
95 | |
6605 | 96 @signaldef account-setting-info |
97 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
98 void (*account_setting_info)(PurpleAccount *account, const char *new_info); |
6605 | 99 @endsignalproto |
100 @signaldesc | |
101 Emitted when a user is about to send his new user info, or | |
102 profile, to the server. | |
6606
34eaa941ecd6
[gaim-migrate @ 7130]
Christian Hammond <chipx86@chipx86.com>
parents:
6605
diff
changeset
|
103 @param account The account that the info will be set on. |
34eaa941ecd6
[gaim-migrate @ 7130]
Christian Hammond <chipx86@chipx86.com>
parents:
6605
diff
changeset
|
104 @param new_info The new information to set. |
6605 | 105 @endsignaldef |
106 | |
107 @signaldef account-set-info | |
108 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
109 void (*account_set_info)(PurpleAccount *account, const char *new_info); |
6605 | 110 @endsignalproto |
6606
34eaa941ecd6
[gaim-migrate @ 7130]
Christian Hammond <chipx86@chipx86.com>
parents:
6605
diff
changeset
|
111 @signaldesc |
34eaa941ecd6
[gaim-migrate @ 7130]
Christian Hammond <chipx86@chipx86.com>
parents:
6605
diff
changeset
|
112 Emitted when a user sent his new user info, or profile, to the server. |
6605 | 113 @param account The account that the info was set on. |
114 @param new_info The new information set. | |
115 @endsignaldef | |
116 | |
11628 | 117 @signaldef account-status-changed |
118 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
119 void (*account_status_changed)(PurpleAccount *account, PurpleStatus *old, PurpleStatus *new); |
11628 | 120 @endsignalproto |
121 @signaldesc | |
122 Emitted when the status of an account changes (after the change). | |
123 @param account The account that changed status. | |
124 @param old The status before change. | |
125 @param new The status after change. | |
126 @endsignaldef | |
127 | |
26776
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
128 @signaldef account-actions-changed |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
129 @signalproto |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
130 void (*account_actions_changed)(PurpleAccount *account); |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
131 @endsignalproto |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
132 @signaldesc |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
133 Emitted when the account actions are changed after initial connection. |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
134 @param account The account whose actions changed. |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
135 @endsignaldef |
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26327
diff
changeset
|
136 |
13281
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
137 @signaldef account-alias-changed |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
138 @signalproto |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
13281
diff
changeset
|
139 void (*account_alias_changed)(PurpleAccount *account, const char *old); |
13281
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
140 @endsignalproto |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
141 @signaldesc |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
142 Emitted when the alias of an account changes (after the change). |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
143 @param account The account for which the alias was changed. |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
144 @param old The alias before change. |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
145 @endsignaldef |
e629076386f1
[gaim-migrate @ 15647]
Richard Laager <rlaager@wiktel.com>
parents:
12127
diff
changeset
|
146 |
20178
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
147 @signaldef account-authorization-requested |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
148 @signalproto |
26327
5b522d6e04ca
Update the documentation for the account-authorization-requested signal, as
Richard Laager <rlaager@wiktel.com>
parents:
22300
diff
changeset
|
149 int (*account_authorization_requested)(PurpleAccount *account, const char *user); |
20178
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
150 @endsignalproto |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
151 @signaldesc |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
152 Emitted when a user requests authorization. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
153 @param account The account. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
154 @param user The name of the user requesting authorization. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
155 @return Less than zero to deny the request without prompting, greater |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
156 than zero if the request should be granted. If zero is returned, |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
157 then the user will be prompted with the request. |
21221
e98c08afb706
Changelog some of the stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21220
diff
changeset
|
158 @since 2.3.0 |
20178
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
159 @endsignaldef |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
160 |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
161 @signaldef account-authorization-denied |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
162 @signalproto |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
163 void (*account_authorization_denied)(PurpleAccount *account, const char *user); |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
164 @endsignalproto |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
165 @signaldesc |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
166 Emitted when the authorization request for a buddy is denied. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
167 @param account The account. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
168 @param user The name of the user requesting authorization. |
21221
e98c08afb706
Changelog some of the stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21220
diff
changeset
|
169 @since 2.3.0 |
20178
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
170 @endsignaldef |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
171 |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
172 @signaldef account-authorization-granted |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
173 @signalproto |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
174 void (*account_authorization_granted)(PurpleAccount *account, const char *user); |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
175 @endsignalproto |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
176 @signaldesc |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
177 Emitted when the authorization request for a buddy is granted. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
178 @param account The account. |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
179 @param user The name of the user requesting authorization. |
21221
e98c08afb706
Changelog some of the stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21220
diff
changeset
|
180 @since 2.3.0 |
20178
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
181 @endsignaldef |
8e3ef71c4362
Authorization signals. Modified patch from cockroach. Closes #1061.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16183
diff
changeset
|
182 |
21366
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
183 @signaldef account-error-changed |
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
184 @signalproto |
21377
872068d10eab
Mark pointed out that PurpleConnectionErrorPair is not a very good name for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
21374
diff
changeset
|
185 void (*account_error_changed)(PurpleAccount *account, const PurpleConnectionErrorInfo *old_error, const PurpleConnectionErrorInfo *current_error); |
21366
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
186 @endsignalproto |
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
187 @signaldesc |
22300
cccdcc7e5642
I think it's reasonable to just say "don't do this".
Will Thompson <will.thompson@collabora.co.uk>
parents:
21597
diff
changeset
|
188 Emitted when @a account's error changes. You should not call |
cccdcc7e5642
I think it's reasonable to just say "don't do this".
Will Thompson <will.thompson@collabora.co.uk>
parents:
21597
diff
changeset
|
189 purple_account_clear_current_error() while this signal is being emitted. |
21373
cbf197042bad
Add the old error to the account-error-changed signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
21366
diff
changeset
|
190 @param account The account whose error has changed. |
cbf197042bad
Add the old error to the account-error-changed signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
21366
diff
changeset
|
191 @param old_error The account's previous error, or @c NULL if it had no |
21379
30a532b14003
Document exactly how long the PurpleConnectionErrorInfo pointers given out by
Will Thompson <will.thompson@collabora.co.uk>
parents:
21377
diff
changeset
|
192 error. After this signal is emitted, @a old_error is |
30a532b14003
Document exactly how long the PurpleConnectionErrorInfo pointers given out by
Will Thompson <will.thompson@collabora.co.uk>
parents:
21377
diff
changeset
|
193 not guaranteed to be a valid pointer. |
21373
cbf197042bad
Add the old error to the account-error-changed signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
21366
diff
changeset
|
194 @param new_error The account's new error, or @c NULL if it has no error. |
21379
30a532b14003
Document exactly how long the PurpleConnectionErrorInfo pointers given out by
Will Thompson <will.thompson@collabora.co.uk>
parents:
21377
diff
changeset
|
195 If not @c NULL, @a new_error will remain a valid until |
30a532b14003
Document exactly how long the PurpleConnectionErrorInfo pointers given out by
Will Thompson <will.thompson@collabora.co.uk>
parents:
21377
diff
changeset
|
196 pointer just after the next time this signal is emitted |
30a532b14003
Document exactly how long the PurpleConnectionErrorInfo pointers given out by
Will Thompson <will.thompson@collabora.co.uk>
parents:
21377
diff
changeset
|
197 for this @a account. |
21366
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
198 @see purple_account_get_current_error() |
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
199 @since 2.3.0 |
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
200 @endsignaldef |
8858a42ca237
Make PurpleAccount keep track of the last connection error suffered (or not, if
Will Thompson <will.thompson@collabora.co.uk>
parents:
21221
diff
changeset
|
201 |
30119
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
202 @signaldef account-signed-on |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
203 @signalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
204 void (*signed_on)(PurpleAccount *account); |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
205 @endsignalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
206 @signaldesc |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
207 Emitted when an account has signed on. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
208 @param account The account that has signed on. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
209 @since 2.7.0 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
210 @endsignaldef |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
211 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
212 @signaldef account-signed-off |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
213 @signalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
214 void (*signed_off)(PurpleAccount *account); |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
215 @endsignalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
216 @signaldesc |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
217 Emitted when an account has signed off. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
218 @param account The account that has signed off. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
219 @since 2.7.0 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
220 @endsignaldef |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
221 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
222 @signaldef account-connection-error |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
223 @signalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
224 void (*connection_error)(PurpleAccount *gc, PurpleConnectionError err, const gchar *desc) |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
225 @endsignalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
226 @signaldesc |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
227 Emitted when a connection error occurs, before @ref signed-off. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
228 @param account The account on which the error has occurred |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
229 @param err The error that occurred |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
230 @param desc A description of the error, giving more information. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
231 @since 2.7.0 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26845
diff
changeset
|
232 @endsignaldef |
6605 | 233 */ |
20807
e0613cf8c493
Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
16183
diff
changeset
|
234 // vim: syntax=c.doxygen tw=75 et |