[
https://issues.apache.org/jira/browse/MJAVADOC-423?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15270578#comment-15270578
]
Roman Ivanov commented on MJAVADOC-423:
---------------------------------------
Yes I did a report, but Oracle still try to confirm it as a bug.
(Review ID: JI-9035943) - linkoffline option generate broken link as
"org/xml/sax/helpers.DefaultHandler.html"
Problem is in absence of newline symbol at
target/javadoc-bundle-options/package-list .
Here are steps to show problem and make a workaround
{code}
git clone https://github.com/checkstyle/checkstyle.git
cd checkstyle
mvn clean javadoc:javadoc -X
grep "helpers\.DefaultHandler\.html"
target/site/apidocs/com/puppycrawl/tools/checkstyle/api/AbstractLoader.html
<< BAD LINKS ARE SHOWN >>
cd target/site/apidocs/
./javadoc.sh
grep "helpers\.DefaultHandler\.html"
../../../target/site/apidocs/com/puppycrawl/tools/checkstyle/api/AbstractLoader.html
<< BAD LINKS ARE SHOWN >>
printf "\n" >> ../../../target/javadoc-bundle-options/package-list
./javadoc.sh
grep "helpers\.DefaultHandler\.html"
../../../target/site/apidocs/com/puppycrawl/tools/checkstyle/api/AbstractLoader.html
<< NO BAD LINKS >>
{code}
[~michael-o] , Does it make sense to do reopen this issue and just add newline
symbol to target/javadoc-bundle-options/package-list ?
fix from JDK could take a while, and bug is still not confirmed.
> wrong link generation for org.xml.sax.helpers.DefaultHandler
> ------------------------------------------------------------
>
> Key: MJAVADOC-423
> URL: https://issues.apache.org/jira/browse/MJAVADOC-423
> Project: Maven Javadoc Plugin
> Issue Type: Bug
> Affects Versions: 2.10.1
> Reporter: Roman Ivanov
> Attachments: linkcheck.html
>
>
> Review report:
> http://checkstyle.sourceforge.net/linkcheck.html
> javadoc plugin -
> https://github.com/checkstyle/checkstyle/blob/master/pom.xml#L524
> here you can see number of broken links as:
> "http://docs.oracle.com/javase/6/docs/api/org/xml/sax/helpers.DefaultHandler.html?is-external=true:
> 404 Not Found
> "
> problem is in "helpers.DefaultHandler.html" should be
> "helpers/DefaultHandler.html"
> I switched to java7 in latest code of checkstyle
> (https://github.com/checkstyle/checkstyle) project , but problem is the same.
> to reproduce problem please do :
> git clone https://github.com/checkstyle/checkstyle
> cd checkstyle
> mvn -Pdistro clean package
> after that review linkcheck maven report.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
