--- a/libpurple/purpleconversation.c Mon Apr 15 21:56:20 2024 -0500
+++ b/libpurple/purpleconversation.c Tue Apr 16 00:41:54 2024 -0500
@@ -123,33 +123,35 @@
-purple_conversation_set_account(PurpleConversation *conv,
+purple_conversation_set_account(PurpleConversation *conversation, PurpleConversationMember *member = NULL;
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); /* Remove the account from the conversation if it's a member. */
- if(PURPLE_IS_ACCOUNT(conv->account)) {
+ if(PURPLE_IS_ACCOUNT(conversation->account)) { if(PURPLE_IS_CONVERSATION_MEMBER(member)) {
- purple_conversation_remove_member(conv,
- PURPLE_CONTACT_INFO(conv->account),
+ purple_conversation_remove_member(conversation, + PURPLE_CONTACT_INFO(conversation->account), - if(g_set_object(&conv->account, account)) {
- if(PURPLE_IS_ACCOUNT(conv->account)) {
- purple_conversation_add_member(conv, PURPLE_CONTACT_INFO(account),
+ if(g_set_object(&conversation->account, account)) { + if(PURPLE_IS_ACCOUNT(conversation->account)) { + purple_conversation_add_member(conversation, + PURPLE_CONTACT_INFO(account), g_signal_connect_object(account, "notify::connected",
G_CALLBACK(purple_conversation_account_connected_cb),
- g_object_notify_by_pspec(G_OBJECT(conv), properties[PROP_ACCOUNT]);
+ g_object_notify_by_pspec(G_OBJECT(conversation), + properties[PROP_ACCOUNT]); @@ -203,21 +205,21 @@
-common_send(PurpleConversation *conv, const gchar *message,
+common_send(PurpleConversation *conversation, const char *message, PurpleMessageFlags msgflags)
PurpleProtocol *protocol = NULL;
- gchar *displayed = NULL;
- const gchar *sent, *me;
+ char *displayed = NULL; - account = purple_conversation_get_account(conv);
+ account = purple_conversation_get_account(conversation); g_return_if_fail(PURPLE_IS_ACCOUNT(account));
gc = purple_account_get_connection(account);
@@ -237,7 +239,7 @@
- if(displayed && (conv->features & PURPLE_CONNECTION_FLAG_HTML) &&
+ if(displayed && (conversation->features & PURPLE_CONNECTION_FLAG_HTML) && !(msgflags & PURPLE_MESSAGE_RAW))
@@ -255,7 +257,8 @@
protocol_conversation = PURPLE_PROTOCOL_CONVERSATION(protocol);
purple_protocol_conversation_send_message_async(protocol_conversation,
purple_conversation_send_message_async_cb,
@@ -263,17 +266,17 @@
- who = purple_conversation_get_name(conv);
+ who = purple_conversation_get_name(conversation); msg = _("Unable to send message: The message is too large.");
if(!purple_conversation_present_error(who, account, msg)) {
- gchar *msg2 = g_strdup_printf(_("Unable to send message to %s."),
+ char *msg2 = g_strdup_printf(_("Unable to send message to %s."), purple_notify_error(gc, NULL, msg2,
_("The message is too large."),
purple_request_cpar_from_connection(gc));
@@ -285,8 +288,8 @@
msg = _("Unable to send message.");
if(!purple_conversation_present_error(who, account, msg)) {
- gchar *msg2 = g_strdup_printf(_("Unable to send message to %s."),
+ char *msg2 = g_strdup_printf(_("Unable to send message to %s."), purple_notify_error(gc, NULL, msg2, NULL,
purple_request_cpar_from_connection(gc));
@@ -299,17 +302,17 @@
purple_conversation_send_confirm_cb(gpointer *data) {
- PurpleConversation *conv = data[0];
- gchar *message = data[1];
+ PurpleConversation *conversation = data[0]; + char *message = data[1]; - if(!PURPLE_IS_CONVERSATION(conv)) {
+ if(!PURPLE_IS_CONVERSATION(conversation)) { /* Maybe it was closed before this callback was called. */
- common_send(conv, message, 0);
+ common_send(conversation, message, 0); /**************************************************************************
@@ -343,73 +346,80 @@
purple_conversation_set_property(GObject *obj, guint param_id,
const GValue *value, GParamSpec *pspec)
- PurpleConversation *conv = PURPLE_CONVERSATION(obj);
+ PurpleConversation *conversation = PURPLE_CONVERSATION(obj);
- purple_conversation_set_id(conv, g_value_get_string(value));
- purple_conversation_set_conversation_type(conv, g_value_get_enum(value));
- purple_conversation_set_account(conv, g_value_get_object(value));
- purple_conversation_set_avatar(conv, g_value_get_object(value));
- conv->name = g_value_dup_string(value);
- purple_conversation_set_title(conv, g_value_get_string(value));
- purple_conversation_set_features(conv, g_value_get_flags(value));
- case PROP_AGE_RESTRICTED:
- purple_conversation_set_age_restricted(conv,
- g_value_get_boolean(value));
- purple_conversation_set_description(conv,
- g_value_get_string(value));
- purple_conversation_set_topic(conv, g_value_get_string(value));
- case PROP_TOPIC_AUTHOR:
- purple_conversation_set_topic_author(conv,
- g_value_get_object(value));
- case PROP_TOPIC_UPDATED:
- purple_conversation_set_topic_updated(conv,
- g_value_get_boxed(value));
- case PROP_USER_NICKNAME:
- purple_conversation_set_user_nickname(conv,
- g_value_get_string(value));
- purple_conversation_set_favorite(conv, g_value_get_boolean(value));
- purple_conversation_set_created_on(conv, g_value_get_boxed(value));
- purple_conversation_set_creator(conv, g_value_get_object(value));
- purple_conversation_set_online(conv, g_value_get_boolean(value));
- purple_conversation_set_federated(conv,
- g_value_get_boolean(value));
- G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, pspec);
+ purple_conversation_set_id(conversation, g_value_get_string(value)); + purple_conversation_set_conversation_type(conversation, + g_value_get_enum(value)); + purple_conversation_set_account(conversation, + g_value_get_object(value)); + purple_conversation_set_avatar(conversation, + g_value_get_object(value)); + purple_conversation_set_name(conversation, g_value_get_string(value)); + purple_conversation_set_title(conversation, g_value_get_string(value)); + purple_conversation_set_features(conversation, + g_value_get_flags(value)); + case PROP_AGE_RESTRICTED: + purple_conversation_set_age_restricted(conversation, + g_value_get_boolean(value)); + purple_conversation_set_description(conversation, + g_value_get_string(value)); + purple_conversation_set_topic(conversation, g_value_get_string(value)); + case PROP_TOPIC_AUTHOR: + purple_conversation_set_topic_author(conversation, + g_value_get_object(value)); + case PROP_TOPIC_UPDATED: + purple_conversation_set_topic_updated(conversation, + g_value_get_boxed(value)); + case PROP_USER_NICKNAME: + purple_conversation_set_user_nickname(conversation, + g_value_get_string(value)); + purple_conversation_set_favorite(conversation, + g_value_get_boolean(value)); + purple_conversation_set_created_on(conversation, + g_value_get_boxed(value)); + purple_conversation_set_creator(conversation, + g_value_get_object(value)); + purple_conversation_set_online(conversation, + g_value_get_boolean(value)); + purple_conversation_set_federated(conversation, + g_value_get_boolean(value)); + G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, pspec); @@ -417,95 +427,104 @@
purple_conversation_get_property(GObject *obj, guint param_id, GValue *value,
- PurpleConversation *conv = PURPLE_CONVERSATION(obj);
+ PurpleConversation *conversation = PURPLE_CONVERSATION(obj);
- g_value_set_string(value, purple_conversation_get_id(conv));
- g_value_set_enum(value,
- purple_conversation_get_conversation_type(conv));
- g_value_set_object(value, purple_conversation_get_account(conv));
- g_value_set_object(value, purple_conversation_get_avatar(conv));
- g_value_set_string(value, purple_conversation_get_name(conv));
- g_value_set_string(value, purple_conversation_get_title(conv));
- g_value_set_flags(value, purple_conversation_get_features(conv));
- case PROP_AGE_RESTRICTED:
- g_value_set_boolean(value,
- purple_conversation_get_age_restricted(conv));
- g_value_set_string(value,
- purple_conversation_get_description(conv));
- g_value_set_string(value, purple_conversation_get_topic(conv));
- case PROP_TOPIC_AUTHOR:
- g_value_set_object(value,
- purple_conversation_get_topic_author(conv));
- case PROP_TOPIC_UPDATED:
- g_value_set_boxed(value,
- purple_conversation_get_topic_updated(conv));
- case PROP_USER_NICKNAME:
- g_value_set_string(value,
- purple_conversation_get_user_nickname(conv));
- g_value_set_boolean(value, purple_conversation_get_favorite(conv));
- g_value_set_boxed(value, purple_conversation_get_created_on(conv));
- g_value_set_object(value, purple_conversation_get_creator(conv));
- g_value_set_boolean(value, purple_conversation_get_online(conv));
- g_value_set_boolean(value,
- purple_conversation_get_federated(conv));
- g_value_set_object(value, purple_conversation_get_tags(conv));
- g_value_set_object(value, purple_conversation_get_members(conv));
- g_value_set_object(value, purple_conversation_get_messages(conv));
- G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, pspec);
+ g_value_set_string(value, purple_conversation_get_id(conversation)); + g_value_set_enum(value, + purple_conversation_get_conversation_type(conversation)); + g_value_set_object(value, + purple_conversation_get_account(conversation)); + g_value_set_object(value, + purple_conversation_get_avatar(conversation)); + g_value_set_string(value, purple_conversation_get_name(conversation)); + g_value_set_string(value, purple_conversation_get_title(conversation)); + g_value_set_flags(value, + purple_conversation_get_features(conversation)); + case PROP_AGE_RESTRICTED: + g_value_set_boolean(value, + purple_conversation_get_age_restricted(conversation)); + g_value_set_string(value, + purple_conversation_get_description(conversation)); + g_value_set_string(value, purple_conversation_get_topic(conversation)); + case PROP_TOPIC_AUTHOR: + g_value_set_object(value, + purple_conversation_get_topic_author(conversation)); + case PROP_TOPIC_UPDATED: + g_value_set_boxed(value, + purple_conversation_get_topic_updated(conversation)); + case PROP_USER_NICKNAME: + g_value_set_string(value, + purple_conversation_get_user_nickname(conversation)); + g_value_set_boolean(value, + purple_conversation_get_favorite(conversation)); + g_value_set_boxed(value, + purple_conversation_get_created_on(conversation)); + g_value_set_object(value, + purple_conversation_get_creator(conversation)); + g_value_set_boolean(value, + purple_conversation_get_online(conversation)); + g_value_set_boolean(value, + purple_conversation_get_federated(conversation)); + g_value_set_object(value, purple_conversation_get_tags(conversation)); + g_value_set_object(value, + purple_conversation_get_members(conversation)); + g_value_set_object(value, + purple_conversation_get_messages(conversation)); + G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, pspec); -purple_conversation_init(PurpleConversation *conv) {
- conv->tags = purple_tags_new();
- conv->members = g_list_store_new(PURPLE_TYPE_CONVERSATION_MEMBER);
- conv->messages = g_list_store_new(PURPLE_TYPE_MESSAGE);
+purple_conversation_init(PurpleConversation *conversation) { + conversation->tags = purple_tags_new(); + conversation->members = g_list_store_new(PURPLE_TYPE_CONVERSATION_MEMBER); + conversation->messages = g_list_store_new(PURPLE_TYPE_MESSAGE); purple_conversation_constructed(GObject *object) {
- PurpleConversation *conv = PURPLE_CONVERSATION(object);
+ PurpleConversation *conversation = PURPLE_CONVERSATION(object); @@ -518,12 +537,12 @@
* case where we will not have a connection.
if(PURPLE_IS_CONNECTION(gc)) {
- purple_conversation_set_features(conv,
+ purple_conversation_set_features(conversation, purple_connection_get_flags(gc));
/* Auto-set the title. */
- purple_conversation_autoset_title(conv);
+ purple_conversation_autoset_title(conversation); @@ -535,25 +554,25 @@
purple_conversation_finalize(GObject *object) {
- PurpleConversation *conv = PURPLE_CONVERSATION(object);
+ PurpleConversation *conversation = PURPLE_CONVERSATION(object); - purple_request_close_with_handle(conv);
+ purple_request_close_with_handle(conversation); - g_clear_pointer(&conv->id, g_free);
- g_clear_object(&conv->avatar);
- g_clear_pointer(&conv->name, g_free);
- g_clear_pointer(&conv->title, g_free);
+ g_clear_pointer(&conversation->id, g_free); + g_clear_object(&conversation->avatar); + g_clear_pointer(&conversation->name, g_free); + g_clear_pointer(&conversation->title, g_free); - g_clear_pointer(&conv->description, g_free);
- g_clear_pointer(&conv->topic, g_free);
- g_clear_object(&conv->topic_author);
- g_clear_pointer(&conv->topic_updated, g_date_time_unref);
- g_clear_pointer(&conv->user_nickname, g_free);
- g_clear_pointer(&conv->created_on, g_date_time_unref);
- g_clear_object(&conv->creator);
- g_clear_object(&conv->tags);
- g_clear_object(&conv->members);
- g_clear_object(&conv->messages);
+ g_clear_pointer(&conversation->description, g_free); + g_clear_pointer(&conversation->topic, g_free); + g_clear_object(&conversation->topic_author); + g_clear_pointer(&conversation->topic_updated, g_date_time_unref); + g_clear_pointer(&conversation->user_nickname, g_free); + g_clear_pointer(&conversation->created_on, g_date_time_unref); + g_clear_object(&conversation->creator); + g_clear_object(&conversation->tags); + g_clear_object(&conversation->members); + g_clear_object(&conversation->messages); G_OBJECT_CLASS(purple_conversation_parent_class)->finalize(object);
@@ -973,27 +992,28 @@
-purple_conversation_present(G_GNUC_UNUSED PurpleConversation *conv) {
+purple_conversation_present(G_GNUC_UNUSED PurpleConversation *conversation) { -purple_conversation_set_features(PurpleConversation *conv,
+purple_conversation_set_features(PurpleConversation *conversation, PurpleConnectionFlags features)
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); - if(conv->features != features) {
- conv->features = features;
+ if(conversation->features != features) { + conversation->features = features; - g_object_notify_by_pspec(G_OBJECT(conv), properties[PROP_FEATURES]);
+ g_object_notify_by_pspec(G_OBJECT(conversation), + properties[PROP_FEATURES]); -purple_conversation_get_features(PurpleConversation *conv) {
- g_return_val_if_fail(PURPLE_IS_CONVERSATION(conv), 0);
+purple_conversation_get_features(PurpleConversation *conversation) { + g_return_val_if_fail(PURPLE_IS_CONVERSATION(conversation), 0);
+ return conversation->features; @@ -1026,19 +1046,19 @@
-purple_conversation_get_account(PurpleConversation *conv) {
- g_return_val_if_fail(PURPLE_IS_CONVERSATION(conv), NULL);
+purple_conversation_get_account(PurpleConversation *conversation) { + g_return_val_if_fail(PURPLE_IS_CONVERSATION(conversation), NULL);
+ return conversation->account; -purple_conversation_get_connection(PurpleConversation *conv) {
+purple_conversation_get_connection(PurpleConversation *conversation) { - g_return_val_if_fail(PURPLE_IS_CONVERSATION(conv), NULL);
+ g_return_val_if_fail(PURPLE_IS_CONVERSATION(conversation), NULL); - account = purple_conversation_get_account(conv);
+ account = purple_conversation_get_account(conversation); @@ -1048,141 +1068,151 @@
-purple_conversation_set_title(PurpleConversation *conv, const gchar *title) {
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+purple_conversation_set_title(PurpleConversation *conversation, + g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); g_return_if_fail(title != NULL);
- if(!purple_strequal(conv->title, title)) {
- conv->title = g_strdup(title);
+ if(!purple_strequal(conversation->title, title)) { + g_free(conversation->title); + conversation->title = g_strdup(title); - g_object_notify_by_pspec(G_OBJECT(conv), properties[PROP_TITLE]);
+ g_object_notify_by_pspec(G_OBJECT(conversation), + properties[PROP_TITLE]);
-purple_conversation_get_title(PurpleConversation *conv) {
- g_return_val_if_fail(PURPLE_IS_CONVERSATION(conv), NULL);
+purple_conversation_get_title(PurpleConversation *conversation) { + g_return_val_if_fail(PURPLE_IS_CONVERSATION(conversation), NULL);
+ return conversation->title; -purple_conversation_autoset_title(PurpleConversation *conv) {
- const gchar *name = NULL;
+purple_conversation_autoset_title(PurpleConversation *conversation) { + const char *name = NULL; - g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); - name = purple_conversation_get_name(conv);
+ name = purple_conversation_get_name(conversation); - purple_conversation_set_title(conv, name);
+ purple_conversation_set_title(conversation, name); -purple_conversation_set_name(PurpleConversation *conv, const gchar *name) {
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+purple_conversation_set_name(PurpleConversation *conversation, + g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); - if(!purple_strequal(conv->name, name)) {
- conv->name = g_strdup(name);
+ if(!purple_strequal(conversation->name, name)) { + g_free(conversation->name); + conversation->name = g_strdup(name); - g_object_notify_by_pspec(G_OBJECT(conv), properties[PROP_NAME]);
- purple_conversation_autoset_title(conv);
+ g_object_notify_by_pspec(G_OBJECT(conversation), + properties[PROP_NAME]);
-purple_conversation_get_name(PurpleConversation *conv) {
- g_return_val_if_fail(PURPLE_IS_CONVERSATION(conv), NULL);
+purple_conversation_get_name(PurpleConversation *conversation) { + g_return_val_if_fail(PURPLE_IS_CONVERSATION(conversation), NULL);
+ return conversation->name; -purple_conversation_write_message(PurpleConversation *conv,
+purple_conversation_write_message(PurpleConversation *conversation, + PurpleMessage *message) - g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
- g_return_if_fail(msg != NULL);
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); + g_return_if_fail(message != NULL); - if(purple_message_is_empty(msg)) {
+ if(purple_message_is_empty(message)) { - if(!(purple_message_get_flags(msg) & PURPLE_MESSAGE_NO_LOG))
+ if(!(purple_message_get_flags(message) & PURPLE_MESSAGE_NO_LOG)) { PurpleHistoryManager *manager = NULL;
+ gboolean success = FALSE; manager = purple_history_manager_get_default();
/* We should probably handle this error somehow, but I don't think that
* spamming purple_debug_warning is necessarily the right call.
- if(!purple_history_manager_write(manager, conv, msg, &error)){
- purple_debug_info("conversation", "history manager write returned error: %s", error->message);
+ success = purple_history_manager_write(manager, conversation, message, + purple_debug_info("conversation", + "history manager write returned error: %s", - g_list_store_append(conv->messages, msg);
+ g_list_store_append(conversation->messages, message); -purple_conversation_write_system_message(PurpleConversation *conv,
+purple_conversation_write_system_message(PurpleConversation *conversation, PurpleMessageFlags flags)
PurpleMessage *pmsg = NULL;
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); pmsg = purple_message_new_system(message, flags);
- purple_conversation_write_message(conv, pmsg);
+ purple_conversation_write_message(conversation, pmsg); -purple_conversation_send(PurpleConversation *conv, const gchar *message) {
- purple_conversation_send_with_flags(conv, message, 0);
+purple_conversation_send(PurpleConversation *conversation, + purple_conversation_send_with_flags(conversation, message, 0); -purple_conversation_send_with_flags(PurpleConversation *conv,
+purple_conversation_send_with_flags(PurpleConversation *conversation, PurpleMessageFlags flags)
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); g_return_if_fail(message != NULL);
- common_send(conv, message, flags);
+ common_send(conversation, message, flags); -purple_conversation_has_focus(PurpleConversation *conv) {
+purple_conversation_has_focus(PurpleConversation *conversation) { - g_return_val_if_fail(PURPLE_IS_CONVERSATION(conv), FALSE);
+ g_return_val_if_fail(PURPLE_IS_CONVERSATION(conversation), FALSE); -purple_conversation_present_error(const gchar *who, PurpleAccount *account,
+purple_conversation_present_error(const char *who, PurpleAccount *account, - PurpleConversation *conv;
- PurpleConversationManager *manager;
+ PurpleConversation *conversation = NULL; + PurpleConversationManager *manager = NULL; g_return_val_if_fail(who != NULL, FALSE);
g_return_val_if_fail(PURPLE_IS_ACCOUNT(account), FALSE);
g_return_val_if_fail(what != NULL, FALSE);
manager = purple_conversation_manager_get_default();
- conv = purple_conversation_manager_find(manager, account, who);
- if(PURPLE_IS_CONVERSATION(conv)) {
- purple_conversation_write_system_message(conv, what,
+ conversation = purple_conversation_manager_find(manager, account, who); + if(PURPLE_IS_CONVERSATION(conversation)) { + purple_conversation_write_system_message(conversation, what, @@ -1191,24 +1221,24 @@
-purple_conversation_send_confirm(PurpleConversation *conv,
+purple_conversation_send_confirm(PurpleConversation *conversation,
- g_return_if_fail(PURPLE_IS_CONVERSATION(conv));
+ g_return_if_fail(PURPLE_IS_CONVERSATION(conversation)); g_return_if_fail(message != NULL);
text = g_strdup_printf("You are about to send the following message:\n%s",
data = g_new0(gpointer, 2);
+ data[0] = conversation; data[1] = (gpointer)message;
- purple_request_action(conv, NULL, _("Send Message"), text, 0,
+ purple_request_action(conversation, NULL, _("Send Message"), text, 0, purple_request_cpar_from_account(
- purple_conversation_get_account(conv)),
+ purple_conversation_get_account(conversation)), data, 2, _("_Send Message"),
G_CALLBACK(purple_conversation_send_confirm_cb), _("Cancel"), NULL);
--- a/libpurple/purpleconversation.h Mon Apr 15 21:56:20 2024 -0500
+++ b/libpurple/purpleconversation.h Tue Apr 16 00:41:54 2024 -0500
@@ -156,7 +156,7 @@
* purple_conversation_present:
- * @conv: The conversation to present
+ * @conversation: The conversation to present * Present a conversation to the user. This allows core code to initiate a
* conversation by displaying the IM dialog.
@@ -164,7 +164,7 @@
-void purple_conversation_present(PurpleConversation *conv);
+void purple_conversation_present(PurpleConversation *conversation); * purple_conversation_get_id:
@@ -209,7 +209,7 @@
* purple_conversation_get_account:
- * @conv: The conversation.
+ * @conversation: The conversation. * Returns the specified conversation's purple_account.
@@ -221,11 +221,11 @@
-PurpleAccount *purple_conversation_get_account(PurpleConversation *conv);
+PurpleAccount *purple_conversation_get_account(PurpleConversation *conversation); * purple_conversation_get_connection:
- * @conv: The conversation.
+ * @conversation: The conversation. * Returns the specified conversation's purple_connection.
@@ -234,11 +234,11 @@
-PurpleConnection *purple_conversation_get_connection(PurpleConversation *conv);
+PurpleConnection *purple_conversation_get_connection(PurpleConversation *conversation); * purple_conversation_set_title:
- * @conv: The conversation.
+ * @conversation: The conversation. * Sets the specified conversation's title.
@@ -246,11 +246,11 @@
-void purple_conversation_set_title(PurpleConversation *conv, const gchar *title);
+void purple_conversation_set_title(PurpleConversation *conversation, const char *title); * purple_conversation_get_title:
- * @conv: The conversation.
+ * @conversation: The conversation. * Returns the specified conversation's title.
@@ -259,11 +259,11 @@
-const char *purple_conversation_get_title(PurpleConversation *conv);
+const char *purple_conversation_get_title(PurpleConversation *conversation); * purple_conversation_autoset_title:
- * @conv: The conversation.
+ * @conversation: The conversation. * Automatically sets the specified conversation's title.
@@ -273,11 +273,11 @@
-void purple_conversation_autoset_title(PurpleConversation *conv);
+void purple_conversation_autoset_title(PurpleConversation *conversation); * purple_conversation_set_name:
- * @conv: The conversation.
+ * @conversation: The conversation. * @name: The conversation's name.
* Sets the specified conversation's name.
@@ -285,11 +285,11 @@
-void purple_conversation_set_name(PurpleConversation *conv, const gchar *name);
+void purple_conversation_set_name(PurpleConversation *conversation, const char *name); * purple_conversation_get_name:
- * @conv: The conversation.
+ * @conversation: The conversation. * Returns the specified conversation's name.
@@ -299,36 +299,36 @@
-const char *purple_conversation_get_name(PurpleConversation *conv);
+const char *purple_conversation_get_name(PurpleConversation *conversation); * purple_conversation_write_message:
- * @conv: The conversation.
- * @msg: The message to write.
+ * @conversation: The conversation. + * @message: The message to write. * Writes to a chat or an IM.
-void purple_conversation_write_message(PurpleConversation *conv, PurpleMessage *msg);
+void purple_conversation_write_message(PurpleConversation *conv, PurpleMessage *message); * purple_conversation_write_system_message:
- * @conv: The conversation.
+ * @conversation: The conversation. * @message: The message to write.
- * @flags: The message flags (you don't need to set %PURPLE_MESSAGE_SYSTEM.
+ * @flags: The message flags (you don't need to set %PURPLE_MESSAGE_SYSTEM. * Writes a system message to a chat or an IM.
-void purple_conversation_write_system_message(PurpleConversation *conv, const gchar *message, PurpleMessageFlags flags);
+void purple_conversation_write_system_message(PurpleConversation *conversation, const char *message, PurpleMessageFlags flags); * purple_conversation_send:
- * @conv: The conversation.
+ * @conversation: The conversation. * @message: The message to send.
* Sends a message to this conversation. This function calls
@@ -337,37 +337,36 @@
-void purple_conversation_send(PurpleConversation *conv, const gchar *message);
+void purple_conversation_send(PurpleConversation *conversation, const char *message); * purple_conversation_send_with_flags:
- * @conv: The conversation.
+ * @conversation: The conversation. * @message: The message to send.
- * @flags: The PurpleMessageFlags flags to use in addition to
+ * @flags: The [flags@MessageFlags] to use in addition to %PURPLE_MESSAGE_SEND. * Sends a message to this conversation with specified flags.
-void purple_conversation_send_with_flags(PurpleConversation *conv, const gchar *message, PurpleMessageFlags flags);
+void purple_conversation_send_with_flags(PurpleConversation *conversation, const char *message, PurpleMessageFlags flags); * purple_conversation_set_features:
- * @conv: The conversation
- * @features: Bitset defining supported features
+ * @conversation: The conversation + * @features: Bitset defining supported features * Set the features as supported for the given conversation.
-void purple_conversation_set_features(PurpleConversation *conv, PurpleConnectionFlags features);
+void purple_conversation_set_features(PurpleConversation *conversation, PurpleConnectionFlags features); * purple_conversation_get_features:
- * @conv: The conversation
+ * @conversation: The conversation * Get the features supported by the given conversation.
@@ -376,11 +375,11 @@
-PurpleConnectionFlags purple_conversation_get_features(PurpleConversation *conv);
+PurpleConnectionFlags purple_conversation_get_features(PurpleConversation *conversation); * purple_conversation_has_focus:
- * @conv: The conversation.
+ * @conversation: The conversation. * Determines if a conversation has focus
@@ -394,7 +393,7 @@
* purple_conversation_send_confirm:
- * @conv: The conversation.
+ * @conversation: The conversation. * @message: The message to send.
* Sends a message to a conversation after confirming with
@@ -408,7 +407,7 @@
-void purple_conversation_send_confirm(PurpleConversation *conv, const gchar *message);
+void purple_conversation_send_confirm(PurpleConversation *conversation, const char *message); * purple_conversation_present_error:
@@ -428,7 +427,7 @@
-gboolean purple_conversation_present_error(const gchar *who, PurpleAccount *account, const gchar *what);
+gboolean purple_conversation_present_error(const char *who, PurpleAccount *account, const char *what); * purple_conversation_get_age_restricted: