# HG changeset patch
# User Mark Doliner <mark@kingant.net>
# Date 1212800174 0
# Node ID 27f7fae4a36196ac12aaecad357e9a500a82294a
# Parent  945bf99cb233d7e27372cd988d9b4c0403c958f2
Add a few bits of documentation

diff -r 945bf99cb233 -r 27f7fae4a361 libpurple/protocols/msn/notification.c
--- a/libpurple/protocols/msn/notification.c	Sat Jun 07 00:47:16 2008 +0000
+++ b/libpurple/protocols/msn/notification.c	Sat Jun 07 00:56:14 2008 +0000
@@ -1015,13 +1015,13 @@
 	MsnSlpLink *slplink;
 	MsnUser *user;
 
+	/* Tell libpurple that the user has signed off */
 	user = msn_userlist_find_user(cmdproc->session->userlist, cmd->params[0]);
-
 	user->status = "offline";
 	msn_user_update(user);
 
+	/* If we have an open MsnSlpLink with the user then close it */
 	slplink = msn_session_find_slplink(cmdproc->session, cmd->params[0]);
-
 	if (slplink != NULL)
 		msn_slplink_destroy(slplink);
 
diff -r 945bf99cb233 -r 27f7fae4a361 libpurple/protocols/msn/slplink.h
--- a/libpurple/protocols/msn/slplink.h	Sat Jun 07 00:47:16 2008 +0000
+++ b/libpurple/protocols/msn/slplink.h	Sat Jun 07 00:56:14 2008 +0000
@@ -60,9 +60,20 @@
 };
 
 void msn_slplink_destroy(MsnSlpLink *slplink);
+
+/**
+ * @return An MsnSlpLink for the given user, or NULL if there is no
+ *         existing MsnSlpLink.
+ */
 MsnSlpLink *msn_session_find_slplink(MsnSession *session,
 									 const char *who);
+
+/**
+ * @return An MsnSlpLink for the given user.  One will be created if
+ *         it does not already exist.
+ */
 MsnSlpLink *msn_session_get_slplink(MsnSession *session, const char *username);
+
 MsnSlpSession *msn_slplink_find_slp_session(MsnSlpLink *slplink,
 											long session_id);
 void msn_slplink_add_slpcall(MsnSlpLink *slplink, MsnSlpCall *slpcall);