Mercurial > pidgin
annotate doc/account-signals.dox @ 30431:c9a57878ed17
I think this is marginally better to read.
author | Elliott Sales de Andrade <qulogic@pidgin.im> |
---|---|
date | Mon, 23 Aug 2010 00:53:55 +0000 |
parents | 0417d6bc47cd |
children | 28e27a37e4b4 |
rev | line source |
---|---|
6605 | 1 /** @page account-signals Account Signals |
2 | |
3 @signals | |
26763
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
4 @signal account-created |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
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 |
26694
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26245
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 |
29708
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
20 @signal account-signed-on |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
21 @signal account-signed-off |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
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 | |
26763
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
29 @signaldef account-created |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
30 @signalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
31 void (*account_created)(PurpleAccount *account); |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
32 @endsignalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
33 @signaldesc |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
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:
26694
diff
changeset
|
35 @param account The account. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
36 @since 2.6.0 |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
37 @endsignaldef |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
38 |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
39 @signaldef account-destroying |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
40 @signalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
41 void (*account_destroying)(PurpleAccount *account); |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
42 @endsignalproto |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
43 @signaldesc |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
44 Emitted when an account is about to be destroyed. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
45 @param account The account. |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
46 @since 2.6.0 |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
diff
changeset
|
47 @endsignaldef |
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
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. | |
26763
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
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. | |
26763
76a1598ecf1c
Add account-(created|destroying) signals.
Paul Aurich <paul@darkrain42.org>
parents:
26694
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 | |
26694
83e6e710cbf3
Add a new signal which is emitted (after the account is connected) if the
Paul Aurich <paul@darkrain42.org>
parents:
26245
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:
26245
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:
26245
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:
26245
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:
26245
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:
26245
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:
26245
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:
26245
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:
26245
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 |
26245
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 |
29708
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
202 @signaldef account-signed-on |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
203 @signalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
204 void (*signed_on)(PurpleAccount *account); |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
205 @endsignalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
206 @signaldesc |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
207 Emitted when an account has signed on. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
208 @param account The account that has signed on. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
209 @since 2.7.0 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
210 @endsignaldef |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
211 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
212 @signaldef account-signed-off |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
213 @signalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
214 void (*signed_off)(PurpleAccount *account); |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
215 @endsignalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
216 @signaldesc |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
217 Emitted when an account has signed off. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
218 @param account The account that has signed off. |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
219 @since 2.7.0 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
220 @endsignaldef |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
221 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
222 @signaldef account-connection-error |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
223 @signalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
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:
26763
diff
changeset
|
225 @endsignalproto |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
diff
changeset
|
226 @signaldesc |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
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:
26763
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:
26763
diff
changeset
|
229 @param err The error that occurred |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
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:
26763
diff
changeset
|
231 @since 2.7.0 |
0417d6bc47cd
Document those signals. Refs #11130.
Paul Aurich <paul@darkrain42.org>
parents:
26763
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 |