comparison doc/conversation-signals.dox @ 8736:374477c0dd76

[gaim-migrate @ 9491] (21:37:35) nosnilmot: LSchiere: do you want this? http://nosnilmot.com/patches/gaim-0.77cvs-doclove.patch (21:38:43) LSchiere: oh wow (21:38:44) LSchiere: sure (21:38:56) nosnilmot: oh crap, does that spelling nonsense conflict with it? (21:40:22) nosnilmot: LSchiere: apparently the spelling police avoided doc/ , so that patch should still apply (21:40:29) KingAnt: :-) (21:40:31) LSchiere: nosnilmot: commit message? (21:40:44) KingAnt: "Dr. Love" (21:40:54) nosnilmot: "I never knew EvilDennisR did anything, now I do" (21:41:05) LSchiere: and the serious commit message? but apparently we aren't being serious tonight. committer: Tailor Script <[e-mail]>

8735:92cbf9713795

/** @page conversation-signals Conversation Signals

 @signals
  @signal displaying-im-msg
  @signal displayed-im-msg
  @signal sending-im-msg
  @signal sent-im-msg
  @signal received-im-msg
  @signal displaying-chat-msg
  @signal displayed-chat-msg
  @signal sending-chat-msg
  @signal sent-chat-msg
  @signal received-chat-msg

  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg,
   sending-im-msg, and finally sent-im-msg.
  @param account The account the message was displayed on.
  @param conv    The conversation the message was displayed on.
  @param message The message that was displayed.
 @endsignaldef

   Make sure to free @a *sender and @a *message before you replace them!
  @return @c TRUE if the message should be canceled, or @c FALSE otherwise.
  @param account The account the message was received on.
  @param sender  A pointer to the username of the sender.
  @param message A pointer to the message that was sent.
 @endsignaldef

 @signaldef writing-chat-msg
  @signalproto
gboolean (*writing_chat_msg)(GaimAccount *account, GaimConversation *conv, char **message);

  @param conv    The conversation the message is being displayed and sent on.
  @param message A pointer to the message that will be displayed and sent.
  @return @c TRUE if the message should be canceled, or @c FALSE otherwise.
 @endsignaldef

 @signaldef wrote-im-msg
  @signalproto
void (*wrote_im_msg)(GaimAccount *account, GaimConversation *conv, const char *message);
  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg,
   sending-im-msg, and finally sent-im-msg.
  @param account The account the message was displayed on.
  @param conv    The conversation the message was displayed on.
  @param message The message that was displayed.
 @endsignaldef

8736:374477c0dd76

/** @page conversation-signals Conversation Signals

 @signals
  @signal writing-im-msg
  @signal wrote-im-msg
  @signal displaying-im-msg
  @signal displayed-im-msg
  @signal sending-im-msg
  @signal sent-im-msg
  @signal received-im-msg
  @signal writing-chat-msg
  @signal wrote-chat-msg
  @signal displaying-chat-msg
  @signal displayed-chat-msg
  @signal sending-chat-msg
  @signal sent-chat-msg
  @signal received-chat-msg

  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg,
   and finally sent-im-msg.
  @param account The account the message was displayed on.
  @param conv    The conversation the message was displayed on.
  @param message The message that was displayed.
 @endsignaldef

   Make sure to free @a *sender and @a *message before you replace them!
  @return @c TRUE if the message should be canceled, or @c FALSE otherwise.
  @param account The account the message was received on.
  @param sender  A pointer to the username of the sender.
  @param message A pointer to the message that was sent.
  @param flags   The message flags.
 @endsignaldef

 @signaldef writing-chat-msg
  @signalproto
gboolean (*writing_chat_msg)(GaimAccount *account, GaimConversation *conv, char **message);

  @param conv    The conversation the message is being displayed and sent on.
  @param message A pointer to the message that will be displayed and sent.
  @return @c TRUE if the message should be canceled, or @c FALSE otherwise.
 @endsignaldef

 @signaldef wrote-chat-msg
  @signalproto
void (*wrote_chat_msg)(GaimAccount *account, GaimConversation *conv, const char *message);
  @endsignalproto
  @signaldesc
   Emitted after a message is entered by the user, but before it is sent and displyed.
   When sending an IM, the order that the im-msg callbacks will be called is:
   writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg,
   and finally sent-im-msg.
  @param account The account the message was displayed on.
  @param conv    The conversation the message was displayed on.
  @param message The message that was displayed.
 @endsignaldef