update DocCommentParser

Back when it was written, DocCommentParser was stylistically based on the javac lexical/parser classes at the time.

Code styles have moved on. There are places in DocCommentParser that could be improved for readability/reliability, and as part of that, it would be good to adopt the styles in the recent updates to the javac world. JDK-8224225.