- try:
- (<object>conversation_cbs["write-im"])(username, sender, \
- sender_alias, message)
- except KeyError:
- pass
-
-cdef void write_conv (conversation.PurpleConversation *conv, const_char *name,
- const_char *alias, const_char *message,
- conversation.PurpleMessageFlags flags, time_t mtime):
+ if conversation_cbs.has_key("write-im"):
+ (<object> conversation_cbs["write-im"])(username, sender, \
+ sender_alias, message)
+
+cdef void write_conv(conversation.PurpleConversation *conv, const_char *name, \
+ const_char *alias, const_char *message, \
+ conversation.PurpleMessageFlags flags, time_t mtime):
+ """
+ Write a message to a conversation. This is used rather than the chat- or
+ im-specific ops for errors, system messages (such as "x is now known as
+ y"), and as the fallback if write_im and write_chat are not implemented.
+ It should be implemented, or the UI will miss conversation error messages
+ and your users will hate you.
+ @see purple_conversation_write()
+ """