javadoc task problem

[Peter Spelman <pe...@propylon.com>]

Hi
I'm trying to get the ant javadoc task working on a project made up of a 
number of different plugins with slightly different names.
I am using Hudson build tool and Ant 1.7. The build script falls down 
with the following errors:

BUILD FAILED
C:\subversion\D0040_OR\workbench\build\jDocBuild.xml:5: Javadoc failed: 
java.io.IOException: CreateProcess: "C:\Program 
Files\Java\jdk1.5.0_11\bin\javadoc.exe" -d 
C:\subversion\D0040_OR\workbench\docs\api -use -windowtitle "LBDS API" 
-doctitle "<h1>Core/OR API</h1>" -bottom "<i>Copyright &#169; 2007 
Propylon.com All Rights Reserved.</i>" -classpath 
"C:\apache-ant-1.7.0\lib\ant-launcher.jar;C:\apache-ant-1.7.0\lib\ant-antlr.jar;C:\apache-ant-1.7.0\lib\ant-apache-bcel.jar;C:\apache-ant-1.7.0\lib\ant-apache-bsf.jar;C:\apache-ant-1.7.0\lib\ant-apache-log4j.jar;C:\apache-ant-1.7.0\lib\ant-apache-oro.jar;C:\apache-ant-1.7.0\lib\ant-apache-regexp.jar;C:\apache-ant-1.7.0\lib\ant-apache-resolver.jar;C:\apache-ant-1.7.0\lib\ant-commons-logging.jar;C:\apache-ant-1.7.0\lib\ant-commons-net.jar;C:\apache-ant-1.7.0\lib\ant-jai.jar;C:\apache-ant-1.7.0\lib\ant-javamail.jar;C:\apache-ant-1.7.0\lib\ant-jdepend.jar;C:\apache-ant-1.7.0\lib\ant-jmf.jar;C:\apache-ant-1.7.0\lib\ant-jsch.jar;C:\apache-ant-1.7.0\lib\ant-junit.jar;C:\apache-ant-1.7.0\lib\ant-netrexx.jar;C:\apache-ant-1.7.0\lib\ant-nodeps.jar;C:\apache-ant-1.7.”
....
Caused by: java.io.IOException: CreateProcess: "C:\Program 
Files\Java\jdk1.5.0_11\bin\javadoc.exe" -d 
C:\subversion\D0040_OR\workbench\docs\api -use -windowtitle "LBDS API" 
-doctitle "<h1>Core/OR API</h1>" -bottom "<i>Copyright &#169; 2007 
Propylon.com All Rights Reserved.</i>" -classpath 
"C:\apache-ant-1.7.0\lib\ant-launcher.jar;C:\apache-ant-1.7.0\lib\ant-antlr.jar;C:\apache-ant-1.7.0\lib\ant-apache-bcel.jar;C:\apache-ant-1.7.0\lib\ant-apache-bsf.jar;C:\apache-ant-1.7.0\lib\ant-apache-log4j.jar;C:\apache-ant-1.7.0\lib\ant-apache-oro.jar;C:\apache-ant-1.7.0\lib\ant-apache-regexp.jar;C:\apache-ant-1.7.0\lib\ant-apache-resolver.jar;C:\apache-ant-1.7.0\lib\ant-commons-logging.jar;C:\apache-ant-1.7.0\lib\ant-commons-net.jar;C:\apache-ant-1.7.0\lib\ant-jai.jar;C:\apache-ant-1.7.0\lib\ant-javamail.jar;C:\apache-ant-1.7.0\lib\ant-jdepend.jar;C:\apache-ant-1.7.0\lib\ant-jmf.jar;C:\apache-ant-1.7.0\lib\ant-jsch.jar;C:\apache-ant-1.7.0\lib\ant-junit.jar;C:\apache-ant-1.7.0\lib\ant-netrexx.jar;C:\apache-ant-1.7.0\lib\ant-nodeps.jar;C:\apache-ant-1.7.”
....
--- Nested Exception ---
java.io.IOException: CreateProcess: "C:\Program 
Files\Java\jdk1.5.0_11\bin\javadoc.exe" -d 
C:\subversion\D0040_OR\workbench\docs\api -use -windowtitle "LBDS API" 
-doctitle "<h1>Core/OR API</h1>" -bottom "<i>Copyright &#169; 2007 
Propylon.com All Rights Reserved.</i>" -classpath 
"C:\apache-ant-1.7.0\lib\ant-launcher.jar;C:\apache-ant-1.7.0\lib\ant-antlr.jar;C:\apache-ant-1.7.0\lib\ant-apache-bcel.jar;C:\apache-ant-1.7.0\lib\ant-apache-bsf.jar;C:\apache-ant-1.7.0\lib\ant-apache-log4j.jar;C:\apache-ant-1.7.0\lib\ant-apache-oro.jar;C:\apache-ant-1.7.0\lib\ant-apache-regexp.jar;C:\apache-ant-1.7.0\lib\ant-apache-resolver.jar;C:\apache-ant-1.7.0\lib\ant-commons-logging.jar;C:\apache-ant-1.7.0\lib\ant-commons-net.jar;C:\apache-ant-1.7.0\lib\ant-jai.jar;C:\apache-ant-1.7.0\lib\ant-javamail.jar;C:\apache-ant-1.7.0\lib\ant-jdepend.jar;C:\apache-ant-1.7.0\lib\ant-jmf.jar;C:\apache-ant-1.7.0\lib\ant-jsch.jar;C:\apache-ant-1.7.0\lib\ant-junit.jar;C:\apache-ant-1.7.0\lib\ant-netrexx.jar;C:\apache-ant-1.7.0\lib\ant-nodeps.jar;C:\apache-ant-1.7.”
....

The build file 'javadoc' task pretty much follows the example in the Ant 
Manual and is incorporated into the following build file:

<project name="jDocBuild" default="jDoc" basedir="..">
<target name="jDoc">

<javadoc packagenames="com.myproj.*.*" destdir="docs/api" author="true" 
version="true" use="true" windowtitle="LBDS API">

<fileset dir="C:/subversion/a_proj/workbench/plugins" defaultexcludes="yes">
<include name="**/src/com/myproj/**/**/*.java"/>
</fileset>

<doctitle><![CDATA[<h1>MyProj API</h1>]]></doctitle>

<bottom><![CDATA[<i>Copyright &#169; 2007 MyProj.com All Rights 
Reserved.</i>]]></bottom>

<tag name="todo" scope="all" description="To do:"/>

<group title="Core Packages" packages="com.myproj.core.*"/>
<group title="Extra Packages" packages="com.myproj.extra.*"/>

</javadoc>

</target>

</project>

The output from the build tool tells me that javadoc is finding all the 
code it requires but not doing anything with it e.g.

[javadoc] 
'C:\subversion\A_Proj\workbench\plugins\XQuerySearch\src\com\myproj\core\xquerysearch\actions\NewXQueryAction.java'
[javadoc] 
'C:\subversion\A_Proj\workbench\plugins\XQuerySearch\src\com\myproj\core\xquerysearch\editor\XQueryEditor.java'
[javadoc] 
'C:\subversion\A_Proj\workbench\plugins\XQuerySearch\src\com\myproj\extra\search\util\SearchUtil.java'
[javadoc]
[javadoc] The ' characters around the executable and arguments are
[javadoc] not part of the command.
[javadoc] Javadoc execution

then 'bails out' with the errors stated above
I'd appreciate any help in solving this as I'm relatively new to using ant
I have a feeling that my problem may be associated with getting the task 
to cope with packages that vary at two locations in the package names e.g
com.myproj.thisName.* and com.myproj.otherName.*
Do the package names have to be the same up to the wild card? i.e 
com.myproj.theSameName.*
Does it work with two wild cards as per the build file example above?

Any help greatly appreciated
TIA
Pete



---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org