You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by bu...@apache.org on 2009/02/02 22:16:31 UTC
DO NOT REPLY [Bug 46649] New: Javadoc task does nothing when given
3+ nested link elements
https://issues.apache.org/bugzilla/show_bug.cgi?id=46649
Summary: Javadoc task does nothing when given 3+ nested link
elements
Product: Ant
Version: 1.7.0
Platform: Macintosh
OS/Version: Mac OS X 10.4
Status: NEW
Severity: normal
Priority: P2
Component: Core tasks
AssignedTo: notifications@ant.apache.org
ReportedBy: quinntaylor@mac.com
When using the <javadoc> task in a target, I can get it to link to external
Javadoc API by providing a nested <link> element, even two, and it works fine.
The moment a third <link> element is added, the only output I get is:
docs:
[javadoc] Generating Javadoc
[javadoc] Javadoc execution
BUILD SUCCESSFUL
Total time: 0 seconds
No packages are loaded or parsed, and no output is generated. It doesn't seem
to matter what URL's are, or what order they're in. For reference, here are
several that I've been using:
<link href="http://java.sun.com/j2se/1.5.0/docs/api/"/>
<link href="http://java.sun.com/javaee/5/docs/api/"/>
<link href="http://bouncycastle.org/docs/docs1.5/"/>
<link href="http://bouncycastle.org/docs/mdocs1.5/"/>
<link href="http://junit.org/junit/javadoc/4.5/"/>
It wouldn't seem to be a timeout issue, since when I'm on a slow connection,
the javadoc tasks hangs until it can download the "package-list" file from each
URL.
I've tried increasing the memory with the 'maxmemory' attribute, to no avail.
My next step is to try using offline saved files for each link. Perhaps that
will work, but even if it does, that's a serious PITA workaround for something
that should just work, especially since each file has to be named
"package-list" and be in a different directory.
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
DO NOT REPLY [Bug 46649] Javadoc task does nothing when given 3+
nested link elements
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46649
Quinn Taylor <qu...@mac.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEEDINFO |RESOLVED
Resolution| |WORKSFORME
--- Comment #2 from Quinn Taylor <qu...@mac.com> 2009-02-05 13:22:39 PST ---
(In reply to comment #1)
>
> Maybe the command line is getting too long? Have you tried
> useexternalfile="true"?
>
> What does Ant tell you it would be doing in -verbose mode?
>
Excellent catch! I used the verbose flag, and although Ant didn't print the
entire command, the resulting output was sufficient to disclose the symptom.
The classpath for the problematic project includes a whole heap of JAR files,
as well as a lot of other options. (Those potential problems are less obvious
in a build.xml, especiall with *.jar pattern matching.) I think what must have
happened is that adding one-too-many external links cause the command to be
truncated before any source files were specified, so Javadoc figured it had
nothing to document.
In the end, adding useexternalfile="true" solved the problem for me. Thanks!
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
DO NOT REPLY [Bug 46649] Javadoc task does nothing when given 3+
nested link elements
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46649
--- Comment #1 from Stefan Bodewig <bo...@apache.org> 2009-02-02 20:46:07 PST ---
I've used Ant's own javadoc task (the one from Ant's build.xml) and added your
five links and it just works both with Ant's svn trunk and 1.7.1 - so it must
be something else.
Maybe the command line is getting too long? Have you tried
useexternalfile="true"?
What does Ant tell you it would be doing in -verbose mode?
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
DO NOT REPLY [Bug 46649] Javadoc task does nothing when given 3+
nested link elements
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46649
Stefan Bodewig <bo...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |NEEDINFO
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.