comparison doc/account-signals.dox @ 31820:28e27a37e4b4

Patch from Stefan Ott to add the account-authorization-requested-with-message signal, which can be useful to plugins. Fixes #8690. I also slipped in some ChangeLog.API tweaks.
author John Bailey <rekkanoryo@rekkanoryo.org>
date Sun, 09 Jan 2011 04:40:07 +0000
parents 0417d6bc47cd
children 02a2e8183b1d
comparison
equal deleted inserted replaced
31819:5767e981508a 31820:28e27a37e4b4
12 @signal account-set-info 12 @signal account-set-info
13 @signal account-status-changed 13 @signal account-status-changed
14 @signal account-actions-changed 14 @signal account-actions-changed
15 @signal account-alias-changed 15 @signal account-alias-changed
16 @signal account-authorization-requested 16 @signal account-authorization-requested
17 @signal account-authorization-requested-with-message
17 @signal account-authorization-denied 18 @signal account-authorization-denied
18 @signal account-authorization-granted 19 @signal account-authorization-granted
19 @signal account-error-changed 20 @signal account-error-changed
20 @signal account-signed-on 21 @signal account-signed-on
21 @signal account-signed-off 22 @signal account-signed-off
154 @param user The name of the user requesting authorization. 155 @param user The name of the user requesting authorization.
155 @return Less than zero to deny the request without prompting, greater 156 @return Less than zero to deny the request without prompting, greater
156 than zero if the request should be granted. If zero is returned, 157 than zero if the request should be granted. If zero is returned,
157 then the user will be prompted with the request. 158 then the user will be prompted with the request.
158 @since 2.3.0 159 @since 2.3.0
160 @endsignaldef
161
162 @signaldef account-authorization-requested-with-message
163 @signalproto
164 int (*account_authorization_requested)(PurpleAccount *account, const char *user, const char *message);
165 @endsignalproto
166 @signaldesc
167 Emitted when a user requests authorization.
168 @param account The account.
169 @param user The name of the user requesting authorization.
170 @param message The authorization request message
171 @return PURPLE_ACCOUNT_RESPONSE_IGNORE to silently ignore the request,
172 PURPLE_ACCOUNT_RESPONSE_DENY to block the request (the sender might
173 get informed, PURPLE_ACCOUNT_RESPONSE_ACCEPT if the request should be
174 granted. If PURPLE_ACCOUNT_RESPONSE_PASS is returned, then the user
175 will be prompted with the request.
176 @since 2.8.0
159 @endsignaldef 177 @endsignaldef
160 178
161 @signaldef account-authorization-denied 179 @signaldef account-authorization-denied
162 @signalproto 180 @signalproto
163 void (*account_authorization_denied)(PurpleAccount *account, const char *user); 181 void (*account_authorization_denied)(PurpleAccount *account, const char *user);