add coverage tests for lexer.c

Given the low hanging fruit of

 https://dlang.dawg.eu/coverage/src/lexer.c.gcov.html

this adds more coverage tests. Found a couple bugs (!) doing it, improved some error messages, and refactored some unnecessary goto's.