Document Omd_lexer & remove headers trailing spaces

Consequences of the longer names in Omd_parser have been taken care of.  Also, the
new function Omd_lexer.split_first allows to remove some generated code.