diff --git a/docs/manual/CoreTasks/style.html b/docs/manual/CoreTasks/style.html
index bf6b9193e..daaa39747 100644
--- a/docs/manual/CoreTasks/style.html
+++ b/docs/manual/CoreTasks/style.html
@@ -32,7 +32,9 @@
 or for generating code.</p>
 <p><b>Note:</b> If you are using JDK 1.4 or higher, this task does not require external libraries
 not supplied in the Ant distribution. However, often the built in XSL engine is not as up
-to date as a fresh download, so an update is still highly recommended.
+to date as a fresh download, so an update is still highly recommended
+  in particual since the built-in XSLT processors of Java5 (and to a
+  certain extent Java6) are known to have serious issues.
 See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p>
 <p>It is possible to refine the set of files that are being processed. This can be
 done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i>