Javadoc tool not handling nested anonymous classes

Jonathan Gibbons jonathan.gibbons at oracle.com
Fri Jan 5 21:35:27 UTC 2018


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/20180105/66e667b4/attachment.html>


More information about the javadoc-dev mailing list