Maven 1.x XDoc Plugin
  1. Maven 1.x XDoc Plugin
  2. MPXDOC-120

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

    Details

    • Type: Improvement Improvement
    • Status: Closed Closed
    • Priority: Major Major
    • Resolution: Won't Fix
    • Affects Version/s: None
    • Fix Version/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.
        Hide
        Michael Osipov added a comment -

        Please refer to https://cwiki.apache.org/confluence/display/MAVEN/The+Great+JIRA+Cleanup+of+2014 if you're wondering why this issue was closed out.

        Show
        Michael Osipov added a comment - Please refer to https://cwiki.apache.org/confluence/display/MAVEN/The+Great+JIRA+Cleanup+of+2014 if you're wondering why this issue was closed out.

          People

          • Assignee:
            Unassigned
            Reporter:
            Matthias Kerkhoff
          • Votes:
            1 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: