Troubles running javadoc with jsr166 CVS and jigsaw integration

[Martin Buchholz]

The current status: we have updated jsr166 CVS to run with
jdk9-ea+111, but jdk9 javadoc doesn't work to create the traditional
jsr166 javadoc we have been publishing for 10 years, so we are working
around this temporarily by running jdk8 javadoc on our jdk8 backport.

On Thu, Mar 24, 2016 at 8:50 PM, Martin Buchholz <martinrb at google.com> wrote:
> (last minute fiddling with ant properties ... hope this works:)
>
> cvs -Q -d ':pserver:anonymous:@gee.cs.oswego.edu/home/jsr166/jsr166'
> checkout jsr166 && cd jsr166 && ant -Djdk9.home="$JDK9_IMAGE"
> -Djdk9.src.home="$JDK9_SOURCE_FOREST" docs
>
> where $JDK9_IMAGE is an image for +110 or +111, and
> $JDK9_SOURCE_FOREST is a mercurial forest for +110 or +111
>
> Use "ant -v" to get much more verbose diagnostics.
>
>
> On Thu, Mar 24, 2016 at 5:17 PM, Jonathan Gibbons
> <jonathan.gibbons at oracle.com> wrote:
>> Martin,
>>
>> Can you provide details on how to reproduce this (e.g. including repo paths)
>>
>> -- Jon
>>
>>
>> On 03/24/2016 04:10 PM, Martin Buchholz wrote:
>>>
>>> Hi jigsaw/javadoc folk,
>>>
>>> I'm trying to update jsr166 CVS to latest jdks and failing.
>>>
>>> If I run "ant docs" with a -Djdk9.home pointing at jdk-9+110 binaries
>>> and -Djdk9.src.dir pointing at openjdk9 tip sources, I get:
>>>
>>>    [javadoc] Constructing Javadoc information...
>>>    [javadoc] Standard Doclet (Next) version 9-ea
>>>    [javadoc] Building tree for all the packages and classes...
>>>    [javadoc] Generating
>>>
>>> /usr/local/google/home/martinrb/jsr166/javadoc/build/docs/constant-values.html...
>>>    [javadoc] 1 error
>>>    [javadoc] javadoc: error -
>>> com.sun.tools.javac.code.ClassFinder$BadClassFile: bad class file:
>>> /modules/java.base/java/util/ServiceLoader$LazyIterator.class
>>>    [javadoc]   undeclared type variable: S
>>>    [javadoc]   Please remove or make sure it appears in the correct
>>> subdirectory of the classpath.
>>>
>>> Hmmm ?? ... don't know what to do about that ... except upgrade to +111
>>> ...
>>> Binaries are not available yet, but I can build my own.  If I then
>>> point -Djdk9.home at a freshly built jdk at tip, I get:
>>>
>>>    [javadoc] 1 error
>>>    [javadoc] java.lang.AssertionError
>>>    [javadoc] at
>>> com.sun.tools.javac.util.Assert.error(jdk.compiler at 9-internal/Assert.java:155)
>>>    [javadoc] at
>>> com.sun.tools.javac.util.Assert.checkNull(jdk.compiler at 9-internal/Assert.java:54)
>>>    [javadoc] at
>>> com.sun.tools.javac.code.Symtab.enterModule(jdk.compiler at 9-internal/Symtab.java:753)
>>>    [javadoc] at
>>> com.sun.tools.javac.comp.Modules.enterModule(jdk.compiler at 9-internal/Modules.java:257)
>>>    [javadoc] at
>>> com.sun.tools.javac.comp.Modules.enterModules(jdk.compiler at 9-internal/Modules.java:235)
>>>    [javadoc] at
>>> com.sun.tools.javac.comp.Modules.enter(jdk.compiler at 9-internal/Modules.java:203)
>>>    [javadoc] at
>>> com.sun.tools.javac.main.JavaCompiler.readSourceFile(jdk.compiler at 9-internal/JavaCompiler.java:816)
>>>    [javadoc] at
>>> com.sun.tools.javac.main.JavaCompiler.readSourceFile(jdk.compiler at 9-internal/JavaCompiler.java:778)
>>>    [javadoc] at
>>> com.sun.tools.javac.main.JavaCompiler.access$100(jdk.compiler at 9-internal/JavaCompiler.java:97)
>>>    [javadoc] at
>>> com.sun.tools.javac.main.JavaCompiler$1.complete(jdk.compiler at 9-internal/JavaCompiler.java:339)
>>>    [javadoc] at
>>> com.sun.tools.javac.code.ClassFinder.fillIn(jdk.compiler at 9-internal/ClassFinder.java:362)
>>>    [javadoc] at
>>> com.sun.tools.javac.code.ModuleFinder.lambda$findSingleModule$0(jdk.compiler at 9-internal/ModuleFinder.java:206)
>>>    [javadoc] at
>>> com.sun.tools.javac.code.Symbol.complete(jdk.compiler at 9-internal/Symbol.java:601)
>>>    [javadoc] at
>>> com.sun.tools.javac.comp.Modules.setCompilationUnitModules(jdk.compiler at 9-internal/Modules.java:361)
>>>    [javadoc] at
>>> com.sun.tools.javac.comp.Modules.enter(jdk.compiler at 9-internal/Modules.java:205)
>>>    [javadoc] at
>>> jdk.javadoc.internal.tool.JavadocTool.getEnvironment(jdk.javadoc at 9-internal/JavadocTool.java:190)
>>>    [javadoc] at
>>> jdk.javadoc.internal.tool.Start.parseAndExecute(jdk.javadoc at 9-internal/Start.java:401)
>>>    [javadoc] at
>>> jdk.javadoc.internal.tool.Start.begin(jdk.javadoc at 9-internal/Start.java:274)
>>>    [javadoc] at
>>> jdk.javadoc.internal.tool.Start.begin(jdk.javadoc at 9-internal/Start.java:220)
>>>    [javadoc] at
>>> jdk.javadoc.internal.tool.Main.execute(jdk.javadoc at 9-internal/Main.java:70)
>>>    [javadoc] at
>>> jdk.javadoc.internal.tool.Main.main(jdk.javadoc at 9-internal/Main.java:52)
>>>    [javadoc] javadoc: error - fatal error
>>
>>