Cleanup/javadoc correction

I didn't have Java 8 on my machine. Noticed the CI build failed for Java 8 version. Then after installing Java 8, noticed some javadoc warnings as well. Thought would be a good time to correct them. Merge if you think its useful. So this pull request consists of documentation fixes and two tests.