By jjg on May 29, 2013
The recent series of patches1 for javadoc completes the work started during JDK 7 to change the internal data model for standard javadoc doclets from strings to a document tree. As a result of this work, there should no longer be any unnecessary internal conversion from tree nodes to strings and back again.
As a side-effect of this work, some bugs were uncovered and fixed, such as not using entities for literal use of '<', '>', and '&', and conversely, treating some HTML fragments as plain text, and then incorrectly replacing those characters with entities. Oops. Also, the indentation of method signatures should now be fixed, so that parameters and exceptions thrown should be vertically aligned, as used to be the case.
A more important side-effect is that the code to generate HTML content has been consolidated within the
com.sun.tools.doclets.formats.html package, leaving the main internal taglet API to be more format-neutral. This should make it easier to provide doclets that write to alternate formats.
1. hg: jdk8/tl/langtools: 17 new changesets