A DESCRIPTION OF THE PROBLEM :
The Javadoc should indicate that a common cause of ToolProvider.getSystemJavaCompiler() returning null is if the method is invoked from a JRE as opposed to the JDK.


URL OF FAULTY DOCUMENTATION :
http://java.sun.com/javase/6/docs/api/javax/tools/ToolProvider.html