http://nagoya.apache.org/bugzilla/show_bug.cgi?id=622
*** shadow/622 Thu Feb 15 11:31:51 2001
--- shadow/622.tmp.2019 Thu Feb 15 11:31:51 2001
***************
*** 0 ****
--- 1,61 ----
+ +============================================================================+
+ | Javadoc task fails if 'bottom' attribute is set to empty string |
+ +----------------------------------------------------------------------------+
+ | Bug #: 622 Product: Ant |
+ | Status: NEW Version: 1.3 Beta 1 |
+ | Resolution: Platform: PC |
+ | Severity: Minor OS/Version: |
+ | Priority: Component: Core tasks |
+ +----------------------------------------------------------------------------+
+ | Assigned To: ant-dev@jakarta.apache.org |
+ | Reported By: skip@maplerise.com |
+ +----------------------------------------------------------------------------+
+ | URL: |
+ +============================================================================+
+ | DESCRIPTION |
+ I have been using the follwing javadoc task for many builds. All the properties
+ are assigned at the top of my build file.
+
+ <javadoc packagenames="${javadoc.packagenames}"
+ sourcepath="${src.java}"
+ destdir="${build.javadocs}"
+ author="${javadoc.author}"
+ version="${javadoc.version}"
+ public="${javadoc.public}"
+ protected="${javadoc.protected}"
+ package="${javadoc.package}"
+ private="${javadoc.private}"
+ nodeprecated="${javadoc.nodeprecated}"
+ windowtitle="${javadoc.windowtitle}"
+ doctitle="${javadoc.doctitle}"
+ bottom="${javadoc.footer}">
+ <classpath>
+ <pathelement location="${build.classes}"/>
+ <path refid="project-classpath"/>
+ </classpath>
+ </javadoc>
+
+ On a new project, I set the ${javadoc.footer} property to the null string:
+
+ <property name="javadoc.footer" value=""/>
+
+ The build failed with a message from javadoc saying:
+
+ javadoc: No package, class, or source file found named <... a long string
+ which was my specified classpath ...>
+
+ Running ant -verbose, it's clear that the empty string is not being emitted and
+ the next token, "-classpath", is interpreted as the value of the -bottom
+ option. Javadoc then tries to interpret the classpath string as a package name!
+
+ Changing the property to:
+
+ <property name="javadoc.footer" value=" "/>
+
+ eliminates the problem.
+
+ I'm sure it's an easy fix, but it took me a while to figure out what was going
+ on. The same problem may exist with the other attributes; I didn't investigate
+ further.
+
+ Thanks for a cool tool!
|