This should be done as part of JEP 221, Simplified Doclet API.
We should deprecate the old API types. This should include the following:
There should be a package-info.java file with an @Deprecated annotation (for completeness) and an @deprecated comment giving details.
In addition, there should be an @Deprecated annotation on each top level type in the com.sun.javadoc package, with a short @deprecated comment referencing the package-info file.