oracle中的javadoc,.jar files with javadoc

More details.

I have a file called Ellipsoid.java that references an annotation called @Immutable. I've parred down my javadoc command to this:

javadoc -d javadocs Ellipsoid.java -classpath /home/bamboo/annotations-1.3.5.jar

where the annotations-1.3.5.jar file contains the annotation class referenced from Ellipsoid.java. I know about http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6442982 which is why I am adding the .jar to the classpath. Yet I continue to get this exception:

java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl

at com.sun.tools.javadoc.AnnotationDescImpl.annotationType(AnnotationDescImpl.java:46)

at com.sun.tools.doclets.internal.toolkit.util.Util.isDeprecated(Util.java:804)

at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printComment(AbstractIndexWriter.java:179)

at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printDescription(AbstractIndexWriter.java:126)

at com.sun.tools.doclets.formats.html.AbstractIndexWriter.generateContents(AbstractIndexWriter.java:91)

at com.sun.tools.doclets.formats.html.SingleIndexWriter.generateIndexFile(SingleIndexWriter.java:76)

at com.sun.tools.doclets.formats.html.SingleIndexWriter.generate(SingleIndexWriter.java:52)

at com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(HtmlDoclet.java:103)

at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:122)

at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64)

at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42)

at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)

at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)

at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)

at java.lang.reflect.Method.invoke(Method.java:585)

at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269)

at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143)

at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)

at com.sun.tools.javadoc.Start.begin(Start.java:128)

at com.sun.tools.javadoc.Main.execute(Main.java:41)

at com.sun.tools.javadoc.Main.main(Main.java:31)

Removing the annotation from the file fixes the problem and Javadoc runs fine.

Edited by: Mary_at_Palantir on Jan 12, 2009 10:39 AM