Hide purple_conversation_write, use purple_conversation_write_message or purple_conversation_write_system_message instead

1 files changed, 25 insertions, 0 deletions

diff --git a/libpurple/internal.h b/libpurple/internal.h
index 4a8215349a..ce0e5b9072 100644
--- a/libpurple/internal.h
+++ b/libpurple/internal.h
@@ -399,4 +399,29 @@ void
 _purple_assert_connection_is_valid(PurpleConnection *gc,
 	const gchar *file, int line);
 
+/**
+ * _purple_conversation_write_common:
+ * @conv:    The conversation.
+ * @who:     The user who sent the message.
+ * @message: The message.
+ * @flags:   The message flags.
+ * @mtime:   The time the message was sent.
+ *
+ * Writes to a conversation window.
+ *
+ * This function should not be used to write IM or chat messages. Use
+ * purple_conversation_write_message() instead. This function will
+ * most likely call this anyway, but it may do it's own formatting,
+ * sound playback, etc. depending on whether the conversation is a chat or an
+ * IM.
+ *
+ * This can be used to write generic messages, such as "so and so closed
+ * the conversation window."
+ *
+ * See purple_conversation_write_message().
+ */
+void
+_purple_conversation_write_common(PurpleConversation *conv, const gchar *who,
+	const gchar *message, PurpleMessageFlags flags, time_t mtime);
+
 #endif /* _PURPLE_INTERNAL_H_ */