diff -r b2591070c07b -r 423fbe5e5289 doc/reference/libpurple/account-signals.dox
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/reference/libpurple/account-signals.dox	Sun Oct 13 15:41:22 2013 +0530
@@ -0,0 +1,231 @@
+/** @page account-signals Account Signals
+
+ @signals
+  @signal account-created
+  @signal account-destroying
+  @signal account-added
+  @signal account-connecting
+  @signal account-removed
+  @signal account-disabled
+  @signal account-enabled
+  @signal account-setting-info
+  @signal account-set-info
+  @signal account-status-changed
+  @signal account-actions-changed
+  @signal account-alias-changed
+  @signal account-authorization-requested
+  @signal account-authorization-denied
+  @signal account-authorization-granted
+  @signal account-error-changed
+  @signal account-signed-on
+  @signal account-signed-off
+  @signal account-connection-error
+ @endsignals
+
+ @see account.h
+
+ <hr>
+
+ @signaldef account-created
+  @signalproto
+void (*account_created)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account is created by calling purple_account_new.
+  @param account The account.
+ @endsignaldef
+
+ @signaldef account-destroying
+  @signalproto
+void (*account_destroying)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account is about to be destroyed.
+  @param account The account.
+ @endsignaldef
+
+ @signaldef account-added
+  @signalproto
+void (*account_added)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account is added.
+  @param account The account that was added.
+  @see purple_accounts_add
+ @endsignaldef
+
+ @signaldef account-connecting
+  @signalproto
+void (*account_connecting)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   This is called when an account is in the process of connecting.
+  @param account The account in the process of connecting.
+ @endsignaldef
+
+ @signaldef account-removed
+  @signalproto
+void (*account_removed)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account is removed.
+  @param account The account that was removed.
+  @see purple_accounts_remove
+ @endsignaldef
+
+ @signaldef account-disabled
+  @signalproto
+void (*account_disabled)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account is disabled.
+  @param account The account that was disabled.
+ @endsignaldef
+
+ @signaldef account-enabled
+  @signalproto
+void (*account_enabled)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account is enabled.
+  @param account The account that was enabled.
+ @endsignaldef
+
+ @signaldef account-setting-info
+  @signalproto
+void (*account_setting_info)(PurpleAccount *account, const char *new_info);
+  @endsignalproto
+  @signaldesc
+   Emitted when a user is about to send his new user info, or
+   profile, to the server.
+  @param account  The account that the info will be set on.
+  @param new_info The new information to set.
+ @endsignaldef
+
+ @signaldef account-set-info
+  @signalproto
+void (*account_set_info)(PurpleAccount *account, const char *new_info);
+  @endsignalproto
+  @signaldesc
+   Emitted when a user sent his new user info, or profile, to the server.
+  @param account  The account that the info was set on.
+  @param new_info The new information set.
+ @endsignaldef
+
+ @signaldef account-status-changed
+  @signalproto
+void (*account_status_changed)(PurpleAccount *account, PurpleStatus *old, PurpleStatus *new);
+  @endsignalproto
+  @signaldesc
+   Emitted when the status of an account changes (after the change).
+  @param account The account that changed status.
+  @param old     The status before change.
+  @param new     The status after change.
+ @endsignaldef
+
+ @signaldef account-actions-changed
+  @signalproto
+void (*account_actions_changed)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when the account actions are changed after initial connection.
+  @param account The account whose actions changed.
+ @endsignaldef
+
+ @signaldef account-alias-changed
+  @signalproto
+void (*account_alias_changed)(PurpleAccount *account, const char *old);
+  @endsignalproto
+  @signaldesc
+   Emitted when the alias of an account changes (after the change).
+  @param account The account for which the alias was changed.
+  @param old     The alias before change.
+ @endsignaldef
+
+ @signaldef account-authorization-requested
+  @signalproto
+int (*account_authorization_requested)(PurpleAccount *account, const char *user, const char *message, char **response);
+  @endsignalproto
+  @signaldesc
+   Emitted when a user requests authorization.
+  @param account  The account.
+  @param user     The name of the user requesting authorization.
+  @param message  The authorization request message.
+  @param response The message to send in the response.
+  @return PURPLE_ACCOUNT_RESPONSE_IGNORE to silently ignore the request,
+          PURPLE_ACCOUNT_RESPONSE_DENY to block the request (the sender might
+          get informed), PURPLE_ACCOUNT_RESPONSE_ACCEPT if the request should be
+          granted. If PURPLE_ACCOUNT_RESPONSE_PASS is returned, then the user
+          will be prompted with the request.
+ @endsignaldef
+
+ @signaldef account-authorization-denied
+  @signalproto
+void (*account_authorization_denied)(PurpleAccount *account, const char *user, const char *message);
+  @endsignalproto
+  @signaldesc
+   Emitted when the authorization request for a buddy is denied.
+  @param account The account.
+  @param user    The name of the user requesting authorization.
+  @param message The message to tell the buddy who was denied.
+ @endsignaldef
+
+ @signaldef account-authorization-granted
+  @signalproto
+void (*account_authorization_granted)(PurpleAccount *account, const char *user, const char *message);
+  @endsignalproto
+  @signaldesc
+   Emitted when the authorization request for a buddy is granted.
+  @param account The account.
+  @param user    The name of the user requesting authorization.
+  @param message The message to tell the buddy who was granted authorization.
+ @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.  You should not call
+   purple_account_clear_current_error() while this signal is being emitted.
+  @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()
+ @endsignaldef
+
+ @signaldef account-signed-on
+  @signalproto
+void (*signed_on)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account has signed on.
+  @param account The account that has signed on.
+ @endsignaldef
+
+ @signaldef account-signed-off
+  @signalproto
+void (*signed_off)(PurpleAccount *account);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account has signed off.
+  @param account The account that has signed off.
+ @endsignaldef
+
+ @signaldef account-connection-error
+  @signalproto
+void (*connection_error)(PurpleAccount *gc, PurpleConnectionError err, const gchar *desc)
+  @endsignalproto
+  @signaldesc
+   Emitted when a connection error occurs, before @ref signed-off.
+   @param account The account on which the error has occurred
+   @param err     The error that occurred
+   @param desc    A description of the error, giving more information.
+ @endsignaldef
+ */
+// vim: syntax=c.doxygen tw=75 et