[jboss-dev-forums] [JBoss Transactions Development] - Moving the javadoc building into the release profile?

[Tom Jenkinson]

Tom Jenkinson [https://community.jboss.org/people/tomjenkinson] created the discussion

"Moving the javadoc building into the release profile?"

To view the discussion, visit: https://community.jboss.org/message/821715#821715

--------------------------------------------------------------
Hi,

We are considering moving the generation of javadocs out of the main build cycle and into the release profile.

In pratice this means:

./build.sh 
  which used to generate the javadocs for the relevant modules
./build.sh -Prelease
  could be used to generate the javadocs for everything that was built before, or
./build.sh javadoc:jar -pl <module, e.g. ArjunaJTA/narayana-jta/>
  to build a specific modules javadocs

The benefit of this is a more efficient dev build cycle as generating the javadocs adds around 30% to the build time:

./build.sh clean install -DskipTests 2:27
./build.sh clean install -DskipTests -Dmaven.javadoc.skip=true 1:54

If anyone routinely uses the javadocs that are generated from a dev build (and isn't happy with the alternatives above), please do shout up,
Tom
--------------------------------------------------------------

Reply to this message by going to Community
[https://community.jboss.org/message/821715#821715]

Start a new discussion in JBoss Transactions Development at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=1&containerType=14&container=2041]

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-dev-forums/attachments/20130606/5f16c799/attachment.html