JDK-8191625 : Release Note: javadoc Treats Failure to Access a URL as an Error
  • Type: Sub-task
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 10
  • Priority: P3
  • Status: Closed
  • Resolution: Delivered
  • OS: generic
  • CPU: generic
  • Submitted: 2017-11-21
  • Updated: 2019-04-09
  • Resolved: 2017-11-21
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.
JDK 10
10Resolved
Description
The javadoc tool has been changed to treat failure to access a URL as an error instead of a warning. If javadoc cannot access the contents of a URL provided with the `-link` or `-linkoffline` options, the tool will now report an error. Previously, the tool continued with a warning and produced incorrect documentation output.
Comments
Maybe something, but not that. As written, you're suggesting -linkoffline as an alternate to -link or -linkoffline. Rather than try and explain the details here in the release note, it would be better to refer to the Tool Reference Guide, where we can give a more detailed explanation.
22-11-2017
Should we add a one liner about -linkoption ? Something to this effect If javadoc cannot access the contents of a URL provided with the `-link` or `-linkoffline` options, the tool will now report an error. Previously, the tool continued with a warning, producing incorrect documentation output. Please see -linkoffline option as a suitable alternate.
22-11-2017