Fixed javadoc problems

This pull request fixes problems with the javadocs which cause the build to fail during a release. This is necessary for #12 to be resolved.

The changes include:
- fixing wrong method and class references
- removing references to removed methods
- adding documentation to \@return
- removing an unsued com.sun.* import