From Alan,

I was exchanging mail with [...] about Class::newInstance, javadoc here:

http://download.java.net/java/jdk9/docs/api/java/lang/Class.html#newInstance--

and it reminded me to ask if we've ever had any feedback to say that it's hard to see where the @Deprecated comment ends and the method description starts. I've noticed this in several methods.

It's not a big deal, just wondering if it's come up and whether itlatic font -> normal font is enough when you looking for the method description.

-Alan