RFR: JDK-8286338: suppress warnings about bad @author tags when author info is not generated.
Pavel Rappo
prappo at openjdk.java.net
Fri May 13 09:10:49 UTC 2022
On Thu, 12 May 2022 23:10:36 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:
> > What's that `-XDdummy=dummy` you use in tests?
>
> It's a no-op placeholder. JavaDoc does not allow empty arguments, and the alternative is dynamically build a list with a conditional component. `-XD` is a "hidden" option to inject values in the compiler options map, so `-XDdummy=dummy` just injects a dummy value there.
Okay, I can see what happens when you pass an empty string:
error: Illegal package name: ""
I wish there were a better way of conditionally providing a javadoc option.
-------------
PR: https://git.openjdk.java.net/jdk/pull/8583
More information about the javadoc-dev
mailing list