[
https://jira.codehaus.org/browse/MJAVADOC-425?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Aleksey Nesterenko updated MJAVADOC-425:
-----------------------------------------
Description:
I've faced problems while generating linkcheck report on our project.
Links are pointing to methods in javadoc generated html pages, but in final
report lots of links are marked as "invalid"
Analyzing of the problem let me noticed that maven-javadoc-plugin is using
doxia libs version 1.0, e.g. snippet from maven-javadoc-plugin version 2.10.1
pom:
<properties>
...
<doxiaVersion>1.0</doxiaVersion>
<doxia-sitetoolsVersion>1.0</doxia-sitetoolsVersion>
...
</properties>
My problem is close to this one http://jira.codehaus.org/browse/DOXIA-397 and
as you see it was fixed in doxia 1.4
Current latest doxia version is 1.6, so I think there's need of updating
javadoc plugin.
Steps of reproducing my problem:
1) git clone g...@github.com:checkstyle/checkstyle.git && cd checkstyle/ && git
checkout checkstyle-6.3
2) mvn clean install -DskipTests -Dpmd.skip=true -Dfindbugs.skip=true
-Dcobertura.skip=true
3) Open target/site/linkcheck.html
Example of my current report:
http://alexkravin.github.io/linkcheck/linkcheck.html
As you can see - even "invalid" link will redirect you to proper location.
E.g.:
apidocs/com/puppycrawl/tools/checkstyle/grammars/GeneratedJavaRecognizer.html
error
../../../../../com/puppycrawl/tools/checkstyle/grammars/GeneratedJavaRecognizer.html#GeneratedJavaRecognizer(antlr.TokenBuffer,%20int):
doesn't exist.
but it's valid
http://alexkravin.github.io/linkcheck/apidocs/com/puppycrawl/tools/checkstyle/grammars/GeneratedJavaRecognizer.html#GeneratedJavaRecognizer(antlr.TokenBuffer,
int)
was:
I've faced problems while generating linkcheck report on our project.
Links are pointing to methods in javadoc generated html pages, but in final
report lots of links are marked as "invalid"
Analyzing of the problem let me noticed that maven-javadoc-plugin is using
doxia libs version 1.0, e.g. snippet from maven-javadoc-plugin version 2.10.1
pom:
<properties>
...
<doxiaVersion>1.0</doxiaVersion>
<doxia-sitetoolsVersion>1.0</doxia-sitetoolsVersion>
...
</properties>
My problem is close to this one http://jira.codehaus.org/browse/DOXIA-397 and
as you see it was fixed in doxia 1.4
Current latest doxia version is 1.6, so I think there's need of updating
javadoc plugin.
Steps of reproducing my problem:
1) git clone g...@github.com:checkstyle/checkstyle.git && cd checkstyle/ && git
checkout checkstyle-6.3
2) mvn clean install -DskipTests -Dpmd.skip=true -Dfindbugs.skip=true
-Dcobertura.skip=true
3) Open target/site/linkcheck.html
Example of my current report:
http://alexkravin.github.io/linkcheck/linkcheck.html
As you can see - even "invalid" link will redirect you to proper location.
> Outdated doxia's version is used in plugin
> ------------------------------------------
>
> Key: MJAVADOC-425
> URL: https://jira.codehaus.org/browse/MJAVADOC-425
> Project: Maven Javadoc Plugin
> Issue Type: Bug
> Affects Versions: 2.10.1
> Reporter: Aleksey Nesterenko
>
> I've faced problems while generating linkcheck report on our project.
> Links are pointing to methods in javadoc generated html pages, but in final
> report lots of links are marked as "invalid"
> Analyzing of the problem let me noticed that maven-javadoc-plugin is using
> doxia libs version 1.0, e.g. snippet from maven-javadoc-plugin version 2.10.1
> pom:
> <properties>
> ...
> <doxiaVersion>1.0</doxiaVersion>
> <doxia-sitetoolsVersion>1.0</doxia-sitetoolsVersion>
> ...
> </properties>
> My problem is close to this one http://jira.codehaus.org/browse/DOXIA-397 and
> as you see it was fixed in doxia 1.4
> Current latest doxia version is 1.6, so I think there's need of updating
> javadoc plugin.
> Steps of reproducing my problem:
> 1) git clone g...@github.com:checkstyle/checkstyle.git && cd checkstyle/ &&
> git checkout checkstyle-6.3
> 2) mvn clean install -DskipTests -Dpmd.skip=true -Dfindbugs.skip=true
> -Dcobertura.skip=true
> 3) Open target/site/linkcheck.html
> Example of my current report:
> http://alexkravin.github.io/linkcheck/linkcheck.html
> As you can see - even "invalid" link will redirect you to proper location.
> E.g.:
> apidocs/com/puppycrawl/tools/checkstyle/grammars/GeneratedJavaRecognizer.html
> error
> ../../../../../com/puppycrawl/tools/checkstyle/grammars/GeneratedJavaRecognizer.html#GeneratedJavaRecognizer(antlr.TokenBuffer,%20int):
> doesn't exist.
> but it's valid
> http://alexkravin.github.io/linkcheck/apidocs/com/puppycrawl/tools/checkstyle/grammars/GeneratedJavaRecognizer.html#GeneratedJavaRecognizer(antlr.TokenBuffer,
> int)
--
This message was sent by Atlassian JIRA
(v6.1.6#6162)
