8035473: [javadoc] Revamp the existing Doclet APIs

[Mandy Chung]

> On Jan 22, 2016, at 2:50 PM, Kumar Srinivasan <kumar.x.srinivasan at oracle.com> wrote:
> 
> Hi All,
> 
> Please review the following build changes:
> 
> JDK changes:
> * simple entry point change
> http://cr.openjdk.java.net/~ksrini/8035473/webrev.07/webrev.jdk.0/
> 

This 1-line change looks fine.

> Top forest repo:
> * configuration changes to use the new javadoc/doclet implementation
> * module dependency changes (Mandy, Alan)
> http://cr.openjdk.java.net/~ksrini/8035473/webrev.07/webrev.jdk9.0/
> 

modules.xml - the new qualified export from javac to jdk.javadoc is okay.

jdk.javadoc.doclet and jdk.javadoc.doclet.taglet are exported API, right?  They should be listed in modules.xml to export them from jdk.javadoc module.

The package-info.java of com.sun.javadoc and com.sun.tools.doclets says they are superseded by the new jdk.javadoc.doclet package.  Should the existing ones be deprecated?

Mandy