--- a/src/irc_user.h	Mon Mar 30 01:31:13 2009 +0300
+++ b/src/irc_user.h	Mon Mar 30 01:31:27 2009 +0300
@@ -2,8 +2,10 @@
 #define IRC_USER_H
 
 /**
+ * @file
+ *
  * Minimal state for tracking per-user state for an irc_net. Mainly, the purpose of this module is to support the
- * irc_chan.users implementation, such that when a user's nickname is changed, one does not need to modify all
+ * irc_chan::users implementation, such that when a user's nickname is changed, one does not need to modify all
  * irc_chan lists, but rather, just replace the nickname field here.
  *
  * XXX: should this tie in to irc_net to register its own NICK/QUIT handlers?
@@ -12,9 +14,9 @@
 #include "error.h"
 
 /**
- * The basic per-network user info. The lifetime of an irc_user struct is strictly for the duration between the user
+ * Basic per-network user info. The lifetime of an irc_user struct is strictly for the duration between the user
  * JOIN'ing onto the first irc_chan we are on (or us JOIN'ing onto it while they are on it), and them PART'ing the
- * channel or QUIT'ing.
+ * last channel we see them on, or QUIT'ing.
  */
 struct irc_user {
     /** The user's nickname */