Some more tokenizer fixes:

 * Reinstate the "_keyword" suffix for reserved words tokens.
   Otherwise SableCC will complain that e.g. "class" is not a
   valid name when we later use them in grammar productions.

 * Rename "equal" to "assign", as that is how the token is
   used in MiniJava.

 * Add some comments to Tokens section.