8035473: [javadoc] Revamp the existing Doclet APIs
jonathan.gibbons at oracle.com
Fri Jan 22 23:49:55 UTC 2016
On 01/22/2016 03:41 PM, Magnus Ihse Bursie wrote:
> In make/Javadoc.gmk:
> What's the story with all these old doclet duplication?
The story is that we're adding a completely new public API, and there
are existing users of the existing API, both good and bad. The good ones
are just using the Doclet API itself (and providing their own doclet),
the bad ones are using and overriding classes in the (internal)
implementation of the standard doclet. Since we have not hitherto given
notice about anything going away, for the time being we'll keep old and
new side by side.
The informal unofficial expectation is that we'll give the bad users 1
release to convert their code (and delete the old standard doclet in
10), and we'll maybe give the good users 2 releases to change their code
(and delete the old API in 11).
More information about the build-dev