diff libpurple/conversation.h @ 17221:c9a046a7f326

New function purple_conversation_do_command. This is almost like purple_cmd_do_command, except it allows NULL for markup and error, and it's properly namespaced.
author Sadrul Habib Chowdhury <imadil@gmail.com>
date Tue, 22 May 2007 06:03:42 +0000
parents da2bab3b9fab
children 6b7b13adb9b1
line wrap: on
line diff
--- a/libpurple/conversation.h	Tue May 22 03:28:12 2007 +0000
+++ b/libpurple/conversation.h	Tue May 22 06:03:42 2007 +0000
@@ -1201,6 +1201,19 @@
  */
 GList * purple_conversation_get_extended_menu(PurpleConversation *conv);
 
+/**
+ * Perform a command in a conversation. Similar to @see purple_cmd_do_command
+ *
+ * @param conv    The conversation.
+ * @param cmdline The entire command including the arguments.
+ * @param markup  @c NULL, or the formatted command line.
+ * @param error   If the command failed errormsg is filled in with the appropriate error
+ *                message, if not @c NULL. It must be freed by the caller with g_free().
+ *
+ * @return  @c TRUE if the command was executed successfully, @c FALSE otherwise.
+ */
+gboolean purple_conversation_do_command(PurpleConversation *conv, const gchar *cmdline, const gchar *markup, gchar **error);
+
 /*@}*/
 
 /**************************************************************************/