doc/account-signals.dox

changeset 21649
6e27033ade81
parent 21206
a54d8733a611
parent 21300
1c23e08cb824
child 21682
cfbbf5c5217f
--- a/doc/account-signals.dox	Sat Nov 17 01:55:40 2007 +0000
+++ b/doc/account-signals.dox	Sat Nov 17 02:03:01 2007 +0000
@@ -9,6 +9,10 @@
   @signal account-setting-info
   @signal account-set-info
   @signal account-status-changed
+  @signal account-authorization-requested
+  @signal account-authorization-denied
+  @signal account-authorization-granted
+  @signal account-error-changed
  @endsignals
 
  @see account.h
@@ -113,6 +117,7 @@
   @return Less than zero to deny the request without prompting, greater
           than zero if the request should be granted. If zero is returned,
           then the user will be prompted with the request.
+  @since 2.3.0
  @endsignaldef
 
  @signaldef account-authorization-denied
@@ -123,6 +128,7 @@
    Emitted when the authorization request for a buddy is denied.
   @param account The account.
   @param user    The name of the user requesting authorization.
+  @since 2.3.0
  @endsignaldef
 
  @signaldef account-authorization-granted
@@ -133,6 +139,25 @@
    Emitted when the authorization request for a buddy is granted.
   @param account The account.
   @param user    The name of the user requesting authorization.
+  @since 2.3.0
+ @endsignaldef
+
+ @signaldef account-error-changed
+  @signalproto
+void (*account_error_changed)(PurpleAccount *account, const PurpleConnectionErrorInfo *old_error, const PurpleConnectionErrorInfo *current_error);
+  @endsignalproto
+  @signaldesc
+   Emitted when @a account's error changes.
+  @param account   The account whose error has changed.
+  @param old_error The account's previous error, or @c NULL if it had no
+                   error.  After this signal is emitted, @a old_error is
+                   not guaranteed to be a valid pointer.
+  @param new_error The account's new error, or @c NULL if it has no error.
+                   If not @c NULL, @a new_error will remain a valid until
+                   pointer just after the next time this signal is emitted
+                   for this @a account.
+  @see purple_account_get_current_error()
+  @since 2.3.0
  @endsignaldef
 
  */

mercurial