Author: jhm
Date: Tue Nov 11 06:07:24 2008
New Revision: 713046
URL: http://svn.apache.org/viewvc?rev=713046&view=rev
Log:
Document Java bug 6442982 : javadoc crashes when finding annotations not on its classpath
Modified:
ant/core/trunk/docs/manual/CoreTasks/javadoc.html
Modified: ant/core/trunk/docs/manual/CoreTasks/javadoc.html
URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/CoreTasks/javadoc.html?rev=713046&r1=713045&r2=713046&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/CoreTasks/javadoc.html (original)
+++ ant/core/trunk/docs/manual/CoreTasks/javadoc.html Tue Nov 11 06:07:24 2008
@@ -62,6 +62,13 @@
If you specify the <code>executable</code> attribute it is up to you
to ensure that this command supports the attributes you wish to use.</p>
+<p><b>Note:</b><br>When generating the JavaDocs for classes which
contains annotations
+you maybe get a <tt>java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl</tt>.
+This is due <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6442982" target="_blank">bug-6442982</a>.
The cause is that JavaDoc cannot find the implementations of used annotations.
+The workaround is providing the jars with these implementations (like JAXBs <tt>@XmlType</tt>,
...)
+to <javadoc> using <tt>classpath</tt>, <tt>classpathref</tt>
attributes or nested
+<classpath> element.</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
|