You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@ant.apache.org by Scott M Stark <Sc...@displayscape.com> on 2000/10/28 23:53:24 UTC
javadoc tag does not see destdir when
The javadoc task is failing to see the destdir attribute when the doclet attribute is
specified:
<project name = "ProjectRepositoryServer" default = "projrep-jdoc" basedir = ".">
<target name="projrep-jdoc">
<javadoc packagenames="com.dscape.projects.documents.ejb.*"
destdir="dist"
sourcepath="../classes"
doclet="com.dreambean.ejbdoclet.EJBDoclet"
docletpath="../jars/ejbdoclet.jar"
>
</javadoc>
</target>
</project>
bash-2.04$ ant -verbose -buildfile tst.xml projrep-jdoc
Ant version 1.2 compiled on October 28 2000
Buildfile: tst.xml
Detected Java Version: 1.3
Detected OS: Windows 2000
Project base dir set to: D:\usr\local\src\cvsroot\dscape\build
Build sequence for target `projrep-jdoc' is [projrep-jdoc]
Complete build sequence is [projrep-jdoc]
[javadoc] Generating Javadoc
[javadoc] Source path = D:\usr\local\src\cvsroot\dscape\classes
[javadoc] Packages = [com.dscape.projects.documents.ejb.*]
[javadoc] Javadoc args: javadoc -classpath \usr\local\src\cvsroot\dscape\class
es;\usr\local\Java\Ant\install\lib\ant.jar;\usr\local\Java\Ant\install\lib\jaxp.
jar;\usr\local\Java\Ant\install\lib\parser.jar;\usr\local\Java\jdk1.3\lib\tools.
jar -sourcepath D:\usr\local\src\cvsroot\dscape\classes -doclet com.dreambean.ej
bdoclet.EJBDoclet -docletpath D:\usr\local\src\cvsroot\dscape\jars\ejbdoclet.jar
com.dscape.projects.documents.ejb
[javadoc] Javadoc execution
[javadoc] No dest dir specified
BUILD SUCCESSFUL
Total time: 2 seconds
bash-2.04$
Re: javadoc tag does not see destdir when
Posted by Scott M Stark <Sc...@displayscape.com>.
Thanks. Passing in the -d via param is fine for a workaround.
----- Original Message -----
From: "Conor MacNeill" <co...@m64.com>
To: <an...@jakarta.apache.org>
Sent: Sunday, October 29, 2000 5:08 AM
Subject: RE: javadoc tag does not see destdir when
> Scott,
>
> Strictly speaking this is correct. The -d option is not part of javadoc
> itself but rather the standard doclet. This problem came up when someone
> attempted to use doclint. doclint will fail if the -d option is set. A
> change was made not to pass the -d paramater if a doclet was specified.
> I think that change was not quite correct. A better approach would be to
> only pass -d if the destDir option is set and to only check that option
> is supplied if using javadoc1 or the standard doclet.
>
> I will make the change in CVS but you can use the doclet params as a
> short term workaround. Be warned, however, that doclet params are simple
> strings. Paths are not translated to that of the native platform.
>
> Conor
>
>
RE: javadoc tag does not see destdir when
Posted by Conor MacNeill <co...@m64.com>.
Scott,
Strictly speaking this is correct. The -d option is not part of javadoc
itself but rather the standard doclet. This problem came up when someone
attempted to use doclint. doclint will fail if the -d option is set. A
change was made not to pass the -d paramater if a doclet was specified.
I think that change was not quite correct. A better approach would be to
only pass -d if the destDir option is set and to only check that option
is supplied if using javadoc1 or the standard doclet.
I will make the change in CVS but you can use the doclet params as a
short term workaround. Be warned, however, that doclet params are simple
strings. Paths are not translated to that of the native platform.
Conor
> -----Original Message-----
> From: Scott M Stark [mailto:Scott_Stark@displayscape.com]
> Sent: Sunday, 29 October 2000 19:06
> To: ant-user@jakarta.apache.org
> Subject: Re: javadoc tag does not see destdir when
>
>
> After looking at the javadoc target code this behavior
> appears to be by design. It looks
> like custom doclets are expected to supply a -d via a param
> tag. Is there a good reason
> why the destdir attribute does not set the -d option when a
> custom doclet is being used?
>
>
Re: javadoc tag does not see destdir when
Posted by Scott M Stark <Sc...@displayscape.com>.
After looking at the javadoc target code this behavior appears to be by design. It looks
like custom doclets are expected to supply a -d via a param tag. Is there a good reason
why the destdir attribute does not set the -d option when a custom doclet is being used?
RE: javadoc tag does not see destdir when
Posted by Chris Bartling <ce...@harbinger-partners.com>.
I'm seeing the same thing in Ant 1.2 with the dreamBean EJBDoclet. I've
sent a note to Rickard Oberg (the author of EJBDoclet) about the matter.
-- chris --
*********************************************
Chris Bartling
Object Technology Consultant
Harbinger Partners, Inc.
Cell: 651-261-0275
*********************************************
-----Original Message-----
From: Scott M Stark [mailto:Scott_Stark@displayscape.com]
Sent: Saturday, October 28, 2000 3:53 PM
To: ant-user@jakarta.apache.org
Subject: javadoc tag does not see destdir when
The javadoc task is failing to see the destdir attribute when the doclet
attribute is
specified:
<project name = "ProjectRepositoryServer" default = "projrep-jdoc" basedir =
".">
<target name="projrep-jdoc">
<javadoc packagenames="com.dscape.projects.documents.ejb.*"
destdir="dist"
sourcepath="../classes"
doclet="com.dreambean.ejbdoclet.EJBDoclet"
docletpath="../jars/ejbdoclet.jar"
>
</javadoc>
</target>
</project>
bash-2.04$ ant -verbose -buildfile tst.xml projrep-jdoc
Ant version 1.2 compiled on October 28 2000
Buildfile: tst.xml
Detected Java Version: 1.3
Detected OS: Windows 2000
Project base dir set to: D:\usr\local\src\cvsroot\dscape\build
Build sequence for target `projrep-jdoc' is [projrep-jdoc]
Complete build sequence is [projrep-jdoc]
[javadoc] Generating Javadoc
[javadoc] Source path = D:\usr\local\src\cvsroot\dscape\classes
[javadoc] Packages = [com.dscape.projects.documents.ejb.*]
[javadoc] Javadoc args: javadoc -classpath
\usr\local\src\cvsroot\dscape\class
es;\usr\local\Java\Ant\install\lib\ant.jar;\usr\local\Java\Ant\install\lib\j
axp.
jar;\usr\local\Java\Ant\install\lib\parser.jar;\usr\local\Java\jdk1.3\lib\to
ols.
jar -sourcepath D:\usr\local\src\cvsroot\dscape\classes -doclet
com.dreambean.ej
bdoclet.EJBDoclet -docletpath
D:\usr\local\src\cvsroot\dscape\jars\ejbdoclet.jar
com.dscape.projects.documents.ejb
[javadoc] Javadoc execution
[javadoc] No dest dir specified
BUILD SUCCESSFUL
Total time: 2 seconds
bash-2.04$