Mercurial > pidgin3 / file diff

--- a/libpurple/purpleimconversation.h	Tue Oct 24 01:23:22 2023 -0500
+++ b/libpurple/purpleimconversation.h	Tue Oct 24 02:02:49 2023 -0500
@@ -57,6 +57,7 @@
 
 #include "purpleaccount.h"
 #include "purpleconversation.h"
+#include "purpleversion.h"
 
 /**
  * PurpleIMConversation:
@@ -82,7 +83,10 @@
  * purple_im_conversation_get_type:
  *
  * Returns: The #GType for the IMConversation object.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 GType purple_im_conversation_get_type(void);
 
 /**
@@ -94,7 +98,10 @@
  * Creates a new IM conversation.
  *
  * Returns: The new conversation.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 PurpleConversation *purple_im_conversation_new(PurpleAccount *account, const gchar *name);
 
 /**
@@ -103,7 +110,10 @@
  * @state: The typing state.
  *
  * Sets the IM's typing state.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_set_typing_state(PurpleIMConversation *im, PurpleIMTypingState state);
 
 /**
@@ -113,7 +123,10 @@
  * Returns the IM's typing state.
  *
  * Returns: The IM's typing state.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 PurpleIMTypingState purple_im_conversation_get_typing_state(PurpleIMConversation *im);
 
 /**
@@ -123,7 +136,10 @@
  *           PURPLE_IM_NOT_TYPING.
  *
  * Starts the IM's typing timeout.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_start_typing_timeout(PurpleIMConversation *im, int timeout);
 
 /**
@@ -131,7 +147,10 @@
  * @im: The IM.
  *
  * Stops the IM's typing timeout.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_stop_typing_timeout(PurpleIMConversation *im);
 
 /**
@@ -141,7 +160,10 @@
  * Returns the IM's typing timeout.
  *
  * Returns: The timeout.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 guint purple_im_conversation_get_typing_timeout(PurpleIMConversation *im);
 
 /**
@@ -155,7 +177,10 @@
  * Few protocols need this (maybe only MSN).  If the user is still
  * typing after this quiet-period, then another #PURPLE_IM_TYPING message
  * will be sent.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_set_type_again(PurpleIMConversation *im, guint val);
 
 /**
@@ -166,7 +191,10 @@
  *
  * Returns: The time in seconds since the epoch.  Or 0 if no additional
  *         PURPLE_IM_TYPING message should be sent.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 time_t purple_im_conversation_get_type_again(PurpleIMConversation *im);
 
 /**
@@ -174,7 +202,10 @@
  * @im:      The IM.
  *
  * Starts the IM's type again timeout.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_start_send_typed_timeout(PurpleIMConversation *im);
 
 /**
@@ -182,7 +213,10 @@
  * @im: The IM.
  *
  * Stops the IM's type again timeout.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_stop_send_typed_timeout(PurpleIMConversation *im);
 
 /**
@@ -192,7 +226,10 @@
  * Returns the IM's type again timeout interval.
  *
  * Returns: The type again timeout interval.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 guint purple_im_conversation_get_send_typed_timeout(PurpleIMConversation *im);
 
 /**
@@ -200,7 +237,10 @@
  * @im: The IM.
  *
  * Updates the visual typing notification for an IM conversation.
+ *
+ * Since: 3.0.0
  */
+PURPLE_AVAILABLE_IN_3_0
 void purple_im_conversation_update_typing(PurpleIMConversation *im);
 
 G_END_DECLS