javadoc + modules + out-of-tree sources

[Martin Buchholz]

Hi,

I'm still trying and failing to get our jsr166 docs target to work with
jdk9 sources (to have @inheritDoc work)
And I'm still unclear on how this is expected to work.

My latest try (with jdk9+139) fails as below.  I can understand javadoc
doesn't like mixing modular and non-modular sources, but how am I (or other
users of @inheritDoc) supposed to get this to work?

'/home/martin/jdk/jdk9/bin/javadoc' '-d'
'/home/martin/jsr166/build/build/docs' '-Xmodule:java.base' '-sourcepath'
'/home/martin/jsr166/build/src/main:/home/martin/jdk/src/jdk9/jdk/src/java.base/share/classes'
'/home/martin/jsr166/build/src/main/java/util/AbstractQueue.java'
Loading source file
/home/martin/jsr166/build/src/main/java/util/AbstractQueue.java...
/home/martin/jdk/src/jdk9/jdk/src/java.base/share/classes/module-info.java:29:
error: illegal combination of -Xmodule and module-info on sourcepath
module java.base {
^
error: cannot access module-info
  cannot resolve modules
java.lang.AssertionError
at com.sun.tools.javac.util.Assert.error(jdk.compiler at 9-ea/Assert.java:155)
at com.sun.tools.javac.util.Assert.check(jdk.compiler at 9-ea/Assert.java:46)
at com.sun.tools.javac.comp.Modules.enter(jdk.compiler at 9-ea
/Modules.java:228)
at jdk.javadoc.internal.tool.JavadocTool.getEnvironment(jdk.javadoc at 9-ea
/JavadocTool.java:186)
at jdk.javadoc.internal.tool.Start.parseAndExecute(jdk.javadoc at 9-ea
/Start.java:512)
at jdk.javadoc.internal.tool.Start.begin(jdk.javadoc at 9-ea/Start.java:401)
at jdk.javadoc.internal.tool.Start.begin(jdk.javadoc at 9-ea/Start.java:345)
at jdk.javadoc.internal.tool.Main.execute(jdk.javadoc at 9-ea/Main.java:63)
at jdk.javadoc.internal.tool.Main.main(jdk.javadoc at 9-ea/Main.java:52)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20161010/71c29b9f/attachment.html>