8035473: [javadoc] Revamp the existing Doclet APIs

[Magnus Ihse Bursie]

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?

/Magnus


>
> 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
>