Build JBoss Javadoc

[jiwils]

We use JBoss 3.2.4 in production, and due to our use of JMX, the JBoss service lifecycle, clustering, and some other JBoss-specific functionality, we have long wanted to utilize the JBoss Javadoc.

Using the JBoss 3.2.4 source tar, running build docs from the build directory, as the help suggests, results in the following builld error:

buildmagic.ent:662: C:\dev\jboss-3.2.4-src\build${source.java} not found.

Just to see if this was a bug that had been fixed, I downloaded the JBoss 3.2.6 source tar, and tried the same thing. I received the same error.

Can anyone help me make sense of this? Looking at the buildmagic.ent file at the specified line does not yield any answers. The "${source.java}" property is a part of that line, but I am not sure what to substitute as it looks like this could be invoked many times with a different value for that property.

[starksm64]

Use the all target.

[jiwils]

Use the all target.

I thought you might say that, so I have also run build all for both JBoss 3.2.4 and 3.2.6 and both targets result in failed builds. The specific build errors are below:

For 3.2.4:

...<snip>...

docs-javadocs:

_buildmagic:init:

init:

docs-javadocs-check:

docs-javadocs_1_4:
 [mkdir] Created dir: C:\dev\jboss-3.2.4-src\remoting\output\api

BUILD FAILED
C:\dev\jboss-3.2.4-src\tools\etc\buildmagic\buildmagic.ent:662:
 No source files and no packages have been specified.

Total time: 21 minutes 18 seconds

For 3.2.6:

...<snip>...

docs-javadocs:

_buildmagic:init:

init:

docs-javadocs-check:

docs-javadocs_1_4:
 [mkdir] Created dir: C:\dev\jboss-3.2.6-src\jaxrpc\output\api

BUILD FAILED
C:\dev\jboss-3.2.6-src\tools\etc\buildmagic\buildmagic.ent:662:
 No source files and no packages have been specified.

Total time: 47 minutes 18 seconds

[davidchen]

Hi, Jimmy:

I got the exactly same problem as you listed above, so, did you figure out how to build javadoc api yet? Could you please share with us?

Thanks a lot

David

[jiwils]

I was unable to get this to work in 3.2.4 or 3.2.6. I posted a bug report on JIRA. Vote for it!

http://jira.jboss.com/jira/browse/JBBUILD-6

[starksm64]

Both the 3.2.7 and 4.0.1sp1 source releases build the all target for me. The 3.2.7 api output is 150mb:

[starksm@buildhost build]$ ant all
BUILD SUCCESSFUL
Total time: 39 minutes 40 seconds
[starksm@buildhost build]$ du -s output/jboss-3.2.7/docs/api/
153756 output/jboss-3.2.7/docs/api

You wil need a large ant memory setting. I used:
ANT_OPTS=-Xmx256m

[gshifrin]

It'd be nice if the Javadocs were available online somewhere.