-
Bug
-
Resolution: Fixed
-
P3
-
8
-
b10
-
x86_64
-
linux
-
Verified
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8045146 | 8u25 | Kumar Srinivasan | P3 | Resolved | Fixed | b01 |
JDK-8040771 | 8u20 | Kumar Srinivasan | P3 | Resolved | Fixed | b13 |
JDK-8052585 | emb-8u26 | Kumar Srinivasan | P3 | Resolved | Fixed | b17 |
FULL PRODUCT VERSION :
java version "1.8.0"
Java(TM) SE Runtime Environment (build 1.8.0-b132)
Java HotSpot(TM) 64-Bit Server VM (build 25.0-b70, mixed mode)
ADDITIONAL OS VERSION INFORMATION :
Ubuntu Linux 13.10, x86_64
A DESCRIPTION OF THE PROBLEM :
First noticed with gradle while building the javadoc for one of my projects. From the debug file:
----
11:59:45.949 [INFO] [org.gradle.process.internal.DefaultExecHandle] Starting process 'command '/opt/sunjdk/1.8/jdk1.8.0/bin/javadoc''. Working directory: /home/fge/src/perso/largetext Command: /opt/sunjdk/1.8/jdk1.8.0/bin/javadoc @/home/fge/src/perso/largetext/build/tmp/javadoc/javadoc.options
----
The javadoc.options file contains the following:
----
-classpath '/home/fge/src/perso/largetext/build/classes/main:/home/fge/src/perso/largetext/build/resources/main:/home/fge/.gradle/caches/modules-2/files-2.1/com.google.guava/guava/16.0.1/5fa98cd1a63c99a44dd8d3b77e4762b066a5d0c5/guava-16.0.1.jar:/home/fge/.gradle/caches/modules-2/files-2.1/com.google.code.findbugs/jsr305/2.0.1/516c03b21d50a644d538de0f0369c620989cd8f0/jsr305-2.0.1.jar'
-d '/home/fge/src/perso/largetext/build/docs/javadoc'
-doctitle 'largetext 0.1-SNAPSHOT API'
-link 'http://docs.oracle.com/javase/7/docs/api'
-link 'http://jsr-305.googlecode.com/svn/trunk/javadoc'
-link 'http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc'
-quiet
-overview 'src/main/java/overview.html'
-windowtitle 'largetext 0.1-SNAPSHOT API'
'/home/fge/src/perso/largetext/src/main/java/com/github/fge/largetext/LargeTextFactory.java'
[ etc etc]
---
But the javadoc process does not find the links. From the debug file again:
----
11:59:47.959 [ERROR] [system.err] javadoc: warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
11:59:48.217 [ERROR] [system.err] javadoc: warning - Error fetching URL: http://jsr-305.googlecode.com/svn/trunk/javadoc
11:59:48.472 [ERROR] [system.err] javadoc: warning - Error fetching URL: http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc
----
The workaround is to add trailing slashes to the links, ie:
http://docs.oracle.com/javase/7/docs/api/
instead of:
http://docs.oracle.com/javase/7/docs/api
Java 7's javadoc didn't have this problem.
REGRESSION. Last worked in version 7u51
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Write an options file for the javadoc tool; add in it:
----
-link 'http://docs.oracle.com/javase/7/docs/api'
----
and all other relevant options. Launch the javadoc tool with "javadoc @path/to/optionfile".
See that the command generates a warning on stderr:
warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
The javadoc is generated properly, with external links
ACTUAL -
The javadoc tool is unable to find the links
ERROR MESSAGES/STACK TRACES THAT OCCUR :
warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
warning - Error fetching URL: http://jsr-305.googlecode.com/svn/trunk/javadoc
warning - Error fetching URL: http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc
REPRODUCIBILITY :
This bug can be reproduced always.
---------- BEGIN SOURCE ----------
not relevant here
---------- END SOURCE ----------
CUSTOMER SUBMITTED WORKAROUND :
Add a trailing / to each link option, ie:
-link http://docs.oracle.com/javase/7/docs/api/
instead of:
-link http://docs.oracle.com/javase/7/docs/api
java version "1.8.0"
Java(TM) SE Runtime Environment (build 1.8.0-b132)
Java HotSpot(TM) 64-Bit Server VM (build 25.0-b70, mixed mode)
ADDITIONAL OS VERSION INFORMATION :
Ubuntu Linux 13.10, x86_64
A DESCRIPTION OF THE PROBLEM :
First noticed with gradle while building the javadoc for one of my projects. From the debug file:
----
11:59:45.949 [INFO] [org.gradle.process.internal.DefaultExecHandle] Starting process 'command '/opt/sunjdk/1.8/jdk1.8.0/bin/javadoc''. Working directory: /home/fge/src/perso/largetext Command: /opt/sunjdk/1.8/jdk1.8.0/bin/javadoc @/home/fge/src/perso/largetext/build/tmp/javadoc/javadoc.options
----
The javadoc.options file contains the following:
----
-classpath '/home/fge/src/perso/largetext/build/classes/main:/home/fge/src/perso/largetext/build/resources/main:/home/fge/.gradle/caches/modules-2/files-2.1/com.google.guava/guava/16.0.1/5fa98cd1a63c99a44dd8d3b77e4762b066a5d0c5/guava-16.0.1.jar:/home/fge/.gradle/caches/modules-2/files-2.1/com.google.code.findbugs/jsr305/2.0.1/516c03b21d50a644d538de0f0369c620989cd8f0/jsr305-2.0.1.jar'
-d '/home/fge/src/perso/largetext/build/docs/javadoc'
-doctitle 'largetext 0.1-SNAPSHOT API'
-link 'http://docs.oracle.com/javase/7/docs/api'
-link 'http://jsr-305.googlecode.com/svn/trunk/javadoc'
-link 'http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc'
-quiet
-overview 'src/main/java/overview.html'
-windowtitle 'largetext 0.1-SNAPSHOT API'
'/home/fge/src/perso/largetext/src/main/java/com/github/fge/largetext/LargeTextFactory.java'
[ etc etc]
---
But the javadoc process does not find the links. From the debug file again:
----
11:59:47.959 [ERROR] [system.err] javadoc: warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
11:59:48.217 [ERROR] [system.err] javadoc: warning - Error fetching URL: http://jsr-305.googlecode.com/svn/trunk/javadoc
11:59:48.472 [ERROR] [system.err] javadoc: warning - Error fetching URL: http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc
----
The workaround is to add trailing slashes to the links, ie:
http://docs.oracle.com/javase/7/docs/api/
instead of:
http://docs.oracle.com/javase/7/docs/api
Java 7's javadoc didn't have this problem.
REGRESSION. Last worked in version 7u51
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Write an options file for the javadoc tool; add in it:
----
-link 'http://docs.oracle.com/javase/7/docs/api'
----
and all other relevant options. Launch the javadoc tool with "javadoc @path/to/optionfile".
See that the command generates a warning on stderr:
warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
The javadoc is generated properly, with external links
ACTUAL -
The javadoc tool is unable to find the links
ERROR MESSAGES/STACK TRACES THAT OCCUR :
warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
warning - Error fetching URL: http://jsr-305.googlecode.com/svn/trunk/javadoc
warning - Error fetching URL: http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc
REPRODUCIBILITY :
This bug can be reproduced always.
---------- BEGIN SOURCE ----------
not relevant here
---------- END SOURCE ----------
CUSTOMER SUBMITTED WORKAROUND :
Add a trailing / to each link option, ie:
-link http://docs.oracle.com/javase/7/docs/api/
instead of:
-link http://docs.oracle.com/javase/7/docs/api
- backported by
-
JDK-8040771 javadoc requires a trailing / for links where java 7's javadoc didn't
- Resolved
-
JDK-8045146 javadoc requires a trailing / for links where java 7's javadoc didn't
- Resolved
-
JDK-8052585 javadoc requires a trailing / for links where java 7's javadoc didn't
- Resolved