You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@ant.apache.org by Brett Francis <br...@mediagate.com> on 2000/08/01 05:57:23 UTC

No files after Javadoc run

I have created the following javadoc target:

<target name="javadocs" depends="docprepare">
    <echo message="### Building JavaDocs to destination:
${javadocs.build}"/>
    <javadoc packagenames="com.mediagate.*"
            sourcepath="${mg.source}"
            destdir="${javadocs.build}"
            author="true"
            version="true"
            use="true"
        <group title="mediagate Packages"
               packages="com.mediagate.*"/>
    </javadoc>
</target>

... but even though I get a BUILD SUCCESSFUL at the end of this target's
execution I never get any files in my "javadocs.build" destination
directory.

Any help?

I've turned on the attribute verbose="true" and the only additional
information it displays is that it is in fact walking the entire package
hierarchy and Parsing the files.
_________________________________________
|> Brett Francis
|> mediagate, inc.
|> mailto:brett@mediagate.com



Re: No files after Javadoc run

Posted by Brett Francis <br...@mediagate.com>.
Yes, the directory exists. I just rechecked. I also checked that if the
directory doesn't exist it is definitely auto-created.

...and No, when I remove the space from the group name it still does not
work.

Stefan Bodewig wrote:

> >>>>> "BF" == Brett Francis <br...@mediagate.com> writes:
>
>  BF> Here's the snipped output with ant -verbose turned on.
>
> Two quick checks, I'm more than puzzled about your problem.
>
> * Are you sure W:\mg\docs\javadocs exists?
>
> * Does it work if you use another label than "mediagate Packages" for
> the group, especially something without spaces in it?
>
> Just guessing at the moment, sorry.
>
> Stefan

--
_________________________________________
|> Brett Francis
|> mediagate, inc.
|> mailto:brett@mediagate.com



Re: No files after Javadoc run

Posted by Stefan Bodewig <bo...@bost.de>.
>>>>> "BF" == Brett Francis <br...@mediagate.com> writes:

 BF> Here's the snipped output with ant -verbose turned on.

Two quick checks, I'm more than puzzled about your problem.

* Are you sure W:\mg\docs\javadocs exists?

* Does it work if you use another label than "mediagate Packages" for
the group, especially something without spaces in it?

Just guessing at the moment, sorry. 

Stefan

Re: No files after Javadoc run

Posted by Brett Francis <br...@mediagate.com>.
Here's the snipped output with ant -verbose turned on. I also added the
failonerror="true" attribute to the javadoc tag so now I get a BUILD
FAILED at the end of the run:
-------------
Build sequence for target `javadocs' is [init, docprepare, javadocs]
Complete build sequence is [init, docprepare, javadocs, <snip>]
### Construct all document target dirs
### Building quicksilver JavaDocs into destination: W:\mg/docs/javadocs
  [javadoc] Generating Javadoc
  [javadoc] Parsing source files for packages
  [javadoc] Source path = W:\mg\src
  [javadoc] Packages = [com.mediagate.*]
  [javadoc] found 10 source files in W:\mg\src\com\mediagate\adapter\web
...<snip>...
  [javadoc] W:\mg\src\com\mediagate\foo\FooContext.java -->
com.mediagate.foo
...<snip>...
  [javadoc] Javadoc args: [-classpath,
w:\mg\build\jdk\jdk1.2.2\lib\tools.jar;w:
\mg\build\tools\ant\lib\ant.jar;w:\qs\build\tools\ant\lib\jaxp.jar;w:\qs\build\tools\ant\lib\optional.jar;w:\mg\build\tools\ant\lib\parser.jar,
-sourcepath, W:\mg\src, -d, W:\mg\docs\javadocs, -version, -author, -use,
-group, mediagate Packages, com.mediagate.*]
  [javadoc] Javadoc execution
  [javadoc] Myos = Windows NT
  [javadoc] javadoc -classpath
"w:\mg\build\jdk\jdk1.2.2\lib\tools.jar;w:\mg\build\tools\ant\lib\ant.jar;w:\mg\build\tools\ant\lib\jaxp.jar;w:\qs\build\tools\ant\lib\optional.jar;w:\mg\build\tools\ant\lib\parser.jar"
-sourcepath "W:\mg\src" -d "W:\mg\docs\javadocs" -version -author -use
-group "mediagate Packages" "com.mediagate.*"
  [javadoc] Loading source files for package com.mediagate.foo...
...<snip>...
BUILD FAILED

w:\qs\build\jdk\ant\build.xml:563: Exec returned: 1
-------------


Stefan Bodewig wrote:

> >>>>> "BF" == Brett Francis <br...@mediagate.com> writes:
>
>  BF> I've turned on the attribute verbose="true" and the only
>  BF> additional information it displays is that it is in fact walking
>  BF> the entire package hierarchy and Parsing the files.
>
> Could you try and run "ant -verbose" as well as/instead of setting the
> verbose attribute on the javadoc task?
>
> Javadoc is a little bit chatty, even if you don't ask it to be verbose
> - that why the task filters a lot of messages and you won't see them
> unless you make Ant verbose. It's possible that Ant swallows a message
> that would have been important to you - if so, please tell us which.
>
> Stefan

--
_________________________________________
|> Brett Francis
|> mediagate, inc.
|> mailto:brett@mediagate.com



Re: No files after Javadoc run

Posted by Stefan Bodewig <bo...@bost.de>.
>>>>> "BF" == Brett Francis <br...@mediagate.com> writes:

 BF> I've turned on the attribute verbose="true" and the only
 BF> additional information it displays is that it is in fact walking
 BF> the entire package hierarchy and Parsing the files.

Could you try and run "ant -verbose" as well as/instead of setting the
verbose attribute on the javadoc task?

Javadoc is a little bit chatty, even if you don't ask it to be verbose
- that why the task filters a lot of messages and you won't see them
unless you make Ant verbose. It's possible that Ant swallows a message
that would have been important to you - if so, please tell us which.

Stefan