JDK-8193030 : javadoc crashes when pre-module source is specified along with subpackages option
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 9.0.1
  • Priority: P3
  • Status: Open
  • Resolution: Unresolved
  • OS: linux
  • CPU: x86_64
  • Submitted: 2017-12-04
  • Updated: 2018-05-17
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
tbd_minorUnresolved
Related Reports
Relates :  
JDK-8175277 - javadoc AssertionError when specified with release 8
Description
FULL PRODUCT VERSION :


A DESCRIPTION OF THE PROBLEM :
Hi, when building the javadoc for the java-gnome project with OpenJDK 9.0.1 I get the following error:

java.lang.AssertionError
        at jdk.compiler/com.sun.tools.javac.util.Assert.error(Assert.java:155)
        at jdk.compiler/com.sun.tools.javac.util.Assert.checkNonNull(Assert.java:62)
        at jdk.compiler/com.sun.tools.javac.comp.Modules.allModules(Modules.java:1193)
        at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.findModuleOfPackageName(ElementsTable.java:864)
        at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.addPackagesFromLocations(ElementsTable.java:547)
        at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.computeSubpackages(ElementsTable.java:520)
        at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.computeSpecifiedPackages(ElementsTable.java:754)
        at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.analyze(ElementsTable.java:348)
        at jdk.javadoc/jdk.javadoc.internal.tool.JavadocTool.getEnvironment(JavadocTool.java:211)
        at jdk.javadoc/jdk.javadoc.internal.tool.Start.parseAndExecute(Start.java:562)
        at jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:423)
        at jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:340)
        at jdk.javadoc/jdk.javadoc.internal.tool.Main.execute(Main.java:63)
        at jdk.javadoc/jdk.javadoc.internal.tool.Main.main(Main.java:52)

Here is the command line used:

javadoc -Xdoclint:none -d doc/api -public -nodeprecated -source 1.7 -notree -noindex -notimestamp -nohelp -version -author -windowtitle 'java-gnome 4.1.3 API Documentation' -doctitle '<h1>java-gnome 4.1.3 API Documentation</h1>' -header 'java-gnome version 4.1.3' -footer '<img src="/images/java-gnome_JavaDocLogo.png" style="padding-right:25px;"><br> <span style="font-family: Arial; font-style: normal; font-size: large;">java-gnome</span>' -breakiterator -stylesheetfile src/bindings/stylesheet.css -overview src/bindings/overview.html -sourcepath src/bindings:generated/bindings -encoding UTF-8 -subpackages org -exclude org.freedesktop.bindings -noqualifier 'java.*:com.sun.*' src/bindings/org/freedesktop/bindings/Time.java src/bindings/org/freedesktop/bindings/Version.java src/bindings/org/freedesktop/bindings/Internationalization.java

Removing the -subpackages solves the issue.

This looks similar to JDK-8175277.


REGRESSION.  Last worked in version 8u152


REPRODUCIBILITY :
This bug can be reproduced always.
Comments
It seems to be a combination of -source and -subpackage removing any one of them will allow javadoc to succeed.
23-01-2018
Reproducer: % cat src/m/p/C.java package p; public class C {} % $JAVA_HOME/bin/javadoc -d out -source 1.7 -subpackages p -sourcepath src/m/ Loading source files for package p... Constructing Javadoc information... javadoc: error - fatal error encountered: java.lang.AssertionError javadoc: error - Please file a bug against the javadoc tool via the Java bug reporting page (http://bugreport.java.com) after checking the Bug Database (http://bugs.java.com) for duplicates. Include error messages and the following diagnostic in your report. Thank you. java.lang.AssertionError at jdk.compiler/com.sun.tools.javac.util.Assert.error(Assert.java:155) at jdk.compiler/com.sun.tools.javac.util.Assert.checkNonNull(Assert.java:62) at jdk.compiler/com.sun.tools.javac.comp.Modules.allModules(Modules.java:1196) at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.findModuleOfPackageName(ElementsTable.java:865) at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.addPackagesFromLocations(ElementsTable.java:548) at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.computeSubpackages(ElementsTable.java:521) at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.computeSpecifiedPackages(ElementsTable.java:755) at jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.analyze(ElementsTable.java:349) at jdk.javadoc/jdk.javadoc.internal.tool.JavadocTool.getEnvironment(JavadocTool.java:211) at jdk.javadoc/jdk.javadoc.internal.tool.Start.parseAndExecute(Start.java:569) at jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:430) at jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:343) at jdk.javadoc/jdk.javadoc.internal.tool.Main.execute(Main.java:63) at jdk.javadoc/jdk.javadoc.internal.tool.Main.main(Main.java:52) 2 errors
23-01-2018
Submitter provided github link, which has thirdparty dependencies, requested further clarification I encountered this issue when building the java-gnome project. You can reproduce the issue by following these steps: 1. Clone the java-gnome repository git clone https://github.com/afcowie/java-gnome 2. Patch build/faster to change the javadoc source level: --- a/build/faster +++ b/build/faster @@ -650,7 +650,7 @@ def compileDocumentation(): cmd += "-d doc/api " cmd += "-public " cmd += "-nodeprecated " - cmd += "-source 1.5 " + cmd += "-source 1.6 " cmd += "-notree " cmd += "-noindex " cmd += "-notimestamp " 3. Run "./configure" and then "build/faster doc"
10-01-2018
The bug could not be reproduced. The bug can be reopened if there is a reproducible testcase or clear reproducible steps
26-12-2017
Issue looks very similar to JDK-8175277 which is laready fixed in 9. Without reproducer we won't be able to confirm on that. Issue reported on Openjdk build. Requestd submitter to confirm the issue on Oracle binary and share the standalone test case.
05-12-2017