8035473: [javadoc] Revamp the existing Doclet APIs

[Jonathan Gibbons]

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