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
