DDocEmitter.writeCommentText

Scans the comment text and:

• skips HTML tags
• escapes '<', '>' and '&' with named HTML entities
• inserts $(DDOC_BLANKLINE) in place of '\n\n'
• highlights the tokens in code sections