comparison doc/conversation-signals.dox @ 23171:ff8ec3d58367

Modified patch from Stefan 'cockroach' Ott to add blocked-im-msg and chat-invite-blocked signals for blocked im messages and blocked chat invites. Closes #1062.

23170:d7e66b6137f9

  @signal wrote-im-msg
  @signal sending-im-msg
  @signal sent-im-msg
  @signal receiving-im-msg
  @signal received-im-msg
  @signal writing-chat-msg
  @signal wrote-chat-msg
  @signal sending-chat-msg
  @signal sent-chat-msg
  @signal receiving-chat-msg

  @signal chat-buddy-leaving
  @signal chat-buddy-left
  @signal chat-inviting-user
  @signal chat-invited-user
  @signal chat-invited
  @signal chat-joined
  @signal chat-join-failed
  @signal chat-left
  @signal chat-topic-changed
  @signal conversation-extended-menu

  @param account The account the message was received on.
  @param sender  The username of the sender.
  @param message The message that was sent.
  @param conv    The IM conversation.
  @param flags   The IM message flags.
 @endsignaldef

 @signaldef writing-chat-msg
  @signalproto
gboolean (*writing_chat_msg)(PurpleAccount *account, const char *who,

  @return Less than zero if the invitation should be rejected, greater than
          zero if the invitation should be accepted. If zero is returned, the
          default behavior will be maintained: the user will be prompted.
 @endsignaldef

 @signaldef chat-joined
  @signalproto
void (*chat_joined)(PurpleConversation *conv);
  @endsignalproto
  @signaldesc

23171:ff8ec3d58367

  @signal wrote-im-msg
  @signal sending-im-msg
  @signal sent-im-msg
  @signal receiving-im-msg
  @signal received-im-msg
  @signal blocked-im-msg
  @signal writing-chat-msg
  @signal wrote-chat-msg
  @signal sending-chat-msg
  @signal sent-chat-msg
  @signal receiving-chat-msg

  @signal chat-buddy-leaving
  @signal chat-buddy-left
  @signal chat-inviting-user
  @signal chat-invited-user
  @signal chat-invited
  @signal chat-invite-blocked
  @signal chat-joined
  @signal chat-join-failed
  @signal chat-left
  @signal chat-topic-changed
  @signal conversation-extended-menu

  @param account The account the message was received on.
  @param sender  The username of the sender.
  @param message The message that was sent.
  @param conv    The IM conversation.
  @param flags   The IM message flags.
 @endsignaldef

 @signaldef blocked-im-msg
  @signalproto
void (*blocked_im_msg)(PurpleAccount *account, const char *sender,
        const char *message, PurpleMessageFlags flags, time_t when);
  @endsignalproto
  @signaldesc
   Emitted after an IM is blocked due to privacy settings.
  @param account The account the message was received on.
  @param sender  The username of the sender.
  @param message The message that was blocked.
  @param flags   The IM message flags.
  @param when    The time the message was sent.
  @since 2.5.0
 @endsignaldef

 @signaldef writing-chat-msg
  @signalproto
gboolean (*writing_chat_msg)(PurpleAccount *account, const char *who,

  @return Less than zero if the invitation should be rejected, greater than
          zero if the invitation should be accepted. If zero is returned, the
          default behavior will be maintained: the user will be prompted.
 @endsignaldef

 @signaldef chat-invite-blocked
  @signalproto
void (*chat_invite_blocked)(PurpleAccount *account, const char *inviter,
                   const char *name, const char *message, GHashTable *data);
  @endsignalproto
  @signaldesc
   Emitted when an invitation to join a chat is blocked.
  @param account  The account the invitation was sent to.
  @param inviter  The name of the person sending the invitation.
  @param name     The name of the chat invited to.
  @param message  The invitation message sent.
  @param data     Hashtable containing data about the invited chat.
  @since 2.5.0
 @endsignaldef

 @signaldef chat-joined
  @signalproto
void (*chat_joined)(PurpleConversation *conv);
  @endsignalproto
  @signaldesc