Javadoc tool not handling nested anonymous classes
Jonathan Gibbons
jonathan.gibbons at oracle.com
Mon Jan 8 22:46:20 UTC 2018
That would help. Thanks.
-- Jon
On 01/08/2018 02:45 PM, Jason Tedor wrote:
> Jonathan: If it helps, I can show you how to use Gradle to produce the
> arguments that are passed to the javadoc command line, and then you'll
> have a pure javadoc command line that you can use to reproduce the issue?
>
> On Mon, Jan 8, 2018 at 4:31 PM Jonathan Gibbons
> <jonathan.gibbons at oracle.com <mailto:jonathan.gibbons at oracle.com>> wrote:
>
> 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/f558b06b/attachment.html>
More information about the javadoc-dev
mailing list