If you are using Eclipse and it does not show you the JavaDoc information as you would have expected it to, maybe it is using the wrong Java Runtime (JRE).
To fix this open Eclipse’s Preferences (under the Window menu). Click on + sign next to ‘Java’ and click on ‘Installed JREs’. Now, click ‘Add’ and a window will open. From it, click ‘Browse’ next to the box saying ‘JRE Home directory’ and in the window that will open, traverse the directory structure and select the root folder for your installation of your Java SDK. Select it and click OK. The rest of the form in the window will be populated automatically and your JavaDocs will suddenly be more helpful.
Kudos to Rob for finding this one.
