@@ -46,10 +46,15 @@
 
 /// Represents a lexer token
 
 class Token
-{
-	enum Kind {identifier, stringLiteral, number};
+{
+	/// currently we have three kinds of token
+	enum Kind {
+		identifier, /// anything other than others
+		stringLiteral, /// "string literal"
+		number /// 42
+	};
 	immutable LexPosition pos;  /// position where the token occurred in the source
 	immutable string      str;  /// the token string itself
 	immutable Kind        kind; /// which kind of token?