Maven 2.x Javadoc Plugin

detectOfflineLinks sets off extra spurious executions of javadoc

Details

  • Type: Bug Bug
  • Status: Closed Closed
  • Priority: Major Major
  • Resolution: Fixed
  • Affects Version/s: 2.6.1
  • Fix Version/s: 2.8
  • Labels:
    None
  • Number of attachments :
    0

Description

I have an aggregate project. In pluginManagement, I spec out javadoc:jar. In the leaf projects, I turn it on with an ordinary <plugin/> for the plugin.

If I leave detectOfflineLinks with its default value of true, the javadoc plugin uses the invoker plugin to relaunch itself, recursively, complaining that it hasn't been run on one or another of the projects. Note that, when this happens, it is 'swimming upstream' – it is processing project A, it invokes itself on project B, where B depends on A, not the other way around.

If I run maven just in the leaf directories all is well. The trouble only happens when running maven from the aggregating parent.

Just to clarify, in case I don't get a test case together too soon ...

external/corporate parent:

javadoc only mentioned in the <reporting> section.

aggregating parent:

javadoc only mentioned in pluginManagement, setting up execution of javadoc:jar.

leaf:

A very plain 'plugin' element just to turn on the configuration from plugin management.

mvn run from leaf: all is well.

mvn run from aggregating parent: lots of extra 'invoker' invocations of javadoc on projects that have dependencies on the current project.

Issue Links

is duplicated by

Bug - A problem which impairs or prevents the functions of the product. MJAVADOC-295 javadoc plugin version: 2.5, 2.6, 2.7 does not follow the reactor build sequence "mvn install site site:deploy"

  • Major - Major loss of function.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.
is related to

Bug - A problem which impairs or prevents the functions of the product. MJAVADOC-286 Version 2.7 in Maven Reactor may cause infinite recursion, symptoms similar to MJAVADOC-268

  • Critical - Crashes, loss of data, severe memory leak.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.

Bug - A problem which impairs or prevents the functions of the product. MJAVADOC-181 Javadoc report not generated for multi-module project if run from parent level.

  • Major - Major loss of function.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.
relates to

Bug - A problem which impairs or prevents the functions of the product. MJAVADOC-268 performance problem in AbstractJavadocMojo.getModulesLinks()

  • Critical - Crashes, loss of data, severe memory leak.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.

Bug - A problem which impairs or prevents the functions of the product. MJAVADOC-275 Creation of Javadoc attachments fails in multi-module project where modules have never been installed/deployed

  • Critical - Crashes, loss of data, severe memory leak.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Herve Boutemy added a comment -

can you provide a sample project causing such problem, please?

Show
Herve Boutemy added a comment - can you provide a sample project causing such problem, please?
Hide
Permalink
Benson Margulies added a comment - 
svn co https://svn.apache.org/repos/asf/mahout/trunk
maven 3.0 ...
mvn -Prelease
Show
Benson Margulies added a comment - svn co https: //svn.apache.org/repos/asf/mahout/trunk maven 3.0 ... mvn -Prelease
Hide
Permalink
Herve Boutemy added a comment -

I just tested and cannot reproduce any problem
In fact, I can't reproduce any problem now, but I'm sure a few months ago I had the same problems as you (but I changed computer in the meaning time: perhaps this could have an unexpected impact)
Can you confrirm you're still having problems with mahout?
If yes, please attach "mvn -X ..." output: perhaps I'll se something
And if you can update javadoc plugin to 1.8-SNAPSHOT and attach output, it would be great too: I added some traces to help investigate

Show
Herve Boutemy added a comment - I just tested and cannot reproduce any problem In fact, I can't reproduce any problem now, but I'm sure a few months ago I had the same problems as you (but I changed computer in the meaning time: perhaps this could have an unexpected impact) Can you confrirm you're still having problems with mahout? If yes, please attach "mvn -X ..." output: perhaps I'll se something And if you can update javadoc plugin to 1.8-SNAPSHOT and attach output, it would be great too: I added some traces to help investigate
Hide
Permalink
Herve Boutemy added a comment -

fixed in r1058359

Show
Herve Boutemy added a comment - fixed in r1058359

People

  • Assignee:
    Herve Boutemy
    Reporter:
    Benson Margulies
Vote (5)
Watch (6)

Dates

  • Created:
    Updated:
    Resolved: