html2xdoc goal runs 3 times during site goal

Details

  • Type: Improvement Improvement
  • Status: Closed Closed
  • Priority: Major Major
  • Resolution: Won't Fix
  • Affects Version/s: None
  • Fix Version/s: None
  • Labels:
    None
  • Environment:
    All

Description

When setting maven.html2xdoc.enabled to true, the html2xdoc goal is run 3 times during execution of the site goal. With a reasonable amount of documentation, this can significantly increase build time, and is very annoying. This is because html2xdoc is attained within a preGoal of xdoc:init. When attained as a preGoal of xdoc:jelly-transform instead, it is correctly attained only once. Note that the documentation for this plugin indicates that maven.xml should include a preGoal for xdoc:jelly-transform, but the plugin actually contains a preGoal for xdoc:init.

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Lukas Theussl added a comment -

html2xdoc is run as a preGoal of xdoc:init so that generated xdocs can also be used by the pdf plugin. This was fixed in Release 1.3.1 (check the Changelog). It's the documentation that was not updated. The current issue has to be resolved in the xdoc plugin where the xdoc:init goal is attained too many times per site goal.

Show
Lukas Theussl added a comment - html2xdoc is run as a preGoal of xdoc:init so that generated xdocs can also be used by the pdf plugin. This was fixed in Release 1.3.1 (check the Changelog). It's the documentation that was not updated. The current issue has to be resolved in the xdoc plugin where the xdoc:init goal is attained too many times per site goal.
Hide
Permalink
Lukas Theussl added a comment -

Opened MPXDOC-181 instead.

Show
Lukas Theussl added a comment - Opened MPXDOC-181 instead.

People

  • Assignee:
    Unassigned
    Reporter:
    Chuck Daniels
Vote (0)
Watch (0)

Dates

  • Created:
    Updated:
    Resolved: