Key event struct field docs fix/clarify

Per request changed /*! .. */ to ///. 

Also expanded meaning of `keycode`