RFR: 8154399, 8159096, export packages containing standard javadoc doclet
Alan Bateman
Alan.Bateman at oracle.com
Fri Jun 17 10:51:02 UTC 2016
On 17/06/2016 03:28, Jonathan Gibbons wrote:
> Please review this simple fix for two related aspects of the same
> problem:
>
> Export the "standard doclet" used by javadoc, such that it is possible
> to derive alternative doclets, either by delegation or subtyping.
>
> In JDK 9, javadoc has a "new" standard doclet (JEP 221), but the old
> one remains for compatibility, for the time being. Both should be
> exported.
>
>
> Jigsaw folk:
> Please review the changes to jdk.javadoc module-info.
>
> Build folk:
> The javadoc documentation is extended to include the documentation
> for the package containing the new StandardDoclet.
> (The API for the old StandardDoclet was never published in this
> manner; it is only included in the javadoc tool guide, which remains
> unchanged, for now.)
>
> javadoc folk:
> The top level class for the new StandardDoclet is moved, without
> any functional change, from an internal package to the new exported
> package.
>
> JBS: https://bugs.openjdk.java.net/browse/JDK-8154399
> https://bugs.openjdk.java.net/browse/JDK-8159096
> Webrev: http://cr.openjdk.java.net/~jjg/8154399/webrev.00
This looks okay to me, I just wonder if StandardDoclet should be final -
do you remember want that to be extended?
-Alan
More information about the build-dev
mailing list