[jira] [Commented] (MJAVADOC-527) detectLinks may pass invalid urls to javadoc

["John Fox (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/MJAVADOC-527?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16543593#comment-16543593 ] 

John Fox commented on MJAVADOC-527:
-----------------------------------

I ran into an issue which I believe is similar to the one described here for jaxb-api when updating to use JDK10. The maven-javadoc-plugin failed to generate javadoc with the below error. I wanted to explicitly add jaxb-api-2.2.3 as a dependency so that even when the java.xml.bind module is removed in JDK11 the project would continue to resolve the JAXB libraries. Pulling in the above snapshot resolves this issue as well.

{code}
 [ERROR] Exit code: 1 - javadoc: error - Error fetching URL: [https://github.com/javaee/jaxb-v2/]
 [ERROR] javadoc: error - Error fetching URL: [http://www.oracle.com/technetwork/java/index.html/]
 [ERROR] javadoc: warning - You have not specified the version of HTML to use.
 [ERROR] The default is currently HTML 4.01, but this will change to HTML5
 [ERROR] in a future release. To suppress this warning, please specify the
 [ERROR] version of HTML used in your documentation comments and to be
 [ERROR] generated by this doclet, using the -html4 or -html5 options.{code}

> detectLinks may pass invalid urls to javadoc
> --------------------------------------------
>
>                 Key: MJAVADOC-527
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-527
>             Project: Maven Javadoc Plugin
>          Issue Type: Bug
>          Components: javadoc
>    Affects Versions: 3.0.1
>         Environment: Windows 10
> JDK 8
> Maven 3.5.2
>            Reporter: Roberto Benedetti
>            Priority: Major
>              Labels: detectLinks
>
> The url of artifact com.sun.mail:mailapi:1.5.5 is [http://javamail.java.net/mailapi], so the plugin tests if [http://javamail.java.net/mailapi/apidocs/package-list] is valid.
>  That url redirects to [https://javaee.github.io/javamail/] which is JavaMail home page, so the plugin thinks the url is valid and passes it to javadoc.
>  javadoc warns about invalid link.
> Maybe checking if the effective url is still "package-list" would be safer.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)