Index: java-devel.xml
===================================================================
--- java-devel.xml	(revision 1096)
+++ java-devel.xml	(working copy)
@@ -287,8 +287,17 @@
 
 <p>
 Always depend on dev-java/ant-core when possible, and dev-java/ant when your
-package requires the optional ant tasks</p>
+package requires the optional ant tasks. 
+</p>
 
+<impo>
+When finding out the dependencies, it is important that you disable the 
+<c>LOCALCLASSPATH</c> in <path>/usr/bin/ant</path> because otherwise the
+javac task can have jars in CLASSPATH that you are not aware of, which results
+in broken dependencies. To ensure a smooth emerge process you can also start
+emerging your package from a clean table with only a jdk installed.
+</impo>
+
 </body>
 </section>
 <section>