Index: uspace/lib/c/generic/async_sess.c
===================================================================
--- uspace/lib/c/generic/async_sess.c	(revision a1dc7fe84096c2e1a97f1148301daa5edeaac376)
+++ uspace/lib/c/generic/async_sess.c	(revision 8cd21d1683e63a439a0782f7e8f10270fc169e6d)
@@ -107,7 +107,8 @@
 #include <assert.h>
 
+/** An inactive open connection. */
 typedef struct {
-	link_t conn_link;	/**< Link for the list of connections. */
-	link_t global_link;	/**< Link for the global list of phones. */
+	link_t sess_link;	/**< Link for the session list of inactive connections. */
+	link_t global_link;	/**< Link for the global list of inactive connectinos. */
 	int data_phone;		/**< Connected data phone. */
 } conn_node_t;
@@ -139,4 +140,15 @@
 }
 
+/** Create a session.
+ *
+ * Session is a logical datapath from a client task to a server task.
+ * One session can accomodate multiple concurrent exchanges. Here
+ * @a phone is a phone connected to the desired server task.
+ *
+ * This function always succeeds.
+ *
+ * @param sess	Session structure provided by caller, will be filled in.
+ * @param phone	Phone connected to the desired server task.
+ */
 void async_session_create(async_sess_t *sess, int phone)
 {
@@ -150,4 +162,11 @@
 }
 
+/** Destroy a session.
+ *
+ * Dismantle session structure @a sess and release any resources (connections)
+ * held by the session.
+ *
+ * @param sess	Session to destroy.
+ */
 void async_session_destroy(async_sess_t *sess)
 {
@@ -165,7 +184,7 @@
 	while (!list_empty(&sess->conn_head)) {
 		conn = list_get_instance(sess->conn_head.next, conn_node_t,
-		    conn_link);
-
-		list_remove(&conn->conn_link);
+		    sess_link);
+
+		list_remove(&conn->sess_link);
 		list_remove(&conn->global_link);
 		
@@ -177,5 +196,5 @@
 static void conn_node_initialize(conn_node_t *conn)
 {
-	link_initialize(&conn->conn_link);
+	link_initialize(&conn->sess_link);
 	link_initialize(&conn->global_link);
 	conn->data_phone = -1;
@@ -200,6 +219,6 @@
 		 */
 		conn = list_get_instance(sess->conn_head.next, conn_node_t,
-		    conn_link);
-		list_remove(&conn->conn_link);
+		    sess_link);
+		list_remove(&conn->sess_link);
 		list_remove(&conn->global_link);
 		
@@ -224,5 +243,5 @@
 			    conn_node_t, global_link);
 			list_remove(&conn->global_link);
-			list_remove(&conn->conn_link);
+			list_remove(&conn->sess_link);
 			data_phone = conn->data_phone;
 			free(conn);
@@ -267,5 +286,5 @@
 	conn_node_initialize(conn);
 	conn->data_phone = data_phone;
-	list_append(&conn->conn_link, &sess->conn_head);
+	list_append(&conn->sess_link, &sess->conn_head);
 	list_append(&conn->global_link, &inactive_conn_head);
 	fibril_mutex_unlock(&async_sess_mutex);