Mercurial > pidgin3 / changeset

--- a/libpurple/protocols/msn/dialog.c	Wed Feb 24 01:21:07 2010 +0000
+++ b/libpurple/protocols/msn/dialog.c	Wed Feb 24 17:36:45 2010 +0000
@@ -34,9 +34,11 @@
 
 } MsnAddRemData;
 
-/* Remove the buddy referenced by the MsnAddRemData before the serverside list is changed.
- * If the buddy will be added, he'll be added back; if he will be removed, he won't be. */
-/* Actually with our MSNP14 code that isn't true yet, he won't be added back :( */
+/* Remove the buddy referenced by the MsnAddRemData before the serverside list
+ * is changed.  If the buddy will be added, he'll be added back; if he will be
+ * removed, he won't be. */
+/* Actually with our MSNP14 code that isn't true yet, he won't be added back :(
+ * */
 static void
 msn_complete_sync_issue(MsnAddRemData *data)
 {

--- a/libpurple/protocols/msn/msnutils.h	Wed Feb 24 01:21:07 2010 +0000
+++ b/libpurple/protocols/msn/msnutils.h	Wed Feb 24 17:36:45 2010 +0000
@@ -54,7 +54,23 @@
  */
 void msn_import_html(const char *html, char **attributes, char **message);
 
+/**
+ * Parses a socket string.
+ *
+ * @param str		A host:port string.
+ * @param ret_host 	Return string value of the host.
+ * @param ret_port	Return integer value of the port.
+ */
 void msn_parse_socket(const char *str, char **ret_host, int *ret_port);
+
+/**
+ * Handle MSN Challenge Computation
+ * This algorithm references
+ * http://imfreedom.org/wiki/index.php/MSN:NS/Challenges
+ *
+ * @param input 	Challenge input.
+ * @param output 	Callenge output.
+ */
 void msn_handle_chl(char *input, char *output);
 
 #endif /* MSN_UTILS_H */