RFR JDK-8174245: Javadoc is not working for some methods

Jan Lahoda jan.lahoda at oracle.com
Thu Feb 9 16:02:57 UTC 2017


Hi,

Bug:
https://bugs.openjdk.java.net/browse/JDK-8174245

Webrev:
http://cr.openjdk.java.net/~jlahoda/8174245/webrev.00/

The primary problem here is that showing javadoc for e.g.:
Collections.min(
or:
Collections.max(

fails. The reason is that when JavadocHelper computes the javadoc for 
the method, it needs to parse the source for the given class, and find 
the method in the parsed source. But, when parsing/entering 
java.util.Collections outside of the java.base module, the MethodSymbols 
for the min/max (and other) methods are too much broken to be recognized 
as the methods we are searching for (because the java.util package 
belongs to the java.base module). The proposed solution is to use the 
new --patch-module semantics to parse/enter the class as-if it was in 
the java.base module.

Note that patch depends on this change:
http://cr.openjdk.java.net/~jlahoda/8173777/langtools.02/

A secondary problem is that when printing multiple javadocs, there is a 
note printed:
<press space for next javadoc, Q to quit>
but it may not be fully overwritten when writing the next javadoc (or 
page). The proposed solution is to simply overwrite it with spaces 
before writing the further text.

Feedback is welcome!

Thanks,
     Jan


More information about the kulla-dev mailing list