8035473: [javadoc] Revamp the existing Doclet APIs

Jonathan Gibbons 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).

-- Jon

More information about the build-dev mailing list