From f7cec58a607900954a1686009fb5ebe4ea6ddea6 Mon Sep 17 00:00:00 2001
From: Jan Materne <jhm@apache.org>
Date: Tue, 11 Nov 2008 14:07:24 +0000
Subject: [PATCH] Document Java bug 6442982 : javadoc crashes when finding
 annotations not on its classpath

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@713046 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/CoreTasks/javadoc.html | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/manual/CoreTasks/javadoc.html b/docs/manual/CoreTasks/javadoc.html
index 3b841eb36..5414ab5a8 100644
--- a/docs/manual/CoreTasks/javadoc.html
+++ b/docs/manual/CoreTasks/javadoc.html
@@ -62,6 +62,13 @@ any VM of at least version 1.2 is acceptable. JDK 1.1 is no longer supported.
 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 &lt;javadoc&gt; using <tt>classpath</tt>, <tt>classpathref</tt> attributes or nested
+&lt;classpath&gt; element.</p>
+
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
   <tr>