8035473: [javadoc] Revamp the existing Doclet APIs
jonathan.gibbons at oracle.com
Tue Jan 26 07:49:01 UTC 2016
On 01/25/2016 06:20 AM, Magnus Ihse Bursie wrote:
> 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?
There are existing usages of the old doclet API that will not be
converted before we ship JDK 9, so the old and new code will need to
exist side by side at least through the lifetime of JDK 9, while we
decide how and when to retire the old code.
More information about the build-dev