cpw.qulogic.msnp16: 338fa5f6: msn: Improve cmdproc.h docs.

[masca at cpw.pidgin.im]

-----------------------------------------------------------------
Revision: 338fa5f69bb7675fc80f890f27023b462eadb1fa
Ancestor: 9e76c8a2e0e342f636d1412d55c5b7c0af3d3b9c
Author: masca at cpw.pidgin.im
Date: 2010-03-05T04:19:05
Branch: im.pidgin.cpw.qulogic.msnp16
URL: http://d.pidgin.im/viewmtn/revision/info/338fa5f69bb7675fc80f890f27023b462eadb1fa

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

ChangeLog: 

msn: Improve cmdproc.h docs.

-------------- next part --------------
============================================================
--- libpurple/protocols/msn/cmdproc.h	17067b2ccaa965b1c8eaa7fdf2a72c38339bfbc5
+++ libpurple/protocols/msn/cmdproc.h	ef09f1e07de96566298363cb0bb807fb6a951cae
@@ -51,14 +51,54 @@ struct _MsnCmdProc
 	void *data; /**< Extra data, like the switchboard. */
 };
 
+/**
+ * Creates a MsnCmdProc structure.
+ *
+ * @param session 	The session to associate with.
+ *
+ * @return A new MsnCmdProc structure.
+ */
 MsnCmdProc *msn_cmdproc_new(MsnSession *session);
+
+/**
+ * Destroys an MsnCmdProc.
+ *
+ * @param cmdproc 	The object structure.
+ */
 void msn_cmdproc_destroy(MsnCmdProc *cmdproc);
 
+/**
+ * Process the queued transactions.
+ *
+ * @param cmdproc 	The MsnCmdProc.
+ */
 void msn_cmdproc_process_queue(MsnCmdProc *cmdproc);
 
+/**
+ * Sends transaction using this servconn.
+ *
+ * @param cmdproc 	The MsnCmdProc to be used.
+ * @param trans 	The MsnTransaction to be sent.
+ */
 void msn_cmdproc_send_trans(MsnCmdProc *cmdproc, MsnTransaction *trans);
+
+/**
+ * Add a transaction to the queue to be processed latter.
+ *
+ * @param cmdproc 	The MsnCmdProc in which the transaction will be queued.
+ * @param trans 	The MsnTransaction to be queued.
+ */
 void msn_cmdproc_queue_trans(MsnCmdProc *cmdproc,
 							 MsnTransaction *trans);
+
+/**
+ * This function is just a wrapper that creates a MsnTransaction
+ * and send it.
+ *
+ * @param cmdproc 	The MsnCmdProc to be attached to the MsnTransaction.
+ * @param command 	The command to use in this transaction.
+ * @param format 	The payload format.
+ */
 void msn_cmdproc_send(MsnCmdProc *cmdproc, const char *command,
 					  const char *format, ...);
 void msn_cmdproc_send_quick(MsnCmdProc *cmdproc, const char *command,