maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Max (Jira)" <j...@apache.org>
Subject [jira] [Commented] (MJAVADOC-628) add javadoc.io link pattern when <detectLink> option is set to true
Date Sun, 03 Nov 2019 07:21:00 GMT

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

Max commented on MJAVADOC-628:
------------------------------

creating JIRA as suggested by Enrico Olivelli in the email.

> add javadoc.io link pattern when <detectLink> option is set to true
> -------------------------------------------------------------------
>
>                 Key: MJAVADOC-628
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-628
>             Project: Maven Javadoc Plugin
>          Issue Type: New Feature
>          Components: javadoc
>    Affects Versions: next-release
>            Reporter: Max
>            Priority: Major
>
> For example, google gson ([https://github.com/google/gson]) has pointed their javadoc
to [https://www.javadoc.io/doc/com.google.code.gson/gson] on their README.md. But currently,
maven-javadoc-plugin will only try to fetch [https://github.com/google/gson/apidoc/package-list] ,
which apparently is an invalid address. It doesn't make sense to have github, a source control
system to keep track of generated files as well.
>   
>  Many popular libraries are hosting javadoc with [javadoc.io|http://javadoc.io/] already
(eg, mockito / spark), and the pattern is very simple as well: https://www.javadoc.io/doc/[group_id]/[artifact_id]/[version_id]/package-list
>  This will work with <links> tag, but that's quite tedious as everytime we have
to manually keep things in sync when we add / remove dependencies or update dependency versions.
> Thus, it will be quite helpful if maven-javadoc-plugin can just automatically try this
url pattern from the dependency list as well.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Mime
View raw message