JDK 9 javax.lang.model.type.Type

Discussion:

Sam Lijin

2018-10-01 03:15:45 UTC

Hi all,

Hopefully I've gotten the right mailing list for this. I was digging around
in the JDK 9 Javadoc javadocs, and noticed something that according to the
package docs for jdk.javadoc.doclet, the successor to com.sun.javadoc.Type
class is javax.lang.model.type.Type. This type doesn't seem to exist,
though - everything seems to implement TypeMirror.

What am I missing here?

Thanks,
Sam

https://docs.oracle.com/javase/9/docs/api/jdk/javadoc/doclet/package-summary.html
https://docs.oracle.com/javase/9/docs/api/javax/lang/model/type/package-summary.html
http://hg.openjdk.java.net/jdk9/jdk9/langtools/annotate/b5d08bc0d224/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/package-info.java#l239
http://hg.openjdk.java.net/jdk9/jdk9/langtools/file/65bfdabaab9c/src/java.compiler/share/classes/javax/lang/model/type

Jonathan Gibbons

2018-10-01 14:40:16 UTC

Permalink

Sam,

You are not missing anything; there is a typo on that page.

You are correct that the common supertype for all types in
javax.lang.model is TypeMirror, not Type.

I will file a bug to fix the error.

-- Jon

Post by Sam Lijin
Hi all,
Hopefully I've gotten the right mailing list for this. I was digging
around in the JDK 9 Javadoc javadocs, and noticed something that
according to the package docs for jdk.javadoc.doclet, the successor to
com.sun.javadoc.Type class is javax.lang.model.type.Type. This type
doesn't seem to exist, though - everything seems to implement TypeMirror.
What am I missing here?
Thanks,
Sam
https://docs.oracle.com/javase/9/docs/api/jdk/javadoc/doclet/package-summary.html
https://docs.oracle.com/javase/9/docs/api/javax/lang/model/type/package-summary.html
http://hg.openjdk.java.net/jdk9/jdk9/langtools/annotate/b5d08bc0d224/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/package-info.java#l239
http://hg.openjdk.java.net/jdk9/jdk9/langtools/file/65bfdabaab9c/src/java.compiler/share/classes/javax/lang/model/type

Jonathan Gibbons

2018-10-02 23:18:43 UTC

Permalink

Sam,

This was already fixed in JDK 10.

-- Jon

Jonathan Gibbons

2018-10-02 23:29:49 UTC

Permalink

Sam,

As a general rule, we do not publish updates to the API documentation.

-- Jon

Thanks. Is there any chance that the published javadocs for jdk 9 will
see the update?
No idea what that release process is like, hence the question.
On Tue, Oct 2, 2018 at 4:18 PM Jonathan Gibbons
Sam,
This was already fixed in JDK 10.
-- Jon

Post by Sam Lijin
Hi all,
Hopefully I've gotten the right mailing list for this. I was

digging

Post by Sam Lijin
around in the JDK 9 Javadoc javadocs, and noticed something that
according to the package docs for jdk.javadoc.doclet, the

successor to

Post by Sam Lijin
com.sun.javadoc.Type class is javax.lang.model.type.Type. This type
doesn't seem to exist, though - everything seems to implement

TypeMirror.

Post by Sam Lijin
What am I missing here?
Thanks,
Sam

https://docs.oracle.com/javase/9/docs/api/jdk/javadoc/doclet/package-summary.html
https://docs.oracle.com/javase/9/docs/api/javax/lang/model/type/package-summary.html
http://hg.openjdk.java.net/jdk9/jdk9/langtools/annotate/b5d08bc0d224/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/package-info.java#l239
http://hg.openjdk.java.net/jdk9/jdk9/langtools/file/65bfdabaab9c/src/java.compiler/share/classes/javax/lang/model/type