JDK-8202627 : javadoc generates broken links to deprecated items when -nodeprecated is used
Type:Bug
Component:tools
Sub-Component:javadoc(tool)
Affected Version:11
Priority:P3
Status:Closed
Resolution:Fixed
Submitted:2018-05-04
Updated:2018-06-11
Resolved:2018-06-03
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.
See test test/langtools/jdk/javadoc/doclet/testSearch/TestSearch.java
When run with JavadocTester checkLinks, it shows a broken link to a deprecated item when nodeprecated is used
Comments
Although this might be worth a new specific test, there is also an existing test case which is commented out.
$ grep -r 8202627 open/test/langtools
open/test/langtools/jdk/javadoc/doclet/testSearch/TestSearch.java: setAutomaticCheckLinks(false); // @ignore JDK-8202627
open/test/langtools/jdk/javadoc/doclet/testSearch/TestSearch.java: setAutomaticCheckLinks(true); // @ignore JDK-8202627
As part of fixing this issue, those two lines should be deleted, so that the link checker is activated for this test case.
21-05-2018
This is another situation where something like utils.isIncluded should be used.