diff src/protocols/msn/slpmsg.h @ 10345:2e01c503aa4f

[gaim-migrate @ 11556] Patch 1078151 from Felipe Contreras to fix some more MSN bugs: "User Dislpay messages, and other less used, did not set an slpcall, so the callback that should not be called, was called (in some very special cases)." ... "Here it goes the real real one, as far as I can tell. Cleaning + organizing + documentation + hard bug fix = big patch." -- Felipe Contreras I also fixed drag-and-drop to conversation window file transfers (which I had broken when I fixed some other dnd thing), made the debug output of the autoreconnect plugin more useful, and stopped the message notification plugin notifying you for messages sent by ignored users. committer: Tailor Script <[e-mail]>

--- a/src/protocols/msn/slpmsg.h	Sat Dec 11 00:06:06 2004 +0000
+++ b/src/protocols/msn/slpmsg.h	Sat Dec 11 20:01:58 2004 +0000
@@ -34,11 +34,15 @@
 
 #include "slp.h"
 
+/**
+ * A SLP Message  This contains everything that we will need to send a SLP
+ * Message even if has to be sent in several parts.
+ */
 struct _MsnSlpMessage
 {
 	MsnSlpSession *slpsession;
-	MsnSlpCall *slpcall;
-	MsnSlpLink *slplink;
+	MsnSlpCall *slpcall; /**< The slpcall to which this slp message belongs (if applicable). */
+	MsnSlpLink *slplink; /**< The slplink through which this slp message is being sent. */
 	MsnSession *session;
 
 	long session_id;
@@ -48,10 +52,8 @@
 	long long ack_size;
 	long app_id;
 
-	gboolean sip;
-#if 0
-	gboolean wasted;
-#endif
+	gboolean sip; /**< A flag that states if this is a SIP slp message. */
+	int ref_count; /**< The reference count. */
 	long flags;
 
 	FILE *fp;
@@ -59,16 +61,33 @@
 	long long offset;
 	long long size;
 
-	MsnMessage *msg; /* The temporary real message that will be sent */
+	GList *msgs; /**< The real messages. */
 
-#ifdef DEBUG_SLP
+#if 1
+	MsnMessage *msg; /**< The temporary real message that will be sent. */
+#endif
+
+#ifdef MSN_DEBUG_SLP
 	char *info;
 	gboolean text_body;
 #endif
 };
 
+/**
+ * Creates a new slp message
+ *
+ * @param slplink The slplink through which this slp message will be sent.
+ * @return The created slp message.
+ */
 MsnSlpMessage *msn_slpmsg_new(MsnSlpLink *slplink);
+
+/**
+ * Destroys a slp message
+ *
+ * @param slpmsg The slp message to destory.
+ */
 void msn_slpmsg_destroy(MsnSlpMessage *slpmsg);
+
 void msn_slpmsg_set_body(MsnSlpMessage *slpmsg, const char *body,
 						 long long size);
 void msn_slpmsg_open_file(MsnSlpMessage *slpmsg,
@@ -79,7 +98,7 @@
 								   const char *content_type,
 								   const char *content);
 
-#ifdef DEBUG_SLP
+#ifdef MSN_DEBUG_SLP
 const void msn_slpmsg_show(MsnMessage *msg);
 #endif