Maven 1.x XDoc Plugin

Faster execution of xdoc:jelly-transform with ant:parallel

Details

  • Type: Improvement Improvement
  • Status: Open Open
  • Priority: Major Major
  • Resolution: Unresolved
  • Affects Version/s: None
  • Fix Version/s: None
  • Component/s: None
  • Labels:
    None
  • Number of attachments :
    0

Description

In larger projects or in multiproject builds transforming the xdoc files into html may take a significant amount of time.
After looking into the plugin.jelly - especially into the definition of the doc:performJsl tag - I would think that there is an opportunity to distribute the transformation workload over multiple threads/cpus.
The best candidate for doing so would be the for-each loop over docFiles (lines 328-367). It should possible to reduce the overall transformation time with the ant:parallel task.
The effect should be noticeable on multiprocessor build machines and/or builds which transform many xdoc files, as they may for example occur in conjunction with the statcvs-plugin.

Activity

Hide
dion gillard added a comment -

Rather than Ant's parallel task, why not use Jelly's thread tag?

Show
dion gillard added a comment - Rather than Ant's parallel task, why not use Jelly's thread tag?
Hide
Arnaud Heritier added a comment -

It seems a good idea but what is the difference between ant:parallel and jelly:thread ?

Show
Arnaud Heritier added a comment - It seems a good idea but what is the difference between ant:parallel and jelly:thread ?
Hide
Matthias Kerkhoff added a comment -

I suggested ant:parallel because its threadsPerProcessor attribute. I'm not sure how to model a similar behaviour with the jelly:threads taglib.

Show
Matthias Kerkhoff added a comment - I suggested ant:parallel because its threadsPerProcessor attribute. I'm not sure how to model a similar behaviour with the jelly:threads taglib.

People

Vote (1)
Watch (1)

Dates

  • Created:
    Updated: