cpw.qulogic.msnp16: 029197c9: Document msnutils.

[masca at cpw.pidgin.im]

-----------------------------------------------------------------
Revision: 029197c93909a808e78b66053bb4115e20435b72
Ancestor: d32de539cc61b160933ea8565a250a3349d05192
Author: masca at cpw.pidgin.im
Date: 2010-02-23T17:49:32
Branch: im.pidgin.cpw.qulogic.msnp16
URL: http://d.pidgin.im/viewmtn/revision/info/029197c93909a808e78b66053bb4115e20435b72

Modified files:
        libpurple/protocols/msn/msnutils.h

ChangeLog: 

Document msnutils.

-------------- next part --------------
============================================================
--- libpurple/protocols/msn/msnutils.h	ac95cf7b1395659d2fcd9793164551ad6830b03d
+++ libpurple/protocols/msn/msnutils.h	640fd129b3232cc5ffcff1aa2ee7a6a742b09f67
@@ -54,7 +54,23 @@ void msn_import_html(const char *html, c
  */
 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 */