8035473: [javadoc] Revamp the existing Doclet APIs

Magnus Ihse Bursie magnus.ihse.bursie at oracle.com
Mon Jan 25 14:20:30 UTC 2016

On 2016-01-23 00:49, Jonathan Gibbons wrote:
> 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.

And we still have users of the old API internally in the JDK? Are the 
plan for them to go away in a JDK 10 frame as well, or will we convert 
all the old one's to the new format in JDK 9, so the current duplication 
in Javadoc.gmk is only temporary?


> 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