Index: uspace/srv/kbd/include/gsp.h
===================================================================
--- uspace/srv/kbd/include/gsp.h	(revision 63b15373eee376c379663c5f4cbe72e41378054c)
+++ uspace/srv/kbd/include/gsp.h	(revision c640876a2871d801c859155f90c27f4d2ff40c11)
@@ -41,26 +41,34 @@
 
 enum {
-	GSP_END		= -1,
-	GSP_DEFAULT	= -2
+	GSP_END		= -1,	/**< Terminates a sequence. */
+	GSP_DEFAULT	= -2	/**< Wildcard, catches unhandled cases. */
 };
 
+/** Scancode parser description */
 typedef struct {
-	/** Transition table, (state, input) -> (state, output). */
+	/** Transition table, (state, input) -> (state, output) */
 	hash_table_t trans;
 
-	/** Current number of states. */
+	/** Number of states */
 	int states;
 } gsp_t;
 
+/** Scancode parser transition. */
 typedef struct {
-	link_t link;
+	link_t link;		/**< Link to hash table in @c gsp_t */ 
 
-	int old_state;
-	int input;
+	/* Preconditions */
 
-	int new_state;
+	int old_state;		/**< State before transition */
+	int input;		/**< Input symbol (scancode) */
 
-	unsigned out_mods;
-	unsigned out_key;
+	/* Effects */
+
+	int new_state;		/**< State after transition */
+
+	/* Output emitted during transition */
+
+	unsigned out_mods;	/**< Modifier to emit */
+	unsigned out_key;	/**< Keycode to emit */
 } gsp_trans_t;
 
@@ -70,5 +78,4 @@
 extern int gsp_step(gsp_t *, int, int, unsigned *, unsigned *);
 
-
 #endif
 
@@ -76,3 +83,2 @@
  * @}
  */ 
-