WARNING: This blog entry was imported from my old blog on blogs.sun.com (which used different blogging software), so formatting and links may not be correct.
The JDK ships with a "src.zip" file - the sources to the java classes. Yet getting the JDK javadocs requires a separate download - and the download is not small.
But of course the javadocs can be derived from the src.zip file, since the comments are all in the source. So part of the JDK installation should offer to extract the javadocs for you - by running the javadoc command on the src.zip file!!
Creator ships with a bundled JDK, but we don't bundle the javadocs. This should give us a simple solution to that, to improve the out-of-the-box experience.