Javadoc tool not handling nested anonymous classes

Jonathan Gibbons jonathan.gibbons at oracle.com
Mon Jan 8 21:31:00 UTC 2018


I spent hour on Friday trying to create a small test case, but without 
success so far. It seems notable that the example you list in your 
source code is a lambda whose body contains 3 levels of nested anon classes.

In general, I strongly dislike having to debug javac code involving 
large external build systems like Maven and Gradle, but I guess it may 
become necessary here.

At any rate, I note you have a workaround, since you say you have ways 
to run javadoc that does not trigger the error.

-- Jon


On 1/8/18 1:13 PM, Jason Tedor wrote:
> Thanks Jonathan. To clarify, is that something that you will do or are 
> you expecting me to take action here?
>
> On Fri, Jan 5, 2018 at 4:35 PM Jonathan Gibbons 
> <jonathan.gibbons at oracle.com <mailto:jonathan.gibbons at oracle.com>> wrote:
>
>     Jason,
>
>     Thanks for the experiments and report.  It sounds like we can make
>     a very reduced test case from that.
>
>     -- Jon
>
>
>     On 01/05/2018 01:30 PM, Jason Tedor wrote:
>>     Thanks again for your replies Jonathan, this is helpful.
>>
>>     > I see that one possibility may be the presence of source code
>>     on the source or class path, and equivalent previously-compiled
>>     classes on the class path.
>>
>>     This is indeed the case, the compiled classes are on the
>>     -classpath passed to the invocation of javadoc; we are not
>>     specifying --source-path in our invocation.
>>
>>     > If that is what is happening for you, that may indicate a bug
>>     in javac (which is the front end for javadoc, and which should
>>     handle this situation).
>>
>>     Indeed.
>>
>>     > The workaround for you would be to try and ensure that you
>>     don't have sources and equivalent compiled classes on your
>>     source/classpath for javadoc.
>>
>>     If I remove compiling these classes before running javadoc then
>>     this error does not occur.
>>
>>     > I am following up with javac folk to see if there is an issue
>>     there.
>>
>>     Thanks, please let me know what you find out.
>>
>>     Again, thank you for your help.
>>
>>     On Thu, Jan 4, 2018 at 7:40 PM Jonathan Gibbons
>>     <jonathan.gibbons at oracle.com
>>     <mailto:jonathan.gibbons at oracle.com>> wrote:
>>
>>
>>
>>         On 01/04/2018 04:37 PM, Jonathan Gibbons wrote:
>>         >
>>         > One other change may be relevant: JDK-8177588, in which we made
>>         > javadoc be more strict when it encounters compilation
>>         errors. This was
>>         > fix in JDK 10 b10.
>>         >
>>
>>         We can probably take this off the table, as the fix
>>         originally appeared
>>         in JDK 9.
>>
>>         -- Jon
>>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20180108/4545eaf9/attachment.html>


More information about the javadoc-dev mailing list