comparison doc/account-signals.dox @ 30119:0417d6bc47cd

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.

30118:4d0ccbc905aa

  @signal account-alias-changed
  @signal account-authorization-requested
  @signal account-authorization-denied
  @signal account-authorization-granted
  @signal account-error-changed
 @endsignals

 @see account.h

 <hr>

                   for this @a account.
  @see purple_account_get_current_error()
  @since 2.3.0
 @endsignaldef

 */
// vim: syntax=c.doxygen tw=75 et

30119:0417d6bc47cd

  @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>

                   for this @a account.
  @see purple_account_get_current_error()
  @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