Update lexer docs

Remove some very questionable examples for changing startLexing()
to accept a file name.

Add token offset lexer implementation and usage example.