pidgin: 512105f8: Document those signals. Refs #11130.

[darkrain42 at pidgin.im]

-----------------------------------------------------------------
Revision: 512105f86bd25c63994d1ab26ed4d4998773c923
Ancestor: 798f83c08c517ab0e8bbd39b8d6654541ba66656
Author: darkrain42 at pidgin.im
Date: 2010-04-12T04:01:07
Branch: im.pidgin.pidgin
URL: http://d.pidgin.im/viewmtn/revision/info/512105f86bd25c63994d1ab26ed4d4998773c923

Modified files:
        doc/account-signals.dox

ChangeLog: 

Document those signals.  Refs #11130.

I just noticed account-error-changed, which possibly overlaps some with
account-connection-error, but this version provides the error code and
string without requiring another D-Bus roundtrip.

-------------- next part --------------
============================================================
--- doc/account-signals.dox	0d19c6172e97756bf58163090cafe91818c9a843
+++ doc/account-signals.dox	237592d9ef1adb82ff1a881fb64c3f82e6d62ede
@@ -17,6 +17,9 @@
   @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
@@ -196,5 +199,36 @@ void (*account_error_changed)(PurpleAcco
   @since 2.3.0
  @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.
+  @since 2.7.0
+ @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.
+  @since 2.7.0
+ @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.
+  @since 2.7.0
+ @endsignaldef
  */
 // vim: syntax=c.doxygen tw=75 et