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